%global _empty_manifest_terminate_build 0
Name:		python-litex.regon
Version:	1.0.7
Release:	1
Summary:	An API for accessing a Polish REGON database
License:	GPL
URL:		http://litexservice.pl
Source0:	https://mirrors.aliyun.com/pypi/web/packages/4f/a1/cfe76c4c6725630794ea6febbb83184a9e298802d9844a8788b06860ebf7/litex.regon-1.0.7.tar.gz
BuildArch:	noarch


%description
Simple, pythonic wrapper for REGON database (web frontend is reachable at
https://wyszukiwarkaregon.stat.gov.pl/appBIR/index.aspx). To access its SOAP
API, one needs an USER_KEY issued by REGON administrators available at
Regon_Bir@stat.gov.pl.
Usage example below:
```python
>>> from litex.regon import REGONAPI
```
REGONAPI accepts one argument: service URL (provided by REGON Administrators).
```python
>>> api = REGONAPI(SERVICE_URL)
```
First, one needs to log in (using provided user key)
```python
>>> api.login(USER_KEY)
```
After login, one can start querying the database. The search method
accepts the following parameters:
 - `regon` - single REGON number (either 9 or 14 digits long)
 - `krs` - single 10 digit KRS number
 - `nip` - single NIP (10 digits string)
 - `regons` - a collection of REGONs (all of them have to be either 14 or 9 digits long)
 - `krss` - a collection of KRSs
 - `nips` - a collection of NIPs
Only one parameter is used in the query. If multiple ones are passed, first
from the above list is taken into account.
Additionally, a `detailed` parameter can be passed: `detailed=True` causes search method to
fetch default detailed report.
```python
>>> entities = api.search(nip='9999999999')
```
`entities` is a list of LXML objectify objects wrapping the search results (up to 100).
If search was called with `detailed=True`, the full report is available as the `detailed` attribute.
If one knows the REGON of a business entity and an detailed report name, a full report can be fetched
directly:
```python
>>> detailed_report = api.full_report('99999999', 'PublDaneRaportFizycznaOsoba')
```
Summary report with a list of REGONs for the given criteria can be fetched by:
```python
>>> summary_report = api.summary_report(
        '2020-01-01', 
        'BIR11NowePodmiotyPrawneOrazDzialalnosciOsFizycznych'
    )
```
Report names can be found in the documentation provided by REGON admins.

%package -n python3-litex.regon
Summary:	An API for accessing a Polish REGON database
Provides:	python-litex.regon
BuildRequires:	python3-devel
BuildRequires:	python3-setuptools
BuildRequires:	python3-pip
%description -n python3-litex.regon
Simple, pythonic wrapper for REGON database (web frontend is reachable at
https://wyszukiwarkaregon.stat.gov.pl/appBIR/index.aspx). To access its SOAP
API, one needs an USER_KEY issued by REGON administrators available at
Regon_Bir@stat.gov.pl.
Usage example below:
```python
>>> from litex.regon import REGONAPI
```
REGONAPI accepts one argument: service URL (provided by REGON Administrators).
```python
>>> api = REGONAPI(SERVICE_URL)
```
First, one needs to log in (using provided user key)
```python
>>> api.login(USER_KEY)
```
After login, one can start querying the database. The search method
accepts the following parameters:
 - `regon` - single REGON number (either 9 or 14 digits long)
 - `krs` - single 10 digit KRS number
 - `nip` - single NIP (10 digits string)
 - `regons` - a collection of REGONs (all of them have to be either 14 or 9 digits long)
 - `krss` - a collection of KRSs
 - `nips` - a collection of NIPs
Only one parameter is used in the query. If multiple ones are passed, first
from the above list is taken into account.
Additionally, a `detailed` parameter can be passed: `detailed=True` causes search method to
fetch default detailed report.
```python
>>> entities = api.search(nip='9999999999')
```
`entities` is a list of LXML objectify objects wrapping the search results (up to 100).
If search was called with `detailed=True`, the full report is available as the `detailed` attribute.
If one knows the REGON of a business entity and an detailed report name, a full report can be fetched
directly:
```python
>>> detailed_report = api.full_report('99999999', 'PublDaneRaportFizycznaOsoba')
```
Summary report with a list of REGONs for the given criteria can be fetched by:
```python
>>> summary_report = api.summary_report(
        '2020-01-01', 
        'BIR11NowePodmiotyPrawneOrazDzialalnosciOsFizycznych'
    )
```
Report names can be found in the documentation provided by REGON admins.

%package help
Summary:	Development documents and examples for litex.regon
Provides:	python3-litex.regon-doc
%description help
Simple, pythonic wrapper for REGON database (web frontend is reachable at
https://wyszukiwarkaregon.stat.gov.pl/appBIR/index.aspx). To access its SOAP
API, one needs an USER_KEY issued by REGON administrators available at
Regon_Bir@stat.gov.pl.
Usage example below:
```python
>>> from litex.regon import REGONAPI
```
REGONAPI accepts one argument: service URL (provided by REGON Administrators).
```python
>>> api = REGONAPI(SERVICE_URL)
```
First, one needs to log in (using provided user key)
```python
>>> api.login(USER_KEY)
```
After login, one can start querying the database. The search method
accepts the following parameters:
 - `regon` - single REGON number (either 9 or 14 digits long)
 - `krs` - single 10 digit KRS number
 - `nip` - single NIP (10 digits string)
 - `regons` - a collection of REGONs (all of them have to be either 14 or 9 digits long)
 - `krss` - a collection of KRSs
 - `nips` - a collection of NIPs
Only one parameter is used in the query. If multiple ones are passed, first
from the above list is taken into account.
Additionally, a `detailed` parameter can be passed: `detailed=True` causes search method to
fetch default detailed report.
```python
>>> entities = api.search(nip='9999999999')
```
`entities` is a list of LXML objectify objects wrapping the search results (up to 100).
If search was called with `detailed=True`, the full report is available as the `detailed` attribute.
If one knows the REGON of a business entity and an detailed report name, a full report can be fetched
directly:
```python
>>> detailed_report = api.full_report('99999999', 'PublDaneRaportFizycznaOsoba')
```
Summary report with a list of REGONs for the given criteria can be fetched by:
```python
>>> summary_report = api.summary_report(
        '2020-01-01', 
        'BIR11NowePodmiotyPrawneOrazDzialalnosciOsFizycznych'
    )
```
Report names can be found in the documentation provided by REGON admins.

%prep
%autosetup -n litex.regon-1.0.7

%build
%py3_build

%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
	find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
	find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
	find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
	find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
	find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .

%files -n python3-litex.regon -f filelist.lst
%dir %{python3_sitelib}/*

%files help -f doclist.lst
%{_docdir}/*

%changelog
* Tue Jun 20 2023 Python_Bot <Python_Bot@openeuler.org> - 1.0.7-1
- Package Spec generated