thtml-tstring 0.1.0__py3-none-any.whl

thtml_tstring/__init__.py

@@ -0,0 +1,41 @@
+from ._bindings import (
+    CompiledThtmlTemplate,
+    Fragment,
+    RawHtml,
+    Renderable,
+    TemplateError,
+    TemplateParseError,
+    TemplateRuntimeError,
+    TemplateSemanticError,
+)
+from ._runtime import (
+    ThtmlTemplate,
+    check_template,
+    compile_template,
+    component,
+    format_template,
+    html,
+    render_html,
+    spread,
+    thtml,
+)
+
+__all__ = [
+    "CompiledThtmlTemplate",
+    "Fragment",
+    "RawHtml",
+    "Renderable",
+    "TemplateError",
+    "TemplateParseError",
+    "TemplateRuntimeError",
+    "TemplateSemanticError",
+    "ThtmlTemplate",
+    "check_template",
+    "compile_template",
+    "component",
+    "format_template",
+    "html",
+    "render_html",
+    "spread",
+    "thtml",
+]

thtml_tstring/_bindings.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+try:
+    import tstring_html_bindings as _bindings
+except ImportError:  # pragma: no cover
+    from tstring_html_bindings import _bindings  # type: ignore[attr-defined]
+
+TemplateError = _bindings.TemplateError
+TemplateParseError = _bindings.TemplateParseError
+TemplateSemanticError = _bindings.TemplateSemanticError
+TemplateRuntimeError = _bindings.TemplateRuntimeError
+Fragment = _bindings.Fragment
+RawHtml = _bindings.RawHtml
+Renderable = _bindings.Renderable
+CompiledThtmlTemplate = _bindings.CompiledThtmlTemplate
+
+check_thtml_template = _bindings.check_thtml_template
+format_thtml_template = _bindings.format_thtml_template
+compile_thtml_template = _bindings.compile_thtml_template
+render_thtml_template = _bindings.render_thtml_template
+
+__all__ = [
+    "CompiledThtmlTemplate",
+    "Fragment",
+    "RawHtml",
+    "Renderable",
+    "TemplateError",
+    "TemplateParseError",
+    "TemplateRuntimeError",
+    "TemplateSemanticError",
+    "check_thtml_template",
+    "compile_thtml_template",
+    "format_thtml_template",
+    "render_thtml_template",
+]

thtml_tstring/_runtime.py

@@ -0,0 +1,181 @@
+from __future__ import annotations
+
+import sys
+from functools import wraps
+from string.templatelib import Template
+from typing import Annotated, Any, Callable, Mapping, TypeIs, TypeVar, cast
+
+from . import _bindings
+from ._bindings import CompiledThtmlTemplate, Renderable, TemplateRuntimeError
+
+type ThtmlTemplate = Annotated[Template, "thtml"]
+ComponentT = TypeVar("ComponentT", bound=Callable[..., object])
+
+
+def _is_template(value: object) -> TypeIs[Template]:
+    return isinstance(value, Template)
+
+
+def _is_renderable(value: object) -> TypeIs[Renderable]:
+    return isinstance(value, Renderable)
+
+
+def _validate_template(template: object, api_name: str) -> ThtmlTemplate:
+    if _is_template(template):
+        return template
+    raise TypeError(
+        f"{api_name} requires a PEP 750 Template object. "
+        f"Got {type(template).__name__} instead."
+    )
+
+
+def _capture_scope(
+    globals: Mapping[str, Any] | None,
+    locals: Mapping[str, Any] | None,
+    *,
+    frame_depth: int,
+) -> tuple[dict[str, Any], dict[str, Any]]:
+    if globals is not None and locals is not None:
+        return dict(globals), dict(locals)
+
+    try:
+        frame = sys._getframe(frame_depth)
+    except AttributeError, ValueError:
+        raise TemplateRuntimeError(
+            "Caller-frame inspection failed. Pass globals= or locals= explicitly."
+        ) from None
+
+    captured_globals = dict(globals) if globals is not None else dict(frame.f_globals)
+    captured_locals = dict(locals) if locals is not None else dict(frame.f_locals)
+    return captured_globals, captured_locals
+
+
+def _make_thtml_renderable(
+    template: object,
+    *,
+    globals: Mapping[str, Any] | None,
+    locals: Mapping[str, Any] | None,
+    frame_depth: int,
+    api_name: str,
+) -> Renderable:
+    checked = _validate_template(template, api_name)
+    captured_globals, captured_locals = _capture_scope(
+        globals,
+        locals,
+        frame_depth=frame_depth,
+    )
+    return Renderable(
+        "thtml",
+        checked,
+        globals=captured_globals,
+        locals=captured_locals,
+    )
+
+
+def component(
+    func: ComponentT | None = None,
+    *,
+    backend: str = "thtml",
+) -> ComponentT | Callable[[ComponentT], ComponentT]:
+    if backend not in {"thtml", "html"}:
+        raise ValueError("component backend must be 'thtml' or 'html'.")
+
+    def decorator(inner: ComponentT) -> ComponentT:
+        @wraps(inner)
+        def wrapped(*args: Any, **kwargs: Any) -> object:
+            result = inner(*args, **kwargs)
+            if _is_template(result):
+                if backend == "thtml":
+                    return _make_thtml_renderable(
+                        result,
+                        globals=cast(Mapping[str, Any], inner.__globals__),
+                        locals={},
+                        frame_depth=0,
+                        api_name="component",
+                    )
+                from html_tstring import html as html_renderable
+
+                return html_renderable(result)
+            return result
+
+        return cast(ComponentT, wrapped)
+
+    if func is None:
+        return decorator
+    return decorator(func)
+
+
+def spread(value: Mapping[str, Any]) -> Mapping[str, Any]:
+    return value
+
+
+def check_template(template: ThtmlTemplate) -> None:
+    _bindings.check_thtml_template(_validate_template(template, "check_template"))
+
+
+def format_template(template: ThtmlTemplate) -> str:
+    checked = _validate_template(template, "format_template")
+    return _bindings.format_thtml_template(checked)
+
+
+def compile_template(template: ThtmlTemplate) -> CompiledThtmlTemplate:
+    checked = _validate_template(template, "compile_template")
+    return _bindings.compile_thtml_template(checked)
+
+
+def thtml(
+    template: ThtmlTemplate,
+    *,
+    globals: Mapping[str, Any] | None = None,
+    locals: Mapping[str, Any] | None = None,
+) -> Renderable:
+    return _make_thtml_renderable(
+        template,
+        globals=globals,
+        locals=locals,
+        frame_depth=3,
+        api_name="thtml",
+    )
+
+
+def render_html(
+    template: ThtmlTemplate | Renderable,
+    *,
+    globals: Mapping[str, Any] | None = None,
+    locals: Mapping[str, Any] | None = None,
+) -> str:
+    if _is_renderable(template):
+        return cast(Renderable, template).render()
+
+    checked = _validate_template(template, "render_html")
+    captured_globals, captured_locals = _capture_scope(
+        globals,
+        locals,
+        frame_depth=2,
+    )
+    return _bindings.render_thtml_template(
+        checked,
+        globals=captured_globals,
+        locals=captured_locals,
+    )
+
+
+def html(
+    template: ThtmlTemplate | Renderable,
+    *,
+    globals: Mapping[str, Any] | None = None,
+    locals: Mapping[str, Any] | None = None,
+) -> str:
+    if _is_renderable(template):
+        return cast(Renderable, template).render()
+    checked = _validate_template(template, "html")
+    captured_globals, captured_locals = _capture_scope(
+        globals,
+        locals,
+        frame_depth=2,
+    )
+    return _bindings.render_thtml_template(
+        checked,
+        globals=captured_globals,
+        locals=captured_locals,
+    )

thtml_tstring/py.typed

@@ -0,0 +1 @@
+

thtml_tstring-0.1.0.dist-info/METADATA

@@ -0,0 +1,42 @@
+Metadata-Version: 2.3
+Name: thtml-tstring
+Version: 0.1.0
+Summary: T-HTML renderer for PEP 750 template strings
+Keywords: html,pep750,t-strings,template-strings,thtml
+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-html-bindings>=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-html
+Project-URL: Repository, https://github.com/koxudaxi/tstring-html
+Project-URL: Documentation, https://github.com/koxudaxi/tstring-html/blob/main/thtml-tstring/README.md
+Project-URL: Changelog, https://github.com/koxudaxi/tstring-html/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/koxudaxi/tstring-html/issues
+Description-Content-Type: text/markdown
+
+# thtml-tstring
+
+Higher-level T-HTML renderer for PEP 750 template strings.
+
+```python
+from thtml_tstring import component, thtml
+
+@component
+def Button(*, children: str, kind: str = "primary"):
+    classes = [kind]
+    return t'<button class="{classes}">{children}</button>'
+
+label = "Save"
+page = thtml(t"<Button kind='primary'>{label}</Button>")
+assert page.render() == '<button class="primary">Save</button>'
+```

thtml_tstring-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+thtml_tstring/__init__.py,sha256=E2cjwA0Rku0cDFAtKchEDJzwRAVOpryuz3tz9lUwWiI,728
+thtml_tstring/_bindings.py,sha256=T_kY16PsDTiMjYrpc6YUiq9gzlwAV9zDlx9_CcNVFBc,1092
+thtml_tstring/_runtime.py,sha256=cuLwZXQpzQKob_JcppnvVMM7bgPJFcThBxwi30BA3Oc,5152
+thtml_tstring/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+thtml_tstring-0.1.0.dist-info/WHEEL,sha256=GuAqCqoyQuys5_R4zkHUJFlKXw4RpRLNzo31-ui90WQ,81
+thtml_tstring-0.1.0.dist-info/METADATA,sha256=tWifaUE1fDL-NlYvs0SiWbwYkJt4TaKI1fgziqbQ5IM,1603
+thtml_tstring-0.1.0.dist-info/RECORD,,

thtml_tstring-0.1.0.dist-info/WHEEL

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