agnue-push 0.1.3

SDK and CLI for pushing data to the AgNUE platform

agnue-push

CLI and Python SDK for uploading sensor data to the AgNUE platform.

Installation

pip install agnue-push

Configuration

When your site is approved, you receive an agnue.toml file by email. Place it in your working directory — the SDK picks it up automatically.

You can also configure via environment variables: AGNUE_PLATFORM_URL, AGNUE_API_TOKEN, and optionally AGNUE_S3_*.

CLI

# Upload a single file
agnue upload data.csv --data-source DK-Foo-SOIL-01

# Upload a directory
agnue upload ./sensor-exports/ --data-source DK-Foo-SOIL-01

# Upload with glob, excluding backups
agnue upload "*.csv" --data-source DK-Foo-SOIL-01 --exclude "*_backup*"

The --data-source ID follows the format CC-SSS-DOMAIN-SEQ (e.g. DK-Foo-SOIL-01).

Fallback behaviour: if the platform API is unreachable after 3 retries, files are uploaded directly to S3 (if configured) or staged locally under agnue-staging/raw/<site>/ for later pickup.

Python API

from agnue_push import AgNUEClient

client = AgNUEClient.from_config()  # reads agnue.toml or env vars

# Upload a file — returns ingestion_id, or None if staged locally
ingestion_id = client.upload("data.csv", data_source_id="DK-Foo-SOIL-01")

# Check an earlier S3 upload
exists = client.verify_upload("raw/DK-Foo/data.csv")

# List all uploads for this site
keys = client.list_uploads()

Pass explicit config instead of a file:

client = AgNUEClient.from_config(
    platform_url="https://api.example.com",
    api_token="st_tok-...",
)

License

See LICENSE.