# lsst.resources
[![pypi](https://img.shields.io/pypi/v/lsst-resources.svg)](https://pypi.org/project/lsst-resources/)
[![codecov](https://codecov.io/gh/lsst/resources/branch/main/graph/badge.svg?token=jGf63Xc1Ar)](https://codecov.io/gh/lsst/resources)
This package provides a simple interface to local or remote files using URIs.
```
from lsst.resources import ResourcePath
file_uri = ResourcePath("/data/file.txt")
contents = file_uri.read()
s3_uri = ResourcePath("s3://bucket/data/file.txt")
contents = s3_uri.read()
```
The package currently understands `file`, `s3`, `gs`, `http[s]`, and `resource` (Python package resource) URI schemes as well as a scheme-less URI (relative local file path).
The package provides the main file abstraction layer in the [Rubin Observatory Data Butler](https://github.com/lsst/daf_butler) datastore.
PyPI: [lsst-resources](https://pypi.org/project/lsst-resources/)
Raw data
{
"_id": null,
"home_page": null,
"name": "lsst-resources",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11.0",
"maintainer_email": null,
"keywords": "lsst",
"author": null,
"author_email": "Rubin Observatory Data Management <dm-admin@lists.lsst.org>",
"download_url": "https://files.pythonhosted.org/packages/11/4e/1bab1750e5201498048c60e47f6ceab00b5d015aaf989565872d1297ea89/lsst_resources-28.2025.500.tar.gz",
"platform": null,
"description": "# lsst.resources\n\n[![pypi](https://img.shields.io/pypi/v/lsst-resources.svg)](https://pypi.org/project/lsst-resources/)\n[![codecov](https://codecov.io/gh/lsst/resources/branch/main/graph/badge.svg?token=jGf63Xc1Ar)](https://codecov.io/gh/lsst/resources)\n\n\nThis package provides a simple interface to local or remote files using URIs.\n\n```\nfrom lsst.resources import ResourcePath\n\nfile_uri = ResourcePath(\"/data/file.txt\")\ncontents = file_uri.read()\n\ns3_uri = ResourcePath(\"s3://bucket/data/file.txt\")\ncontents = s3_uri.read()\n```\n\nThe package currently understands `file`, `s3`, `gs`, `http[s]`, and `resource` (Python package resource) URI schemes as well as a scheme-less URI (relative local file path).\n\nThe package provides the main file abstraction layer in the [Rubin Observatory Data Butler](https://github.com/lsst/daf_butler) datastore.\n\nPyPI: [lsst-resources](https://pypi.org/project/lsst-resources/)\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License",
"summary": "An abstraction layer for reading and writing from URI file resources.",
"version": "28.2025.500",
"project_urls": {
"Homepage": "https://github.com/lsst/resources"
},
"split_keywords": [
"lsst"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "707fc20bd786b1e852f7cfcabf91c30a915b7be5fc16e2b5af267cdfe8efadd8",
"md5": "6d0677e7533f02577766cfe3539c4e68",
"sha256": "3dcb923a4c3dd07bf2ddc38b159d2dd335ca19db939d07caab5e494a4ba5dc0a"
},
"downloads": -1,
"filename": "lsst_resources-28.2025.500-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6d0677e7533f02577766cfe3539c4e68",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11.0",
"size": 97929,
"upload_time": "2025-01-30T09:30:10",
"upload_time_iso_8601": "2025-01-30T09:30:10.249674Z",
"url": "https://files.pythonhosted.org/packages/70/7f/c20bd786b1e852f7cfcabf91c30a915b7be5fc16e2b5af267cdfe8efadd8/lsst_resources-28.2025.500-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "114e1bab1750e5201498048c60e47f6ceab00b5d015aaf989565872d1297ea89",
"md5": "3337ebc4885ed056ef8f5e16d90aac14",
"sha256": "1c555efcb4f1ba99f6f36b34361727a05a4dc7725a3431fba79d3dac7c9f828d"
},
"downloads": -1,
"filename": "lsst_resources-28.2025.500.tar.gz",
"has_sig": false,
"md5_digest": "3337ebc4885ed056ef8f5e16d90aac14",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11.0",
"size": 109816,
"upload_time": "2025-01-30T09:30:12",
"upload_time_iso_8601": "2025-01-30T09:30:12.060974Z",
"url": "https://files.pythonhosted.org/packages/11/4e/1bab1750e5201498048c60e47f6ceab00b5d015aaf989565872d1297ea89/lsst_resources-28.2025.500.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-30 09:30:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lsst",
"github_project": "resources",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "lsst-utils",
"specs": []
},
{
"name": "backoff",
"specs": [
[
">=",
"1.10"
]
]
},
{
"name": "boto3",
"specs": [
[
">=",
"1.13"
]
]
},
{
"name": "botocore",
"specs": [
[
">=",
"1.15"
]
]
},
{
"name": "moto",
"specs": [
[
"!=",
"5.0.0"
],
[
"!=",
"5.0.1"
],
[
"!=",
"5.0.3"
],
[
"!=",
"5.0.2"
],
[
">=",
"4"
]
]
},
{
"name": "responses",
"specs": [
[
">=",
"0.12.0"
]
]
},
{
"name": "urllib3",
"specs": [
[
">=",
"1.25.10"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.26.0"
]
]
},
{
"name": "defusedxml",
"specs": []
}
],
"lcname": "lsst-resources"
}