json-tstring 0.1.0__py3-none-any.whl

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/_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/_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/_slots.py

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

json_tstring/py.typed

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

json_tstring-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,8 @@
+json_tstring/__init__.py,sha256=hbI2b0EyxRFDoeQCw8PhmNxwJwmvRfiqkmDetGNqlm8,446
+json_tstring/_errors.py,sha256=bZp21oaGkpLPS70_eJ6jlP7Edrvf1mC6JaOB1FzG0HA,290
+json_tstring/_runtime.py,sha256=fSFQONfsYnHPUNjqLIu8QAFYNkuyGW8KPWnk3GnyR8U,3199
+json_tstring/_slots.py,sha256=V7QUPNUvo2G1IQzVXjRHvD8IQTcXI0-oOEi5lzTfXag,110
+json_tstring/py.typed,sha256=0VrMqa_u6HfLYNPxflMqTVvjIovV_taKM7nltQcS1TA,42
+json_tstring-0.1.0.dist-info/WHEEL,sha256=9sjN42GvvIkyGb9JrWAWXnA96E2dxDe0tzHzrLxUlD4,81
+json_tstring-0.1.0.dist-info/METADATA,sha256=Yqc_aJjcWu8I-zboZ5NXTKyPg6KjTz-WKJGE5v0aV8I,2884
+json_tstring-0.1.0.dist-info/RECORD,,

json_tstring-0.1.0.dist-info/WHEEL

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