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.0.tar.gz (286.0 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.0-py3-none-any.whl (47.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: er_smart_sync-0.2.0.tar.gz
  • Upload date:
  • Size: 286.0 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.0.tar.gz
Algorithm Hash digest
SHA256 c928146980856de7428aa7301f7891fdcfeaa92596902306b176322049683c4d
MD5 3d1e4f1dd659348b2e46fc27bd52b5db
BLAKE2b-256 35038a65439f729d84d5145ff3e8f6ea61339e3602390ed57c5bbe253ddcfcaf

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: er_smart_sync-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 47.0 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 04682c1c605338840126b92bc29099624a8f0505a3afeb3cbf261790972e9fed
MD5 cd95bbb3f7a4abfc480c44db0f9873a5
BLAKE2b-256 9f2ce711181d8b60d3d682d96a6b0c1913e213a2aaeed7f9d28b820c688dd06f

See more details on using hashes here.

Provenance

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