htpy-htmx 0.1.0__py3-none-any.whl

htpy_htmx/_types.py

@@ -0,0 +1,107 @@
+from typing import TypeAlias, Literal
+
+_swap_style: TypeAlias = (
+    str  # This allows extensions to add new swap_styles (like upsert and download)
+    | Literal[
+        "innerHTML",
+        "outerHTML",
+        "beforebegin",
+        "before",
+        "afterbegin",
+        "prepend",
+        "beforeend",
+        "append",
+        "afterend",
+        "after",
+        "delete",
+        "none",
+        "innerMorph",
+        "outerMorph",
+        "textContent",
+        "outerSync",
+        # "upsert",  # Requires the hx-upsert extension.
+        # "download",  # Required the hx-download extension.
+    ]
+)
+
+_selector: TypeAlias = (
+    str | Literal["this", "next", "previous", "body", "document", "window", "host"]
+)
+
+_event: TypeAlias = (
+    str
+    | Literal[
+        "load",
+        "revealed",
+        "intersect",
+        "submit",
+        "change",
+        "input",
+        "focus",
+        "blur",
+        "click",
+        "dblclick",
+        "mousedown",
+        "mouseup",
+        "mousemove",
+        "mouseenter",
+        "mouseleave",
+        "wheel",
+        "mousewheel",
+        "keyup",
+        "keydown",
+        "keypress",
+        "dragstart",
+        "drag",
+        "dragend",
+        "dragenter",
+        "dragover",
+        "dragleave",
+        "drop",
+        "play",
+        "pause",
+        "ended",
+        "volumechange",
+        "touchstart",
+        "touchend",
+        "touchmove",
+        "touchcancel",
+        "resize",
+        "scroll",
+        "select",
+        "search",
+        "invalid",
+        "contextmenu",
+        "reset",
+    ]
+)
+
+_htmx_events: TypeAlias = Literal[
+    "htmx:config:request",
+    "htmx:before:request",
+    "htmx:after:request",
+    "htmx:finally:request",
+    "htmx:before:swap",
+    "htmx:after:swap",
+    "htmx:finally:swap",
+    "htmx:before:cleanup",
+    "htmx:after:cleanup",
+    "htmx:confirm",
+    "htmx:error",
+    "htmx:abort",
+    "htmx:before:init",
+    "htmx:after:init",
+    "htmx:before:process",
+    "htmx:after:process",
+    "htmx:before:history:update",
+    "htmx:after:history:update",
+    "htmx:after:history:push",
+    "htmx:after:history:replace",
+    "htmx:before:history:restore",
+    "htmx:before:viewTransition",
+    "htmx:after:viewTransition",
+    "htmx:before:response",
+    "htmx:before:settle",
+    "htmx:after:settle",
+    "htmx:response:error",
+]

htpy_htmx/ext.py

@@ -0,0 +1,129 @@
+from __future__ import annotations
+from typing import Literal
+from ._types import _selector, _event
+
+
+def multipart(*, connect: str, close: _event, inherited: bool = False) -> dict[str, str]:
+    """Stream HTML with multipart/mixed.
+
+    https://four.htmx.org/extensions/hx-multipart
+    """
+    data: dict[str, str] = {}
+    if connect:
+        data[f"hx-multipart:connect{':inherited' if inherited else ''}"] = connect
+    if close:
+        data[f"hx-multipart:close{':inherited' if inherited else ''}"] = close
+    return data
+
+
+def sse(*, connect: _event = "", close: _event = "", inherited: bool = False) -> dict[str, str]:
+    """Stream HTML with text/event-stream (SSE).
+
+    https://four.htmx.org/extensions/hx-sse
+    """
+    data: dict[str, str] = {}
+    if connect:
+        data[f"hx-sse:connect{':inherited' if inherited else ''}"] = connect
+    if close:
+        data[f"hx-sse:close{':inherited' if inherited else ''}"] = close
+    return data
+
+
+def ws(*, connect: _event = "", send: bool = False, inherited: bool = False) -> dict[str, str]:
+    """Stream HTML and send data over WebSockets.
+
+    https://four.htmx.org/extensions/hx-ws
+    """
+    data: dict[str, str] = {}
+    if connect:
+        data[f"hx-ws:connect{':inherited' if inherited else ''}"] = connect
+    if send:
+        data[f"hx-ws:send{':inherited' if inherited else ''}"] = ""
+    return data
+
+
+def live(attribute: str, expression: str, *, inherited: bool = False) -> dict[str, str]:
+    """Add reactive bindings to HTML.
+
+    https://four.htmx.org/extensions/hx-live
+    """
+    return {f"hx-live:{attribute}{':inherited' if inherited else ''}": expression}
+
+
+def optimistic(selector: _selector, *, inherited: bool = False) -> dict[str, str]:
+    """Shows optimistic content during request.
+
+    Note: This is an extension attribute. To use it, you must include the optimistic extension.
+    https://four.htmx.org/reference/attributes/hx-optimistic
+    """
+    return {f"hx-optimistic{':inherited' if inherited else ''}": selector}
+
+
+def browser_indicator(show_indicator: bool = True, *, inherited: bool = False) -> dict[str, str]:
+    """Show tab's spinner with hx-browser-indicator.
+
+    https://four.htmx.org/extensions/hx-browser-indicator
+    """
+    return {f"hx-browser-indicator{':inherited' if inherited else ''}": str(show_indicator).lower()}
+
+
+def prompt(prompt: str, *, inherited: bool = False) -> dict[str, str]:
+    """Prompt before requests with hx-prompt='Reason?'
+
+    https://four.htmx.org/extensions/hx-prompt
+    """
+    return {f"hx-prompt{':inherited' if inherited else ''}": prompt}
+
+
+def preload(
+    event: Literal["mouseenter", "mouseover", "touchstart"], *, inherited: bool = False
+) -> dict[str, str]:
+    """Preloads content before user triggers request.
+
+    Note: This is an extension attribute. To use it, you must include the preload extension.
+    https://four.htmx.org/reference/attributes/hx-preload
+    """
+    return {f"hx-preload{':inherited' if inherited else ''}": event}
+
+
+def ptag(tag: str, *, inherited: bool = False) -> dict[str, str]:
+    """Skip unchanged polls with HX-PTag: "v42".
+
+    https://four.htmx.org/extensions/hx-ptag
+    """
+    return {f"hx-ptag{':inherited' if inherited else ''}": tag}
+
+
+def history(save_to_cache: bool, *, inherited: bool = False) -> dict[str, str]:
+    """Restore back/forward pages from sessionStorage.
+
+    https://four.htmx.org/extensions/hx-history-cache
+    """
+    return {f"hx-history{':inherited' if inherited else ''}": str(save_to_cache).lower()}
+
+
+def head(
+    strategy: Literal["merge", "append", "re-eval"], *, inherited: bool = False
+) -> dict[str, str]:
+    """Merge <head> tags with hx-head='merge'.
+
+    https://four.htmx.org/extensions/hx-head
+    """
+    return {f"hx-head{':inherited' if inherited else ''}": strategy}
+
+
+def targets(*selector: _selector, inherited: bool = False) -> dict[str, str]:
+    """Target many elements.
+
+    Requires the hx-targets extension
+    https://four.htmx.org/extensions/hx-targets
+    """
+    return {f"hx-targets{':inherited' if inherited else ''}": ", ".join(selector)}
+
+
+def nonce(csp_nonce: str, *, inherited: bool = False) -> dict[str, str]:
+    """Make htmx work under strict Content Security Policy.
+
+    https://four.htmx.org/extensions/hx-csp
+    """
+    return {f"hx-nonce{':inherited' if inherited else ''}": csp_nonce}

htpy_htmx/hx.py

@@ -0,0 +1,509 @@
+from __future__ import annotations
+import json
+from typing import Literal, Any, overload
+from htpy import Element
+from ._types import _swap_style, _selector, _event, _htmx_events
+
+partial = Element("hx-partial")
+
+
+def get(url: str, *, inherited: bool = False) -> dict[str, str]:
+    """Issues GET request to specified URL.
+
+    https://four.htmx.org/reference/attributes/hx-get
+    """
+    return {f"hx-get{':inherited' if inherited else ''}": url}
+
+
+def post(url: str, *, inherited: bool = False) -> dict[str, str]:
+    """Issues POST request to specified URL.
+
+    https://four.htmx.org/reference/attributes/hx-post
+    """
+    return {f"hx-post{':inherited' if inherited else ''}": url}
+
+
+def put(url: str, *, inherited: bool = False) -> dict[str, str]:
+    """Issues PUT request to specified URL.
+
+    https://four.htmx.org/reference/attributes/hx-put
+    """
+    return {f"hx-put{':inherited' if inherited else ''}": url}
+
+
+def patch(url: str, *, inherited: bool = False) -> dict[str, str]:
+    """Issues PATCH request to specified URL.
+
+    https://four.htmx.org/reference/attributes/hx-patch
+    """
+    return {f"hx-patch{':inherited' if inherited else ''}": url}
+
+
+def delete(url: str, *, inherited: bool = False) -> dict[str, str]:
+    """Issues DELETE request to specified URL.
+
+    https://four.htmx.org/reference/attributes/hx-delete
+    """
+    return {f"hx-delete{':inherited' if inherited else ''}": url}
+
+
+def trigger_event(
+    event: _event,
+    filter: str = "",
+    once: bool = False,
+    changed: bool = False,
+    delay: str = "",
+    throttle: str = "",
+    from_: _selector = "",
+    target: _selector = "",
+    prevent: bool = False,
+    stop: bool = False,
+    consume: bool = False,
+    halt: bool = False,
+    capture: bool = False,
+    passive: bool = False,
+) -> str:
+    """Helper function to generate event syntax for hx-trigger.
+
+    Usage:
+        hx.trigger(hx.trigger_event("keyup", filter="key==Enter"), "click")
+    """
+    text: str = event
+    if filter:
+        text += f"[{filter}]"
+    if once:
+        text += " once"
+    if changed:
+        text += " changed"
+    if delay:
+        text += f" delay:{delay}"
+    if throttle:
+        text += f" throttle:{throttle}"
+    if from_:
+        text += f" from:{from_}"
+    if target:
+        text += f" target:{target}"
+    if prevent:
+        text += " prevent"
+    if stop:
+        text += " stop"
+    if consume:
+        text += " consume"
+    if halt:
+        text += " halt"
+    if capture:
+        text += " capture"
+    if passive:
+        text += " passive"
+    return text
+
+
+def trigger(*event: _event, inherited: bool = False) -> dict[str, str]:
+    """Controls when element issues requests.
+
+    https://four.htmx.org/reference/attributes/hx-trigger
+    """
+    return {f"hx-trigger{':inherited' if inherited else ''}": ", ".join(event)}
+
+
+def swap(
+    style: _swap_style,
+    *,
+    transition: bool | None = None,
+    swap: str = "",
+    settle: str = "",
+    ignoreTitle: bool | None = None,
+    scroll: Literal["top", "bottom"] | str = "",
+    scrollTarget: str = "",
+    show: Literal["top", "bottom", "none"] | str = "",
+    showTarget: str = "",
+    focusScroll: bool | None = None,
+    target: str = "",
+    strip: bool | None = None,
+    swapEmpty: bool | None = None,
+    inherited: bool = False,
+) -> dict[str, str]:
+    """Controls how response is inserted.
+
+    https://four.htmx.org/reference/attributes/hx-swap
+    """
+    text: str = style
+    if transition is not None:
+        text += f" transition:{str(transition).lower()}"
+    if swap:
+        text += f" swap:{swap}"
+    if settle:
+        text += f" settle:{settle}"
+    if ignoreTitle is not None:
+        text += f" ignoreTitle:{str(ignoreTitle).lower()}"
+    if scroll:
+        text += f" scroll:{scroll}"
+    if scrollTarget:
+        text += f" scrollTarget:{scrollTarget}"
+    if show:
+        text += f" show:{show}"
+    if showTarget:
+        text += f" showTarget:{showTarget}"
+    if focusScroll is not None:
+        text += f" focusScroll:{str(focusScroll).lower()}"
+    if target:
+        text += f" target:{target}"
+    if strip is not None:
+        text += f" strip:{str(strip).lower()}"
+    if swapEmpty is not None:
+        text += f" swapEmpty:{str(swapEmpty).lower()}"
+    return {f"hx-swap{':inherited' if inherited else ''}": text}
+
+
+def morph_skip(*, inherited: bool = False) -> dict[str, bool]:
+    """Skip morphing with attributes and children"""
+    return {f"hx-morph-skip{':inherited' if inherited else ''}": True}
+
+
+def morph_skip_children(*, inherited: bool = False) -> dict[str, bool]:
+    """Skip morphing with children only; attributes still morph"""
+    return {f"hx-morph-skip-children{':inherited' if inherited else ''}": True}
+
+
+def target(selector: _selector, *, inherited: bool = False) -> dict[str, str]:
+    """Controls where response is inserted.
+
+    https://four.htmx.org/reference/attributes/hx-target
+    """
+    return {f"hx-target{':inherited' if inherited else ''}": selector}
+
+
+def select(selector: _selector, *, inherited: bool = False) -> dict[str, str]:
+    """Controls which response part is inserted.
+
+    https://four.htmx.org/reference/attributes/hx-select
+    """
+    return {f"hx-select{':inherited' if inherited else ''}": selector}
+
+
+def on(
+    event: _event | _htmx_events = "", js: str = "", *, inherited: bool = False
+) -> dict[str, str]:
+    """Runs inline JavaScript when event fires.
+
+    https://four.htmx.org/reference/attributes/hx-on
+    """
+    return {f"hx-on{':' + event if event else ''}{':inherited' if inherited else ''}": js}
+
+
+class JS:
+    """Used to mark strings as js expressions for use in hx-vals and hx-headers."""
+
+    start = "HXJS-start:"
+    end = ":HXJS-end"
+
+    def __init__(self, value: str) -> None:
+        self.value = value
+
+    def __repr__(self) -> str:
+        return f"{JS.start}{self.value}{JS.end}"
+
+    def __str__(self) -> str:
+        return f"JS({self.value})"
+
+
+class _HTMXJSONEncoder(json.JSONEncoder):
+    def default(self, o: Any) -> Any:
+        if isinstance(o, JS):
+            return repr(o)
+            # Let the base class default method raise the TypeError
+        return super().default(o)
+
+    def encode(self, o: Any) -> str:
+        string: str = super().encode(o)
+        string = string.replace(f'"{JS.start}', "").replace(f'{JS.end}"', "")
+        return string
+
+
+def vals(
+    data: dict[str, Any], *, js: bool = False, append: bool = False, inherited: bool = False
+) -> dict[str, str]:
+    """Adds values to request parameters.
+
+    https://four.htmx.org/reference/attributes/hx-vals
+    """
+    data_string = json.dumps(data, cls=_HTMXJSONEncoder)
+    return {
+        f"hx-vals{':append' if append else ''}{':inherited' if inherited else ''}": f"{'js:' if js else ''}{data_string}"
+    }
+
+
+def include(
+    selector: _selector, *, append: bool = False, inherited: bool = False
+) -> dict[str, str]:
+    """Includes additional element values in request.
+
+    https://four.htmx.org/reference/attributes/hx-include
+    """
+    return {f"hx-include{':append' if append else ''}{':inherited' if inherited else ''}": selector}
+
+
+def swap_oob(
+    swap_style: _swap_style | bool = True, selector: _selector = "", *, inherited: bool = False
+) -> dict[str, str]:
+    """Marks response elements to swap into page by ID.
+
+    https://four.htmx.org/reference/attributes/hx-swap-oob
+    """
+    if isinstance(swap_style, bool):
+        style: str = str(swap_style).lower()
+    else:
+        style = str(swap_style)
+    return {
+        f"hx-swap-oob{':inherited' if inherited else ''}": f"{style}{':' + selector if selector else ''}"
+    }
+
+
+def select_oob(*selector: str, inherited: bool = False) -> dict[str, str]:
+    """Picks response elements to swap into page by ID.
+
+    https://four.htmx.org/reference/attributes/hx-select-oob
+    """
+    return {f"hx-select-oob{':inherited' if inherited else ''}": ", ".join(selector)}
+
+
+def push_url(push: bool = True, *, inherited: bool = False) -> dict[str, str]:
+    """Pushes URL into browser history.
+
+    https://four.htmx.org/reference/attributes/hx-push-url
+    """
+    return {f"hx-push-url{':inherited' if inherited else ''}": str(push).lower()}
+
+
+def replace_url(replace: bool = True, *, inherited: bool = False) -> dict[str, str]:
+    """Replaces current URL in browser history.
+
+    https://four.htmx.org/reference/attributes/hx-replace-url
+    """
+    return {f"hx-replace-url{':inherited' if inherited else ''}": str(replace).lower()}
+
+
+def headers(data: dict[str, Any], *, js: bool = False, inherited: bool = False) -> dict[str, str]:
+    """Adds custom headers to request.
+
+    https://four.htmx.org/reference/attributes/hx-headers
+    """
+    return {
+        f"hx-headers{':inherited' if inherited else ''}": f"{'js:' if js else ''}{json.dumps(data, cls=_HTMXJSONEncoder)}"
+    }
+
+
+def encoding(
+    encoding_string: str | Literal["application/x-www-form-urlencoded", "multipart/form-data"],
+    *,
+    inherited: bool = False,
+) -> dict[str, str]:
+    """Sets request encoding type.
+
+    https://four.htmx.org/reference/attributes/hx-encoding
+    """
+    return {f"hx-encoding{':inherited' if inherited else ''}": encoding_string}
+
+
+def indicator(
+    selector: _selector, *, append: bool = False, inherited: bool = False
+) -> dict[str, str]:
+    """Specifies loading indicator element.
+
+    https://four.htmx.org/reference/attributes/hx-indicator
+    """
+    return {
+        f"hx-indicator{':append' if append else ''}{':inherited' if inherited else ''}": selector
+    }
+
+
+@overload
+def boost(boost: bool, *, inherited: bool = False) -> dict[str, str]:
+    pass
+
+
+@overload
+def boost(
+    *,
+    swap: _swap_style | str = "",
+    target: _selector = "",
+    select: _selector = "",
+    inherited: bool = False,
+) -> dict[str, str]:
+    pass
+
+
+def boost(
+    boost: bool | None = None,
+    *,
+    swap: _swap_style | str = "",
+    target: _selector = "",
+    select: _selector = "",
+    inherited: bool = False,
+) -> dict[str, str]:
+    """Converts links and forms to AJAX.
+
+    https://four.htmx.org/reference/attributes/hx-boost
+    """
+    text = ""
+    if swap:
+        text += f"swap:{swap}"
+    if target:
+        text += f" target:{target}"
+    if select:
+        text += f" select:{select}"
+    if boost is not None and text == "":
+        text = str(boost).lower()
+    return {f"hx-boost{':inherited' if inherited else ''}": text}
+
+
+def sync(
+    selector: _selector,
+    strategy: Literal["drop", "abort", "replace", "queue first", "queue last", "queue all"],
+    *,
+    inherited: bool = False,
+) -> dict[str, str]:
+    """Synchronizes requests between elements.
+
+    https://four.htmx.org/reference/attributes/hx-sync
+    """
+    return {f"hx-sync{':inherited' if inherited else ''}": f"{selector}:{strategy}"}
+
+
+def confirm(confirmation_prompt: str, *, inherited: bool = False) -> dict[str, str]:
+    """Shows confirmation dialog before request.
+
+    https://four.htmx.org/reference/attributes/hx-confirm
+    """
+    return {f"hx-confirm{':inherited' if inherited else ''}": confirmation_prompt}
+
+
+def validate(validate: bool = True, *, inherited: bool = False) -> dict[str, str]:
+    """Validates before submitting request.
+
+    https://four.htmx.org/reference/attributes/hx-validate
+    """
+    return {f"hx-validate{':inherited' if inherited else ''}": str(validate).lower()}
+
+
+def disable(*selector: _selector, merge: bool = False, inherited: bool = False) -> dict[str, str]:
+    """Disables elements during request.
+
+    https://four.htmx.org/reference/attributes/hx-disable
+    """
+    return {
+        f"hx-disable{':merge' if merge else ''}{':inherited' if inherited else ''}": ", ".join(
+            selector
+        )
+    }
+
+
+def ignore(*, inherited: bool = False) -> dict[str, str]:
+    """Disables htmx processing for element.
+
+    https://four.htmx.org/reference/attributes/hx-ignore
+    """
+    return {f"hx-ignore{':inherited' if inherited else ''}": ""}
+
+
+def preserve(*, inherited: bool = False) -> dict[str, str]:
+    """Preserves element during swaps.
+
+    https://four.htmx.org/reference/attributes/hx-preserve
+    """
+    return {f"hx-preserve{':inherited' if inherited else ''}": "true"}
+
+
+def status(
+    status_code: str | int,
+    *,
+    swap: _swap_style | None = None,
+    target: _selector = "",
+    select: _selector = "",
+    push: bool | str = "",
+    replace: bool | str = "",
+    transition: bool | None = None,
+    inherited: bool = False,
+) -> dict[str, str]:
+    """Handles responses differently by status code.
+
+    https://four.htmx.org/reference/attributes/hx-status
+    """
+    text: str = ""
+    if swap is not None:
+        text += f"swap:{swap}"
+    if target:
+        text += f" target:{target}"
+    if select:
+        text += f" select:{select}"
+    if push != "":
+        text += f" push:{push}"
+    if replace != "":
+        text += f" replace:{replace}"
+    if transition is not None:
+        text += f" transition:{transition}"
+    return {f"hx-status:{status_code}{':inherited' if inherited else ''}": text}
+
+
+def action(url: str, *, inherited: bool = False) -> dict[str, str]:
+    """Specifies URL to receive request.
+
+    https://four.htmx.org/reference/attributes/hx-action
+    """
+    return {f"hx-action{':inherited' if inherited else ''}": url}
+
+
+def method(
+    text: Literal["get", "post", "put", "patch", "delete"], *, inherited: bool = False
+) -> dict[str, str]:
+    """Specifies HTTP method for request.
+
+    https://four.htmx.org/reference/attributes/hx-method
+    """
+    return {f"hx-method{':inherited' if inherited else ''}": text}
+
+
+def config(
+    *,
+    timeout: int | None = None,
+    credentials: str = "",
+    cache: str = "",
+    redirect: str = "",
+    referrer: str = "",
+    integrity: str = "",
+    validate: bool | None = None,
+    append: bool = False,
+    inherited: bool = False,
+) -> dict[str, str]:
+    """Configures request behavior.
+
+    https://four.htmx.org/reference/attributes/hx-config
+    """
+    data: dict[str, int | str | bool] = {}
+    if timeout is not None:
+        data["timeout"] = timeout
+    if credentials:
+        data["credentials"] = credentials
+    if cache:
+        data["cache"] = cache
+    if redirect:
+        data["redirect"] = redirect
+    if referrer:
+        data["referrer"] = referrer
+    if integrity:
+        data["integrity"] = integrity
+    if validate is not None:
+        data["validate"] = validate
+    return {
+        f"hx-config{':append' if append else ''}{':inherited' if inherited else ''}": json.dumps(
+            data
+        )
+    }
+
+
+def history_elt(*, inherited: bool = False) -> dict[str, str]:
+    """Marks element to swap on history restore.
+
+    https://four.htmx.org/reference/attributes/hx-history-elt
+    """
+    return {f"hx-history-elt{':inherited' if inherited else ''}": ""}

htpy_htmx-0.1.0.dist-info/METADATA

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: htpy-htmx
+Version: 0.1.0
+Summary: Helpers for using htmx in htpy
+Author-email: August Malmdahl <august.malmdahl@gmail.com>
+Project-URL: Repository, https://github.com/augustifolia/htpy-htmx
+Project-URL: Issues, https://github.com/augustifolia/htpy-htmx/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENCE
+Requires-Dist: htpy
+Dynamic: license-file
+
+# htpy-htmx
+
+htpy-htmx is a library to make it easier to work with [htmx](https://four.htmx.org/) in [htpy](https://htpy.dev/).
+
+This library is intended to work with htmx 4.
+
+Note: This project is still a work in progress and there may be breaking changes.
+
+## Usage
+
+You can import htpy-htmx as htpy_htmx.hx. All normal htmx attributes are available from the module,
+but without the "hx-" prefix. So `hx-get="url"` would become `hx.get("url")`.
+
+Some htmx extension attributes are available in the htpy_htmx.ext module.
+
+```python
+import htpy as h
+from htpy_htmx import hx
+from htpy_htmx import ext
+
+# pass htmx attributes as functions
+h.div("#div-id", hx.get("/some-url/"), hx.trigger("click"))
+
+# hx-partial is also available as a htpy element
+h.div("#div-id")[
+    h.h2["header"],
+    hx.partial("#part-id", hx.target("#some-element"))[
+        h.div("#div1")[
+            h.p["part one"]
+        ]
+    ],
+]
+
+h.div(
+    # trigger allows a list of trigger events
+    hx.trigger("blur", "keyup[key=='Enter']"),
+    # swap takes a swap style as string and modifiers as keyword arguments
+    hx.swap("before", swap="1s", scroll="bottom"),
+    # hx-on takes an event and a JavaScript expression
+    hx.on("htmx:before:request", "showSpinner()"),
+    # vals takes a dict of data.
+    # To evaluate JavaScript, wrap your js expression in hx.JS() and pass js=True.
+    hx.vals({"foo": "bar", "some_js": hx.JS("getSomeData()")}, js=True),
+)
+
+# to enable inheritance pass inherited=True to a hx-function
+h.div(hx.confirm("Are you sure?", inherited=True))[
+    h.button(hx.delete("/account"))["Delete My Account"],
+    h.button(hx.put("/account"))["Update My Account"],
+]
+
+# Some extension attributes are available in ext:
+h.div(
+    ext.preload("touchstart"),
+    ext.optimistic("#msg-opt"),
+    ext.ws(connect="click"),
+)
+```
+
+## Installation
+
+To install with pip run:
+
+    pip install htpy-htmx

htpy_htmx-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+htpy_htmx/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+htpy_htmx/_types.py,sha256=VNFk6T8nDIvQ9QEiEQbGCo-lGvq1wzBUcIIu37d-uMk,2351
+htpy_htmx/ext.py,sha256=ORI6uXsskt5LqWZXW4BYma8fwjKpFi6OjOBThHRvnM8,4351
+htpy_htmx/hx.py,sha256=HaimQdXfOWa73yl5lIcUUoGFksKmRn6rlGd_u1uxgow,14787
+htpy_htmx-0.1.0.dist-info/licenses/LICENCE,sha256=Vl3Hxc8G6RHH3q4lgrNKZuJiVQD3FOdwGbUAkJvN1Jc,1072
+htpy_htmx-0.1.0.dist-info/METADATA,sha256=9NcFHrSbGSDYOSWRUTIi6406UiI_erf70IraWiOd95Y,2571
+htpy_htmx-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+htpy_htmx-0.1.0.dist-info/top_level.txt,sha256=xKrtpdM7_Rv-NIPYrfAV1qHatgmJuFkuzu4LEHN4Twc,10
+htpy_htmx-0.1.0.dist-info/RECORD,,

htpy_htmx-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

htpy_htmx-0.1.0.dist-info/licenses/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 August Malmdahl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

htpy_htmx-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+htpy_htmx