datacommons-pandas 0.0.2

A library to create pandas objects using the Data Commons Python API.

Data Commons Pandas API

This is a Python library for creating pandas objects with data in the Data Commons Graph.

To get started, install this package from pip.

pip install datacommons_pandas

Once the package is installed, import datacommons_pandas.

import datacommons_pandas as dcpd

For more detail on getting started with the API, please visit our API Overview.

When you are ready to use the API, you can refer to datacommons_pandas/examples for examples on how to use this package to perform various tasks. More tutorials and documentation can be found on our tutorials page!

About Data Commons

Data Commons is an open knowledge repository that provides a unified view across multiple public data sets and statistics. You can view what datasets are currently ingested and browse the graph using our browser.

License

Apache 2.0

Development

Please follow the Development instructions.

Release to PyPI

If this is your first time releasing to PyPI, please review the PyPI guide starting from the setup section.

Release to Test PyPI

1. Append "-USERNAME" to the package "NAME". For example, NAME = 'foo_package-janedoe123'.
2. Increment the "VERSION" code to something that has not been used in your test project. This will not affect the production PyPI versioning.
3. Build the dist

python3 -m pip install --user --upgrade setuptools wheel
python3 ../setup_datacommons_pandas.py sdist bdist_wheel

1. Release the dist to TestPyPI.

python3 -m pip install --user --upgrade twine
python3 -m twine upload --repository testpypi ../dist/*

Release to Production PyPI

1. Revert the package name to datacommons_pandas
2. Update and double check "VERSION" in setup_datacommons.py
3. Update CHANGELOG.md for a new version
4. Clear the dist folder: rm ../dist/*
5. Build the dist

python3 -m pip install --user --upgrade setuptools wheel
python3 ../setup_datacommons_pandas.py sdist bdist_wheel

1. Release the dist to PyPI.

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 page. For all other questions, please send an email to [e-mail].

Note - This is not an officially supported Google product.