Add pypi publish workflow and badges to README

Author: davepeck

.github/workflows/pypi.yml

@@ -0,0 +1,62 @@
+name: Publish Python Package
+
+on:
+  release:
+    types: [created]
+
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test_and_build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.14.0-rc.2
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.14.0-rc.2
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Lint
+        run: uv run ruff check
+
+      - name: Check formatting
+        run: uv run ruff format --check
+
+      - name: Type check
+        run: uv run pyright
+
+      - name: Run tests
+        run: uv run pytest -v
+
+      - name: Build
+        run: uv build
+
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-packages
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [test_and_build]
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distribution packages
+        uses: actions/download-artifact@v5
+        with:
+          name: python-packages
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

README.md

@@ -2,6 +2,11 @@
 
 A 🤘 rockin' t-string HTML templating system for Python 3.14.
 
+[![PyPI](https://img.shields.io/pypi/v/html-tstring.svg)](https://pypi.org/project/html-tstring/)
+[![Tests](https://github.com/t-strings/html-tstring/actions/workflows/ci.yml/badge.svg)](https://github.com/t-strings/tdom/actions/workflows/pytest.yml)
+[![Changelog](https://img.shields.io/github/v/release/t-strings/html-tstring?include_prereleases&label=changelog)](https://github.com/t-strings/html-tstring/releases)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/t-strings/html-tstring/blob/main/LICENSE)
+
 ## Installation
 
 Just run:
@@ -251,31 +256,43 @@ The result is the same either way.
 
 #### Component Functions
 
-Create reusable template functions that work like custom HTML elements:
+You can create reusable component functions that generate templates with dynamic content and attributes. Use these like custom HTML elements in your templates.
+
+The basic form of all component functions is:
 
 ```python
-def Alert(message: str, type: str = "info", **props) -> Template:
-    alert_class = f"alert alert-{type}"
-    attrs = {"class": alert_class, **props}
-    return t'<div {attrs}>{message}</div>'
+from typing import Any
 
-# Use your component
-warning = html(t'<{Alert} message="Be careful!" type="warning" id="main-alert" />')
+def MyComponent(*children: Node, **attrs: Any) -> Template:
+    # Build your template using the provided props
+    return t"<div {attrs}>{children}</div>"
 ```
 
-#### Fragment Rendering
+To _invoke_ your component within an HTML template, use the special `<{ComponentName} ... />` syntax:
+
+```python
+result = html(t"<{MyComponent} id='comp1'>Hello, Component!</{MyComponent}>")
+# <div id="comp1">Hello, Component!</div>
+```
 
-Templates can return multiple root elements:
+Because attributes are passed as keyword arguments, you can explicitly provide type hints for better editor support:
 
 ```python
-def TableColumns() -> Template:
-    return t"<td>Column 1</td><td>Column 2</td>"
+from typing import Any
+
+def Link(*, href: str, text: str, **props: Any) -> Template:
+    return t'<a href="{href}" {props}>{text}</a>'
 
-table = html(t"<table><tr><{TableColumns} /></tr></table>")
+result = html(t'<{Link} href="https://example.com" text="Example" target="_blank" />')
+# <a href="https://example.com" target="_blank">Example</a>
 ```
 
-The `html()` function returns a tree of nodes that can be converted to strings, manipulated programmatically, or composed with other templates for maximum flexibility.
+In addition to returning a `Template` directly, component functions may also return any `Node` type found in [`html_tstring.nodes`](./html_tstring/nodes.py). This allows you to build more complex components that manipulate the HTML structure programmatically.
 
 #### Context
 
 TODO: implement context feature
+
+#### Working with `Node` Objects
+
+TODO: say more about working with them directly

html_tstring/processor_test.py

@@ -1,9 +1,10 @@
+import typing as t
 from string.templatelib import Template
 
 import pytest
 from markupsafe import Markup
 
-from .nodes import Element, Fragment, Text
+from .nodes import Element, Fragment, Node, Text
 from .processor import html
 
 # --------------------------------------------------------------------------
@@ -456,14 +457,14 @@ def test_interpolated_style_attribute():
 
 
 def TemplateComponent(
-    *children: Element | str, first: int, second: int, third: str, **props: str | None
+    *children: Node, first: int, second: int, third: str, **attrs: t.Any
 ) -> Template:
-    attrs = {
+    new_attrs = {
         "id": third,
         "data": {"first": first, "second": second},
-        **props,
+        **attrs,
     }
-    return t"<div {attrs}>Component: {children}</div>"
+    return t"<div {new_attrs}>Component: {children}</div>"
 
 
 def test_interpolated_template_component():