compono 0.1.0__py3-none-any.whl

compono/__init__.py

@@ -0,0 +1,45 @@
+"""compono — agent-oriented, code-based PPTX generation library.
+
+Public exports ONLY (COMPONO_PLAN.md section 10) — resolver/validator/template
+loader stay internal, reached only through render_deck/validate.
+"""
+
+from compono.render import (
+    DeckValidationError,
+    RenderReport,
+    ValidationReport,
+    render_deck,
+    validate,
+)
+from compono.schema import (
+    Chart,
+    Deck,
+    Grid,
+    Header,
+    Image,
+    Sequence,
+    Shape,
+    Slide,
+    Stat,
+    Table,
+    Text,
+)
+
+__all__ = [
+    "Chart",
+    "Deck",
+    "DeckValidationError",
+    "Grid",
+    "Header",
+    "Image",
+    "RenderReport",
+    "Sequence",
+    "Shape",
+    "Slide",
+    "Stat",
+    "Table",
+    "Text",
+    "ValidationReport",
+    "render_deck",
+    "validate",
+]

compono/cli.py

@@ -0,0 +1,70 @@
+"""Console-script entry point mirroring the render_deck/validate verbs.
+
+    compono validate spec.json
+    compono render spec.json --template fractal -o deck.pptx
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from compono.render import DeckValidationError, render_deck, validate
+
+
+def _load_spec(path: str) -> dict:
+    return json.loads(Path(path).read_text(encoding="utf-8"))
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(prog="compono")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    validate_parser = subparsers.add_parser("validate", help="Validate a deck spec without rendering.")
+    validate_parser.add_argument("spec", help="Path to a JSON deck spec.")
+
+    render_parser = subparsers.add_parser("render", help="Render a deck spec to a .pptx file.")
+    render_parser.add_argument("spec", help="Path to a JSON deck spec.")
+    render_parser.add_argument("-o", "--output", default="deck.pptx", help="Output .pptx path.")
+    render_parser.add_argument(
+        "--template", default=None, help="Template name (reserved; the default template is used for now)."
+    )
+
+    args = parser.parse_args(argv)
+
+    if args.command == "validate":
+        spec = _load_spec(args.spec)
+        validation_report = validate(spec)
+        print(
+            json.dumps(
+                {
+                    "valid": validation_report.valid,
+                    "errors": validation_report.errors,
+                    "warnings": validation_report.warnings,
+                },
+                indent=2,
+            )
+        )
+        return 0 if validation_report.valid else 1
+
+    if args.command == "render":
+        spec = _load_spec(args.spec)
+        try:
+            render_report = render_deck(spec, args.output)
+        except DeckValidationError as exc:
+            print(json.dumps({"valid": False, "errors": exc.errors}, indent=2), file=sys.stderr)
+            return 1
+        print(
+            json.dumps(
+                {"pptx_path": str(render_report.pptx_path), "warnings": render_report.warnings}, indent=2
+            )
+        )
+        return 0
+
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

compono/primitives.py

@@ -0,0 +1,5 @@
+"""Typed builder classes (human path). Pure sugar over the pydantic schema in schema.py.
+
+Serializes to the identical dict shape the agent path (raw JSON/dict) uses —
+see COMPONO_PLAN.md section 9. Populated starting Step 1.
+"""