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.32.0.tar.gz (47.7 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.32.0-py3-none-any.whl (33.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agent_first_data-0.32.0.tar.gz
  • Upload date:
  • Size: 47.7 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.32.0.tar.gz
Algorithm Hash digest
SHA256 a108b28a309483e8b8ac86445d21c88bc8c4eac913813bd559e96de8045054a9
MD5 598d6138618bbc8dc1836282057dfd81
BLAKE2b-256 e381b3dadc670fd8443efe04de89c8bcb9a9698d785a2044cf21f360d05bd2b6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agent_first_data-0.32.0-py3-none-any.whl
Algorithm Hash digest
SHA256 74af0212eafd617891798d206ba73756148d6c07123297d9270e10efdf2f56b0
MD5 f8c9b3e714f9a5eaea72f3b6007e6c32
BLAKE2b-256 42dd5c253defa2249fd0cb7a134ebb6d4b4f5b50aa6c3bbd2803c9c9cd70d6cf

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