diff options
Diffstat (limited to 'python-datacommons.spec')
| -rw-r--r-- | python-datacommons.spec | 451 |
1 files changed, 451 insertions, 0 deletions
diff --git a/python-datacommons.spec b/python-datacommons.spec new file mode 100644 index 0000000..4b43ba5 --- /dev/null +++ b/python-datacommons.spec @@ -0,0 +1,451 @@ +%global _empty_manifest_terminate_build 0 +Name: python-datacommons +Version: 1.4.3 +Release: 1 +Summary: A library to access Data Commons Python API. +License: Apache 2.0 +URL: https://github.com/datacommonsorg/api-python +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/25/6d/4fc9b08a784a542c3a7b5ecbc7f856ba2fdbe86ea236ffefc11dd976ecda/datacommons-1.4.3.tar.gz +BuildArch: noarch + +Requires: python3-six + +%description +# Data Commons Python API + +This is a Python library for accessing data in the Data Commons Graph. + +> See also: [Data Commons Pandas API](datacommons_pandas/README.md). + + +To get started, install this package from pip. + + pip install datacommons + +Once the package is installed, import `datacommons`. + + import datacommons as dc + +If you would like to provide an API key, follow the steps in +[Setting up access to the Data Commons API](https://docs.datacommons.org/api/setup.html), +add the following line to your code: + + dc.set_api_key('YOUR-API-KEY') + +Data Commons *does not charge* users, but uses the API key for +understanding API usage. + +For more detail on getting started with the API, please visit our +[API Overview](http://docs.datacommons.org/api/). + +When you are ready to use the API, you can refer to `datacommons/examples` for +examples on how to use this package to perform various tasks. More tutorials and +documentation can be found on our [tutorials page](https://datacommons.org/colab)! + +## About Data Commons + +[Data Commons](https://datacommons.org/) is an open knowledge repository that +provides a unified view across multiple public data sets and statistics. You can +view what [datasets](https://datacommons.org/datasets) are currently ingested +and browse the graph using our [browser](https://browser.datacommons.org/). + +## License + +Apache 2.0 + +## Development + +The Python API currently supports `python>=2.7`. + +To test, run: + +``` +$ ./run_tests_local.sh +``` + +To debug the continuous integration tests, run: + +``` +$ cloud-build-local --config=cloudbuild.yaml --dryrun=false . +``` + +Both commands will run the same set of tests. + +To run the examples: + +``` +$ python -m datacommons.examples.XXX +``` + +where XXX is the module you want to run. + +## Release + +Note: Always release `datacommons_pandas` when `datacommons` is released. + +**If this is your first time releasing to PyPI**, please review the PyPI guide +starting from the +[setup section](https://packaging.python.org/tutorials/packaging-projects/#creating-setup-py). + +### Release to Test PyPI + +1. In [setup_datacommons.py](setup_datacommons.py) and + [setup_datacommons_pandas.py](setup_datacommons_pandas.py): + - Append "-USERNAME" to the package "NAME". For example, + `NAME = 'foo_package-janedoe123'`. + - Increment the "VERSION" codes to something that has not been used in your + test project. This will not affect the production PyPI versioning. +1. Build the dists: + ```bash + rm dist/* + python3 -m pip install --user --upgrade setuptools wheel + python3 setup_datacommons.py sdist bdist_wheel + python3 setup_datacommons_pandas.py sdist bdist_wheel + ``` +1. Release the dists to TestPyPI: + ```bash + python3 -m pip install --user --upgrade twine + python3 -m twine upload --repository testpypi dist/* + ``` + +### Release to Production PyPI +1. In [setup_datacommons.py](setup_datacommons.py) and + [setup_datacommons_pandas.py](setup_datacommons_pandas.py): + - Revert the package name to `datacommons` and `datacommons_pandas` + - Update and double check "VERSION" +1. Update [CHANGELOG.md](CHANGELOG.md) and + [datacommons_pandas/CHANGELOG.md](datacommons_pandas/CHANGELOG.md) +1. Build the dists: + ```bash + rm dist/* + python3 -m pip install --user --upgrade setuptools wheel + python3 setup_datacommons.py sdist bdist_wheel + python3 setup_datacommons_pandas.py sdist bdist_wheel + ``` +1. Release the dists to PyPI: + ```bash + python3 -m pip install --user --upgrade twine + twine upload dist/* + ``` + +## Support + +For general questions or issues about the API, please open an issue on our +[issues](https://github.com/google/datacommons/issues) page. For all other +questions, please send an email to `support@datacommons.org`. + +**Note** - This is not an officially supported Google product. + + + + +%package -n python3-datacommons +Summary: A library to access Data Commons Python API. +Provides: python-datacommons +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-datacommons +# Data Commons Python API + +This is a Python library for accessing data in the Data Commons Graph. + +> See also: [Data Commons Pandas API](datacommons_pandas/README.md). + + +To get started, install this package from pip. + + pip install datacommons + +Once the package is installed, import `datacommons`. + + import datacommons as dc + +If you would like to provide an API key, follow the steps in +[Setting up access to the Data Commons API](https://docs.datacommons.org/api/setup.html), +add the following line to your code: + + dc.set_api_key('YOUR-API-KEY') + +Data Commons *does not charge* users, but uses the API key for +understanding API usage. + +For more detail on getting started with the API, please visit our +[API Overview](http://docs.datacommons.org/api/). + +When you are ready to use the API, you can refer to `datacommons/examples` for +examples on how to use this package to perform various tasks. More tutorials and +documentation can be found on our [tutorials page](https://datacommons.org/colab)! + +## About Data Commons + +[Data Commons](https://datacommons.org/) is an open knowledge repository that +provides a unified view across multiple public data sets and statistics. You can +view what [datasets](https://datacommons.org/datasets) are currently ingested +and browse the graph using our [browser](https://browser.datacommons.org/). + +## License + +Apache 2.0 + +## Development + +The Python API currently supports `python>=2.7`. + +To test, run: + +``` +$ ./run_tests_local.sh +``` + +To debug the continuous integration tests, run: + +``` +$ cloud-build-local --config=cloudbuild.yaml --dryrun=false . +``` + +Both commands will run the same set of tests. + +To run the examples: + +``` +$ python -m datacommons.examples.XXX +``` + +where XXX is the module you want to run. + +## Release + +Note: Always release `datacommons_pandas` when `datacommons` is released. + +**If this is your first time releasing to PyPI**, please review the PyPI guide +starting from the +[setup section](https://packaging.python.org/tutorials/packaging-projects/#creating-setup-py). + +### Release to Test PyPI + +1. In [setup_datacommons.py](setup_datacommons.py) and + [setup_datacommons_pandas.py](setup_datacommons_pandas.py): + - Append "-USERNAME" to the package "NAME". For example, + `NAME = 'foo_package-janedoe123'`. + - Increment the "VERSION" codes to something that has not been used in your + test project. This will not affect the production PyPI versioning. +1. Build the dists: + ```bash + rm dist/* + python3 -m pip install --user --upgrade setuptools wheel + python3 setup_datacommons.py sdist bdist_wheel + python3 setup_datacommons_pandas.py sdist bdist_wheel + ``` +1. Release the dists to TestPyPI: + ```bash + python3 -m pip install --user --upgrade twine + python3 -m twine upload --repository testpypi dist/* + ``` + +### Release to Production PyPI +1. In [setup_datacommons.py](setup_datacommons.py) and + [setup_datacommons_pandas.py](setup_datacommons_pandas.py): + - Revert the package name to `datacommons` and `datacommons_pandas` + - Update and double check "VERSION" +1. Update [CHANGELOG.md](CHANGELOG.md) and + [datacommons_pandas/CHANGELOG.md](datacommons_pandas/CHANGELOG.md) +1. Build the dists: + ```bash + rm dist/* + python3 -m pip install --user --upgrade setuptools wheel + python3 setup_datacommons.py sdist bdist_wheel + python3 setup_datacommons_pandas.py sdist bdist_wheel + ``` +1. Release the dists to PyPI: + ```bash + python3 -m pip install --user --upgrade twine + twine upload dist/* + ``` + +## Support + +For general questions or issues about the API, please open an issue on our +[issues](https://github.com/google/datacommons/issues) page. For all other +questions, please send an email to `support@datacommons.org`. + +**Note** - This is not an officially supported Google product. + + + + +%package help +Summary: Development documents and examples for datacommons +Provides: python3-datacommons-doc +%description help +# Data Commons Python API + +This is a Python library for accessing data in the Data Commons Graph. + +> See also: [Data Commons Pandas API](datacommons_pandas/README.md). + + +To get started, install this package from pip. + + pip install datacommons + +Once the package is installed, import `datacommons`. + + import datacommons as dc + +If you would like to provide an API key, follow the steps in +[Setting up access to the Data Commons API](https://docs.datacommons.org/api/setup.html), +add the following line to your code: + + dc.set_api_key('YOUR-API-KEY') + +Data Commons *does not charge* users, but uses the API key for +understanding API usage. + +For more detail on getting started with the API, please visit our +[API Overview](http://docs.datacommons.org/api/). + +When you are ready to use the API, you can refer to `datacommons/examples` for +examples on how to use this package to perform various tasks. More tutorials and +documentation can be found on our [tutorials page](https://datacommons.org/colab)! + +## About Data Commons + +[Data Commons](https://datacommons.org/) is an open knowledge repository that +provides a unified view across multiple public data sets and statistics. You can +view what [datasets](https://datacommons.org/datasets) are currently ingested +and browse the graph using our [browser](https://browser.datacommons.org/). + +## License + +Apache 2.0 + +## Development + +The Python API currently supports `python>=2.7`. + +To test, run: + +``` +$ ./run_tests_local.sh +``` + +To debug the continuous integration tests, run: + +``` +$ cloud-build-local --config=cloudbuild.yaml --dryrun=false . +``` + +Both commands will run the same set of tests. + +To run the examples: + +``` +$ python -m datacommons.examples.XXX +``` + +where XXX is the module you want to run. + +## Release + +Note: Always release `datacommons_pandas` when `datacommons` is released. + +**If this is your first time releasing to PyPI**, please review the PyPI guide +starting from the +[setup section](https://packaging.python.org/tutorials/packaging-projects/#creating-setup-py). + +### Release to Test PyPI + +1. In [setup_datacommons.py](setup_datacommons.py) and + [setup_datacommons_pandas.py](setup_datacommons_pandas.py): + - Append "-USERNAME" to the package "NAME". For example, + `NAME = 'foo_package-janedoe123'`. + - Increment the "VERSION" codes to something that has not been used in your + test project. This will not affect the production PyPI versioning. +1. Build the dists: + ```bash + rm dist/* + python3 -m pip install --user --upgrade setuptools wheel + python3 setup_datacommons.py sdist bdist_wheel + python3 setup_datacommons_pandas.py sdist bdist_wheel + ``` +1. Release the dists to TestPyPI: + ```bash + python3 -m pip install --user --upgrade twine + python3 -m twine upload --repository testpypi dist/* + ``` + +### Release to Production PyPI +1. In [setup_datacommons.py](setup_datacommons.py) and + [setup_datacommons_pandas.py](setup_datacommons_pandas.py): + - Revert the package name to `datacommons` and `datacommons_pandas` + - Update and double check "VERSION" +1. Update [CHANGELOG.md](CHANGELOG.md) and + [datacommons_pandas/CHANGELOG.md](datacommons_pandas/CHANGELOG.md) +1. Build the dists: + ```bash + rm dist/* + python3 -m pip install --user --upgrade setuptools wheel + python3 setup_datacommons.py sdist bdist_wheel + python3 setup_datacommons_pandas.py sdist bdist_wheel + ``` +1. Release the dists to PyPI: + ```bash + python3 -m pip install --user --upgrade twine + twine upload dist/* + ``` + +## Support + +For general questions or issues about the API, please open an issue on our +[issues](https://github.com/google/datacommons/issues) page. For all other +questions, please send an email to `support@datacommons.org`. + +**Note** - This is not an officially supported Google product. + + + + +%prep +%autosetup -n datacommons-1.4.3 + +%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-datacommons -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Fri May 05 2023 Python_Bot <Python_Bot@openeuler.org> - 1.4.3-1 +- Package Spec generated |