Skip to main content

A no-dependency Python package for STAC, using Rust under the hood.

Project description

stacrs

GitHub Workflow Status PyPI - Version Read the Docs PyPI - License Contributor Covenant

A no-dependency Python package for STAC, using Rust under the hood.

Usage

Install via pip:

pip install stacrs

Then:

import stacrs

# Search a STAC API
items = stacrs.search(
    "https://landsatlook.usgs.gov/stac-server",
    collections="landsat-c2l2-sr",
    intersects={"type": "Point", "coordinates": [-105.119, 40.173]},
    sortby="-properties.datetime",
    max_items=100,
)

# Write items to a stac-geoparquet file
stacrs.write("items.parquet", items)

# Read items from a stac-geoparquet file as an item collection
item_collection = stacrs.read("items.parquet")

# Use `search_to` for better performance if you know you'll be writing the items
# to a file
stacrs.search_to(
    "items.parquet",
    "https://landsatlook.usgs.gov/stac-server",
    collections="landsat-c2l2-sr",
    intersects={"type": "Point", "coordinates": [-105.119, 40.173]},
    sortby="-properties.datetime",
    max_items=100,
)

pystac

If pystac is present, stacrs.pystac provides functions that take pystac objects as their inputs and outputs:

import pystac
import stacrs.pystac

item = pystac.read_file("item.json")
stacrs.pystac.validate(item)

items = list(stacrs.pystac.search(...))

You can install pystac with stacrs via an optional dependency:

pip install 'stacrs[pystac]'

Comparisons

This package (intentionally) has limited functionality, as it is not intended to be a replacement for existing Python STAC packages. pystac is a mature Python library with a significantly richer API for working with STAC objects. For querying STAC APIs, pystac-client is more feature-rich than our simplistic stacrs.search.

That being said, it is hoped that stacrs will be a nice complement to the existing Python STAC ecosystem by providing a no-dependency package with unique capabilities, such as searching directly into a stac-geoparquet file.

Other info

This package is part of the stac-rs monorepo, see its README for contributing and license information.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stacrs-0.1.0.tar.gz (1.5 MB view details)

Uploaded Source

Built Distributions

stacrs-0.1.0-cp312-none-win_amd64.whl (9.0 MB view details)

Uploaded CPython 3.12 Windows x86-64

stacrs-0.1.0-cp312-none-win32.whl (8.1 MB view details)

Uploaded CPython 3.12 Windows x86

stacrs-0.1.0-cp312-cp312-manylinux_2_34_x86_64.whl (25.2 MB view details)

Uploaded CPython 3.12 manylinux: glibc 2.34+ x86-64

stacrs-0.1.0-cp312-cp312-macosx_11_0_arm64.whl (9.2 MB view details)

Uploaded CPython 3.12 macOS 11.0+ ARM64

stacrs-0.1.0-cp312-cp312-macosx_10_12_x86_64.whl (9.7 MB view details)

Uploaded CPython 3.12 macOS 10.12+ x86-64

stacrs-0.1.0-cp311-none-win_amd64.whl (9.0 MB view details)

Uploaded CPython 3.11 Windows x86-64

stacrs-0.1.0-cp311-none-win32.whl (8.1 MB view details)

Uploaded CPython 3.11 Windows x86

stacrs-0.1.0-cp311-cp311-macosx_11_0_arm64.whl (9.2 MB view details)

Uploaded CPython 3.11 macOS 11.0+ ARM64

stacrs-0.1.0-cp311-cp311-macosx_10_12_x86_64.whl (9.7 MB view details)

Uploaded CPython 3.11 macOS 10.12+ x86-64

stacrs-0.1.0-cp310-none-win_amd64.whl (9.0 MB view details)

Uploaded CPython 3.10 Windows x86-64

stacrs-0.1.0-cp310-none-win32.whl (8.1 MB view details)

Uploaded CPython 3.10 Windows x86

stacrs-0.1.0-cp310-cp310-manylinux_2_34_x86_64.whl (15.2 MB view details)

Uploaded CPython 3.10 manylinux: glibc 2.34+ x86-64

stacrs-0.1.0-cp310-cp310-macosx_11_0_arm64.whl (9.2 MB view details)

Uploaded CPython 3.10 macOS 11.0+ ARM64

stacrs-0.1.0-cp39-none-win_amd64.whl (9.0 MB view details)

Uploaded CPython 3.9 Windows x86-64

stacrs-0.1.0-cp39-none-win32.whl (8.1 MB view details)

Uploaded CPython 3.9 Windows x86

stacrs-0.1.0-cp39-cp39-macosx_11_0_arm64.whl (9.2 MB view details)

Uploaded CPython 3.9 macOS 11.0+ ARM64

stacrs-0.1.0-cp38-none-win_amd64.whl (9.0 MB view details)

Uploaded CPython 3.8 Windows x86-64

stacrs-0.1.0-cp38-none-win32.whl (8.1 MB view details)

Uploaded CPython 3.8 Windows x86

File details

Details for the file stacrs-0.1.0.tar.gz.

File metadata

  • Download URL: stacrs-0.1.0.tar.gz
  • Upload date:
  • Size: 1.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: maturin/1.7.1

File hashes

Hashes for stacrs-0.1.0.tar.gz
Algorithm Hash digest
SHA256 65a98482fb31144e43c6c5d3c5cc8b589003c6f43369c114fd7071e06a921df2
MD5 7b7c6a9b1c5b07337244a0a63fd9c242
BLAKE2b-256 b76e1dc3f626dfaf15d18ddf60546840a6c2239a22ab012ce10d4a7fd5bb2cc3

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp312-none-win_amd64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp312-none-win_amd64.whl
Algorithm Hash digest
SHA256 e8ac26e59c07ed78ba82f4b0c228f9a3dda4cd92ed565483481e0ce2ce15cfb5
MD5 626aae2da8e5efc40a47909eb8656968
BLAKE2b-256 de67a57d8f3eb6612973b59794597170266f29d0aa1ca167583b5e5d85b8483a

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp312-none-win32.whl.

File metadata

  • Download URL: stacrs-0.1.0-cp312-none-win32.whl
  • Upload date:
  • Size: 8.1 MB
  • Tags: CPython 3.12, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: maturin/1.7.1

File hashes

Hashes for stacrs-0.1.0-cp312-none-win32.whl
Algorithm Hash digest
SHA256 4718921fb24b9a10d88af616784ad608ff7e00b5ad3229a346374590daa70098
MD5 9a3385f9380b801af19dd7084acd06d7
BLAKE2b-256 3e074507dcfdd91228e455a00617bb1bb34f38cd9fea6a2dcf6137fefbd8dcdd

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp312-cp312-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 e1e4d029cd90279636f172d52fb7b2eb72142f14dfb03478dc36dd2530ad651b
MD5 56828cb92ffa687c90f4a332ba04397a
BLAKE2b-256 5470af04ab9f348a6104ec0b07a29264b52deebcda877e7bc9a24bc4945933e4

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 8db1e66ce5d5cd9d0d57fcc0079ab0cdd547f3318c9ccf60627c5bd691845cf4
MD5 461dc5934fc36ea3a60046ccbf68114a
BLAKE2b-256 4bf2301d93dfe31acba441bde4418fda24686d0b564ac7c375a4edcf9208b029

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp312-cp312-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 abe83528b3ebd435a2834086c3cbb3ea03b71038f2877a7b3d491d54c25d23db
MD5 3d0a7d827f28f2ec1393d7eaecfcf8bb
BLAKE2b-256 8ee8abf2105960831c1e826ae4124ed17a328222a757a92ffe56ff0c35add6ab

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp311-none-win_amd64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp311-none-win_amd64.whl
Algorithm Hash digest
SHA256 bdf990a6c5db9fb0223f2b34c5b50a582fd8f65642d18c61523c7a51e5552469
MD5 22a58824c684a60d0cdc21a7b04b2f98
BLAKE2b-256 86d6225c284106c602641697c11d82efba8eae1d1019fbfde058599183981860

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp311-none-win32.whl.

File metadata

  • Download URL: stacrs-0.1.0-cp311-none-win32.whl
  • Upload date:
  • Size: 8.1 MB
  • Tags: CPython 3.11, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: maturin/1.7.1

File hashes

Hashes for stacrs-0.1.0-cp311-none-win32.whl
Algorithm Hash digest
SHA256 f4972e2b44d92f4288fa6b6d5f750888d3f7419738765c4669dfd6c376940d3c
MD5 8d0b596c506584095ee213cab9217b9c
BLAKE2b-256 25c83476977e3a9713b282912bb6774957879bbc7009b7f30cd7972852b8fb59

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7be91c4501c0d6ee322265650bce406092409f89b4b4887e3114475528aef72b
MD5 e918b87bb2de129498f63f3e926f3aa3
BLAKE2b-256 6ddd301dd910975422ec131083ab2218464f83ef56eb407f7ab39d121e51e0e4

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp311-cp311-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp311-cp311-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 669794641f5c6c906ce5a4e5627bff49c375ea25bcc660779b5f876dcf62ed1d
MD5 b9f59b31d41f5e04340cb17048ae6b0b
BLAKE2b-256 868a33e3e462eaefc3e571e607f2fd347d6fc5c609142d14de8b571948b5a300

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp310-none-win_amd64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp310-none-win_amd64.whl
Algorithm Hash digest
SHA256 7be25d9fd03db93fddc0bce0d065b3e6208ed197cc344a994516f1c0bf12014f
MD5 79dbab8a87bc390e8746f9f6ee808302
BLAKE2b-256 23332796ce511a19894e0bd4bdd01fdef5fb0acb77535365e036d30c0e94444a

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp310-none-win32.whl.

File metadata

  • Download URL: stacrs-0.1.0-cp310-none-win32.whl
  • Upload date:
  • Size: 8.1 MB
  • Tags: CPython 3.10, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: maturin/1.7.1

File hashes

Hashes for stacrs-0.1.0-cp310-none-win32.whl
Algorithm Hash digest
SHA256 21f1a35ae5966a26283dc1751a6ef03779e55e4d45a2b064801be19fea4bc3a4
MD5 56be8e7e7faa5f74c93c48a8e3f3ac11
BLAKE2b-256 4896c7d8740aa958ce4e19e8785948a0c0ffb3bac2f146ede30d39fe66503b28

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp310-cp310-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp310-cp310-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 1c56604d8f5cb2b55903f224e5eee34ec1a172feebee7da5c1fae73b3900a515
MD5 47fb7a2fce9785718fedba072ee12a12
BLAKE2b-256 e3e584ee468751f4cf93f5696fc86bc6385153131940f15e4c16e1832eddbefa

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 47faa093676cc11059cc69b452c6c0c3cbd1a3f11040fe4f8d0aafaa12b2d3ce
MD5 1b80ae11480db1b6bbf9f4a128d94062
BLAKE2b-256 6c97a0ff2953e2fd7bf2b17a1194fdbe6c252b964264508dcfef8a41726acf99

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp39-none-win_amd64.whl.

File metadata

  • Download URL: stacrs-0.1.0-cp39-none-win_amd64.whl
  • Upload date:
  • Size: 9.0 MB
  • Tags: CPython 3.9, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: maturin/1.7.1

File hashes

Hashes for stacrs-0.1.0-cp39-none-win_amd64.whl
Algorithm Hash digest
SHA256 ec3866b101b714a5300c32b0bfaf81f1920971dc0db0a8c72899bd518addf57a
MD5 9eb3aa645eca4214e4a799c4f8524fc4
BLAKE2b-256 3f0ff71e59f409ed63cd3459bc22189766156a59c90c191f234d621da5ed7ff1

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp39-none-win32.whl.

File metadata

  • Download URL: stacrs-0.1.0-cp39-none-win32.whl
  • Upload date:
  • Size: 8.1 MB
  • Tags: CPython 3.9, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: maturin/1.7.1

File hashes

Hashes for stacrs-0.1.0-cp39-none-win32.whl
Algorithm Hash digest
SHA256 91c5d9cb676d521819a19cb93aa0a6f48c2c5924237f66815d2342164a05a8d5
MD5 40d15c64dcab89028e9b2c68df89375b
BLAKE2b-256 2908611e2f53c2f855fc07dbea8d84f9c2197598a69c52dfa71e86bdcb49c51d

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for stacrs-0.1.0-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0180a65a11b294e14c194e0f7d1be20cccffd4c3f2505e31f6c50f585018de96
MD5 848726a0676b9aa44b2070008a7f926a
BLAKE2b-256 2c707671da2569463a8bd55247803b66843bd569566f58d81502df1b51648ea0

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp38-none-win_amd64.whl.

File metadata

  • Download URL: stacrs-0.1.0-cp38-none-win_amd64.whl
  • Upload date:
  • Size: 9.0 MB
  • Tags: CPython 3.8, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: maturin/1.7.1

File hashes

Hashes for stacrs-0.1.0-cp38-none-win_amd64.whl
Algorithm Hash digest
SHA256 325d531a370d3b221472fee8a556463ab9a80a7479b0dd2ec2c6d64566c5060a
MD5 cf100929ef19db45af670b864fab4ae8
BLAKE2b-256 1fa0cc0b8921be9f9ac4d1bf88f57a4fedeadbd13d9e97014730accd0d66c36e

See more details on using hashes here.

File details

Details for the file stacrs-0.1.0-cp38-none-win32.whl.

File metadata

  • Download URL: stacrs-0.1.0-cp38-none-win32.whl
  • Upload date:
  • Size: 8.1 MB
  • Tags: CPython 3.8, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: maturin/1.7.1

File hashes

Hashes for stacrs-0.1.0-cp38-none-win32.whl
Algorithm Hash digest
SHA256 982fd55753d93b368c78d701c11487344fc83f27425a5f42d3cef5110c6fd0ae
MD5 524674739c75a3c8eaebbc2f36247631
BLAKE2b-256 43908e2ed51b85675b800f7a76fa1026e6849249b532b6d01693139eace693d7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page