diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-groclient.spec | 224 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 226 insertions, 0 deletions
@@ -0,0 +1 @@ +/groclient-1.267.tar.gz diff --git a/python-groclient.spec b/python-groclient.spec new file mode 100644 index 0000000..704c1dc --- /dev/null +++ b/python-groclient.spec @@ -0,0 +1,224 @@ +%global _empty_manifest_terminate_build 0 +Name: python-groclient +Version: 1.267 +Release: 1 +Summary: Python client library for accessing Gro Intelligence's agricultural data platform +License: MIT +URL: https://gro-intelligence.com/platform/api +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/38/4c/605ecfe5416206a84222bfcb12026b4ed47968e5cc0fee29e23a106f9616/groclient-1.267.tar.gz +BuildArch: noarch + +Requires: python3-numpy +Requires: python3-requests +Requires: python3-pandas +Requires: python3-tornado +Requires: python3-unicodecsv + +%description +<p align="center"><img width="20%" src="https://gro-images.s3.amazonaws.com/Gro-Logo-Emble-Blue-LARGE.svg"></p> +<h1 align="center">Gro API Client</h1> + + +[](https://app.circleci.com/pipelines/github/gro-intelligence/api-client?branch=development) + + +The Gro Intelligence Python API client library provides access to Gro's +[agricultural data platform](https://www.gro-intelligence.com/products/gro-api). + +Please see our developer documentation at +<https://developers.gro-intelligence.com/> for install instructions, API +reference documentation, and guides. + +The short version: +- [Install](https://developers.gro-intelligence.com/installation.html) the + library: `pip install groclient` or `conda install -c conda-forge groclient` +- Get an [API authentication token](https://developers.gro-intelligence.com/authentication.html). +- Check out the examples below. + +## Examples + +Navigate to [api/client/samples/](api/client/samples/) and try executing the provided examples. + +1. Start with [quick_start.py](api/client/samples/quick_start.py). This script creates an authenticated `GroClient` object and uses the `get_data_series()` and `get_data_points()` methods to find Area Harvested series for Ukrainian Wheat from a variety of different sources and output the time series points to a CSV file. You will likely want to revisit this script as a starting point for building your own scripts. + + Note that the script assumes you have your authentication token set to a `GROAPI_TOKEN` environment variable (see [Saving your token as an environment variable](https://developers.gro-intelligence.com/authentication.html#saving-your-token-as-an-environment-variable)). If you don't wish to use environment variables, you can modify the sample script to set [`ACCESS_TOKEN`](https://github.com/gro-intelligence/api-client/blob/0d1aa2bccaa25a033e39712c62363fd89e69eea1/api/client/samples/quick_start.py#L7) in some other way. + + ```sh + python quick_start.py + ``` + + If the API client is installed and your authentication token is set, a csv file called `gro_client_output.csv` should be created in the directory where the script was run. + +2. Try out [soybeans.py](api/client/samples/crop_models/soybeans.py) to see the `CropModel` class and its `compute_crop_weighted_series()` method in action. In this example, NDVI ([Normalized difference vegetation index](https://app.gro-intelligence.com/dictionary/items/321)) for provinces in Brazil is weighted against each province's historical soybean production to put the latest NDVI values into context. This information is put into a pandas dataframe, the description of which is printed to the console. + + ```sh + python crop_models/soybeans.py + ``` + +3. See [brazil_soybeans.ipynb](https://github.com/gro-intelligence/api-client/blob/development/api/client/samples/crop_models/brazil_soybeans.ipynb) for a longer, more detailed demonstration of many of the API's capabilities in the form of a Jupyter notebook. + +4. You can also use the included `gro_client` tool as a quick way to request a single data series right on the command line. Try the following: + + ```sh + gro_client --metric="Production Quantity mass" --item="Corn" --region="United States" --user_email="email@example.com" + ``` + + The `gro_client` command line interface does a keyword search for the inputs and finds a random matching data series. It displays the data series it picked and the data points to the console. This tool is useful for simple queries, but anything more complex should be done using the provided Python packages. + + +%package -n python3-groclient +Summary: Python client library for accessing Gro Intelligence's agricultural data platform +Provides: python-groclient +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-groclient +<p align="center"><img width="20%" src="https://gro-images.s3.amazonaws.com/Gro-Logo-Emble-Blue-LARGE.svg"></p> +<h1 align="center">Gro API Client</h1> + + +[](https://app.circleci.com/pipelines/github/gro-intelligence/api-client?branch=development) + + +The Gro Intelligence Python API client library provides access to Gro's +[agricultural data platform](https://www.gro-intelligence.com/products/gro-api). + +Please see our developer documentation at +<https://developers.gro-intelligence.com/> for install instructions, API +reference documentation, and guides. + +The short version: +- [Install](https://developers.gro-intelligence.com/installation.html) the + library: `pip install groclient` or `conda install -c conda-forge groclient` +- Get an [API authentication token](https://developers.gro-intelligence.com/authentication.html). +- Check out the examples below. + +## Examples + +Navigate to [api/client/samples/](api/client/samples/) and try executing the provided examples. + +1. Start with [quick_start.py](api/client/samples/quick_start.py). This script creates an authenticated `GroClient` object and uses the `get_data_series()` and `get_data_points()` methods to find Area Harvested series for Ukrainian Wheat from a variety of different sources and output the time series points to a CSV file. You will likely want to revisit this script as a starting point for building your own scripts. + + Note that the script assumes you have your authentication token set to a `GROAPI_TOKEN` environment variable (see [Saving your token as an environment variable](https://developers.gro-intelligence.com/authentication.html#saving-your-token-as-an-environment-variable)). If you don't wish to use environment variables, you can modify the sample script to set [`ACCESS_TOKEN`](https://github.com/gro-intelligence/api-client/blob/0d1aa2bccaa25a033e39712c62363fd89e69eea1/api/client/samples/quick_start.py#L7) in some other way. + + ```sh + python quick_start.py + ``` + + If the API client is installed and your authentication token is set, a csv file called `gro_client_output.csv` should be created in the directory where the script was run. + +2. Try out [soybeans.py](api/client/samples/crop_models/soybeans.py) to see the `CropModel` class and its `compute_crop_weighted_series()` method in action. In this example, NDVI ([Normalized difference vegetation index](https://app.gro-intelligence.com/dictionary/items/321)) for provinces in Brazil is weighted against each province's historical soybean production to put the latest NDVI values into context. This information is put into a pandas dataframe, the description of which is printed to the console. + + ```sh + python crop_models/soybeans.py + ``` + +3. See [brazil_soybeans.ipynb](https://github.com/gro-intelligence/api-client/blob/development/api/client/samples/crop_models/brazil_soybeans.ipynb) for a longer, more detailed demonstration of many of the API's capabilities in the form of a Jupyter notebook. + +4. You can also use the included `gro_client` tool as a quick way to request a single data series right on the command line. Try the following: + + ```sh + gro_client --metric="Production Quantity mass" --item="Corn" --region="United States" --user_email="email@example.com" + ``` + + The `gro_client` command line interface does a keyword search for the inputs and finds a random matching data series. It displays the data series it picked and the data points to the console. This tool is useful for simple queries, but anything more complex should be done using the provided Python packages. + + +%package help +Summary: Development documents and examples for groclient +Provides: python3-groclient-doc +%description help +<p align="center"><img width="20%" src="https://gro-images.s3.amazonaws.com/Gro-Logo-Emble-Blue-LARGE.svg"></p> +<h1 align="center">Gro API Client</h1> + + +[](https://app.circleci.com/pipelines/github/gro-intelligence/api-client?branch=development) + + +The Gro Intelligence Python API client library provides access to Gro's +[agricultural data platform](https://www.gro-intelligence.com/products/gro-api). + +Please see our developer documentation at +<https://developers.gro-intelligence.com/> for install instructions, API +reference documentation, and guides. + +The short version: +- [Install](https://developers.gro-intelligence.com/installation.html) the + library: `pip install groclient` or `conda install -c conda-forge groclient` +- Get an [API authentication token](https://developers.gro-intelligence.com/authentication.html). +- Check out the examples below. + +## Examples + +Navigate to [api/client/samples/](api/client/samples/) and try executing the provided examples. + +1. Start with [quick_start.py](api/client/samples/quick_start.py). This script creates an authenticated `GroClient` object and uses the `get_data_series()` and `get_data_points()` methods to find Area Harvested series for Ukrainian Wheat from a variety of different sources and output the time series points to a CSV file. You will likely want to revisit this script as a starting point for building your own scripts. + + Note that the script assumes you have your authentication token set to a `GROAPI_TOKEN` environment variable (see [Saving your token as an environment variable](https://developers.gro-intelligence.com/authentication.html#saving-your-token-as-an-environment-variable)). If you don't wish to use environment variables, you can modify the sample script to set [`ACCESS_TOKEN`](https://github.com/gro-intelligence/api-client/blob/0d1aa2bccaa25a033e39712c62363fd89e69eea1/api/client/samples/quick_start.py#L7) in some other way. + + ```sh + python quick_start.py + ``` + + If the API client is installed and your authentication token is set, a csv file called `gro_client_output.csv` should be created in the directory where the script was run. + +2. Try out [soybeans.py](api/client/samples/crop_models/soybeans.py) to see the `CropModel` class and its `compute_crop_weighted_series()` method in action. In this example, NDVI ([Normalized difference vegetation index](https://app.gro-intelligence.com/dictionary/items/321)) for provinces in Brazil is weighted against each province's historical soybean production to put the latest NDVI values into context. This information is put into a pandas dataframe, the description of which is printed to the console. + + ```sh + python crop_models/soybeans.py + ``` + +3. See [brazil_soybeans.ipynb](https://github.com/gro-intelligence/api-client/blob/development/api/client/samples/crop_models/brazil_soybeans.ipynb) for a longer, more detailed demonstration of many of the API's capabilities in the form of a Jupyter notebook. + +4. You can also use the included `gro_client` tool as a quick way to request a single data series right on the command line. Try the following: + + ```sh + gro_client --metric="Production Quantity mass" --item="Corn" --region="United States" --user_email="email@example.com" + ``` + + The `gro_client` command line interface does a keyword search for the inputs and finds a random matching data series. It displays the data series it picked and the data points to the console. This tool is useful for simple queries, but anything more complex should be done using the provided Python packages. + + +%prep +%autosetup -n groclient-1.267 + +%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-groclient -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Mon May 15 2023 Python_Bot <Python_Bot@openeuler.org> - 1.267-1 +- Package Spec generated @@ -0,0 +1 @@ +1421d0eeed14743c7fa325c07ef59c74 groclient-1.267.tar.gz |