automatic import of python-ipstack

1 files changed, 340 insertions, 0 deletions

diff --git a/python-ipstack.spec b/python-ipstack.spec
new file mode 100644
index 0000000..e3d7f34
--- /dev/null
+++ b/python-ipstack.spec
@@ -0,0 +1,340 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-ipstack
+Version:	0.1.4
+Release:	1
+Summary:	A Python library for interfacing with IPStack Geo API
+License:	MIT License
+URL:		https://github.com/nathan-fiscaletti/ipstackgeo-py
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/a7/ad/628e10cafee7c7e308f06ccd31d277961b2cac8dbde861fb7170778a28de/ipstack-0.1.4.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-requests
+
+%description
+### Basic Usage
+```python
+from ipstack import GeoLookup
+geo_lookup = GeoLookup(".....")
+location = geo_lookup.get_location("github.com")
+print(location)
+```
+### Example Usage
+> Note: See [IPStack: Response Objects](https://ipstack.com/documentation#objects) for a list of available properties in a response object.
+#### Create the GeoLookup object
+```python
+from ipstack import GeoLookup
+# Create the GeoLookup object using your API key.
+geo_lookup = GeoLookup("acecac3893c90871c3")
+```
+#### Lookup a location for an IP Address
+```python
+# Lookup a location for an IP Address
+# and catch any exceptions that might
+# be thrown
+try:
+    # Retrieve the location information for 
+    # github.com by using it's hostname.
+    # 
+    # This function will work with hostnames
+    # or IP addresses.
+    location = geo_lookup.get_location("github.com")
+    # If we are unable to retrieve the location information
+    # for an IP address, null will be returned.
+    if location is None:
+        print("Failed to find location.")
+    else:
+        # Print the Location dictionary.
+        print(location)
+except Exception as e:
+    print(e)
+```
+#### Look up own location
+> For looking up your own location we use https://ip.42.pl/raw
+```python
+location = geo_lookup.get_own_location()
+print(location)
+```
+#### Other Features
+There are also a few other useful features built into this library and the IPStack API.
+1. Bulk Location Lookup
+   The ipstack API also offers the ability to request data for multiple IPv4 or IPv6 addresses at the same time. This requires the PROFESSIONAL teir API key or higher and is limitted to 50 IPs at a time.
+   > See: [https://ipstack.com/documentation#bulk](https://ipstack.com/documentation#bulk)
+   ```python
+   locations = geo_lookup.get_location("github.com", "stackoverflow.com")
+   print(locations)
+   ```
+2. Requesting the hostname for an IP address.
+   By default, the ipstack API does not return information about the hostname the given IP address resolves to. In order to include the hostname use the following.
+   > See: [https://ipstack.com/documentation#hostname](https://ipstack.com/documentation#hostname)
+   ```python
+   location = geo_lookup.find_hostname().get_location("1.1.1.1")
+   print(location["hostname"])
+   ```
+   ```
+   one.one.one.one
+   ```
+3. Assessing Security
+   Customers subscribed to the Professional Plus Plan may access the ipstack API's Security Module, which can be used to assess risks and threats originating from certain IP addresses before any harm can be done to a website or web application.
+   > See: [https://ipstack.com/documentation#security](https://ipstack.com/documentation#security)
+   ```python
+   location = geo_lookup.assess_security().get_location("github.com")
+   ```
+4. Set the language for a response
+   The ipstack API is capable of delivering its result set in different languages. To request data in a language other than English (default) use following with one of the supported language codes.
+   > See: [https://ipstack.com/documentation#language](https://ipstack.com/documentation#language)
+   [Supported Langauges](https://ipstack.com/documentation#language)
+   ```python
+   location = geo_lookup.language("en").get_location("github.com")
+   ```
+5. Configuring your request
+   ```python
+   # Use HTTPS
+   # This requires IPStack Basic plan or higher.
+   location = geo_lookup.use_https().get_location("github.com")
+   # Configure the timeout for requests
+   location = geo_lookup.timeout(10).get_location("github.com")
+   ```
+### Development
+Before commiting anything, please create a pre-commit hook with the following content.
+This will ensure that the pycodestyle badge is properly updated.
+```bash
+#!/bin/bash
+python3 tests/style.py
+```
+
+%package -n python3-ipstack
+Summary:	A Python library for interfacing with IPStack Geo API
+Provides:	python-ipstack
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-ipstack
+### Basic Usage
+```python
+from ipstack import GeoLookup
+geo_lookup = GeoLookup(".....")
+location = geo_lookup.get_location("github.com")
+print(location)
+```
+### Example Usage
+> Note: See [IPStack: Response Objects](https://ipstack.com/documentation#objects) for a list of available properties in a response object.
+#### Create the GeoLookup object
+```python
+from ipstack import GeoLookup
+# Create the GeoLookup object using your API key.
+geo_lookup = GeoLookup("acecac3893c90871c3")
+```
+#### Lookup a location for an IP Address
+```python
+# Lookup a location for an IP Address
+# and catch any exceptions that might
+# be thrown
+try:
+    # Retrieve the location information for 
+    # github.com by using it's hostname.
+    # 
+    # This function will work with hostnames
+    # or IP addresses.
+    location = geo_lookup.get_location("github.com")
+    # If we are unable to retrieve the location information
+    # for an IP address, null will be returned.
+    if location is None:
+        print("Failed to find location.")
+    else:
+        # Print the Location dictionary.
+        print(location)
+except Exception as e:
+    print(e)
+```
+#### Look up own location
+> For looking up your own location we use https://ip.42.pl/raw
+```python
+location = geo_lookup.get_own_location()
+print(location)
+```
+#### Other Features
+There are also a few other useful features built into this library and the IPStack API.
+1. Bulk Location Lookup
+   The ipstack API also offers the ability to request data for multiple IPv4 or IPv6 addresses at the same time. This requires the PROFESSIONAL teir API key or higher and is limitted to 50 IPs at a time.
+   > See: [https://ipstack.com/documentation#bulk](https://ipstack.com/documentation#bulk)
+   ```python
+   locations = geo_lookup.get_location("github.com", "stackoverflow.com")
+   print(locations)
+   ```
+2. Requesting the hostname for an IP address.
+   By default, the ipstack API does not return information about the hostname the given IP address resolves to. In order to include the hostname use the following.
+   > See: [https://ipstack.com/documentation#hostname](https://ipstack.com/documentation#hostname)
+   ```python
+   location = geo_lookup.find_hostname().get_location("1.1.1.1")
+   print(location["hostname"])
+   ```
+   ```
+   one.one.one.one
+   ```
+3. Assessing Security
+   Customers subscribed to the Professional Plus Plan may access the ipstack API's Security Module, which can be used to assess risks and threats originating from certain IP addresses before any harm can be done to a website or web application.
+   > See: [https://ipstack.com/documentation#security](https://ipstack.com/documentation#security)
+   ```python
+   location = geo_lookup.assess_security().get_location("github.com")
+   ```
+4. Set the language for a response
+   The ipstack API is capable of delivering its result set in different languages. To request data in a language other than English (default) use following with one of the supported language codes.
+   > See: [https://ipstack.com/documentation#language](https://ipstack.com/documentation#language)
+   [Supported Langauges](https://ipstack.com/documentation#language)
+   ```python
+   location = geo_lookup.language("en").get_location("github.com")
+   ```
+5. Configuring your request
+   ```python
+   # Use HTTPS
+   # This requires IPStack Basic plan or higher.
+   location = geo_lookup.use_https().get_location("github.com")
+   # Configure the timeout for requests
+   location = geo_lookup.timeout(10).get_location("github.com")
+   ```
+### Development
+Before commiting anything, please create a pre-commit hook with the following content.
+This will ensure that the pycodestyle badge is properly updated.
+```bash
+#!/bin/bash
+python3 tests/style.py
+```
+
+%package help
+Summary:	Development documents and examples for ipstack
+Provides:	python3-ipstack-doc
+%description help
+### Basic Usage
+```python
+from ipstack import GeoLookup
+geo_lookup = GeoLookup(".....")
+location = geo_lookup.get_location("github.com")
+print(location)
+```
+### Example Usage
+> Note: See [IPStack: Response Objects](https://ipstack.com/documentation#objects) for a list of available properties in a response object.
+#### Create the GeoLookup object
+```python
+from ipstack import GeoLookup
+# Create the GeoLookup object using your API key.
+geo_lookup = GeoLookup("acecac3893c90871c3")
+```
+#### Lookup a location for an IP Address
+```python
+# Lookup a location for an IP Address
+# and catch any exceptions that might
+# be thrown
+try:
+    # Retrieve the location information for 
+    # github.com by using it's hostname.
+    # 
+    # This function will work with hostnames
+    # or IP addresses.
+    location = geo_lookup.get_location("github.com")
+    # If we are unable to retrieve the location information
+    # for an IP address, null will be returned.
+    if location is None:
+        print("Failed to find location.")
+    else:
+        # Print the Location dictionary.
+        print(location)
+except Exception as e:
+    print(e)
+```
+#### Look up own location
+> For looking up your own location we use https://ip.42.pl/raw
+```python
+location = geo_lookup.get_own_location()
+print(location)
+```
+#### Other Features
+There are also a few other useful features built into this library and the IPStack API.
+1. Bulk Location Lookup
+   The ipstack API also offers the ability to request data for multiple IPv4 or IPv6 addresses at the same time. This requires the PROFESSIONAL teir API key or higher and is limitted to 50 IPs at a time.
+   > See: [https://ipstack.com/documentation#bulk](https://ipstack.com/documentation#bulk)
+   ```python
+   locations = geo_lookup.get_location("github.com", "stackoverflow.com")
+   print(locations)
+   ```
+2. Requesting the hostname for an IP address.
+   By default, the ipstack API does not return information about the hostname the given IP address resolves to. In order to include the hostname use the following.
+   > See: [https://ipstack.com/documentation#hostname](https://ipstack.com/documentation#hostname)
+   ```python
+   location = geo_lookup.find_hostname().get_location("1.1.1.1")
+   print(location["hostname"])
+   ```
+   ```
+   one.one.one.one
+   ```
+3. Assessing Security
+   Customers subscribed to the Professional Plus Plan may access the ipstack API's Security Module, which can be used to assess risks and threats originating from certain IP addresses before any harm can be done to a website or web application.
+   > See: [https://ipstack.com/documentation#security](https://ipstack.com/documentation#security)
+   ```python
+   location = geo_lookup.assess_security().get_location("github.com")
+   ```
+4. Set the language for a response
+   The ipstack API is capable of delivering its result set in different languages. To request data in a language other than English (default) use following with one of the supported language codes.
+   > See: [https://ipstack.com/documentation#language](https://ipstack.com/documentation#language)
+   [Supported Langauges](https://ipstack.com/documentation#language)
+   ```python
+   location = geo_lookup.language("en").get_location("github.com")
+   ```
+5. Configuring your request
+   ```python
+   # Use HTTPS
+   # This requires IPStack Basic plan or higher.
+   location = geo_lookup.use_https().get_location("github.com")
+   # Configure the timeout for requests
+   location = geo_lookup.timeout(10).get_location("github.com")
+   ```
+### Development
+Before commiting anything, please create a pre-commit hook with the following content.
+This will ensure that the pycodestyle badge is properly updated.
+```bash
+#!/bin/bash
+python3 tests/style.py
+```
+
+%prep
+%autosetup -n ipstack-0.1.4
+
+%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-ipstack -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Mon May 29 2023 Python_Bot <Python_Bot@openeuler.org> - 0.1.4-1
+- Package Spec generated