Development - Contributing¶
Issues and pull requests are more than welcome: github.com/sentinel-hub/titiler-openeo/issues
dev install
git clone https://github.com/sentinel-hub/titiler-openeo.git
cd titiler-openeo
python -m pip install -e ".[test,dev]"
Authentication Testing with Keycloak
The project includes a Keycloak instance for testing OpenID Connect authentication:
- Start the development environment:
This will start: - API service at localhost:8081 - openEO Web Editor at localhost:8080 - Keycloak at localhost:8082
- Access Keycloak admin console at localhost:8082/admin
- Username:
admin
-
Password:
admin
-
Create a new client:
- Go to "Clients" → "Create client"
- Client ID:
titiler-openeo
- Client type:
OpenID Connect
- Click "Next"
- Enable "Client authentication"
- Enable "Authorization"
-
Click "Save"
-
Configure client settings:
- Valid redirect URIs:
http://localhost:8080/*
for the openEO editor - Web origins:
http://localhost:8080
for the openEO editor - Click "Save"
The environment includes several pre-configured settings: - GDAL optimization settings for performance - Debug mode enabled - STAC API endpoint set to stac.eoapi.dev - Keycloak OIDC configuration
- Create a test user:
- Go to "Users" → "Add user"
- Username:
test
- Email:
test@example.com
- Click "Create"
- Go to "Credentials" tab
- Set password:
test123
- Disable "Temporary"
- Click "Save password"
The Keycloak server will be available at localhost:8082 for testing OIDC authentication flows.
pre-commit
This repo is set to use pre-commit
to run isort, flake8, pydocstring, black ("uncompromising Python code formatter") and mypy when committing new code.
Run tests¶
Docs¶
git clone https://github.com/sentinel-hub/titiler-openeo.git
cd titiler-openeo
python -m pip install -e ".[docs]"
Hot-reloading docs:
To manually deploy docs (note you should never need to do this because Github Actions deploys automatically for new commits.):
```bash mkdocs gh-deploy -f docs/mkdocs.yml