without-html 0.0.0__tar.gz → 0.0.6__tar.gz

without_html-0.0.6/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: without-html
+Version: 0.0.6
+Summary: HTML as immutable Python values: build a node tree, render it to a string.
+Author: Josh Karpel
+Author-email: Josh Karpel <josh.karpel@gmail.com>
+License-Expression: MIT
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Dist: markupsafe>=3
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# without-html
+
+HTML as immutable Python values. Build a node tree with plain function calls,
+render it to a string with a pure function. No template language, no loader
+search path, no ambient application object, and no dependency on anything else in
+the workspace: this is a value library that happens to be useful next to
+[`without-web`](../without_web).
+
+```python
+from without_asgi import Response, html_content
+from without_html import render, table, tbody, td, th, thead, tr
+
+
+def runs_table(runs):  # a component is a function that returns a node
+    return table(
+        cls=["table", "table-striped"],
+        children=[
+            thead(children=tr(children=[th(children="run"), th(children="status")])),
+            tbody(children=(run_row(run) for run in runs)),
+        ],
+    )
+
+
+def run_row(run):
+    return tr(attrs={"id": f"run-{run.id}"}, children=[td(children=run.id), td(children=run.status)])
+
+
+Response.from_content(200, html_content(render(runs_table(runs))))
+```
+
+Escaping is a type rather than a setting: text is escaped on the way in, and
+`Markup` (MarkupSafe's own, kept under its own name, so anything Jinja or tdom
+produced is already one) is the only thing that renders verbatim. The element
+constructors carry HTML's own constraints in their signatures, so a void element
+with children and an unescaped `<script>` body are type errors rather than runtime
+surprises.
+
+`render` returns the whole string; `render_chunks` walks the same tree and yields
+the same bytes a chunk at a time, so a large page starts reaching a client while
+the rest of it is still being built.
+
+The tree is the interface, not the string: a component can be rendered whole for a
+page or on its own for a fragment, and syntax sugar can be layered on later without
+changing anything written against it.
+
+See the
+[`without-html` guide](https://without.help/without-html/)
+(with the [API reference](https://without.help/without-html/reference/))
+for nodes and escaping, the attribute rules, custom elements, and what this
+deliberately does not do.

without_html-0.0.6/README.md

@@ -0,0 +1,50 @@
+# without-html
+
+HTML as immutable Python values. Build a node tree with plain function calls,
+render it to a string with a pure function. No template language, no loader
+search path, no ambient application object, and no dependency on anything else in
+the workspace: this is a value library that happens to be useful next to
+[`without-web`](../without_web).
+
+```python
+from without_asgi import Response, html_content
+from without_html import render, table, tbody, td, th, thead, tr
+
+
+def runs_table(runs):  # a component is a function that returns a node
+    return table(
+        cls=["table", "table-striped"],
+        children=[
+            thead(children=tr(children=[th(children="run"), th(children="status")])),
+            tbody(children=(run_row(run) for run in runs)),
+        ],
+    )
+
+
+def run_row(run):
+    return tr(attrs={"id": f"run-{run.id}"}, children=[td(children=run.id), td(children=run.status)])
+
+
+Response.from_content(200, html_content(render(runs_table(runs))))
+```
+
+Escaping is a type rather than a setting: text is escaped on the way in, and
+`Markup` (MarkupSafe's own, kept under its own name, so anything Jinja or tdom
+produced is already one) is the only thing that renders verbatim. The element
+constructors carry HTML's own constraints in their signatures, so a void element
+with children and an unescaped `<script>` body are type errors rather than runtime
+surprises.
+
+`render` returns the whole string; `render_chunks` walks the same tree and yields
+the same bytes a chunk at a time, so a large page starts reaching a client while
+the rest of it is still being built.
+
+The tree is the interface, not the string: a component can be rendered whole for a
+page or on its own for a fragment, and syntax sugar can be layered on later without
+changing anything written against it.
+
+See the
+[`without-html` guide](https://without.help/without-html/)
+(with the [API reference](https://without.help/without-html/reference/))
+for nodes and escaping, the attribute rules, custom elements, and what this
+deliberately does not do.

without_html-0.0.6/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13"]
+build-backend = "uv_build"
+
+[project]
+name = "without-html"
+version = "0.0.6"
+description = "HTML as immutable Python values: build a node tree, render it to a string."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.14"
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries",
+    "Typing :: Typed",
+]
+dependencies = ["markupsafe>=3"]
+
+[[project.authors]]
+name = "Josh Karpel"
+email = "josh.karpel@gmail.com"

without_html-0.0.6/pyproject.toml.orig

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["uv_build>=0.12.3,<0.13"]
+build-backend = "uv_build"
+
+[project]
+name = "without-html"
+version = "0.0.6"
+description = "HTML as immutable Python values: build a node tree, render it to a string."
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Josh Karpel", email = "josh.karpel@gmail.com" },
+]
+requires-python = ">=3.14"
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries",
+    "Typing :: Typed",
+]
+dependencies = [
+    "markupsafe>=3",
+]

without_html-0.0.6/src/without_html/__init__.py

@@ -0,0 +1,296 @@
+from markupsafe import Markup
+from markupsafe import escape
+
+from without_html.markup import DOCTYPE
+from without_html.markup import SupportsHtml
+from without_html.nodes import AnyElement
+from without_html.nodes import Attributes
+from without_html.nodes import AttributeValue
+from without_html.nodes import Child
+from without_html.nodes import ClassNames
+from without_html.nodes import Element
+from without_html.nodes import ElementConstructor
+from without_html.nodes import Node
+from without_html.nodes import RawTextElementConstructor
+from without_html.nodes import VoidElement
+from without_html.nodes import VoidElementConstructor
+from without_html.nodes import element
+from without_html.nodes import element_type
+from without_html.nodes import void_element_type
+from without_html.render import render
+from without_html.render import render_chunks
+
+# The element constructors are re-exported here so that `from without_html import div`
+# works; the block is generated, and isort is held off it so that the generator and the
+# formatter do not disagree about where it starts.
+# isort: off
+# [[[cog import cog; from tags import emit_imports; cog.outl(emit_imports()) ]]]
+from without_html.elements import a
+from without_html.elements import abbr
+from without_html.elements import address
+from without_html.elements import area
+from without_html.elements import article
+from without_html.elements import aside
+from without_html.elements import audio
+from without_html.elements import b
+from without_html.elements import base
+from without_html.elements import bdi
+from without_html.elements import bdo
+from without_html.elements import blockquote
+from without_html.elements import body
+from without_html.elements import br
+from without_html.elements import button
+from without_html.elements import canvas
+from without_html.elements import caption
+from without_html.elements import cite
+from without_html.elements import code
+from without_html.elements import col
+from without_html.elements import colgroup
+from without_html.elements import data
+from without_html.elements import datalist
+from without_html.elements import dd
+from without_html.elements import del_
+from without_html.elements import details
+from without_html.elements import dfn
+from without_html.elements import dialog
+from without_html.elements import div
+from without_html.elements import dl
+from without_html.elements import dt
+from without_html.elements import em
+from without_html.elements import embed
+from without_html.elements import fieldset
+from without_html.elements import figcaption
+from without_html.elements import figure
+from without_html.elements import footer
+from without_html.elements import form
+from without_html.elements import h1
+from without_html.elements import h2
+from without_html.elements import h3
+from without_html.elements import h4
+from without_html.elements import h5
+from without_html.elements import h6
+from without_html.elements import head
+from without_html.elements import header
+from without_html.elements import hgroup
+from without_html.elements import hr
+from without_html.elements import html
+from without_html.elements import i
+from without_html.elements import iframe
+from without_html.elements import img
+from without_html.elements import input_
+from without_html.elements import ins
+from without_html.elements import kbd
+from without_html.elements import label
+from without_html.elements import legend
+from without_html.elements import li
+from without_html.elements import link
+from without_html.elements import main
+from without_html.elements import map_
+from without_html.elements import mark
+from without_html.elements import menu
+from without_html.elements import meta
+from without_html.elements import meter
+from without_html.elements import nav
+from without_html.elements import noembed
+from without_html.elements import noframes
+from without_html.elements import noscript
+from without_html.elements import object_
+from without_html.elements import ol
+from without_html.elements import optgroup
+from without_html.elements import option
+from without_html.elements import output
+from without_html.elements import p
+from without_html.elements import picture
+from without_html.elements import pre
+from without_html.elements import progress
+from without_html.elements import q
+from without_html.elements import rp
+from without_html.elements import rt
+from without_html.elements import ruby
+from without_html.elements import s
+from without_html.elements import samp
+from without_html.elements import script
+from without_html.elements import search
+from without_html.elements import section
+from without_html.elements import select
+from without_html.elements import slot
+from without_html.elements import small
+from without_html.elements import source
+from without_html.elements import span
+from without_html.elements import strong
+from without_html.elements import style
+from without_html.elements import sub
+from without_html.elements import summary
+from without_html.elements import sup
+from without_html.elements import svg
+from without_html.elements import table
+from without_html.elements import tbody
+from without_html.elements import td
+from without_html.elements import template
+from without_html.elements import textarea
+from without_html.elements import tfoot
+from without_html.elements import th
+from without_html.elements import thead
+from without_html.elements import time
+from without_html.elements import title
+from without_html.elements import tr
+from without_html.elements import track
+from without_html.elements import u
+from without_html.elements import ul
+from without_html.elements import var
+from without_html.elements import video
+from without_html.elements import wbr
+from without_html.elements import xmp
+# [[[end]]]
+# isort: on
+
+__all__ = [
+    # [[[cog
+    # import cog
+    # from tags import emit_names
+    # cog.outl(emit_names([
+    #     "DOCTYPE", "AttributeValue", "Attributes", "Child", "ClassNames", "Element",
+    #     "Node", "Markup", "SupportsHtml", "AnyElement", "VoidElement",
+    #     "ElementConstructor", "RawTextElementConstructor", "VoidElementConstructor",
+    #     "element", "element_type", "void_element_type",
+    #     "escape", "render", "render_chunks",
+    # ]))
+    # ]]]
+    "DOCTYPE",
+    "AnyElement",
+    "AttributeValue",
+    "Attributes",
+    "Child",
+    "ClassNames",
+    "Element",
+    "ElementConstructor",
+    "Markup",
+    "Node",
+    "RawTextElementConstructor",
+    "SupportsHtml",
+    "VoidElement",
+    "VoidElementConstructor",
+    "a",
+    "abbr",
+    "address",
+    "area",
+    "article",
+    "aside",
+    "audio",
+    "b",
+    "base",
+    "bdi",
+    "bdo",
+    "blockquote",
+    "body",
+    "br",
+    "button",
+    "canvas",
+    "caption",
+    "cite",
+    "code",
+    "col",
+    "colgroup",
+    "data",
+    "datalist",
+    "dd",
+    "del_",
+    "details",
+    "dfn",
+    "dialog",
+    "div",
+    "dl",
+    "dt",
+    "element",
+    "element_type",
+    "em",
+    "embed",
+    "escape",
+    "fieldset",
+    "figcaption",
+    "figure",
+    "footer",
+    "form",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "head",
+    "header",
+    "hgroup",
+    "hr",
+    "html",
+    "i",
+    "iframe",
+    "img",
+    "input_",
+    "ins",
+    "kbd",
+    "label",
+    "legend",
+    "li",
+    "link",
+    "main",
+    "map_",
+    "mark",
+    "menu",
+    "meta",
+    "meter",
+    "nav",
+    "noembed",
+    "noframes",
+    "noscript",
+    "object_",
+    "ol",
+    "optgroup",
+    "option",
+    "output",
+    "p",
+    "picture",
+    "pre",
+    "progress",
+    "q",
+    "render",
+    "render_chunks",
+    "rp",
+    "rt",
+    "ruby",
+    "s",
+    "samp",
+    "script",
+    "search",
+    "section",
+    "select",
+    "slot",
+    "small",
+    "source",
+    "span",
+    "strong",
+    "style",
+    "sub",
+    "summary",
+    "sup",
+    "svg",
+    "table",
+    "tbody",
+    "td",
+    "template",
+    "textarea",
+    "tfoot",
+    "th",
+    "thead",
+    "time",
+    "title",
+    "tr",
+    "track",
+    "u",
+    "ul",
+    "var",
+    "video",
+    "void_element_type",
+    "wbr",
+    "xmp",
+    # [[[end]]]
+]