Miscellaneous utilities for working with OPERA data products
Project description
opera-utils
Install
The opera_utils
package is available on PyPI and conda-forge:
pip install opera-utils
# if mamba is not already installed: conda install -n base mamba
mamba install -c conda-forge opera-utils
(Note: using mamba
is recommended for conda-forge packages, but miniconda can also be used.)
While not required for all, some utilities use the GDAL package, which can be installed most easily on conda-forge:
mamba env update --file environment-geo.yml
Setup for Developers
To contribute to the development of opera-utils
, you can fork the repository and install the package in development mode.
We encourage new features to be developed on a new branch of your fork, and then submitted as a pull request to the main repository.
To install locally,
- Download source code:
git clone https://github.com/opera-adt/opera-utils.git && cd opera-utils
- Install dependencies:
mamba env create --name my-opera-env --file environment.yml
mamba install gdal
- Install the source in editable mode:
mamba activate my-opera-env
python -m pip install -e .
The extra packages required for testing and building the documentation can be installed:
# Run "pip install -e" to install with extra development requirements
python -m pip install -e ".[docs,test]"
We use pre-commit
to automatically run linting and formatting:
# Get pre-commit hooks so that linting/formatting is done automatically
pre-commit install
This will set up the linters and formatters to run on any staged files before you commit them.
After making functional changes, you can rerun the existing tests and any new ones you have added using:
python -m pytest
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for opera_utils-0.7.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b1a8e5574595bdb9e62b240f004ab4cda75aa45740b17d2391f90b03fe5ad94d |
|
MD5 | 1f37729f755583966bed9bef7216f572 |
|
BLAKE2b-256 | e744dec00a184f9fa77eee4c611eea9eda4f58fac8d80d11e44fe876b20cba1d |