automatic import of python-altdg

3 files changed, 562 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..22d2f0e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/altdg-1.0.5.tar.gz
diff --git a/python-altdg.spec b/python-altdg.spec
new file mode 100644
index 0000000..1036d9c
--- /dev/null
+++ b/python-altdg.spec
@@ -0,0 +1,560 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-altdg
+Version:	1.0.5
+Release:	1
+Summary:	Utility libraries from Alternative Data Group
+License:	MIT
+URL:		https://github.com/altdg/bulk_mapper
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/99/6f/b907c6bd3e1b1f9dc79b6d0957ee855610ae68f9f021dd9efa000403a594/altdg-1.0.5.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-requests
+Requires:	python3-chardet
+
+%description
+# AltDG API Python Tools
+Command-line tool with methods to consume the [AltDG API](https://developer.altdg.com) in bulk.
+
+© [Alternative Data Group](https://www.altdg.com/). All rights reserved.
+
+## Contents
+
+- [AltDG API Python Tools](#AltDG-api-python-tools)
+  - [Contents](#contents)
+  - [Requirements](#requirements)
+  - [Installation](#installation)
+  - [Authorization](#authorization)
+  - [Free tier key](#free-tier-key)
+  - [Usage](#usage)
+    - [Domain mapper](#domain-mapper)
+    - [Merchant mapper](#merchant-mapper)
+    - [Product mapper](#product-mapper)
+    - [Command arguments (options)](#command-arguments-options)
+  - [Development](#development)
+    - [Usage as library](#usage-as-library)
+  - [Support](#support)
+
+
+## Requirements
+
+Python 3.6+
+> See also requirements.txt
+
+
+## Installation
+
+Run the following commands in your shell:
+
+```sh
+# install as usual python package
+pip install altdg
+
+# ... or install "altdg" package directly from repo
+pip install git+https://github.com/altdg/bulk_mapper.git
+
+# ... or if you want to get samples for testing, clone the repo
+git clone https://github.com/altdg/bulk_mapper.git altdg
+pip install -e altdg
+```
+
+Now everything is ready to run the tool.
+
+## Authorization
+
+To use this tool you must have a valid app key to the [AltDG API](https://developer.altdg.com).
+Methods are available depending on you account type with AltDG.
+
+## Free tier key
+
+Use this key to try the API for free: **f816b9125492069f7f2e3b1cc60659f0**
+
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+## Usage
+
+A preferred way to run the tool is to load it as module with the `python` command.
+
+Run the tool with `--help` flag to display command's usage:
+
+```sh
+altdg --help
+```
+
+### Domain mapper
+
+Maps domain names from given text to structured company information.
+> More details in https://developer.altdg.com/docs#domain-mapper
+
+This will run all the domains in the provided text file (one per line expected):
+
+```sh
+altdg -e domain-mapper sample-domains.txt -k "f816b9125492069f7f2e3b1cc60659f0"
+```
+
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+A CSV output file will be created automatically with the same path as the input file but prepending the current date.
+
+[sample-domains.txt](sample-domains.txt) is a sample list of domains we included in our repo. This file is downloaded as part of this package, no need to re-create it.
+
+### Merchant mapper
+
+Maps strings from transactional purchase text (e.g. credit card transactions) to structured company information.
+> More details in https://developer.altdg.com/docs#merchant-mapper
+
+```sh
+altdg -e merchant-mapper sample-merchants.txt -k "f816b9125492069f7f2e3b1cc60659f0"
+```
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+A CSV output file will be created automatically with the same path as the input file but prepending the current date.
+
+[sample-merchants.txt](sample-merchants.txt) is a sample list of domains we included in our repo. This file is downloaded as part of this package, no need to re-create it.
+
+### Product mapper
+
+Maps strings from product related text (e.g. inventory) to structured company information.
+> More details in https://developer.altdg.com/docs#product-mapper
+
+```sh
+altdg -e product-mapper sample-products.txt -k "f816b9125492069f7f2e3b1cc60659f0"
+```
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+A CSV output file will be created automatically with the same path as the input file but prepending the current date.
+
+
+### Command arguments (options)
+
+Arguments:
+
+* `-e <endpoint>` `--endpoint` Type of mapper. Choices are "merchant-mapper", "domain-mapper" and "product-mapper".
+* `-k <key>` `--key` AltDG API application key.
+* `-o <filename>` `--out` Output file path. If not provided, the input file name is used with the ".csv" extension, prepended with the date and time.
+* `-F` `--force` When providing a specific out_file, some results may already exist in that file for an input.
+                 Use this option to force re-process results that are already in that output file, otherwise existing
+                 results won't be processed again. Previous results are NOT overwritten, a new CSV row is added.
+* `-n` `--num-threads` Number of requests to process in parallel. (See `--help` for max and default)
+* `-r` `--num-retires` Number of retries per request. (See `--help` for max and default)
+* `-t` `--timeout` API request timeout (in seconds). (See `--help` for max and default)
+* `-th <hint>` `--type-hint` Improves the accuracy by providing the industry name or any keyword hint relevant to the inputs. E.g. `-th "medical"`
+
+
+## Usage as library
+
+You may use `AltdgAPI` class from your python program:
+
+```python
+from altdg.api import AltdgAPI
+
+# initialize Mapper class with your key
+mapper = AltdgAPI('domain-mapper', api_key='f816b9125492069f7f2e3b1cc60659f0')
+
+# single query
+print(mapper.query('abc.com'))
+
+# single query with hint
+print(mapper.query('abc.com', hint='news'))
+
+# bulk query
+print(mapper.bulk_query(['yahoo.com', 'amazon.com']))
+
+# bulk query with same hint for all inputs
+print(mapper.bulk_query(['yahoo.com', 'amazon.com'], hint='company'))
+
+# bulk query with overwriting hint
+print(mapper.bulk_query([
+    ('purple mint', 'restaurant'),  # (input, hint) tuple
+    'amazon',  # just input with base hint
+], hint='company'))  # base hint
+```
+
+## Support
+
+Please email info@altdg.com if you need to contact us directly.
+
+
+
+
+%package -n python3-altdg
+Summary:	Utility libraries from Alternative Data Group
+Provides:	python-altdg
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-altdg
+# AltDG API Python Tools
+Command-line tool with methods to consume the [AltDG API](https://developer.altdg.com) in bulk.
+
+© [Alternative Data Group](https://www.altdg.com/). All rights reserved.
+
+## Contents
+
+- [AltDG API Python Tools](#AltDG-api-python-tools)
+  - [Contents](#contents)
+  - [Requirements](#requirements)
+  - [Installation](#installation)
+  - [Authorization](#authorization)
+  - [Free tier key](#free-tier-key)
+  - [Usage](#usage)
+    - [Domain mapper](#domain-mapper)
+    - [Merchant mapper](#merchant-mapper)
+    - [Product mapper](#product-mapper)
+    - [Command arguments (options)](#command-arguments-options)
+  - [Development](#development)
+    - [Usage as library](#usage-as-library)
+  - [Support](#support)
+
+
+## Requirements
+
+Python 3.6+
+> See also requirements.txt
+
+
+## Installation
+
+Run the following commands in your shell:
+
+```sh
+# install as usual python package
+pip install altdg
+
+# ... or install "altdg" package directly from repo
+pip install git+https://github.com/altdg/bulk_mapper.git
+
+# ... or if you want to get samples for testing, clone the repo
+git clone https://github.com/altdg/bulk_mapper.git altdg
+pip install -e altdg
+```
+
+Now everything is ready to run the tool.
+
+## Authorization
+
+To use this tool you must have a valid app key to the [AltDG API](https://developer.altdg.com).
+Methods are available depending on you account type with AltDG.
+
+## Free tier key
+
+Use this key to try the API for free: **f816b9125492069f7f2e3b1cc60659f0**
+
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+## Usage
+
+A preferred way to run the tool is to load it as module with the `python` command.
+
+Run the tool with `--help` flag to display command's usage:
+
+```sh
+altdg --help
+```
+
+### Domain mapper
+
+Maps domain names from given text to structured company information.
+> More details in https://developer.altdg.com/docs#domain-mapper
+
+This will run all the domains in the provided text file (one per line expected):
+
+```sh
+altdg -e domain-mapper sample-domains.txt -k "f816b9125492069f7f2e3b1cc60659f0"
+```
+
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+A CSV output file will be created automatically with the same path as the input file but prepending the current date.
+
+[sample-domains.txt](sample-domains.txt) is a sample list of domains we included in our repo. This file is downloaded as part of this package, no need to re-create it.
+
+### Merchant mapper
+
+Maps strings from transactional purchase text (e.g. credit card transactions) to structured company information.
+> More details in https://developer.altdg.com/docs#merchant-mapper
+
+```sh
+altdg -e merchant-mapper sample-merchants.txt -k "f816b9125492069f7f2e3b1cc60659f0"
+```
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+A CSV output file will be created automatically with the same path as the input file but prepending the current date.
+
+[sample-merchants.txt](sample-merchants.txt) is a sample list of domains we included in our repo. This file is downloaded as part of this package, no need to re-create it.
+
+### Product mapper
+
+Maps strings from product related text (e.g. inventory) to structured company information.
+> More details in https://developer.altdg.com/docs#product-mapper
+
+```sh
+altdg -e product-mapper sample-products.txt -k "f816b9125492069f7f2e3b1cc60659f0"
+```
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+A CSV output file will be created automatically with the same path as the input file but prepending the current date.
+
+
+### Command arguments (options)
+
+Arguments:
+
+* `-e <endpoint>` `--endpoint` Type of mapper. Choices are "merchant-mapper", "domain-mapper" and "product-mapper".
+* `-k <key>` `--key` AltDG API application key.
+* `-o <filename>` `--out` Output file path. If not provided, the input file name is used with the ".csv" extension, prepended with the date and time.
+* `-F` `--force` When providing a specific out_file, some results may already exist in that file for an input.
+                 Use this option to force re-process results that are already in that output file, otherwise existing
+                 results won't be processed again. Previous results are NOT overwritten, a new CSV row is added.
+* `-n` `--num-threads` Number of requests to process in parallel. (See `--help` for max and default)
+* `-r` `--num-retires` Number of retries per request. (See `--help` for max and default)
+* `-t` `--timeout` API request timeout (in seconds). (See `--help` for max and default)
+* `-th <hint>` `--type-hint` Improves the accuracy by providing the industry name or any keyword hint relevant to the inputs. E.g. `-th "medical"`
+
+
+## Usage as library
+
+You may use `AltdgAPI` class from your python program:
+
+```python
+from altdg.api import AltdgAPI
+
+# initialize Mapper class with your key
+mapper = AltdgAPI('domain-mapper', api_key='f816b9125492069f7f2e3b1cc60659f0')
+
+# single query
+print(mapper.query('abc.com'))
+
+# single query with hint
+print(mapper.query('abc.com', hint='news'))
+
+# bulk query
+print(mapper.bulk_query(['yahoo.com', 'amazon.com']))
+
+# bulk query with same hint for all inputs
+print(mapper.bulk_query(['yahoo.com', 'amazon.com'], hint='company'))
+
+# bulk query with overwriting hint
+print(mapper.bulk_query([
+    ('purple mint', 'restaurant'),  # (input, hint) tuple
+    'amazon',  # just input with base hint
+], hint='company'))  # base hint
+```
+
+## Support
+
+Please email info@altdg.com if you need to contact us directly.
+
+
+
+
+%package help
+Summary:	Development documents and examples for altdg
+Provides:	python3-altdg-doc
+%description help
+# AltDG API Python Tools
+Command-line tool with methods to consume the [AltDG API](https://developer.altdg.com) in bulk.
+
+© [Alternative Data Group](https://www.altdg.com/). All rights reserved.
+
+## Contents
+
+- [AltDG API Python Tools](#AltDG-api-python-tools)
+  - [Contents](#contents)
+  - [Requirements](#requirements)
+  - [Installation](#installation)
+  - [Authorization](#authorization)
+  - [Free tier key](#free-tier-key)
+  - [Usage](#usage)
+    - [Domain mapper](#domain-mapper)
+    - [Merchant mapper](#merchant-mapper)
+    - [Product mapper](#product-mapper)
+    - [Command arguments (options)](#command-arguments-options)
+  - [Development](#development)
+    - [Usage as library](#usage-as-library)
+  - [Support](#support)
+
+
+## Requirements
+
+Python 3.6+
+> See also requirements.txt
+
+
+## Installation
+
+Run the following commands in your shell:
+
+```sh
+# install as usual python package
+pip install altdg
+
+# ... or install "altdg" package directly from repo
+pip install git+https://github.com/altdg/bulk_mapper.git
+
+# ... or if you want to get samples for testing, clone the repo
+git clone https://github.com/altdg/bulk_mapper.git altdg
+pip install -e altdg
+```
+
+Now everything is ready to run the tool.
+
+## Authorization
+
+To use this tool you must have a valid app key to the [AltDG API](https://developer.altdg.com).
+Methods are available depending on you account type with AltDG.
+
+## Free tier key
+
+Use this key to try the API for free: **f816b9125492069f7f2e3b1cc60659f0**
+
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+## Usage
+
+A preferred way to run the tool is to load it as module with the `python` command.
+
+Run the tool with `--help` flag to display command's usage:
+
+```sh
+altdg --help
+```
+
+### Domain mapper
+
+Maps domain names from given text to structured company information.
+> More details in https://developer.altdg.com/docs#domain-mapper
+
+This will run all the domains in the provided text file (one per line expected):
+
+```sh
+altdg -e domain-mapper sample-domains.txt -k "f816b9125492069f7f2e3b1cc60659f0"
+```
+
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+A CSV output file will be created automatically with the same path as the input file but prepending the current date.
+
+[sample-domains.txt](sample-domains.txt) is a sample list of domains we included in our repo. This file is downloaded as part of this package, no need to re-create it.
+
+### Merchant mapper
+
+Maps strings from transactional purchase text (e.g. credit card transactions) to structured company information.
+> More details in https://developer.altdg.com/docs#merchant-mapper
+
+```sh
+altdg -e merchant-mapper sample-merchants.txt -k "f816b9125492069f7f2e3b1cc60659f0"
+```
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+A CSV output file will be created automatically with the same path as the input file but prepending the current date.
+
+[sample-merchants.txt](sample-merchants.txt) is a sample list of domains we included in our repo. This file is downloaded as part of this package, no need to re-create it.
+
+### Product mapper
+
+Maps strings from product related text (e.g. inventory) to structured company information.
+> More details in https://developer.altdg.com/docs#product-mapper
+
+```sh
+altdg -e product-mapper sample-products.txt -k "f816b9125492069f7f2e3b1cc60659f0"
+```
+Sign up at https://developer.altdg.com/ to get a non-trial key.
+
+A CSV output file will be created automatically with the same path as the input file but prepending the current date.
+
+
+### Command arguments (options)
+
+Arguments:
+
+* `-e <endpoint>` `--endpoint` Type of mapper. Choices are "merchant-mapper", "domain-mapper" and "product-mapper".
+* `-k <key>` `--key` AltDG API application key.
+* `-o <filename>` `--out` Output file path. If not provided, the input file name is used with the ".csv" extension, prepended with the date and time.
+* `-F` `--force` When providing a specific out_file, some results may already exist in that file for an input.
+                 Use this option to force re-process results that are already in that output file, otherwise existing
+                 results won't be processed again. Previous results are NOT overwritten, a new CSV row is added.
+* `-n` `--num-threads` Number of requests to process in parallel. (See `--help` for max and default)
+* `-r` `--num-retires` Number of retries per request. (See `--help` for max and default)
+* `-t` `--timeout` API request timeout (in seconds). (See `--help` for max and default)
+* `-th <hint>` `--type-hint` Improves the accuracy by providing the industry name or any keyword hint relevant to the inputs. E.g. `-th "medical"`
+
+
+## Usage as library
+
+You may use `AltdgAPI` class from your python program:
+
+```python
+from altdg.api import AltdgAPI
+
+# initialize Mapper class with your key
+mapper = AltdgAPI('domain-mapper', api_key='f816b9125492069f7f2e3b1cc60659f0')
+
+# single query
+print(mapper.query('abc.com'))
+
+# single query with hint
+print(mapper.query('abc.com', hint='news'))
+
+# bulk query
+print(mapper.bulk_query(['yahoo.com', 'amazon.com']))
+
+# bulk query with same hint for all inputs
+print(mapper.bulk_query(['yahoo.com', 'amazon.com'], hint='company'))
+
+# bulk query with overwriting hint
+print(mapper.bulk_query([
+    ('purple mint', 'restaurant'),  # (input, hint) tuple
+    'amazon',  # just input with base hint
+], hint='company'))  # base hint
+```
+
+## Support
+
+Please email info@altdg.com if you need to contact us directly.
+
+
+
+
+%prep
+%autosetup -n altdg-1.0.5
+
+%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-altdg -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Wed Apr 12 2023 Python_Bot <Python_Bot@openeuler.org> - 1.0.5-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..bba5e24
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+413e764668127842732ca7657749f9cc  altdg-1.0.5.tar.gz