hyperclass 0.0.3__tar.gz → 0.0.4__tar.gz

{hyperclass-0.0.3 → hyperclass-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperclass
-Version: 0.0.3
+Version: 0.0.4
 Summary: Build interactive web applications as Python class hierarchies.
 Author: Grant Jenks
 License-Expression: Apache-2.0
@@ -50,7 +50,7 @@ from dataclasses import dataclass
 
 from hyperclass import (
     App, button, css, div, form, get, grid, hx, input, outer_morph,
-    post, rem,
+    name, post, rem,
 )
 
 
@@ -64,11 +64,17 @@ class card(div):
     )
 
 
+class guest_name(input):
+    name = name.name
+    placeholder = "Your name"
+    required = True
+
+
 class guest_form(form):
     style = css(display=grid, gap=.75 * rem)
 
     def content(self):
-        yield input(name="name", placeholder="Your name", required=True)
+        yield guest_name()
         yield button("Say hello", type="submit")
 
 
@@ -179,6 +185,39 @@ class greeting(card):
 Text and attribute values are escaped by default. `markup(...)` is the explicit
 escape hatch for trusted HTML.
 
+## HTML attributes inherit too
+
+Non-private class values become default HTML attributes:
+
+~~~python
+from hyperclass import a, input, name
+
+
+class external_link(a):
+    target = "_blank"
+    rel = "noreferrer"
+
+
+class url_field(input):
+    type = "url"
+    name = name.url
+    required = True
+    autocomplete = "url"
+~~~
+
+The defaults follow the same base-to-derived order as styles. Subclasses and
+multiple-inheritance mixins can override them. Attributes passed to an instance
+win last:
+
+~~~python
+external_link("Same tab", href="/", target="_self", rel=None)
+~~~
+
+`None` and `False` suppress an inherited attribute. Underscores in Python names
+become hyphens, so `aria_label` renders as `aria-label`. Boolean `True` renders
+as a valueless HTML attribute. An `hx = hx.get(...)` class default expands into
+the corresponding htmx attributes.
+
 ## CSS is Python too
 
 Base styles, pseudo-states, and media rules live on the component:
@@ -203,7 +242,7 @@ class primary_button(button):
 Pages collect only the rules used by their element tree. Python inheritance and
 the CSS cascade cooperate instead of imitating one another.
 
-## Classes and IDs are selectors
+## Classes, IDs, and names are selectors
 
 Classes can be used directly anywhere a selector is expected:
 
@@ -226,6 +265,19 @@ assert id.unread_count is id.unread_count
 As an HTML attribute, `id.unread_count` renders as `unread-count`. As a
 selector, it renders as `#unread-count`.
 
+Form names work the same way while preserving Python underscores:
+
+~~~python
+from hyperclass import name
+
+input(name=name.search_query)
+request.form[name.search_query]
+hx.get(search, include=name.search_query, target=id.results)
+~~~
+
+As an attribute, `name.search_query` renders as `search_query`. As a selector,
+it renders as `[name="search_query"]`. Repeated access returns the same object.
+
 ## Routes are references, not strings
 
 Application subclasses collect decorated method routes:
@@ -286,6 +338,7 @@ return a more specific `Response`.
 
 The underlying values remain available as `request.form`, `request.query`,
 `.get(...)`, `.getlist(...)`, and `.int(...)` when explicit parsing is clearer.
+Those accessors accept first-class `name.*` objects as well as strings.
 
 ## WSGI and htmx 4
 

{hyperclass-0.0.3 → hyperclass-0.0.4}/README.md

@@ -20,7 +20,7 @@ from dataclasses import dataclass
 
 from hyperclass import (
     App, button, css, div, form, get, grid, hx, input, outer_morph,
-    post, rem,
+    name, post, rem,
 )
 
 
@@ -34,11 +34,17 @@ class card(div):
     )
 
 
+class guest_name(input):
+    name = name.name
+    placeholder = "Your name"
+    required = True
+
+
 class guest_form(form):
     style = css(display=grid, gap=.75 * rem)
 
     def content(self):
-        yield input(name="name", placeholder="Your name", required=True)
+        yield guest_name()
         yield button("Say hello", type="submit")
 
 
@@ -149,6 +155,39 @@ class greeting(card):
 Text and attribute values are escaped by default. `markup(...)` is the explicit
 escape hatch for trusted HTML.
 
+## HTML attributes inherit too
+
+Non-private class values become default HTML attributes:
+
+~~~python
+from hyperclass import a, input, name
+
+
+class external_link(a):
+    target = "_blank"
+    rel = "noreferrer"
+
+
+class url_field(input):
+    type = "url"
+    name = name.url
+    required = True
+    autocomplete = "url"
+~~~
+
+The defaults follow the same base-to-derived order as styles. Subclasses and
+multiple-inheritance mixins can override them. Attributes passed to an instance
+win last:
+
+~~~python
+external_link("Same tab", href="/", target="_self", rel=None)
+~~~
+
+`None` and `False` suppress an inherited attribute. Underscores in Python names
+become hyphens, so `aria_label` renders as `aria-label`. Boolean `True` renders
+as a valueless HTML attribute. An `hx = hx.get(...)` class default expands into
+the corresponding htmx attributes.
+
 ## CSS is Python too
 
 Base styles, pseudo-states, and media rules live on the component:
@@ -173,7 +212,7 @@ class primary_button(button):
 Pages collect only the rules used by their element tree. Python inheritance and
 the CSS cascade cooperate instead of imitating one another.
 
-## Classes and IDs are selectors
+## Classes, IDs, and names are selectors
 
 Classes can be used directly anywhere a selector is expected:
 
@@ -196,6 +235,19 @@ assert id.unread_count is id.unread_count
 As an HTML attribute, `id.unread_count` renders as `unread-count`. As a
 selector, it renders as `#unread-count`.
 
+Form names work the same way while preserving Python underscores:
+
+~~~python
+from hyperclass import name
+
+input(name=name.search_query)
+request.form[name.search_query]
+hx.get(search, include=name.search_query, target=id.results)
+~~~
+
+As an attribute, `name.search_query` renders as `search_query`. As a selector,
+it renders as `[name="search_query"]`. Repeated access returns the same object.
+
 ## Routes are references, not strings
 
 Application subclasses collect decorated method routes:
@@ -256,6 +308,7 @@ return a more specific `Response`.
 
 The underlying values remain available as `request.form`, `request.query`,
 `.get(...)`, `.getlist(...)`, and `.int(...)` when explicit parsing is clearer.
+Those accessors accept first-class `name.*` objects as well as strings.
 
 ## WSGI and htmx 4
 

{hyperclass-0.0.3 → hyperclass-0.0.4}/hyperclass/__init__.py

@@ -62,7 +62,7 @@ from .wsgi import (
 )
 from .wsgi import delete as delete_route
 
-__version__ = "0.0.3"
+__version__ = "0.0.4"
 
 hidden = "hidden"
 submit = "submit"

{hyperclass-0.0.3 → hyperclass-0.0.4}/hyperclass/html.py

@@ -7,7 +7,7 @@ from dataclasses import dataclass
 from html import escape
 from typing import Any
 
-from .css import Media, PSEUDO_STATES, Style
+from .css import PSEUDO_STATES, Media, Style
 
 HTMX_SRC = "https://cdn.jsdelivr.net/npm/htmx.org@4.0.0"
 HTMX_INTEGRITY = (
@@ -51,6 +51,38 @@ class IdNamespace:
 id = IdNamespace()
 
 
+@dataclass(frozen=True)
+class Name:
+    """A first-class form name which is also usable as a selector."""
+
+    name: str
+
+    @property
+    def selector(self) -> str:
+        return f'[name="{self.name}"]'
+
+    def __str__(self) -> str:
+        return self.name
+
+
+class NameNamespace:
+    def __init__(self) -> None:
+        self._values: dict[str, Name] = {}
+
+    def __getattr__(self, value: str) -> Name:
+        if value.startswith("_"):
+            raise AttributeError(value)
+        try:
+            return self._values[value]
+        except KeyError:
+            field_name = Name(value)
+            self._values[value] = field_name
+            return field_name
+
+
+name = NameNamespace()
+
+
 class ElementMeta(type):
     @property
     def selector(cls) -> str:
@@ -93,12 +125,14 @@ def semantic_classes(value: type) -> tuple[type, ...]:
 def selector(value: Any) -> str:
     """Turn a selector string, element class, or element instance into CSS."""
 
-    if isinstance(value, Id):
+    if isinstance(value, (Id, Name)):
         return value.selector
     if isinstance(value, str):
         return value
     if isinstance(value, element):
-        identity = getattr(value, "_attrs", {}).get("id")
+        attributes = _class_attributes(type(value))
+        attributes.update(getattr(value, "_attrs", {}))
+        identity = attributes.get("id")
         if identity:
             return f"#{identity}"
         return selector(type(value))
@@ -183,6 +217,27 @@ def _attribute_value(value: Any) -> str:
     return str(value)
 
 
+def _attribute(target: dict[str, Any], name: str, value: Any) -> None:
+    if name == "hx" and isinstance(value, Mapping):
+        target.update(value)
+    else:
+        target[_attribute_name(name)] = value
+
+
+def _class_attributes(value: type) -> dict[str, Any]:
+    attributes: dict[str, Any] = {}
+    for semantic_class in semantic_classes(value):
+        for name, default in semantic_class.__dict__.items():
+            if name.startswith("_") or isinstance(default, (Style, Media, type)):
+                continue
+            if isinstance(default, (classmethod, staticmethod, property)):
+                continue
+            if callable(default):
+                continue
+            _attribute(attributes, name, default)
+    return attributes
+
+
 class element(metaclass=ElementMeta):
     """Base class for all rendered HTML elements."""
 
@@ -190,10 +245,7 @@ class element(metaclass=ElementMeta):
         self._children = children
         self._attrs: dict[str, Any] = {}
         for name, value in attributes.items():
-            if name == "hx" and isinstance(value, Mapping):
-                self._attrs.update(value)
-            else:
-                self._attrs[_attribute_name(name)] = value
+            _attribute(self._attrs, name, value)
 
     @property
     def selector(self) -> str:
@@ -256,7 +308,8 @@ partial = ElementMeta(
 
 
 def _render_attributes(node: element, classes: tuple[type, ...]) -> str:
-    attributes = dict(getattr(node, "_attrs", {}))
+    attributes = _class_attributes(type(node))
+    attributes.update(getattr(node, "_attrs", {}))
     generated = [class_name(value) for value in classes]
     explicit = attributes.pop("class", attributes.pop("class-", None))
     if explicit:
@@ -365,12 +418,15 @@ __all__ = [
     "Id",
     "IdNamespace",
     "Markup",
+    "Name",
+    "NameNamespace",
     "Page",
     "class_name",
     "element",
     "fragment",
     "id",
     "markup",
+    "name",
     "page",
     "partial",
     "render",

{hyperclass-0.0.3 → hyperclass-0.0.4}/hyperclass/htmx.py

@@ -66,7 +66,7 @@ class Htmx:
         for name, value in options.items():
             if value is None:
                 continue
-            if name in {"target", "select", "select_oob", "sync"}:
+            if name in {"include", "target", "select", "select_oob", "sync"}:
                 value = selector(value) if not isinstance(value, Target) else value
             values[_option_name(name)] = value
         return Attributes(values)

{hyperclass-0.0.3 → hyperclass-0.0.4}/hyperclass/wsgi.py

@@ -230,8 +230,8 @@ class Values(Mapping[str, str]):
     def __init__(self, values: Mapping[str, list[str]] | None = None):
         self._values = dict(values or {})
 
-    def __getitem__(self, key: str) -> str:
-        return self._values[key][-1]
+    def __getitem__(self, key: Any) -> str:
+        return self._values[str(key)][-1]
 
     def __iter__(self) -> Iterator[str]:
         return iter(self._values)
@@ -239,14 +239,14 @@ class Values(Mapping[str, str]):
     def __len__(self) -> int:
         return len(self._values)
 
-    def get(self, key: str, default: Any = None) -> Any:
-        values = self._values.get(key)
+    def get(self, key: Any, default: Any = None) -> Any:
+        values = self._values.get(str(key))
         return values[-1] if values else default
 
-    def getlist(self, key: str) -> list[str]:
-        return list(self._values.get(key, ()))
+    def getlist(self, key: Any) -> list[str]:
+        return list(self._values.get(str(key), ()))
 
-    def int(self, key: str, default: int | None = None) -> int:
+    def int(self, key: Any, default: int | None = None) -> int:
         value = self.get(key)
         if value is None:
             if default is not None:

{hyperclass-0.0.3 → hyperclass-0.0.4}/hyperclass.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperclass
-Version: 0.0.3
+Version: 0.0.4
 Summary: Build interactive web applications as Python class hierarchies.
 Author: Grant Jenks
 License-Expression: Apache-2.0
@@ -50,7 +50,7 @@ from dataclasses import dataclass
 
 from hyperclass import (
     App, button, css, div, form, get, grid, hx, input, outer_morph,
-    post, rem,
+    name, post, rem,
 )
 
 
@@ -64,11 +64,17 @@ class card(div):
     )
 
 
+class guest_name(input):
+    name = name.name
+    placeholder = "Your name"
+    required = True
+
+
 class guest_form(form):
     style = css(display=grid, gap=.75 * rem)
 
     def content(self):
-        yield input(name="name", placeholder="Your name", required=True)
+        yield guest_name()
         yield button("Say hello", type="submit")
 
 
@@ -179,6 +185,39 @@ class greeting(card):
 Text and attribute values are escaped by default. `markup(...)` is the explicit
 escape hatch for trusted HTML.
 
+## HTML attributes inherit too
+
+Non-private class values become default HTML attributes:
+
+~~~python
+from hyperclass import a, input, name
+
+
+class external_link(a):
+    target = "_blank"
+    rel = "noreferrer"
+
+
+class url_field(input):
+    type = "url"
+    name = name.url
+    required = True
+    autocomplete = "url"
+~~~
+
+The defaults follow the same base-to-derived order as styles. Subclasses and
+multiple-inheritance mixins can override them. Attributes passed to an instance
+win last:
+
+~~~python
+external_link("Same tab", href="/", target="_self", rel=None)
+~~~
+
+`None` and `False` suppress an inherited attribute. Underscores in Python names
+become hyphens, so `aria_label` renders as `aria-label`. Boolean `True` renders
+as a valueless HTML attribute. An `hx = hx.get(...)` class default expands into
+the corresponding htmx attributes.
+
 ## CSS is Python too
 
 Base styles, pseudo-states, and media rules live on the component:
@@ -203,7 +242,7 @@ class primary_button(button):
 Pages collect only the rules used by their element tree. Python inheritance and
 the CSS cascade cooperate instead of imitating one another.
 
-## Classes and IDs are selectors
+## Classes, IDs, and names are selectors
 
 Classes can be used directly anywhere a selector is expected:
 
@@ -226,6 +265,19 @@ assert id.unread_count is id.unread_count
 As an HTML attribute, `id.unread_count` renders as `unread-count`. As a
 selector, it renders as `#unread-count`.
 
+Form names work the same way while preserving Python underscores:
+
+~~~python
+from hyperclass import name
+
+input(name=name.search_query)
+request.form[name.search_query]
+hx.get(search, include=name.search_query, target=id.results)
+~~~
+
+As an attribute, `name.search_query` renders as `search_query`. As a selector,
+it renders as `[name="search_query"]`. Repeated access returns the same object.
+
 ## Routes are references, not strings
 
 Application subclasses collect decorated method routes:
@@ -286,6 +338,7 @@ return a more specific `Response`.
 
 The underlying values remain available as `request.form`, `request.query`,
 `.get(...)`, `.getlist(...)`, and `.int(...)` when explicit parsing is clearer.
+Those accessors accept first-class `name.*` objects as well as strings.
 
 ## WSGI and htmx 4
 

{hyperclass-0.0.3 → hyperclass-0.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hyperclass"
-version = "0.0.3"
+version = "0.0.4"
 description = "Build interactive web applications as Python class hierarchies."
 readme = "README.md"
 requires-python = ">=3.10"

{hyperclass-0.0.3 → hyperclass-0.0.4}/tests/test_bookmarks.py

@@ -55,6 +55,11 @@ def test_bookmark_lifecycle(tmp_path):
     assert "<!doctype html>" not in payload
     assert "Read this" in payload
     assert "1 unread bookmark" in payload
+    assert (
+        '<input class="text-field url-field" type="url" name="url" required'
+        in payload
+    )
+    assert 'target="_blank" rel="noreferrer"' in payload
     assert 'hx-patch="/bookmarks/1"' in payload
     bookmark = app.store.list()[0]
 

{hyperclass-0.0.3 → hyperclass-0.0.4}/tests/test_html.py

@@ -1,11 +1,15 @@
 from hyperclass import (
     Page,
+    a,
+    button,
     css,
     div,
     fragment,
     grid,
     id,
+    input,
     media,
+    name,
     orange,
     outer_morph,
     partial,
@@ -107,3 +111,51 @@ def test_page_collects_state_and_media_styles_from_classes():
         "@media (max-width:40rem){.interactive-card{grid-template-columns:1fr}}"
         in document
     )
+
+
+def test_html_attributes_are_inherited_and_can_be_overridden():
+    class external_link(a):
+        target = "_blank"
+        rel = "noreferrer"
+
+    assert render(external_link("Python", href="https://python.org")) == (
+        '<a class="external-link" target="_blank" rel="noreferrer" '
+        'href="https://python.org">Python</a>'
+    )
+    assert render(external_link("Here", href="/", target="_self", rel=None)) == (
+        '<a class="external-link" target="_self" href="/">Here</a>'
+    )
+
+
+def test_multiple_inheritance_composes_attribute_defaults():
+    class disabled:
+        disabled = True
+        aria_disabled = "true"
+
+    class caution:
+        title = "Careful"
+
+    class cautious_button(button, disabled, caution):
+        title = "Really careful"
+
+    assert render(cautious_button("Continue")) == (
+        '<button class="disabled caution cautious-button" disabled '
+        'aria-disabled="true" title="Really careful">Continue</button>'
+    )
+
+
+def test_names_are_lazy_interned_attributes_and_selectors():
+    assert name.search_query is name.search_query
+    assert str(name.search_query) == "search_query"
+    assert name.search_query.selector == '[name="search_query"]'
+    assert selector(name.search_query) == '[name="search_query"]'
+    assert render(input(name=name.search_query)) == (
+        '<input name="search_query">'
+    )
+
+
+def test_class_default_id_controls_instance_selector():
+    class results(div):
+        id = id.search_results
+
+    assert results().selector == "#search-results"

{hyperclass-0.0.3 → hyperclass-0.0.4}/tests/test_htmx.py

@@ -1,4 +1,4 @@
-from hyperclass import closest, div, hx, outer_morph, render
+from hyperclass import closest, div, hx, id, name, outer_morph, render
 
 
 class counter(div):
@@ -24,3 +24,19 @@ def test_plain_class_target_becomes_a_selector():
     assert render(div(hx=hx.get("/counter", target=counter))) == (
         '<div hx-get="/counter" hx-target=".counter"></div>'
     )
+
+
+def test_class_attributes_can_declare_htmx_and_name_selectors():
+    class live_search(div):
+        hx = hx.get(
+            "/search",
+            include=name.query,
+            target=id.results,
+            swap=outer_morph,
+        )
+
+    assert render(live_search()) == (
+        '<div class="live-search" hx-get="/search" '
+        'hx-include="[name=&quot;query&quot;]" hx-target="#results" '
+        'hx-swap="outerMorph"></div>'
+    )

hyperclass-0.0.4/tests/test_package.py

@@ -0,0 +1,5 @@
+import hyperclass
+
+
+def test_version():
+    assert hyperclass.__version__ == "0.0.4"

{hyperclass-0.0.3 → hyperclass-0.0.4}/tests/test_wsgi.py

@@ -5,6 +5,7 @@ from wsgiref.util import setup_testing_defaults
 
 from hyperclass import (
     App,
+    Values,
     button,
     closest,
     div,
@@ -13,6 +14,7 @@ from hyperclass import (
     hidden,
     hx,
     input,
+    name,
     outer_morph,
     output,
     patch,
@@ -266,3 +268,11 @@ def test_dataclass_binding_uses_defaults_and_reports_bad_values():
     )
     assert captured["status"] == "400 Bad Request"
     assert payload == "invalid form value for priority: 'high'"
+
+
+def test_values_accept_first_class_form_names():
+    values = Values({"search_query": ["python", "wsgi"], "page": ["3"]})
+    assert values[name.search_query] == "wsgi"
+    assert values.get(name.search_query) == "wsgi"
+    assert values.getlist(name.search_query) == ["python", "wsgi"]
+    assert values.int(name.page) == 3

hyperclass-0.0.3/tests/test_package.py

@@ -1,5 +0,0 @@
-import hyperclass
-
-
-def test_version():
-    assert hyperclass.__version__ == "0.0.3"