codapact 0.1.0__py3-none-any.whl

codapact/schemas/generation.v1.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "CodaPact generation manifest v1",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "version": {"const": 1, "type": "integer"},
+    "contract": {
+      "type": "object", "additionalProperties": false,
+      "properties": {
+        "source": {"type": "string", "minLength": 1},
+        "type": {"const": "openapi"},
+        "allow_private": {"type": "boolean"}
+      }
+    },
+    "output": {
+      "type": "object", "additionalProperties": false,
+      "properties": {"directory": {"type": "string", "minLength": 1}}
+    },
+    "client": {
+      "type": "object", "additionalProperties": false,
+      "properties": {
+        "language": {"const": "python"},
+        "package": {"type": "string", "minLength": 1}
+      }
+    },
+    "cli": {
+      "type": "object", "additionalProperties": false,
+      "properties": {
+        "style": {"const": "argparse"},
+        "slug": {"type": "string", "minLength": 1},
+        "definition": {"type": ["string", "null"], "minLength": 1}
+      }
+    },
+    "runtime": {
+      "type": "object", "additionalProperties": false,
+      "properties": {
+        "config_directory": {"type": ["string", "null"], "minLength": 1},
+        "defaults": {
+          "type": "object", "additionalProperties": false,
+          "properties": {
+            "base_url": {"type": ["string", "null"], "minLength": 1},
+            "timeout": {"type": "number", "exclusiveMinimum": 0, "maximum": 120},
+            "allow_private": {"type": "boolean"},
+            "policy": {
+              "type": "object", "additionalProperties": false,
+              "properties": {
+                "allow": {"type": ["array", "null"], "items": {"type": "string"}},
+                "deny": {"type": "array", "items": {"type": "string"}}
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

codapact/values.py

@@ -0,0 +1,33 @@
+"""Shared data-only merge and safe naming rules."""
+
+import re
+from copy import deepcopy
+from typing import Any
+
+from codapact.errors import CodaError
+
+
+def merge(base: dict[str, Any], update: dict[str, Any]) -> dict[str, Any]:
+    """Merge maps recursively; empty maps reset, lists/scalars/null replace."""
+    result = deepcopy(base)
+    for key, value in update.items():
+        result[key] = (
+            merge(result[key], value)
+            if isinstance(value, dict) and value and isinstance(result.get(key), dict)
+            else deepcopy(value)
+        )
+    return result
+
+
+def slug_name(value: str) -> str:
+    if (
+        not re.fullmatch(r"[a-z][a-z0-9]*(?:-[a-z0-9]+)*", value)
+        or len(value) > 50
+        or re.fullmatch(r"(?:con|prn|aux|nul|com[0-9]|lpt[0-9])", value)
+    ):
+        raise CodaError("slug must be a safe lowercase name with optional hyphens")
+    return value
+
+
+def default_slug(package: str) -> str:
+    return slug_name(re.sub(r"-+", "-", package.replace("_", "-")).strip("-"))

codapact-0.1.0.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: codapact
+Version: 0.1.0
+Summary: Contracts into callable tools: pluggable API client and CLI generation.
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0.3,<7
+Requires-Dist: jsonschema>=4.25.1,<5
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/mikejhill/codapact
+Project-URL: Documentation, https://github.com/mikejhill/codapact#readme
+Project-URL: Changelog, https://github.com/mikejhill/codapact/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/mikejhill/codapact/issues
+Description-Content-Type: text/markdown
+
+# CodaPact
+
+![CodaPact wordmark](branding/wordmark.svg)
+
+**Contracts into callable tools.**
+
+This first iteration generates an installable, typed Python client and a
+scriptable CLI from a local or remote OpenAPI contract. The package, module, and
+generator CLI are named `codapact`. Install a published release with
+`uv tool install codapact`, or use the source workflow below.
+
+```powershell
+uv sync
+uv run codapact generate examples/pets.yaml --output .tmp/pets-client --package pets_client
+uv build
+uv pip install --no-deps .tmp/pets-client
+uv run pets-client --config examples/runtime.json get-pet --arg-pet-id 7
+```
+
+The example server address is intentionally inert. Override `base_url` with your
+own trusted endpoint and set the environment variable referenced by the runtime
+configuration. Tests use isolated loopback HTTP servers and synthetic credentials.
+
+```python
+from pets_client import Client
+
+client = Client(settings={"auth": {"token": {"env": "PETS_TOKEN"}}})
+pet = client.get_pet(parameters={"pet_id": 7})
+```
+
+Reusable generation values are supported with `uv run codapact generate
+--manifest examples/pets.codapact.yaml`. The resulting `pets` command discovers
+`config.json` and `auth.json` in `$XDG_CONFIG_HOME/pets` or `~/.config/pets`.
+Override its directory with `pets --config-dir PATH ...`. See the configuration
+guide for precedence, credential-file permissions, and every generation override.
+
+- [Architecture and extension contracts](docs/architecture.md)
+- [Supported features and safety boundaries](docs/support.md)
+- [CLI definition and runtime configuration](docs/configuration.md)
+- [Release process](docs/releasing.md)
+- [Verification evidence and limits](docs/verification.md)
+- [Asynchronous mutation testing and open alerts](docs/mutation.md)
+
+Run `uv run poe check` for formatting, lint, type checking, and tests. Generated
+packages depend on this runtime at the exact generator version. For unreleased
+source changes, install the local runtime wheel and generated wheel together.
+The end-to-end test proves that workflow in a fresh environment.

codapact-0.1.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+codapact/__init__.py,sha256=SUG8C-2_faK6uN3iTf_yzXGzTmIB-2mJ5vLbAnyH6qE,98
+codapact/__main__.py,sha256=kqQs8Oyeu8L_gHWlWytNCU_PgnNu-GsZEAsZxxVycvw,3828
+codapact/cli.py,sha256=XvYvKS1AqdpFgXbNDDZmET045zCbAv5PbjXG6q8MrpY,5060
+codapact/configuration.py,sha256=me9nJdA0xVANvr3OhDsUzsnvb4EsA4IHGfCNSF4N0ao,5414
+codapact/errors.py,sha256=QGCbVu3wZMagjMJwcdUm82yzCw5X-B9--IBr90rXEQ4,847
+codapact/generation.py,sha256=5-X1G4ABpojVBCV9ZMexx2aa0ZXSw-nlxwmtRoma1-Y,9767
+codapact/loading.py,sha256=wrNfdYDrXiU3anp8Ra2XEpPVRt--tgljUN_EANz_TPc,5116
+codapact/model.py,sha256=zBJaNBD4QWHMdc4Y-I36TIkBdeP_lHA7lUry8IJI9z8,2619
+codapact/net.py,sha256=pO9a8liTQYa848q9j5QLXOLzeGwbdpqFAx2_uhWK3hs,4067
+codapact/openapi.py,sha256=RgHDXldiyYSDTsc4iI8qz2VoVSxnMK_6mDH8-DxZk3c,13764
+codapact/profiles.py,sha256=KpbEgkd9ODFt0cqbyNfY2p5vFH4kHwWbKBaeeUTxaAs,6902
+codapact/project.py,sha256=lgdaAPo0QyXGC8S0CyjHhwEjql4yks9L8-bT6cRHpJE,6169
+codapact/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codapact/runtime.py,sha256=tFmCLRjaTVxd7kDb9hWhp8NWcRlyiiPlOT8f7n3mogA,12472
+codapact/schemas/generation.v1.json,sha256=M9wnzLs57uJcq5GUpq3WcDbPuxNmb29zLFXiuZOZ-M0,1910
+codapact/values.py,sha256=9BM0-7kIUHrOuhWXhFo3TZ0UXibFDYrR5jQBJPvw5kc,1023
+codapact-0.1.0.dist-info/licenses/LICENSE,sha256=MrM1ktUwGhqY5Eq9uprukyzAi7-UApuuTroNfjlRxPA,1066
+codapact-0.1.0.dist-info/WHEEL,sha256=3NO1oYsF7mANFUWVdyEQLM-zmecczWWEmmF5rEbXrWk,80
+codapact-0.1.0.dist-info/entry_points.txt,sha256=XQ7lpiFJgOGEAV_mJP1B_BHsJ_Epd-rDPz-shmvpLdI,53
+codapact-0.1.0.dist-info/METADATA,sha256=Bp4SQD4AUChvXw6beiCDnF6X7b-BFGEWxD_pnWWBE2w,2684
+codapact-0.1.0.dist-info/RECORD,,

codapact-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.13.6
+Root-Is-Purelib: true
+Tag: py3-none-any

codapact-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+codapact = codapact.__main__:main
+

codapact-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mike Hill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.