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
_secretor configured secret-name subtree with***, including objects and arrays. _urlfields scrub userinfo passwords and secret-named query parameters; surrounding whitespace is trimmed and internal whitespace redacts the whole field.OutputOptions.url_namesapplies URL treatment to exact legacy field names and recurses through collections.redact_urls_in_textis 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 nestedlogpayload and a separatelevelfield, so error-level logs are not terminal protocol errors. build_cli_error(message, hint?)returns a strict-ready CLI error witherror.retryable:falseandtrace:{}.- Do not add a raw version/help pre-parser. Until the Python
CliSpeccompiler lands, applications should keep lifecycle parsing in their own parser rather than claim AFDATA closed-world help compatibility.
Reference
- Formal cross-language contract: spec/agent-first-data.md
- Conformance fixtures: spec/fixtures
- Agent skill: skills/agent-first-data/SKILL.md
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_first_data-0.34.0.tar.gz.
File metadata
- Download URL: agent_first_data-0.34.0.tar.gz
- Upload date:
- Size: 47.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0a4a9d5c2a4d37e44b51f0e50ca92655eef78311d0dcf83f2d2cae45ba921a9b
|
|
| MD5 |
7d09ea4423c38b96af0b65511bf3c64b
|
|
| BLAKE2b-256 |
96f5f8b381c276606d80428b0ab9fecb63400d5e9a6dee580d4df4ca134ab16b
|
File details
Details for the file agent_first_data-0.34.0-py3-none-any.whl.
File metadata
- Download URL: agent_first_data-0.34.0-py3-none-any.whl
- Upload date:
- Size: 33.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
19e152371a1c09b0858025626b71e28e40a2569af5ab3e74882d5e08a58515c8
|
|
| MD5 |
630253de49f8c0e79366c338d834a44f
|
|
| BLAKE2b-256 |
b91df257eadbaa718b37ff2a641887e038e1ba177194758edc2df11474a0a1b4
|
