Metadata-Version: 2.1
Name: geefetch
Version: 0.2.0
Summary: geefetch
Author-email: Gabriel Belouze <gabriel@belouze.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: click
Requires-Dist: earthengine-api
Requires-Dist: gdal
Requires-Dist: geedim
Requires-Dist: geopandas
Requires-Dist: jsons
Requires-Dist: numpy
Requires-Dist: omegaconf
Requires-Dist: rasterio
Requires-Dist: retry
Requires-Dist: rich
Requires-Dist: shapely
Requires-Dist: utm
Requires-Dist: mypy ; extra == "dev"
Requires-Dist: pytest ; extra == "dev"
Requires-Dist: pre-commit ; extra == "dev"
Requires-Dist: sphinx ; extra == "doc"
Requires-Dist: sphinx_rtd_theme ; extra == "doc"
Requires-Dist: sphinxcontrib-napoleon ; extra == "doc"
Requires-Dist: sphinx-click ; extra == "doc"
Project-URL: source, https://github.com/gbelouze/geefetch
Project-URL: tracker, https://github.com/gbelouze/geefetch/issues
Provides-Extra: dev
Provides-Extra: doc

# `geefetch`

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Documentation Status](https://readthedocs.org/projects/geefetch/badge/?version=latest)](https://geefetch.readthedocs.io/en/latest/?badge=latest)

A python library/CLI to download large scale satellite data from Google Earth Engine.

[![CLI demo](https://asciinema.org/a/IuapVy0T9ErtyvgDMb8rMLftC)](https://asciinema.org/a/IuapVy0T9ErtyvgDMb8rMLftC)



## Overview

This library is still in its early days and in active development. After installing `geefetch`, you can check the available commands with

```bash
geefetch --help
```

In its current state, `geefetch` allows you to download Sentinel-1, Sentinel-2, Dynamic World data as raster files, and GEDI data as raster or vector files. See `geefetch download --help`.

## Development

Install GDAL beforehand (see [instructions](https://pypi.org/project/GDAL/)).
Install `geefetch` locally in editable mode

```bash
git clone https://github.com/gbelouze/geefetch.git
cd geefetch
pip install -e .
```
Be sure to read [CONTRIBUTING.md](/CONTRIBUTING.md) before making your first pull request.

### Adding autocompletion

You can add autocompletion for the `geefetch` CLI, following [`click` doc](https://click.palletsprojects.com/en/8.1.x/shell-completion/).

If you are using a `conda` environment, you need to activate autocompletion in that environment only. Following the instructions in [the doc](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#macos-and-linux), add the following command to `$CONDA_PREFIX/etc/conda/activate.d/env_vars.sh` (adapt for other shell than `zsh`)

```bash
eval "$(_GEEFETCH_COMPLETE=zsh_source geefetch)"
```

