Synchronize SMART Connect data models, events, and patrols with EarthRanger
Project description
er-smart-sync
Synchronize SMART Connect wildlife-monitoring data with EarthRanger.
📖 Full documentation
https://padas.github.io/earthranger-smart-utils/
Includes install instructions, step-by-step workflows for every sync flow, a complete CLI reference, conceptual background, and troubleshooting.
What it does
- Datamodel sync (SMART → ER) — turn SMART data models into EarthRanger event categories and event types.
- Event sync (ER → SMART) — poll EarthRanger events and forward them via message broker.
- Patrol sync (ER → SMART) — poll EarthRanger patrols with track points and attached files.
- Event-type copy (ER → ER) — copy a single event type (and the v2
choices its schema references) from one EarthRanger site to another via
the
copy-event-typeCLI subcommand.
Quick install
uv pip install er-smart-sync
er-smart-sync --help
Or install from source (for development):
git clone git@github.com:PADAS/earthranger-smart-utils.git
cd earthranger-smart-utils
uv pip install -e ".[dev]"
er-smart-sync --help
See the Installation page for prerequisites, optional extras, and verification steps.
For contributors
Working on the codebase itself? Start with:
- CLAUDE.md — codebase conventions: Pydantic v1 API, SMART version-gating (<7.5.3 needs
smart_observation_uuidpatching), the bracketed-CA-label convention, and the protocol-based dependency-injection pattern. - USAGE.md — developer-oriented CLI reference and the bracketed-CA-label convention as it affects the codebase.
- docs/superpowers/specs/ — design specs for non-trivial features (v2 event types, choices population, etc.).
- docs/superpowers/plans/ — implementation plans for recent feature work.
The user-facing documentation at the link above covers what er-smart-sync does and how to use it; the references in this section cover how it's built.
License
Apache License 2.0. See LICENSE.
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file er_smart_sync-0.3.1.tar.gz.
File metadata
- Download URL: er_smart_sync-0.3.1.tar.gz
- Upload date:
- Size: 335.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df432fb2c65cc06a9198f54f424170d4b89c3d6f2b859c9532363178a690cb53
|
|
| MD5 |
e9f57ff8b72d0df8029beb69307a640d
|
|
| BLAKE2b-256 |
63f5fb1a24d2e4ca8db577f69f09d398046e0d5e8142ce7026f510c0cb81b928
|
Provenance
The following attestation bundles were made for er_smart_sync-0.3.1.tar.gz:
Publisher:
release.yml on PADAS/earthranger-smart-utils
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
er_smart_sync-0.3.1.tar.gz -
Subject digest:
df432fb2c65cc06a9198f54f424170d4b89c3d6f2b859c9532363178a690cb53 - Sigstore transparency entry: 1794917513
- Sigstore integration time:
-
Permalink:
PADAS/earthranger-smart-utils@f63fdfc94680e3c604f7556256f51f4a78eef5db -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/PADAS
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@f63fdfc94680e3c604f7556256f51f4a78eef5db -
Trigger Event:
push
-
Statement type:
File details
Details for the file er_smart_sync-0.3.1-py3-none-any.whl.
File metadata
- Download URL: er_smart_sync-0.3.1-py3-none-any.whl
- Upload date:
- Size: 57.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fbbfeb549ac268a77ac10514aed36f7b005ee2774e01863b8218f681dc6f7478
|
|
| MD5 |
e54b4b39d8be9942cfaa8ba01fab8f26
|
|
| BLAKE2b-256 |
e9ac56cd85b7d69899507fb687d89c87120bb17e01714dc0524a0f557ad49ef0
|
Provenance
The following attestation bundles were made for er_smart_sync-0.3.1-py3-none-any.whl:
Publisher:
release.yml on PADAS/earthranger-smart-utils
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
er_smart_sync-0.3.1-py3-none-any.whl -
Subject digest:
fbbfeb549ac268a77ac10514aed36f7b005ee2774e01863b8218f681dc6f7478 - Sigstore transparency entry: 1794917657
- Sigstore integration time:
-
Permalink:
PADAS/earthranger-smart-utils@f63fdfc94680e3c604f7556256f51f4a78eef5db -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/PADAS
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@f63fdfc94680e3c604f7556256f51f4a78eef5db -
Trigger Event:
push
-
Statement type:
