| Name | pystac JSON |
| Version |
1.12.0
JSON |
| download |
| home_page | None |
| Summary | Python library for working with the SpatioTemporal Asset Catalog (STAC) specification |
| upload_time | 2025-01-23 17:59:04 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | Apache-2.0 |
| keywords |
pystac
imagery
raster
catalog
stac
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# PySTAC
[](https://github.com/stac-utils/pystac/actions/workflows/continuous-integration.yml)
[](https://badge.fury.io/py/pystac)
[](https://anaconda.org/conda-forge/pystac)
[](https://pystac.readthedocs.io/en/latest/)
[](https://codecov.io/gh/stac-utils/pystac)
[](https://gitter.im/SpatioTemporal-Asset-Catalog/python?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://opensource.org/licenses/Apache-2.0)
PySTAC is a library for working with the [SpatioTemporal Asset Catalog](https://stacspec.org) specification in Python 3.
## Installation
### Install from PyPi (recommended)
```shell
python -m pip install pystac
```
If you would like to enable the validation feature utilizing the
[jsonschema](https://pypi.org/project/jsonschema/) project, install with the optional
`validation` requirements:
```shell
python -m pip install 'pystac[validation]'
```
If you would like to use the [`orjson`](https://pypi.org/project/orjson/) instead of the
standard `json` library for JSON serialization/deserialization, install with the
optional `orjson` requirements:
```shell
python -m pip install 'pystac[orjson]'
```
If you would like to use a custom `RetryStacIO` class for automatically retrying
network requests when reading with PySTAC, you'll need
[`urllib3`](https://urllib3.readthedocs.io/en/stable/):
```shell
python -m pip install 'pystac[urllib3]'
```
If you are using jupyter notebooks and want to enable pretty display of pystac
objects you'll need [`jinja2`](https://pypi.org/project/Jinja2/)
```shell
python -m pip install 'pystac[jinja2]'
```
### Install from source
```shell
git clone https://github.com/stac-utils/pystac.git
cd pystac
python -m pip install .
```
See the [installation page](https://pystac.readthedocs.io/en/latest/installation.html)
for more options.
## Documentation
See the [documentation page](https://pystac.readthedocs.io/en/latest/) for the latest docs.
## Developing
See [contributing docs](https://pystac.readthedocs.io/en/latest/contributing.html)
for details on contributing to this project.
## Running the quickstart and tutorials
There is a quickstart and tutorials written as jupyter notebooks in the `docs/tutorials` folder.
To run the notebooks, run a jupyter notebook with the `docs` directory as the notebook directory:
```shell
jupyter notebook --ip 0.0.0.0 --port 8888 --notebook-dir=docs
```
You can then navigate to the notebooks and execute them.
Requires [Jupyter](https://jupyter.org/) be installed.
Raw data
{
"_id": null,
"home_page": null,
"name": "pystac",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Pete Gadomski <pete.gadomski@gmail.com>",
"keywords": "pystac, imagery, raster, catalog, STAC",
"author": null,
"author_email": "Rob Emanuele <rdemanuele@gmail.com>, Jon Duckworth <duckontheweb@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/2c/9c/f7cc9880f8ff1e25df43c91c1111be11501acb8685aec0534ba047c3cef9/pystac-1.12.0.tar.gz",
"platform": null,
"description": "# PySTAC\n\n[](https://github.com/stac-utils/pystac/actions/workflows/continuous-integration.yml)\n[](https://badge.fury.io/py/pystac)\n[](https://anaconda.org/conda-forge/pystac)\n[](https://pystac.readthedocs.io/en/latest/)\n[](https://codecov.io/gh/stac-utils/pystac)\n[](https://gitter.im/SpatioTemporal-Asset-Catalog/python?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)\n[](https://opensource.org/licenses/Apache-2.0)\n\nPySTAC is a library for working with the [SpatioTemporal Asset Catalog](https://stacspec.org) specification in Python 3.\n\n## Installation\n\n### Install from PyPi (recommended)\n\n```shell\npython -m pip install pystac\n```\n\nIf you would like to enable the validation feature utilizing the\n[jsonschema](https://pypi.org/project/jsonschema/) project, install with the optional\n`validation` requirements:\n\n```shell\npython -m pip install 'pystac[validation]'\n```\n\nIf you would like to use the [`orjson`](https://pypi.org/project/orjson/) instead of the\nstandard `json` library for JSON serialization/deserialization, install with the\noptional `orjson` requirements:\n\n```shell\npython -m pip install 'pystac[orjson]'\n```\n\nIf you would like to use a custom `RetryStacIO` class for automatically retrying\nnetwork requests when reading with PySTAC, you'll need\n[`urllib3`](https://urllib3.readthedocs.io/en/stable/):\n\n```shell\npython -m pip install 'pystac[urllib3]'\n```\n\nIf you are using jupyter notebooks and want to enable pretty display of pystac\nobjects you'll need [`jinja2`](https://pypi.org/project/Jinja2/)\n\n```shell\npython -m pip install 'pystac[jinja2]'\n```\n\n### Install from source\n\n```shell\ngit clone https://github.com/stac-utils/pystac.git\ncd pystac\npython -m pip install .\n```\n\nSee the [installation page](https://pystac.readthedocs.io/en/latest/installation.html)\nfor more options.\n\n## Documentation\n\nSee the [documentation page](https://pystac.readthedocs.io/en/latest/) for the latest docs.\n\n## Developing\n\nSee [contributing docs](https://pystac.readthedocs.io/en/latest/contributing.html)\nfor details on contributing to this project.\n\n## Running the quickstart and tutorials\n\nThere is a quickstart and tutorials written as jupyter notebooks in the `docs/tutorials` folder.\nTo run the notebooks, run a jupyter notebook with the `docs` directory as the notebook directory:\n\n```shell\njupyter notebook --ip 0.0.0.0 --port 8888 --notebook-dir=docs\n```\n\nYou can then navigate to the notebooks and execute them.\n\nRequires [Jupyter](https://jupyter.org/) be installed.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Python library for working with the SpatioTemporal Asset Catalog (STAC) specification",
"version": "1.12.0",
"project_urls": {
"Changelog": "https://github.com/stac-utils/pystac/blob/main/CHANGELOG.md",
"Discussions": "https://github.com/radiantearth/stac-spec/discussions/categories/stac-software",
"Documentation": "https://pystac.readthedocs.io",
"Issues": "https://github.com/stac-utils/pystac/issues",
"Repository": "https://github.com/stac-utils/pystac"
},
"split_keywords": [
"pystac",
" imagery",
" raster",
" catalog",
" stac"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "05a1e6ecd65d9db7ac67c49414e499e3554b2789010a91294507932a9c7805ef",
"md5": "194cef8534a925e4ab06f0d4c0e8378f",
"sha256": "911f2d3b045416e85e26b93cd5b9e7fab489fdbd39c49efc621617e4eccfc2f1"
},
"downloads": -1,
"filename": "pystac-1.12.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "194cef8534a925e4ab06f0d4c0e8378f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 194094,
"upload_time": "2025-01-23T17:59:02",
"upload_time_iso_8601": "2025-01-23T17:59:02.784806Z",
"url": "https://files.pythonhosted.org/packages/05/a1/e6ecd65d9db7ac67c49414e499e3554b2789010a91294507932a9c7805ef/pystac-1.12.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2c9cf7cc9880f8ff1e25df43c91c1111be11501acb8685aec0534ba047c3cef9",
"md5": "24207ffa1cda7d67e5418e74f3c44b49",
"sha256": "1a9d7502ed899e32916a9e101a225b2be3608290bcf343e04a7c40f726c72994"
},
"downloads": -1,
"filename": "pystac-1.12.0.tar.gz",
"has_sig": false,
"md5_digest": "24207ffa1cda7d67e5418e74f3c44b49",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 149779,
"upload_time": "2025-01-23T17:59:04",
"upload_time_iso_8601": "2025-01-23T17:59:04.468859Z",
"url": "https://files.pythonhosted.org/packages/2c/9c/f7cc9880f8ff1e25df43c91c1111be11501acb8685aec0534ba047c3cef9/pystac-1.12.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-23 17:59:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "stac-utils",
"github_project": "pystac",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pystac"
}
