astroapi-io-client 0.2.2__tar.gz → 0.2.3__tar.gz

{astroapi_io_client-0.2.2 → astroapi_io_client-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.2
+Version: 0.2.3
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,12 +14,11 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R195 release version `astroapi-io-client==0.2.2` covers all forty-three calculation routes: forty-two standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
+The R196 source version `astroapi-io-client==0.2.3` covers all forty-four calculation routes: forty-three standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.2 is the R195 release version; package availability does not imply
-new deployed API capabilities.
+`astroapi-io-client`. Version 0.2.2 is the published R195 package; 0.2.3 is source-only and package availability never implies deployed API capabilities.
 
 Install from PyPI with `python -m pip install astroapi-io-client==0.2.2`, or from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
@@ -97,6 +96,7 @@ Type hints describe the server contract and do not perform response validation.
 | `event_rule_search` **beta** | `calculateEventRuleSearch` | bounded versioned AND/OR/NOT rules, location, and interval | validation/cost analysis plus sampled matches and windows |
 | `convention_compare` **beta** | `calculateConventionCompare` | two profiles with one birth, or two trusted signed responses | field-level differences without ranking or interpretation |
 | `chart_robustness` **beta** | `calculateChartRobustness` | unknown or approximate birth time plus 2–3 convention profiles | sampled stability classifications without rectification, ranking, or prediction |
+| `civil_time_audit` **beta** | `calculateCivilTimeAudit` | pinned place, local date/time, one explicit profile | both repeated-time chart candidates and exact 22-fact differences, or no shifted gap time |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.2 → astroapi_io_client-0.2.3}/README.md

@@ -1,11 +1,10 @@
 # AstroAPI.io Python client
 
-The R195 release version `astroapi-io-client==0.2.2` covers all forty-three calculation routes: forty-two standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
+The R196 source version `astroapi-io-client==0.2.3` covers all forty-four calculation routes: forty-three standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.2 is the R195 release version; package availability does not imply
-new deployed API capabilities.
+`astroapi-io-client`. Version 0.2.2 is the published R195 package; 0.2.3 is source-only and package availability never implies deployed API capabilities.
 
 Install from PyPI with `python -m pip install astroapi-io-client==0.2.2`, or from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
@@ -83,6 +82,7 @@ Type hints describe the server contract and do not perform response validation.
 | `event_rule_search` **beta** | `calculateEventRuleSearch` | bounded versioned AND/OR/NOT rules, location, and interval | validation/cost analysis plus sampled matches and windows |
 | `convention_compare` **beta** | `calculateConventionCompare` | two profiles with one birth, or two trusted signed responses | field-level differences without ranking or interpretation |
 | `chart_robustness` **beta** | `calculateChartRobustness` | unknown or approximate birth time plus 2–3 convention profiles | sampled stability classifications without rectification, ranking, or prediction |
+| `civil_time_audit` **beta** | `calculateCivilTimeAudit` | pinned place, local date/time, one explicit profile | both repeated-time chart candidates and exact 22-fact differences, or no shifted gap time |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.2 → astroapi_io_client-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "astroapi-io-client"
-version = "0.2.2"
+version = "0.2.3"
 description = "Synchronous Python client for the AstroAPI.io calculation gateway"
 readme = "README.md"
 license = "ISC"

{astroapi_io_client-0.2.2 → astroapi_io_client-0.2.3}/src/astroapi_client/__init__.py

@@ -17,7 +17,7 @@ from .types import (
     GeographicLocation, RelocationChartInput, AstrocartographyBody, AstrocartographyInput,
     EclipseType, EclipseGeometryInput, EclipseObserverSnapshot, EclipseEvent, EclipseGeometryResponse, MoonPhaseSector, ElectionalAspectFilter,
     ElectionalFilters, ElectionalSearchInput,
-    EventRule, EventRuleSearchInput, ConventionProfile, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput,
+    EventRule, EventRuleSearchInput, ConventionProfile, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput,
     NatalAnalysisAspectName, NatalAnalysisAspectOption, NatalAnalysisInput,
     AshtakootaInput, AshtakavargaInput, NumerologyInput, PlanetaryHoursInput,
     FixedStar, FixedStarsInput,
@@ -30,7 +30,7 @@ from .types import (
     PlaceSearchInput, TimezoneResolveInput, NatalContextInput,
 )
 
-__version__ = "0.2.2"
+__version__ = "0.2.3"
 __all__ = [
     "NumerologyInput", "verify_calculation_receipt",
     "AstroAPIClient", "AstroAPIError", "ClientBusyError", "HTTPError", "DavisonInput",
@@ -45,7 +45,7 @@ __all__ = [
     "GeographicLocation", "RelocationChartInput", "AstrocartographyBody", "AstrocartographyInput",
     "EclipseType", "EclipseGeometryInput", "EclipseObserverSnapshot", "EclipseEvent", "EclipseGeometryResponse", "MoonPhaseSector", "ElectionalAspectFilter",
     "ElectionalFilters", "ElectionalSearchInput",
-    "EventRule", "EventRuleSearchInput", "ConventionProfile", "ConventionCompareInput", "ReleaseCompareInput", "ChartRobustnessInput",
+    "EventRule", "EventRuleSearchInput", "ConventionProfile", "ConventionCompareInput", "ReleaseCompareInput", "ChartRobustnessInput", "CivilTimeAuditInput",
     "NatalAnalysisAspectName", "NatalAnalysisAspectOption", "NatalAnalysisInput",
     "AshtakootaInput", "AshtakavargaInput", "PlanetaryHoursInput",
     "FixedStar", "FixedStarsInput",

{astroapi_io_client-0.2.2 → astroapi_io_client-0.2.3}/src/astroapi_client/_validation.py

@@ -664,6 +664,18 @@ def encode_request(route: str, payload: Any) -> bytes:
         if (type(location["lat"]) not in (int, float) or not math.isfinite(location["lat"]) or abs(location["lat"]) >= 90 or type(location["lon"]) not in (int, float) or not math.isfinite(location["lon"]) or abs(location["lon"]) > 180): _invalid("event rule coordinates are outside supported bounds.")
         if "sample_minutes" in data and data["sample_minutes"] not in (15, 30, 60): _invalid("sample_minutes must be 15, 30, or 60.")
         if "validate_only" in data and type(data["validate_only"]) is not bool: _invalid("validate_only must be a boolean.")
+    elif route == "civil-time-audit":
+        _object(data, {"place_id", "date", "time", "profile"}, {"place_id", "date", "time", "profile"})
+        if type(data["place_id"]) is not str or re.fullmatch(r"geonames:[1-9][0-9]{0,11}:2026-10-02", data["place_id"]) is None:
+            _invalid("place_id must be a current versioned AstroAPI GeoNames place ID.")
+        _date(data["date"]); _time(data["time"])
+        profile = _object(data["profile"], {"zodiac", "ayanamsa", "house_system"}, {"zodiac", "house_system"})
+        _enum(profile["zodiac"], {"tropical", "sidereal"}, "zodiac must be tropical or sidereal.")
+        _enum(profile["house_system"], {"equal", "whole_sign", "placidus"}, "house_system is unsupported.")
+        if profile["zodiac"] == "tropical" and "ayanamsa" in profile:
+            _invalid("tropical profiles cannot include ayanamsa.")
+        if profile["zodiac"] == "sidereal" and ("ayanamsa" not in profile or profile["ayanamsa"] not in _AYANAMSAS):
+            _invalid("sidereal profiles require a supported ayanamsa.")
     elif route == "chart-robustness":
         _object(data, {"birth_time", "lat", "lon", "profiles"}, {"birth_time", "lat", "lon", "profiles"})
         workflow = _object(data["birth_time"], {"status", "date", "time", "timezone", "uncertainty_minutes"}, {"status"})

{astroapi_io_client-0.2.2 → astroapi_io_client-0.2.3}/src/astroapi_client/client.py

@@ -32,7 +32,7 @@ from .types import (
     MoonPhaseInput, MoonPhaseResponse, DavisonInput, PlanetaryEventsInput, PlanetaryEventsResponse,
     HouseIngressesInput, HouseIngressesResponse,
     AspectWindowsInput, AspectWindowsResponse,
-    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput,
+    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput,
     EventCalendarInput, SynastrySvgInput, TransitSvgInput, NatalReportInput,
     BirthTimeSensitivityInput, RelocationChartInput, AstrocartographyInput,
     PlaceSearchInput, TimezoneResolveInput, NatalContextInput,
@@ -181,7 +181,7 @@ def _perform(
             "Content-Type": "application/json",
             "Accept": "application/json",
             "Accept-Encoding": "identity",
-            "User-Agent": "astroapi-io-client/0.2.2",
+            "User-Agent": "astroapi-io-client/0.2.3",
             "Connection": "close",
             **({"X-AstroAPI-Receipt": "v1"} if request_receipt else {}),
         })
@@ -428,6 +428,10 @@ class AstroAPIClient:
         """BETA: separate sampled birth-time and convention sensitivity."""
         return self._request("chart-robustness", payload)
 
+    def civil_time_audit(self, payload: CivilTimeAuditInput) -> JSONResponse:
+        """BETA: never guess a repeated or nonexistent local civil time."""
+        return self._request("civil-time-audit", payload)
+
     def synastry_svg(self, payload: SynastrySvgInput) -> JSONResponse:
         """BETA: original deterministic double-wheel relationship SVG."""
         return self._request("synastry-svg", payload)

{astroapi_io_client-0.2.2 → astroapi_io_client-0.2.3}/src/astroapi_client/types.py

@@ -71,6 +71,7 @@ class TimezoneResolveInput(TypedDict):
     time: str
 
 
+
 class NatalContextInput(AspectsInput, total=False):
     house_system: Literal["equal", "whole_sign", "placidus"]
     formats: list[Literal["json", "xml", "markdown"]]
@@ -374,6 +375,13 @@ class ConventionProfile(TypedDict, total=False):
     house_system: Literal["equal", "whole_sign", "placidus"]
 
 
+class CivilTimeAuditInput(TypedDict):
+    place_id: str
+    date: str
+    time: str
+    profile: ConventionProfile
+
+
 class ReleaseCompareInput(TypedDict):
     releases: list[JSONResponse]
 

{astroapi_io_client-0.2.2 → astroapi_io_client-0.2.3}/src/astroapi_io_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.2
+Version: 0.2.3
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,12 +14,11 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R195 release version `astroapi-io-client==0.2.2` covers all forty-three calculation routes: forty-two standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
+The R196 source version `astroapi-io-client==0.2.3` covers all forty-four calculation routes: forty-three standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.2 is the R195 release version; package availability does not imply
-new deployed API capabilities.
+`astroapi-io-client`. Version 0.2.2 is the published R195 package; 0.2.3 is source-only and package availability never implies deployed API capabilities.
 
 Install from PyPI with `python -m pip install astroapi-io-client==0.2.2`, or from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
@@ -97,6 +96,7 @@ Type hints describe the server contract and do not perform response validation.
 | `event_rule_search` **beta** | `calculateEventRuleSearch` | bounded versioned AND/OR/NOT rules, location, and interval | validation/cost analysis plus sampled matches and windows |
 | `convention_compare` **beta** | `calculateConventionCompare` | two profiles with one birth, or two trusted signed responses | field-level differences without ranking or interpretation |
 | `chart_robustness` **beta** | `calculateChartRobustness` | unknown or approximate birth time plus 2–3 convention profiles | sampled stability classifications without rectification, ranking, or prediction |
+| `civil_time_audit` **beta** | `calculateCivilTimeAudit` | pinned place, local date/time, one explicit profile | both repeated-time chart candidates and exact 22-fact differences, or no shifted gap time |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.2 → astroapi_io_client-0.2.3}/tests/test_client.py

@@ -62,11 +62,13 @@ ROUTES += [
 
 RULE_INPUT = {"rule_version": 1, "start_utc": "2026-01-01T00:00:00Z", "end_utc": "2026-01-02T00:00:00Z", "location": {"lat": 0, "lon": 0}, "sample_minutes": 60, "rule": {"all": [{"fact": "planet_sign", "body": "moon", "value": "Taurus"}]}}
 CONVENTION_INPUT = {"birth": BIRTH, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
+CIVIL_TIME_AUDIT_INPUT = {"place_id": "geonames:5128581:2026-10-02", "date": "2024-11-03", "time": "01:30", "profile": {"zodiac": "tropical", "house_system": "equal"}}
 CHART_ROBUSTNESS_INPUT = {"birth_time": {"status": "approximate", "date": "2000-01-01", "time": "12:00", "timezone": "UTC", "uncertainty_minutes": 30}, "lat": 0, "lon": 0, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
 ROUTES += [
     ("event_rule_search", "event-rule-search", RULE_INPUT, {"type": "event_rule_search", "status": "beta", "rule_analysis": {}, "matching_samples": [], "sampled_candidate_windows": [], "metadata": {}}),
     ("convention_compare", "convention-compare", CONVENTION_INPUT, {"type": "convention_compare", "status": "beta", "profiles": [{}, {}], "differences": {}, "metadata": {}}),
     ("chart_robustness", "chart-robustness", CHART_ROBUSTNESS_INPUT, {"type": "chart_robustness", "status": "beta", "profiles": [{}, {}], "facts": [{} for _ in range(22)], "summary": {}, "evidence": {}, "metadata": {}}),
+    ("civil_time_audit", "civil-time-audit", CIVIL_TIME_AUDIT_INPUT, {"type": "civil_time_audit", "status": "beta", "resolution": {}, "profile": {}, "calculation_ready": False, "requires_selection": True, "candidates": [], "comparison": {}, "metadata": {}}),
 ]
 
 @contextmanager
@@ -149,11 +151,13 @@ def local_client(url, **options):
 
 RULE_INPUT = {"rule_version": 1, "start_utc": "2026-01-01T00:00:00Z", "end_utc": "2026-01-02T00:00:00Z", "location": {"lat": 0, "lon": 0}, "sample_minutes": 60, "rule": {"all": [{"fact": "planet_sign", "body": "moon", "value": "Taurus"}]}}
 CONVENTION_INPUT = {"birth": BIRTH, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
+CIVIL_TIME_AUDIT_INPUT = {"place_id": "geonames:5128581:2026-10-02", "date": "2024-11-03", "time": "01:30", "profile": {"zodiac": "tropical", "house_system": "equal"}}
 CHART_ROBUSTNESS_INPUT = {"birth_time": {"status": "approximate", "date": "2000-01-01", "time": "12:00", "timezone": "UTC", "uncertainty_minutes": 30}, "lat": 0, "lon": 0, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
 ROUTES += [
     ("event_rule_search", "event-rule-search", RULE_INPUT, {"type": "event_rule_search", "status": "beta", "rule_analysis": {}, "matching_samples": [], "sampled_candidate_windows": [], "metadata": {}}),
     ("convention_compare", "convention-compare", CONVENTION_INPUT, {"type": "convention_compare", "status": "beta", "profiles": [{}, {}], "differences": {}, "metadata": {}}),
     ("chart_robustness", "chart-robustness", CHART_ROBUSTNESS_INPUT, {"type": "chart_robustness", "status": "beta", "profiles": [{}, {}], "facts": [{} for _ in range(22)], "summary": {}, "evidence": {}, "metadata": {}}),
+    ("civil_time_audit", "civil-time-audit", CIVIL_TIME_AUDIT_INPUT, {"type": "civil_time_audit", "status": "beta", "resolution": {}, "profile": {}, "calculation_ready": False, "requires_selection": True, "candidates": [], "comparison": {}, "metadata": {}}),
 ]
 
 @contextmanager
@@ -409,6 +413,8 @@ class ClientTests(unittest.TestCase):
                 client.chart_robustness({**CHART_ROBUSTNESS_INPUT, "birth_time": {**CHART_ROBUSTNESS_INPUT["birth_time"], "time": "noon"}})
             with self.assertRaises(ValidationError):
                 client.chart_robustness({**CHART_ROBUSTNESS_INPUT, "profiles": [CHART_ROBUSTNESS_INPUT["profiles"][0]] * 2})
+            with self.assertRaises(ValidationError):
+                client.civil_time_audit({**CIVIL_TIME_AUDIT_INPUT, "place_id": "geonames:5128581:2020-01-01"})
 
 
     def test_request_body_limit(self):