Tweaks to key function visibility

src/bootlace/__init__.py

@@ -4,8 +4,10 @@
 from . import __about__
 from ._version import __version__
 from .util import _monkey_patch_dominate
+from .util import as_tag
+from .util import render
 
-__all__ = ["__version__", "__about__"]
+__all__ = ["__version__", "__about__", "as_tag", "render"]
 
 
 _monkey_patch_dominate()

src/bootlace/table/base.py

@@ -92,6 +92,17 @@ def get_declared_columns(mcls, cls: type) -> dict[str, ColumnBase]:
 
 
 class Table(metaclass=TableMetaclass):
+    """Base class for class-defined tables.
+
+    Subclasses should define columns as class attributes, e.g.:
+
+    class MyTable(Table):
+        name = Column(Heading("Name"))
+        age = Column(Heading("Age"))
+
+    Use :meth:`render` to render a table from a list of items as
+    :class:`dominate.tags.table`.
+    """
 
     decorated_classes: set[str] = set()
     columns: ClassVar[dict[str, ColumnBase]]

src/bootlace/util.py

@@ -15,6 +15,7 @@
 from dominate.util import container
 from dominate.util import text
 from flask import request
+from markupsafe import Markup
 
 T = TypeVar("T")
 
@@ -51,8 +52,8 @@ def as_tag(item: Taggable) -> tags.html_tag:
     return container(text(str(item)), tags.comment(f"Rendered type {item.__class__.__name__} not supported"))
 
 
-def render(item: Taggable) -> str:
-    return as_tag(item).render()
+def render(item: Taggable) -> Markup:
+    return Markup(as_tag(item).render())
 
 
 class Classes: