path: root/python-datacommons.spec

%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