json-tstring 0.1.0__tar.gz

json_tstring-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.3
+Name: json-tstring
+Version: 0.1.0
+Summary: JSON renderer for t-string structured data templates
+Keywords: pep750,t-strings,json,template-strings,structured-data
+Author: Koudai Aono
+Author-email: Koudai Aono <koxudaxi@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: tstring-bindings>=0.1.0
+Requires-Dist: tstring-core>=0.1.0
+Maintainer: Koudai Aono
+Maintainer-email: Koudai Aono <koxudaxi@gmail.com>
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/koxudaxi/tstring-structured-data
+Project-URL: Repository, https://github.com/koxudaxi/tstring-structured-data
+Project-URL: Documentation, https://github.com/koxudaxi/tstring-structured-data/blob/main/json-tstring/README.md
+Project-URL: Changelog, https://github.com/koxudaxi/tstring-structured-data/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/koxudaxi/tstring-structured-data/issues
+Description-Content-Type: text/markdown
+
+# json-tstring
+
+JSON rendering for PEP 750 t-strings. Parsing and rendering happen in Rust;
+this package is the Python wrapper.
+
+Requires Python 3.14+.
+
+This package depends on `tstring-bindings`, a native PyO3 extension. On
+supported platforms, install from prebuilt wheels. Other environments require a
+local Rust 1.94.0 toolchain build.
+
+## API
+
+```python
+render_data(template, profile="rfc8259")  # -> Python data
+render_text(template, profile="rfc8259")  # -> JSON text
+render_result(template, profile="rfc8259")  # -> RenderResult (.text + .data)
+```
+
+Type alias: `JsonProfile = Literal["rfc8259"]`
+
+Parsed template structure is cached per process using `template.strings` +
+profile as the key.
+
+## How it works
+
+The Python `Template` is converted to a Rust token stream, parsed into JSON
+nodes (keeping interpolation visible in values, keys, and string fragments),
+and rendered back to text or Python data. `serde_json` handles normalization.
+
+## Supported positions
+
+- whole-value, object-key, quoted-key-fragment, and string-fragment interpolation
+- bare fragments promoted to JSON strings
+- nested arrays and objects, top-level values
+
+## Limits
+
+- object keys must be `str`
+- non-finite floats rejected
+- values must be JSON-representable
+- integers keep exact Python text (no silent `float` coercion)
+
+## Verify
+
+```bash
+uv sync --group dev
+uv run --group dev pytest
+```
+
+## See also
+
+- [Project README](https://github.com/koxudaxi/tstring-structured-data#readme)
+- [Backend support matrix](https://github.com/koxudaxi/tstring-structured-data/blob/main/docs/backend-support-matrix.md)

json_tstring-0.1.0/README.md

@@ -0,0 +1,54 @@
+# json-tstring
+
+JSON rendering for PEP 750 t-strings. Parsing and rendering happen in Rust;
+this package is the Python wrapper.
+
+Requires Python 3.14+.
+
+This package depends on `tstring-bindings`, a native PyO3 extension. On
+supported platforms, install from prebuilt wheels. Other environments require a
+local Rust 1.94.0 toolchain build.
+
+## API
+
+```python
+render_data(template, profile="rfc8259")  # -> Python data
+render_text(template, profile="rfc8259")  # -> JSON text
+render_result(template, profile="rfc8259")  # -> RenderResult (.text + .data)
+```
+
+Type alias: `JsonProfile = Literal["rfc8259"]`
+
+Parsed template structure is cached per process using `template.strings` +
+profile as the key.
+
+## How it works
+
+The Python `Template` is converted to a Rust token stream, parsed into JSON
+nodes (keeping interpolation visible in values, keys, and string fragments),
+and rendered back to text or Python data. `serde_json` handles normalization.
+
+## Supported positions
+
+- whole-value, object-key, quoted-key-fragment, and string-fragment interpolation
+- bare fragments promoted to JSON strings
+- nested arrays and objects, top-level values
+
+## Limits
+
+- object keys must be `str`
+- non-finite floats rejected
+- values must be JSON-representable
+- integers keep exact Python text (no silent `float` coercion)
+
+## Verify
+
+```bash
+uv sync --group dev
+uv run --group dev pytest
+```
+
+## See also
+
+- [Project README](https://github.com/koxudaxi/tstring-structured-data#readme)
+- [Backend support matrix](https://github.com/koxudaxi/tstring-structured-data/blob/main/docs/backend-support-matrix.md)

json_tstring-0.1.0/pyproject.toml

@@ -0,0 +1,78 @@
+[project]
+name = "json-tstring"
+version = "0.1.0"
+description = "JSON renderer for t-string structured data templates"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Koudai Aono", email = "koxudaxi@gmail.com" }]
+maintainers = [{ name = "Koudai Aono", email = "koxudaxi@gmail.com" }]
+requires-python = ">=3.14"
+dependencies = [
+    "tstring-bindings>=0.1.0",
+    "tstring-core>=0.1.0",
+]
+keywords = ["pep750", "t-strings", "json", "template-strings", "structured-data"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/koxudaxi/tstring-structured-data"
+Repository = "https://github.com/koxudaxi/tstring-structured-data"
+Documentation = "https://github.com/koxudaxi/tstring-structured-data/blob/main/json-tstring/README.md"
+Changelog = "https://github.com/koxudaxi/tstring-structured-data/blob/main/CHANGELOG.md"
+Issues = "https://github.com/koxudaxi/tstring-structured-data/issues"
+
+[build-system]
+requires = ["uv_build>=0.10.9,<0.11.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "coverage[toml]>=7.8.0",
+    "inline-snapshot>=0.32.4",
+    "pytest>=8.4.0",
+    "ruff>=0.11.0",
+    "ty>=0.0.23",
+]
+
+[tool.uv.sources]
+tstring-bindings = { workspace = true }
+tstring-core = { workspace = true }
+
+[tool.uv.build-backend]
+source-exclude = [".DS_Store", "src/json_tstring/core"]
+wheel-exclude = [".DS_Store", "src/json_tstring/core"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.inline-snapshot]
+format-command = "ruff format --stdin-filename {filename}"
+
+[tool.coverage.run]
+branch = true
+source_pkgs = ["json_tstring", "tstring_core"]
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 100
+
+[tool.ty.environment]
+extra-paths = [
+    "../rust/python-bindings/python",
+    "../tstring-core/src",
+    "../examples",
+]
+
+[tool.ruff]
+target-version = "py314"
+
+[tool.ruff.lint]
+select = ["B", "E", "F", "I"]

json_tstring-0.1.0/src/json_tstring/__init__.py

@@ -0,0 +1,21 @@
+from tstring_core import (
+    RenderResult,
+    TemplateError,
+    TemplateParseError,
+    TemplateSemanticError,
+    UnrepresentableValueError,
+)
+
+from ._runtime import JsonProfile, render_data, render_result, render_text
+
+__all__ = [
+    "JsonProfile",
+    "RenderResult",
+    "TemplateError",
+    "TemplateParseError",
+    "TemplateSemanticError",
+    "UnrepresentableValueError",
+    "render_data",
+    "render_result",
+    "render_text",
+]

json_tstring-0.1.0/src/json_tstring/_errors.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from tstring_core import (
+    TemplateError,
+    TemplateParseError,
+    TemplateSemanticError,
+    UnrepresentableValueError,
+)
+
+__all__ = [
+    "TemplateError",
+    "TemplateParseError",
+    "TemplateSemanticError",
+    "UnrepresentableValueError",
+]

json_tstring-0.1.0/src/json_tstring/_runtime.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+from string.templatelib import Template
+from typing import Literal, Protocol, TypeIs, cast
+
+from tstring_bindings import tstring_bindings as _bindings
+from tstring_core import JsonValue, RenderResult
+
+type JsonProfile = Literal["rfc8259"]
+
+_CONTRACT_VERSION = 1
+_REQUIRED_SYMBOLS = {
+    "render_json",
+    "render_json_text",
+    "_render_json_result_payload",
+}
+
+
+class _RenderJson(Protocol):
+    def __call__(self, template: Template, *, profile: JsonProfile) -> JsonValue: ...
+
+
+class _RenderJsonText(Protocol):
+    def __call__(self, template: Template, *, profile: JsonProfile) -> str: ...
+
+
+class _RenderJsonResultPayload(Protocol):
+    def __call__(
+        self, template: Template, *, profile: JsonProfile
+    ) -> tuple[str, JsonValue]: ...
+
+
+def _bind_extension() -> tuple[_RenderJson, _RenderJsonText, _RenderJsonResultPayload]:
+    version = getattr(_bindings, "__contract_version__", None)
+    if version != _CONTRACT_VERSION:
+        raise ImportError(
+            "json_tstring extension contract mismatch: "
+            f"expected version {_CONTRACT_VERSION}, got {version!r}."
+        )
+
+    exported = set(getattr(_bindings, "__contract_symbols__", ()))
+    missing = sorted(_REQUIRED_SYMBOLS - exported)
+    if missing:
+        raise ImportError(
+            "json_tstring could not bind required extension symbols: "
+            + ", ".join(missing)
+        )
+
+    return (
+        cast(_RenderJson, _bindings.render_json),
+        cast(_RenderJsonText, _bindings.render_json_text),
+        cast(_RenderJsonResultPayload, _bindings._render_json_result_payload),
+    )
+
+
+_render_json, _render_json_text, _render_json_result_payload = _bind_extension()
+
+
+def _is_template(value: object) -> TypeIs[Template]:
+    return isinstance(value, Template)
+
+
+def _validate_template(template: object, api_name: str) -> Template:
+    if _is_template(template):
+        return template
+    raise TypeError(
+        f"{api_name} requires a PEP 750 Template object. "
+        f"Got {type(template).__name__} instead."
+    )
+
+
+def _resolve_profile(profile: JsonProfile | str | None) -> JsonProfile:
+    if profile is None or profile == "rfc8259":
+        return "rfc8259"
+    raise ValueError(
+        f"Unsupported JSON profile {profile!r}. Supported profiles: 'rfc8259'."
+    )
+
+
+def render_data(
+    template: Template, *, profile: JsonProfile | str | None = None
+) -> JsonValue:
+    checked = _validate_template(template, "render_data")
+    return _render_json(checked, profile=_resolve_profile(profile))
+
+
+def render_text(template: Template, *, profile: JsonProfile | str | None = None) -> str:
+    checked = _validate_template(template, "render_text")
+    return _render_json_text(checked, profile=_resolve_profile(profile))
+
+
+def render_result(
+    template: Template, *, profile: JsonProfile | str | None = None
+) -> RenderResult[JsonValue]:
+    checked = _validate_template(template, "render_result")
+    text, data = _render_json_result_payload(checked, profile=_resolve_profile(profile))
+    return RenderResult(text=text, data=data)
+
+
+__all__ = [
+    "JsonProfile",
+    "RenderResult",
+    "render_data",
+    "render_result",
+    "render_text",
+]

json_tstring-0.1.0/src/json_tstring/_slots.py

@@ -0,0 +1,3 @@
+from tstring_core import FragmentGroup, Slot, SlotContext
+
+__all__ = ["FragmentGroup", "Slot", "SlotContext"]

json_tstring-0.1.0/src/json_tstring/py.typed

@@ -0,0 +1 @@
+# Marker file for PEP 561 typing support.