Skip to main content

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.

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_uuid patching), 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

er_smart_sync-0.3.0.tar.gz (317.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

er_smart_sync-0.3.0-py3-none-any.whl (53.5 kB view details)

Uploaded Python 3

File details

Details for the file er_smart_sync-0.3.0.tar.gz.

File metadata

  • Download URL: er_smart_sync-0.3.0.tar.gz
  • Upload date:
  • Size: 317.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for er_smart_sync-0.3.0.tar.gz
Algorithm Hash digest
SHA256 33e89e6758ae22250c8e9f5841051b94970595748a83b58c88782aa1264a3a46
MD5 4d9f2529b76f260b822aeba119cacba0
BLAKE2b-256 a56b64757e03ea1ae6a50d7537332992e4f0407acb81eba045a0d14a06e57818

See more details on using hashes here.

Provenance

The following attestation bundles were made for er_smart_sync-0.3.0.tar.gz:

Publisher: release.yml on PADAS/earthranger-smart-utils

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file er_smart_sync-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: er_smart_sync-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 53.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for er_smart_sync-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 420617727615ec325aecce8b1749ac99f40f2b904ceaa54001d2a6f0668fa29f
MD5 bde2ab698995019ea1aee5a01e3c8c64
BLAKE2b-256 55be106f27ef3867622f259ca1be91058a9e58706992c785cab3e3bcaaf9819e

See more details on using hashes here.

Provenance

The following attestation bundles were made for er_smart_sync-0.3.0-py3-none-any.whl:

Publisher: release.yml on PADAS/earthranger-smart-utils

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page