Skip to main content

An application for discovering collections from multiple STAC APIs and/or CMRs

Project description

Federated Collection Discovery

An application for discovering geospatial data collections from multiple STAC APIs and/or CMRs.

Installation

The package can be installed from pypi, optionally with uvicorn for serving the application locally:

for uvicorn:

pip install federated-collection-discovery[uvicorn]

If you are going to run the application in an AWS Lambda function, install the aws_lambda extras in the build context:

pip install federated-collection-discovery[aws_lambda]

Usage

To run the FastAPI application, set the FEDERATED_STAC_API_URLS environment variable and/or the FEDERATED_CMR_URLS environment variable, then launch it with uvicorn:

MAAP_API=https://stac.maap-project.org/
VEDA_API=https://openveda.cloud/api/stac/
ESA_API=https://catalogue.dataspace.copernicus.eu/stac
FEDERATED_STAC_API_URLS=${MAAP_API},${VEDA_API},${ESA_API} \
  uvicorn federated_collection_discovery.main:app --host 0.0.0.0 --port 8000

Development

Clone the repo

git clone git@github.com:developmentseed/federated-collection-discovery.git
cd federated-collection-discovery

Install uv

Ensure you have uv installed. If not, install it:

# install uv

# unix
curl -LsSf https://astral.sh/uv/install.sh | sh

# or on windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Install federated_collection_discovery

Navigate to the src/server directory and install the dependencies (in a virtual environment) using Poetry:

uv sync --all-extras

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

federated_collection_discovery-0.1.8.tar.gz (15.3 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file federated_collection_discovery-0.1.8.tar.gz.

File metadata

File hashes

Hashes for federated_collection_discovery-0.1.8.tar.gz
Algorithm Hash digest
SHA256 ca78ff5bc46a6f0ee42208bc70525f91a8abdc677dd11804f91494a08fe60373
MD5 8478f7107bfeb19bca81520a8fdb09b3
BLAKE2b-256 6dac267214b9adf991eeeb447eadd335c345c77336bd17a04ca23431b618ef73

See more details on using hashes here.

Provenance

The following attestation bundles were made for federated_collection_discovery-0.1.8.tar.gz:

Publisher: ci.yaml on developmentseed/federated-collection-discovery

Attestations:

File details

Details for the file federated_collection_discovery-0.1.8-py3-none-any.whl.

File metadata

File hashes

Hashes for federated_collection_discovery-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 c77c27412b257568614966cb35143fefa608a17f3a76a588d0911d09098ffff6
MD5 46dc166c773c6c1bc03d07fd57f10653
BLAKE2b-256 5b021ef10da5cfcbea63eb5c14fb399afbb13cbbace68c5662b3d77ef36df92a

See more details on using hashes here.

Provenance

The following attestation bundles were made for federated_collection_discovery-0.1.8-py3-none-any.whl:

Publisher: ci.yaml on developmentseed/federated-collection-discovery

Attestations:

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