Agent-First Data for Python

pip install agent-first-data

from agent_first_data import json_result, render, OutputFormat

value = json_result(
    {
        "api_key_secret": "sk-123",
        "latency_ms": 1280,
        "db_url": "postgres://user:p@ss@db/app?token_secret=abc",
    }
).build()

print(render(value, OutputFormat.JSON))
print(render(value, OutputFormat.PLAIN))

Useful names use Python casing: render (the single value x format x options -> str entry point; takes an OutputFormat and an optional keyword-only options=), redacted_value, redact_url_secrets, redact_urls_in_text, redact_argv, normalize_utc_offset, is_valid_rfc3339_date, is_valid_rfc3339_time, is_valid_rfc3339, is_valid_bcp47, cli_parse_output, build_cli_error, build_cli_version, decode_protocol_event.

Behavior Notes

  • Default redaction replaces every _secret or configured secret-name subtree with ***, including objects and arrays.
  • _url fields scrub userinfo passwords and secret-named query parameters; surrounding whitespace is trimmed and internal whitespace redacts the whole field.
  • OutputOptions.url_names applies URL treatment to exact legacy field names and recurses through collections. redact_urls_in_text is explicit and scans only complete scheme URLs, never arbitrary prose secrets.
  • YAML keeps original keys and values (structure-preserving, like JSON), sorting keys by UTF-16 code unit order and quoting/escaping unsafe keys and string scalars. Plain strips formatting suffixes, formats values, sorts the same way, and renders nested objects/arrays as canonical JSON.
  • Logging records use kind:"log" with a nested log payload and a separate level field, so error-level logs are not terminal protocol errors.
  • build_cli_error(message, hint?) returns a strict-ready CLI error with error.retryable:false and trace:{}.
  • Do not add a raw version/help pre-parser. Until the Python CliSpec compiler lands, applications should keep lifecycle parsing in their own parser rather than claim AFDATA closed-world help compatibility.

Reference

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.32.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for agentfirstkit from gravatar.com agentfirstkit

License expression

MIT
View SPDX License List

Requires

Python >=3.9

Report project as malware

Download files

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

Source Distribution

agent_first_data-0.31.0.tar.gz (47.3 kB view details)

Uploaded Source

Built Distribution

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

agent_first_data-0.31.0-py3-none-any.whl (32.9 kB view details)

Uploaded Python 3

File details

Details for the file agent_first_data-0.31.0.tar.gz.

File metadata

  • Download URL: agent_first_data-0.31.0.tar.gz
  • Upload date:
  • Size: 47.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for agent_first_data-0.31.0.tar.gz
Algorithm Hash digest
SHA256 79f7f84c3b66bb7bdcd46331a1f1f060489c22cee418fb69262989406ee965ef
MD5 26d55afc7ad12c4f25ac77edda359b86
BLAKE2b-256 424c58ea6eaef38090910ba259e44056cad0fe41bad163f63faacddffb9a0ee0

See more details on using hashes here.

File details

Details for the file agent_first_data-0.31.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_first_data-0.31.0-py3-none-any.whl
Algorithm Hash digest
SHA256 89b935d6f3f06eaadb9a722274e1c5678dc14963f563e61764afd9e67fa3fbeb
MD5 0e0879804fc6550daa9003a5099b65a1
BLAKE2b-256 99b493912bae355b36c40b78db97fba764b5733702d3810d33d5e790e607ffb0

See more details on using hashes here.

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