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.2.1.tar.gz (288.5 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.2.1-py3-none-any.whl (48.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: er_smart_sync-0.2.1.tar.gz
  • Upload date:
  • Size: 288.5 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.2.1.tar.gz
Algorithm Hash digest
SHA256 901ee9f5c773e06501096bead3889e83d02f466b8b2a5264cecc76046d09e3b9
MD5 8a879cfd341a946b9c54c63a758ec040
BLAKE2b-256 2c4a1e78c85705ed961bccb4cc8a79b07433263f8de43330532ac41d36fa1190

See more details on using hashes here.

Provenance

The following attestation bundles were made for er_smart_sync-0.2.1.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.2.1-py3-none-any.whl.

File metadata

  • Download URL: er_smart_sync-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 48.4 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.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f175d870b3f7d350386f153cb795342f550cab553f3b651da0100419c1eb3d43
MD5 61ee08be036c9d246b5620f283eb20e5
BLAKE2b-256 d7a450763a6cf37ef1a3aec0a5f1a673b409b5d9d4a5754e5a72bb923f34a62e

See more details on using hashes here.

Provenance

The following attestation bundles were made for er_smart_sync-0.2.1-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