%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` Type of mapper. Choices are "merchant-mapper", "domain-mapper" and "product-mapper". * `-k ` `--key` AltDG API application key. * `-o ` `--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 ` `--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` Type of mapper. Choices are "merchant-mapper", "domain-mapper" and "product-mapper". * `-k ` `--key` AltDG API application key. * `-o ` `--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 ` `--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` Type of mapper. Choices are "merchant-mapper", "domain-mapper" and "product-mapper". * `-k ` `--key` AltDG API application key. * `-o ` `--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 ` `--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 - 1.0.5-1 - Package Spec generated