[![PyPI](https://img.shields.io/pypi/v/pandas-datapackage-reader.svg)](https://pypi.python.org/pypi/pandas-datapackage-reader/)
[![CI](https://img.shields.io/github/workflow/status/rgieseke/pandas-datapackage-reader/CI?label=actions&logo=github&logoColor=white)](https://github.com/rgieseke/pandas-datapackage-reader/actions)
# pandas-datapackage-reader
Easy loading of tabular data from [Data Packages](http://frictionlessdata.io/data-packages/) into Pandas DataFrames.
## Installation
pip install pandas-datapackage-reader
## Usage
```python
from pandas_datapackage_reader import read_datapackage
# From GitHub repository
country_codes = read_datapackage("https://github.com/datasets/country-codes")
# From local directory
country_codes = read_datapackage("country-codes")
# Data Package with GeoJSON
geo_countries = read_datapackage("https://github.com/datasets/geo-countries")
```
Resource metadata from the Data Package is returned as a dictionary in the
`_metadata` attribute.
```python
country_codes._metadata
```
contains
```
{'format': 'csv',
'name': 'country-codes',
'path': 'data/country-codes.csv',
'schema': {'fields': [{'description': 'Country or Area official Arabic short name from UN Statistics Divsion',
'name': 'official_name_ar',
'title': 'official name Arabic',
'type': 'string'},
{'description': 'Country or Area official Chinese short name from UN Statistics Divsion',
'name': 'official_name_cn',
'title': 'official name Chinese',
'type': 'string'},
# ...
```
## License
BSD-2-Clause, see [LICENSE](LICENSE)
Raw data
{
"_id": null,
"home_page": "https://github.com/rgieseke/pandas-datapackage-reader",
"name": "pandas-datapackage-reader",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "data-package",
"author": "Robert Gieseke",
"author_email": "robert.gieseke@pik-potsdam.de",
"download_url": "https://files.pythonhosted.org/packages/84/f3/0437587d461e64090dc1244c1b9c318353725249d292e9636ea5e1e9ca61/pandas-datapackage-reader-0.18.0.tar.gz",
"platform": "any",
"description": "[![PyPI](https://img.shields.io/pypi/v/pandas-datapackage-reader.svg)](https://pypi.python.org/pypi/pandas-datapackage-reader/)\n[![CI](https://img.shields.io/github/workflow/status/rgieseke/pandas-datapackage-reader/CI?label=actions&logo=github&logoColor=white)](https://github.com/rgieseke/pandas-datapackage-reader/actions)\n\n# pandas-datapackage-reader\n\nEasy loading of tabular data from [Data Packages](http://frictionlessdata.io/data-packages/) into Pandas DataFrames.\n\n## Installation\n\n pip install pandas-datapackage-reader\n\n## Usage\n\n```python\nfrom pandas_datapackage_reader import read_datapackage\n\n# From GitHub repository\ncountry_codes = read_datapackage(\"https://github.com/datasets/country-codes\")\n\n# From local directory\ncountry_codes = read_datapackage(\"country-codes\")\n\n# Data Package with GeoJSON\ngeo_countries = read_datapackage(\"https://github.com/datasets/geo-countries\")\n```\n\nResource metadata from the Data Package is returned as a dictionary in the\n`_metadata` attribute.\n\n```python\ncountry_codes._metadata\n```\n\ncontains\n\n```\n{'format': 'csv',\n 'name': 'country-codes',\n 'path': 'data/country-codes.csv',\n 'schema': {'fields': [{'description': 'Country or Area official Arabic short name from UN Statistics Divsion',\n 'name': 'official_name_ar',\n 'title': 'official name Arabic',\n 'type': 'string'},\n {'description': 'Country or Area official Chinese short name from UN Statistics Divsion',\n 'name': 'official_name_cn',\n 'title': 'official name Chinese',\n 'type': 'string'},\n# ...\n```\n\n## License\n\nBSD-2-Clause, see [LICENSE](LICENSE)\n\n\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Pandas Data Package Reader",
"version": "0.18.0",
"project_urls": {
"Homepage": "https://github.com/rgieseke/pandas-datapackage-reader"
},
"split_keywords": [
"data-package"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b8decfe7ef4af7badf889f95026634abd0b4c858dca61a6ecd9f7c281b55edb1",
"md5": "07bab17af1d62687f9bd7d0992558eab",
"sha256": "a4660b06f533ccc35eb2f9f7cefe52b9abb7da82f7e66ad5dc52ae1c85d13b1f"
},
"downloads": -1,
"filename": "pandas_datapackage_reader-0.18.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "07bab17af1d62687f9bd7d0992558eab",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 5539,
"upload_time": "2021-03-17T21:10:24",
"upload_time_iso_8601": "2021-03-17T21:10:24.816167Z",
"url": "https://files.pythonhosted.org/packages/b8/de/cfe7ef4af7badf889f95026634abd0b4c858dca61a6ecd9f7c281b55edb1/pandas_datapackage_reader-0.18.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "84f30437587d461e64090dc1244c1b9c318353725249d292e9636ea5e1e9ca61",
"md5": "465c5154092ea4e07c3dbf86a3aaef87",
"sha256": "ced0bb44a9a703a67a956e3b0314238d48726b09ed9ae3ce140344561f900902"
},
"downloads": -1,
"filename": "pandas-datapackage-reader-0.18.0.tar.gz",
"has_sig": false,
"md5_digest": "465c5154092ea4e07c3dbf86a3aaef87",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 22649,
"upload_time": "2021-03-17T21:10:26",
"upload_time_iso_8601": "2021-03-17T21:10:26.655139Z",
"url": "https://files.pythonhosted.org/packages/84/f3/0437587d461e64090dc1244c1b9c318353725249d292e9636ea5e1e9ca61/pandas-datapackage-reader-0.18.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2021-03-17 21:10:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rgieseke",
"github_project": "pandas-datapackage-reader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pandas-datapackage-reader"
}