CSDA client

An Python client for interacting with CSDA program APIs.

Usage

python -m pip install git+https://github.com/nasa-impact/csda-client

See our docs for more. We use semantic versioning for our releases.

Issues

Please open Github issues with any bug reports, feature requests, and questions. You may also reach out to the CSDA Operations team at csda-support@nasa.gov.

At this time, only pull requests from CSDA team members will be accepted and merged.

Development

Get uv. Then:

git clone git@github.com:NASA-IMPACT/csda-client.git
cd csda-client
uv sync

Tests

Many of our tests run requests against the production system, which requires an Earthdata login. These are skipped by default. To enable them, create a .env file with the following values:

EARTHDATA_USERNAME=your-user-name
EARTHDATA_PASSWORD=your-password

We also allow .netrc authentication, so set that up per these instructions.

Then:

uv run pytest --with-earthdata-login

Documentation

To build and serve the documentation:

uv run mkdocs serve

They'll be available on http://127.0.0.1:8000/csda-client/.

License

MIT