agent-first-data 0.13.1__tar.gz → 0.13.2__tar.gz

{agent_first_data-0.13.1 → agent_first_data-0.13.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-first-data
-Version: 0.13.1
+Version: 0.13.2
 Summary: A naming convention that lets AI agents understand your data without being told what it means.
 License-Expression: MIT
 Project-URL: Repository, https://github.com/agentfirstkit/agent-first-data
@@ -29,7 +29,7 @@ print(output_json(value))
 print(output_plain(value))
 ```
 
-Useful names use Python casing: `output_json`, `output_yaml`, `output_plain`, `output_json_with_options`, `redacted_value`, `redact_secrets_in_place`, `redact_url_secrets`, `parse_size`, `normalize_utc_offset`, `cli_parse_output`, `cli_output`, `build_cli_error`, `build_cli_version`, and `cli_handle_version_or_continue`.
+Useful names use Python casing: `output_json`, `output_yaml`, `output_plain`, `output_json_with_options`, `redacted_value`, `redact_secrets_in_place`, `redact_url_secrets`, `parse_size`, `normalize_utc_offset`, `is_valid_rfc3339_date`, `is_valid_rfc3339_time`, `cli_parse_output`, `cli_output`, `build_cli_error`, `build_cli_version`, and `cli_handle_version_or_continue`.
 
 Logging is available through `init_logging_json`, `init_logging_plain`, `init_logging_yaml`, `span`, and `get_logger`.
 

{agent_first_data-0.13.1 → agent_first_data-0.13.2}/README.md

@@ -20,7 +20,7 @@ print(output_json(value))
 print(output_plain(value))
 ```
 
-Useful names use Python casing: `output_json`, `output_yaml`, `output_plain`, `output_json_with_options`, `redacted_value`, `redact_secrets_in_place`, `redact_url_secrets`, `parse_size`, `normalize_utc_offset`, `cli_parse_output`, `cli_output`, `build_cli_error`, `build_cli_version`, and `cli_handle_version_or_continue`.
+Useful names use Python casing: `output_json`, `output_yaml`, `output_plain`, `output_json_with_options`, `redacted_value`, `redact_secrets_in_place`, `redact_url_secrets`, `parse_size`, `normalize_utc_offset`, `is_valid_rfc3339_date`, `is_valid_rfc3339_time`, `cli_parse_output`, `cli_output`, `build_cli_error`, `build_cli_version`, and `cli_handle_version_or_continue`.
 
 Logging is available through `init_logging_json`, `init_logging_plain`, `init_logging_yaml`, `span`, and `get_logger`.
 

{agent_first_data-0.13.1 → agent_first_data-0.13.2}/agent_first_data/__init__.py

@@ -24,6 +24,8 @@ from agent_first_data.format import (
     redact_url_secrets_with_options,
     parse_size,
     normalize_utc_offset,
+    is_valid_rfc3339_date,
+    is_valid_rfc3339_time,
 )
 
 from agent_first_data.afdata_logging import (
@@ -87,6 +89,8 @@ __all__ = [
     "redact_url_secrets_with_options",
     "parse_size",
     "normalize_utc_offset",
+    "is_valid_rfc3339_date",
+    "is_valid_rfc3339_time",
     "AfdataHandler",
     "init_logging_json",
     "init_logging_plain",

{agent_first_data-0.13.1 → agent_first_data-0.13.2}/agent_first_data/format.py

@@ -1,10 +1,10 @@
 """AFDATA output formatting and protocol templates.
 
-19 public APIs and 4 types: protocol builders, value redactors (copy and
+21 public APIs and 4 types: protocol builders, value redactors (copy and
 in-place; cover _secret and _url fields), output formatters, URL-string
 redactors (redact_url_secrets / _with_options), parse_size,
-normalize_utc_offset, RedactionPolicy, RedactionOptions, OutputStyle, and
-OutputOptions.
+normalize_utc_offset, is_valid_rfc3339_date, is_valid_rfc3339_time,
+RedactionPolicy, RedactionOptions, OutputStyle, and OutputOptions.
 """
 
 from __future__ import annotations
@@ -293,6 +293,38 @@ def normalize_utc_offset(value: str) -> str | None:
     return f"{s[0]}{hours:02d}:{minutes:02d}"
 
 
+def is_valid_rfc3339_date(value: str) -> bool:
+    """Return true when value is an RFC 3339 full-date (YYYY-MM-DD)."""
+    if not isinstance(value, str):
+        return False
+    if len(value) != 10 or value[4] != "-" or value[7] != "-":
+        return False
+    year = _parse_ascii_int(value[0:4])
+    month = _parse_ascii_int(value[5:7])
+    day = _parse_ascii_int(value[8:10])
+    if year is None or month is None or day is None:
+        return False
+    return 1 <= month <= 12 and 1 <= day <= _days_in_month(year, month)
+
+
+def is_valid_rfc3339_time(value: str) -> bool:
+    """Return true when value is an RFC 3339 partial-time (HH:MM:SS[.fraction])."""
+    if not isinstance(value, str):
+        return False
+    if len(value) < 8 or value[2] != ":" or value[5] != ":":
+        return False
+    hour = _parse_ascii_int(value[0:2])
+    minute = _parse_ascii_int(value[3:5])
+    second = _parse_ascii_int(value[6:8])
+    if hour is None or minute is None or second is None:
+        return False
+    if hour > 23 or minute > 59 or second > 59:
+        return False
+    if len(value) == 8:
+        return True
+    return value[8] == "." and len(value) > 9 and value[9:].isdigit()
+
+
 def _parse_utc_offset_body(body: str) -> tuple[int, int] | None:
     if not body:
         return None
@@ -315,6 +347,26 @@ def _parse_utc_offset_body(body: str) -> tuple[int, int] | None:
     return None
 
 
+def _parse_ascii_int(value: str) -> int | None:
+    if not value or not (value.isascii() and value.isdigit()):
+        return None
+    return int(value)
+
+
+def _days_in_month(year: int, month: int) -> int:
+    if month in (1, 3, 5, 7, 8, 10, 12):
+        return 31
+    if month in (4, 6, 9, 11):
+        return 30
+    if month == 2:
+        return 29 if _is_leap_year(year) else 28
+    return 0
+
+
+def _is_leap_year(year: int) -> bool:
+    return year % 4 == 0 and (year % 100 != 0 or year % 400 == 0)
+
+
 # ═══════════════════════════════════════════
 # Secret Redaction
 # ═══════════════════════════════════════════

{agent_first_data-0.13.1 → agent_first_data-0.13.2}/agent_first_data.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-first-data
-Version: 0.13.1
+Version: 0.13.2
 Summary: A naming convention that lets AI agents understand your data without being told what it means.
 License-Expression: MIT
 Project-URL: Repository, https://github.com/agentfirstkit/agent-first-data
@@ -29,7 +29,7 @@ print(output_json(value))
 print(output_plain(value))
 ```
 
-Useful names use Python casing: `output_json`, `output_yaml`, `output_plain`, `output_json_with_options`, `redacted_value`, `redact_secrets_in_place`, `redact_url_secrets`, `parse_size`, `normalize_utc_offset`, `cli_parse_output`, `cli_output`, `build_cli_error`, `build_cli_version`, and `cli_handle_version_or_continue`.
+Useful names use Python casing: `output_json`, `output_yaml`, `output_plain`, `output_json_with_options`, `redacted_value`, `redact_secrets_in_place`, `redact_url_secrets`, `parse_size`, `normalize_utc_offset`, `is_valid_rfc3339_date`, `is_valid_rfc3339_time`, `cli_parse_output`, `cli_output`, `build_cli_error`, `build_cli_version`, and `cli_handle_version_or_continue`.
 
 Logging is available through `init_logging_json`, `init_logging_plain`, `init_logging_yaml`, `span`, and `get_logger`.
 

{agent_first_data-0.13.1 → agent_first_data-0.13.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-first-data"
-version = "0.13.1"
+version = "0.13.2"
 description = "A naming convention that lets AI agents understand your data without being told what it means."
 license = "MIT"
 readme = "README.md"

{agent_first_data-0.13.1 → agent_first_data-0.13.2}/tests/test_format.py

@@ -25,6 +25,8 @@ from agent_first_data import (
     output_plain,
     output_plain_with_options,
     normalize_utc_offset,
+    is_valid_rfc3339_date,
+    is_valid_rfc3339_time,
 )
 from agent_first_data.format import (
     _format_bytes_human,
@@ -149,6 +151,12 @@ def test_helper_fixtures():
             elif name == "normalize_utc_offset":
                 got = normalize_utc_offset(inp)
                 assert got == expected, f"[helpers/{name}({inp!r})] got {got!r}"
+            elif name == "is_valid_rfc3339_date":
+                got = is_valid_rfc3339_date(inp)
+                assert got == expected, f"[helpers/{name}({inp!r})] got {got!r}"
+            elif name == "is_valid_rfc3339_time":
+                got = is_valid_rfc3339_time(inp)
+                assert got == expected, f"[helpers/{name}({inp!r})] got {got!r}"
 
 
 def test_output_format_fixtures():