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.2.tar.gz (293.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.2-py3-none-any.whl (50.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: er_smart_sync-0.2.2.tar.gz
  • Upload date:
  • Size: 293.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.2.tar.gz
Algorithm Hash digest
SHA256 0d45c93b5535efb77bbf3a2e1be751a70b78487987d23c1a64b81ef3091658af
MD5 5d74fe9a19a2dc0651e66a94dfa223d4
BLAKE2b-256 29a4d18eafd5a5b7abeef507aeb7d26f2b3bd8e03a7ddf292d96d8038dcae1e0

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: er_smart_sync-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 50.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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d294ee24bdfa57710cbfcf0b85d4d7f4346518a5a231e35edbe9107706be7a9b
MD5 d4016ae0ef4bd922f33b66bffa86bfcc
BLAKE2b-256 8fd480d9e9d6ff1c9b2c6b0ebfa52c8f9e15b6ed58a17da56c8a984d4c7d2228

See more details on using hashes here.

Provenance

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