intenttext 1.0.0__tar.gz

intenttext-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install hatch
+      - run: hatch build
+      - run: pip install pytest && pytest
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

intenttext-1.0.0/.github/workflows/test.yml

@@ -0,0 +1,18 @@
+name: Test
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install -U pip
+      - run: pip install -e .[dev]
+      - run: pytest -q

intenttext-1.0.0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: intenttext
+Version: 1.0.0
+Summary: IntentText - the semantic document format that is natively JSON
+Project-URL: Homepage, https://github.com/intenttext/IntentText
+Project-URL: Repository, https://github.com/intenttext/intenttext-python
+Project-URL: Documentation, https://github.com/intenttext/IntentText/blob/main/docs/SPEC.md
+License: MIT
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# IntentText Python
+
+Python implementation of the IntentText parser and renderer.
+
+Independent implementation (not a Node.js wrapper), designed for Python workflows and AI stacks.
+
+## Install
+
+```bash
+pip install intenttext
+```
+
+## Quick Start
+
+```python
+from intenttext import parse, render_html, merge_data, validate, query
+
+# Parse a document
+source = """
+title: Sprint Planning
+section: Tasks
+task: Write tests | owner: Ahmed | due: Friday
+task: Deploy to staging | owner: Sarah | due: Monday
+gate: Final approval | approver: Lead | timeout: 24h
+""".strip()
+
+doc = parse(source)
+
+# Query for tasks
+tasks = query(doc, type="task")
+for task in tasks:
+    print(f"{task.content} -> {task.properties.get('owner', 'unassigned')}")
+
+# Validate workflow semantics
+result = validate(doc)
+if not result.valid:
+    for issue in result.issues:
+        print(f"[{issue.type.upper()}] {issue.message}")
+
+# Render to HTML
+html = render_html(doc)
+```
+
+## API
+
+- `parse(source: str) -> IntentDocument`
+- `parse_safe(source: str, ...) -> ParseResult`
+- `render_html(doc: IntentDocument, include_css: bool = True) -> str`
+- `render_print(doc: IntentDocument) -> str`
+- `render_markdown(doc: IntentDocument) -> str`
+- `merge_data(template: IntentDocument, data: dict) -> IntentDocument`
+- `parse_and_merge(template_source: str, data: dict) -> IntentDocument`
+- `validate(doc: IntentDocument) -> ValidationResult`
+- `query(doc: IntentDocument, ...) -> list[IntentBlock]`
+- `to_source(doc: IntentDocument) -> str`
+
+## Development
+
+```bash
+pip install -e .[dev]
+pytest
+```
+
+## Release (PyPI)
+
+```bash
+# 1) Ensure tests pass
+python3 -m pytest -q
+
+# 2) Build source + wheel
+python3 -m pip install -U hatch twine
+hatch build
+
+# 3) Validate package metadata and long description
+twine check dist/*
+
+# 4) Upload (interactive)
+twine upload dist/*
+```
+
+Tag-based release flow:
+
+```bash
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+GitHub Action publish workflow uses `PYPI_API_TOKEN` for automated release on `v*` tags.
+
+## License
+
+MIT

intenttext-1.0.0/README.md

@@ -0,0 +1,92 @@
+# IntentText Python
+
+Python implementation of the IntentText parser and renderer.
+
+Independent implementation (not a Node.js wrapper), designed for Python workflows and AI stacks.
+
+## Install
+
+```bash
+pip install intenttext
+```
+
+## Quick Start
+
+```python
+from intenttext import parse, render_html, merge_data, validate, query
+
+# Parse a document
+source = """
+title: Sprint Planning
+section: Tasks
+task: Write tests | owner: Ahmed | due: Friday
+task: Deploy to staging | owner: Sarah | due: Monday
+gate: Final approval | approver: Lead | timeout: 24h
+""".strip()
+
+doc = parse(source)
+
+# Query for tasks
+tasks = query(doc, type="task")
+for task in tasks:
+    print(f"{task.content} -> {task.properties.get('owner', 'unassigned')}")
+
+# Validate workflow semantics
+result = validate(doc)
+if not result.valid:
+    for issue in result.issues:
+        print(f"[{issue.type.upper()}] {issue.message}")
+
+# Render to HTML
+html = render_html(doc)
+```
+
+## API
+
+- `parse(source: str) -> IntentDocument`
+- `parse_safe(source: str, ...) -> ParseResult`
+- `render_html(doc: IntentDocument, include_css: bool = True) -> str`
+- `render_print(doc: IntentDocument) -> str`
+- `render_markdown(doc: IntentDocument) -> str`
+- `merge_data(template: IntentDocument, data: dict) -> IntentDocument`
+- `parse_and_merge(template_source: str, data: dict) -> IntentDocument`
+- `validate(doc: IntentDocument) -> ValidationResult`
+- `query(doc: IntentDocument, ...) -> list[IntentBlock]`
+- `to_source(doc: IntentDocument) -> str`
+
+## Development
+
+```bash
+pip install -e .[dev]
+pytest
+```
+
+## Release (PyPI)
+
+```bash
+# 1) Ensure tests pass
+python3 -m pytest -q
+
+# 2) Build source + wheel
+python3 -m pip install -U hatch twine
+hatch build
+
+# 3) Validate package metadata and long description
+twine check dist/*
+
+# 4) Upload (interactive)
+twine upload dist/*
+```
+
+Tag-based release flow:
+
+```bash
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+GitHub Action publish workflow uses `PYPI_API_TOKEN` for automated release on `v*` tags.
+
+## License
+
+MIT

intenttext-1.0.0/examples/basic.py

@@ -0,0 +1,27 @@
+from intenttext import parse, parse_and_merge, query, render_html, to_source, validate
+
+source = """
+title: Sprint Planning
+section: Tasks
+task: Write tests | owner: Ahmed | due: Friday
+task: Deploy to staging | owner: Sarah | due: Monday
+gate: Final approval | approver: Lead | timeout: 24h
+""".strip()
+
+doc = parse(source)
+
+tasks = query(doc, type="task")
+for task in tasks:
+    print(f"{task.content} -> {task.properties.get('owner', 'unassigned')}")
+
+validation = validate(doc)
+print("Valid:", validation.valid)
+
+html = render_html(doc)
+print("Rendered HTML length:", len(html))
+
+merged = parse_and_merge(
+    "title: Invoice {{invoice.number}}\nnote: Bill To {{client.name}}",
+    {"invoice": {"number": "2026-042"}, "client": {"name": "Acme Corp"}},
+)
+print(to_source(merged))

intenttext-1.0.0/intenttext/__init__.py

@@ -0,0 +1,39 @@
+from .merge import merge_data, parse_and_merge
+from .parser import parse, parse_safe
+from .query import query
+from .renderer import render_html, render_markdown, render_print
+from .source import to_source
+from .types import (
+    InlineSegment,
+    IntentBlock,
+    IntentDocument,
+    IntentMetadata,
+    ParseResult,
+    ParseWarning,
+    ValidationIssue,
+    ValidationResult,
+)
+from .validate import validate
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "parse",
+    "parse_safe",
+    "render_html",
+    "render_print",
+    "render_markdown",
+    "merge_data",
+    "parse_and_merge",
+    "validate",
+    "query",
+    "to_source",
+    "IntentDocument",
+    "IntentBlock",
+    "IntentMetadata",
+    "InlineSegment",
+    "ParseResult",
+    "ParseWarning",
+    "ValidationResult",
+    "ValidationIssue",
+]

intenttext-1.0.0/intenttext/merge.py

@@ -0,0 +1,85 @@
+from __future__ import annotations
+
+import re
+from copy import deepcopy
+from datetime import datetime
+from typing import Any
+
+from .parser import parse
+from .types import IntentDocument
+
+
+def merge_data(template: IntentDocument, data: dict[str, Any]) -> IntentDocument:
+    doc = deepcopy(template)
+    now = datetime.now()
+    system_vars = {
+        "timestamp": now.isoformat(),
+        "date": now.strftime("%d %B %Y"),
+        "year": str(now.year),
+    }
+    merged_data = {**system_vars, **data}
+
+    for block in doc.blocks:
+        block.content = _resolve_string(block.content, merged_data)
+        block.original_content = _resolve_string(block.original_content, merged_data)
+        block.properties = {
+            k: _resolve_string(v, merged_data) if isinstance(v, str) else v
+            for k, v in block.properties.items()
+        }
+
+    _refresh_metadata(doc)
+
+    return doc
+
+
+def parse_and_merge(template_source: str, data: dict[str, Any]) -> IntentDocument:
+    template = parse(template_source)
+    return merge_data(template, data)
+
+
+def _resolve_string(text: str, data: dict[str, Any]) -> str:
+    def replacer(match: re.Match[str]) -> str:
+        path = match.group(1).strip()
+        if path in ("page", "pages"):
+            return match.group(0)
+        value = _get_by_path(data, path)
+        return str(value) if value is not None else match.group(0)
+
+    return re.sub(r"\{\{([^}]+)\}\}", replacer, text)
+
+
+def _get_by_path(obj: Any, path: str) -> Any:
+    parts = path.split(".")
+    current = obj
+
+    for part in parts:
+        if current is None:
+            return None
+
+        if isinstance(current, list):
+            try:
+                current = current[int(part)]
+            except (ValueError, IndexError):
+                return None
+        elif isinstance(current, dict):
+            current = current.get(part)
+        else:
+            return None
+
+    return current
+
+
+def _refresh_metadata(doc: IntentDocument) -> None:
+    for block in doc.blocks:
+        if block.type == "title":
+            doc.metadata.title = block.content
+        elif block.type == "summary":
+            doc.metadata.summary = block.content
+        elif block.type == "agent":
+            doc.metadata.agent = block.content
+            if "model" in block.properties:
+                doc.metadata.model = str(block.properties["model"])
+        elif block.type == "context":
+            doc.metadata.context.update(
+                {k: str(v) for k, v in block.properties.items()}
+            )