update

Author: jph00

README.md

@@ -138,7 +138,7 @@ repo’s notebooks and the official FastHTML examples repo:
 Then explore the small but growing third-party ecosystem of FastHTML
 tutorials, notebooks, libraries, and components:
 
-- [FastHTML Gallery](https://fastht.ml/gallery): Learn from minimal
+- [FastHTML Gallery](https://gallery.fastht.ml): Learn from minimal
   examples of components (ie chat bubbles, click-to-edit, infinite
   scroll, etc)
 - [Creating Custom FastHTML Tags for Markdown

fasthtml/core.pyi

@@ -1,6 +1,6 @@
 """The `FastHTML` subclass of `Starlette`, along with the `RouterX` and `RouteX` classes it automatically uses."""
-__all__ = ['empty', 'htmx_hdrs', 'fh_cfg', 'htmx_resps', 'htmx_exts', 'htmxsrc', 'fhjsscr', 'surrsrc', 'scopesrc', 'viewport', 'charset', 'cors_allow', 'iframe_scr', 'all_meths', 'devtools_loc', 'parsed_date', 'snake2hyphens', 'HtmxHeaders', 'HttpHeader', 'HtmxResponseHeaders', 'form2dict', 'parse_form', 'JSONResponse', 'flat_xt', 'Beforeware', 'EventStream', 'signal_shutdown', 'uri', 'decode_uri', 'flat_tuple', 'noop_body', 'respond', 'is_full_page', 'Redirect', 'get_key', 'qp', 'def_hdrs', 'FastHTML', 'nested_name', 'serve', 'Client', 'RouteFuncs', 'APIRouter', 'cookie', 'reg_re_param', 'MiddlewareBase', 'FtResponse', 'unqid', 'setup_ws']
-import json, uuid, inspect, types, signal, asyncio, threading, inspect, random
+__all__ = ['empty', 'htmx_hdrs', 'fh_cfg', 'htmx_resps', 'htmx_exts', 'htmxsrc', 'fhjsscr', 'surrsrc', 'scopesrc', 'viewport', 'charset', 'cors_allow', 'iframe_scr', 'all_meths', 'devtools_loc', 'parsed_date', 'snake2hyphens', 'HtmxHeaders', 'HttpHeader', 'HtmxResponseHeaders', 'form2dict', 'parse_form', 'JSONResponse', 'flat_xt', 'Beforeware', 'EventStream', 'signal_shutdown', 'uri', 'decode_uri', 'flat_tuple', 'noop_body', 'respond', 'is_full_page', 'Redirect', 'get_key', 'qp', 'def_hdrs', 'FastHTML', 'nested_name', 'serve', 'Client', 'RouteFuncs', 'APIRouter', 'cookie', 'reg_re_param', 'MiddlewareBase', 'FtResponse', 'unqid']
+import json, uuid, inspect, types, signal, asyncio, threading, inspect, random, contextlib
 from fastcore.utils import *
 from fastcore.xml import *
 from fastcore.meta import use_kwargs_dict
@@ -213,7 +213,7 @@ class Redirect:
 
 async def _wrap_call(f, req, params):
     ...
-htmx_exts = {'morph': 'https://cdn.jsdelivr.net/npm/idiomorph@0.7.3/dist/idiomorph-ext.min.js', 'head-support': 'https://cdn.jsdelivr.net/npm/htmx-ext-head-support@2.0.3/head-support.js', 'preload': 'https://cdn.jsdelivr.net/npm/htmx-ext-preload@2.1.0/preload.js', 'class-tools': 'https://cdn.jsdelivr.net/npm/htmx-ext-class-tools@2.0.1/class-tools.js', 'loading-states': 'https://cdn.jsdelivr.net/npm/htmx-ext-loading-states@2.0.0/loading-states.js', 'multi-swap': 'https://cdn.jsdelivr.net/npm/htmx-ext-multi-swap@2.0.0/multi-swap.js', 'path-deps': 'https://cdn.jsdelivr.net/npm/htmx-ext-path-deps@2.0.0/path-deps.js', 'remove-me': 'https://cdn.jsdelivr.net/npm/htmx-ext-remove-me@2.0.0/remove-me.js', 'ws': 'https://cdn.jsdelivr.net/npm/htmx-ext-ws@2.0.2/ws.js', 'chunked-transfer': 'https://cdn.jsdelivr.net/npm/htmx-ext-transfer-encoding-chunked@0.4.0/transfer-encoding-chunked.js'}
+htmx_exts = {'morph': 'https://cdn.jsdelivr.net/npm/idiomorph@0.7.3/dist/idiomorph-ext.min.js', 'head-support': 'https://cdn.jsdelivr.net/npm/htmx-ext-head-support@2.0.3/head-support.js', 'preload': 'https://cdn.jsdelivr.net/npm/htmx-ext-preload@2.1.0/preload.js', 'class-tools': 'https://cdn.jsdelivr.net/npm/htmx-ext-class-tools@2.0.1/class-tools.js', 'loading-states': 'https://cdn.jsdelivr.net/npm/htmx-ext-loading-states@2.0.0/loading-states.js', 'multi-swap': 'https://cdn.jsdelivr.net/npm/htmx-ext-multi-swap@2.0.0/multi-swap.js', 'path-deps': 'https://cdn.jsdelivr.net/npm/htmx-ext-path-deps@2.0.0/path-deps.js', 'remove-me': 'https://cdn.jsdelivr.net/npm/htmx-ext-remove-me@2.0.0/remove-me.js', 'ws': 'https://cdn.jsdelivr.net/npm/htmx-ext-ws@2.0.3/ws.js', 'chunked-transfer': 'https://cdn.jsdelivr.net/npm/htmx-ext-transfer-encoding-chunked@0.4.0/transfer-encoding-chunked.js'}
 htmxsrc = Script(src='https://cdn.jsdelivr.net/npm/htmx.org@2.0.4/dist/htmx.min.js')
 fhjsscr = Script(src='https://cdn.jsdelivr.net/gh/answerdotai/fasthtml-js@1.0.12/fasthtml.js')
 surrsrc = Script(src='https://cdn.jsdelivr.net/gh/answerdotai/surreal@main/surreal.js')
@@ -265,6 +265,9 @@ class FastHTML(Starlette):
         """Add a route at `path`"""
         ...
 
+    def set_lifespan(self, value):
+        ...
+
     def static_route_exts(self, prefix='/', static_path='.', exts='static'):
         """Add a static route at URL path `prefix` with files from `static_path` and `exts` defined by `reg_re_param()`"""
         ...
@@ -273,6 +276,9 @@ class FastHTML(Starlette):
         """Add a static route at URL path `prefix` with files from `static_path` and single `ext` (including the '.')"""
         ...
 
+    def setup_ws(app, f=noop):
+        ...
+
     def devtools_json(self, path=None, uuid=None):
         ...
 all_meths = 'get post put delete patch head trace options'.split()
@@ -370,7 +376,4 @@ def unqid(seeded=False):
 
 def _add_ids(s):
     ...
-
-def setup_ws(app, f=noop):
-    ...
 devtools_loc = '/.well-known/appspecific/com.chrome.devtools.json'

nbs/apilist.txt

@@ -7,6 +7,8 @@
     - `def __call__(self, scope, receive, send)`
     - `def authenticate(self, conn)`
 
+- `def user_pwd_auth(lookup, skip, **kwargs)`
+- `def basic_logout(request)`
 ## fasthtml.cli
 
 - `@call_parse def railway_link()`
@@ -19,6 +21,12 @@
 
 > `ft_html` and `ft_hx` functions to add some conveniences to `ft`, along with a full set of basic HTML components, and functions to work with forms and `FT` conversion
 
+- `@patch def __str__(self)`
+- `@patch def __radd__(self, b)`
+- `@patch def __add__(self, b)`
+- `def attrmap_x(o)`
+- `def ft_html(tag, *c, **kwargs)`
+- `@use_kwargs(hx_attrs + evt_attrs, keep=True) def ft_hx(tag, *c, **kwargs)`
 - `def File(fname)`
     Use the unescaped text in file `fname` directly
 
@@ -34,6 +42,7 @@
 - `def find_inputs(e, tags, **kw)`
     Recursively find all elements in `e` with `tags` and attrs matching `kw`
 
+- `def __getattr__(tag)`
 - `def html2ft(html, attr1st)`
     Convert HTML to an `ft` expression
 
@@ -80,6 +89,11 @@
 - `def EventStream(s)`
     Create a text/event-stream response from `s`
 
+- `def signal_shutdown()`
+- `def uri(_arg, **kwargs)`
+- `def decode_uri(s)`
+- `@patch def to_string(self, value)`
+- `@patch def url_path_for(self, name, **path_params)`
 - `def flat_tuple(o)`
     Flatten lists
 
@@ -89,12 +103,14 @@
 - `def respond(req, heads, bdy)`
     Default FT response creation function
 
+- `def is_full_page(req, resp)`
 - `class Redirect`
     Use HTMX or Starlette RedirectResponse as required to redirect to `loc`
 
     - `def __init__(self, loc)`
     - `def __response__(self, req)`
 
+- `def get_key(key, fname)`
 - `def qp(p, **kw)`
     Add parameters kw to path p
 
@@ -103,8 +119,8 @@
 
 - `class FastHTML`
     - `def __init__(self, debug, routes, middleware, title, exception_handlers, on_startup, on_shutdown, lifespan, hdrs, ftrs, exts, before, after, surreal, htmx, default_hdrs, sess_cls, secret_key, session_cookie, max_age, sess_path, same_site, sess_https_only, sess_domain, key_fname, body_wrap, htmlkw, nb_hdrs, canonical, **bodykw)`
-    - `def add_route(self, route)`
 
+- `@patch def add_route(self, route)`
 - `@patch def ws(self, path, conn, disconn, name, middleware)`
     Add a websocket route at `path`
 
@@ -114,6 +130,7 @@
 - `@patch def route(self, path, methods, name, include_in_schema, body_wrap)`
     Add a route at `path`
 
+- `@patch def set_lifespan(self, value)`
 - `def serve(appname, app, host, port, reload, reload_includes, reload_excludes)`
     Run the app in an async server, with live reload set as the default.
 
@@ -146,6 +163,7 @@
 - `def cookie(key, value, max_age, expires, path, domain, secure, httponly, samesite)`
     Create a 'set-cookie' `HttpHeader`
 
+- `def reg_re_param(m, s)`
 - `@patch def static_route_exts(self, prefix, static_path, exts)`
     Add a static route at URL path `prefix` with files from `static_path` and `exts` defined by `reg_re_param()`
 
@@ -161,6 +179,9 @@
     - `def __init__(self, content, status_code, headers, cls, media_type, background)`
     - `def __response__(self, req)`
 
+- `def unqid(seeded)`
+- `@patch def setup_ws(app, f)`
+- `@patch def devtools_json(self, path, uuid)`
 ## fasthtml.fastapp
 
 > The `fast_app` convenience wrapper
@@ -181,9 +202,11 @@
 - `def MarkdownJS(sel)`
     Implements browser-based markdown rendering.
 
+- `def KatexMarkdownJS(sel, inline_delim, display_delim, math_envs)`
 - `def HighlightJS(sel, langs, light, dark)`
     Implements browser-based syntax highlighting. Usage example [here](/tutorials/quickstart_for_web_devs.html#code-highlighting).
 
+- `def SortableJS(sel, ghost_class)`
 - `def MermaidJS(sel, theme)`
     Implements browser-based Mermaid diagram rendering.
 
@@ -203,6 +226,8 @@
 - `def wait_port_free(port, host, max_wait)`
     Wait for `port` to be free on `host`
 
+- `def render_ft()`
+- `def htmx_config_port(port)`
 - `class JupyUvi`
     Start and stop a Jupyter compatible uvicorn server with ASGI `app` on `port` with `log_level`
 
@@ -218,11 +243,14 @@
     - `def start(self)`
     - `def stop(self)`
 
-- `def HTMX(path, app, host, port, height, link, iframe)`
+- `def HTMX(path, host, app, port, height, link, iframe)`
     An iframe which displays the HTMX application in a notebook.
 
+- `def ws_client(app, nm, host, port, ws_connect, frame, link, **kwargs)`
 ## fasthtml.live_reload
 
+- `def LiveReloadJs(reload_attempts, reload_interval, **kwargs)`
+- `def live_reload_ws(websocket)`
 - `class FastHTMLWithLiveReload`
     `FastHTMLWithLiveReload` enables live reloading.
     This means that any code changes saved on the server will automatically
@@ -299,6 +327,7 @@
 - `@patch def retr_id(self, code, redirect_uri)`
     Call `retr_info` and then return id/subscriber value
 
+- `def url_match(url, patterns)`
 - `class OAuth`
     - `def __init__(self, app, cli, skip, redir_path, error_path, logout_path, login_path, https, http_patterns)`
     - `def redir_login(self, session)`
@@ -324,6 +353,7 @@
 
 > Basic components for generating Pico CSS tags
 
+- `def set_pico_cls()`
 - `@delegates(ft_hx, keep=True) def Card(*c, **kwargs)`
     A PicoCSS Card, implemented as an Article with optional Header and Footer
 
@@ -342,6 +372,7 @@
 - `@delegates(ft_hx, keep=True) def Container(*args, **kwargs)`
     A PicoCSS Container, implemented as a Main with class 'container'
 
+- `def PicoBusy()`
 ## fasthtml.stripe_otp
 
 - `def create_price(app_nm, amt, currency)`
@@ -350,8 +381,16 @@
 - `def archive_price(app_nm)`
     Archive a price - useful for cleanup if testing.
 
+- `def before(sess)`
+- `@rt('/') def home(sess)`
+- `@rt('/create-checkout-session', methods=['POST']) def create_checkout_session(sess)`
 - `class Payment`
 
+- `@rt('/webhook') def post(req)`
+- `@rt('/success') def success(sess, checkout_sid)`
+- `@rt('/cancel') def cancel()`
+- `@rt('/refund', methods=['POST']) def refund(sess, checkout_sid)`
+- `@rt('/account') def account_management(sess)`
 ## fasthtml.svg
 
 > Simple SVG FT elements
@@ -424,6 +463,13 @@
 - `def SvgInb(*args, **kwargs)`
     Wraps an SVG shape as required for an HTMX inband swap
 
+## fasthtml.toaster
+
+- `def Toast(message, typ, dismiss, duration)`
+- `def add_toast(sess, message, typ, dismiss)`
+- `def render_toasts(sess)`
+- `def toast_after(resp, req, sess)`
+- `def setup_toasts(app, duration)`
 ## fasthtml.xtend
 
 > Simple extensions to standard HTML components, such as adding sensible defaults
@@ -488,6 +534,7 @@
 - `def run_js(js, id, **kw)`
     Run `js` script, auto-generating `id` based on name of caller if needed, and js-escaping any `kw` params
 
+- `def HtmxOn(eventname, code)`
 - `def jsd(org, repo, root, path, prov, typ, ver, esm, **kwargs)`
     jsdelivr `Script` or CSS `Link` tag, or URL
 
@@ -508,3 +555,5 @@
 - `def Favicon(light_icon, dark_icon)`
     Light and dark favicon headers
 
+- `def clear(id)`
+- `def with_sid(app, dest, path)`

nbs/index.ipynb

@@ -145,7 +145,7 @@
     "\n",
     "Then explore the small but growing third-party ecosystem of FastHTML tutorials, notebooks, libraries, and components:\n",
     "\n",
-    "- [FastHTML Gallery](https://fastht.ml/gallery): Learn from minimal examples of components (ie chat bubbles, click-to-edit, infinite scroll, etc)\n",
+    "- [FastHTML Gallery](https://gallery.fastht.ml): Learn from minimal examples of components (ie chat bubbles, click-to-edit, infinite scroll, etc)\n",
     "- [Creating Custom FastHTML Tags for Markdown Rendering](https://isaac-flath.github.io/website/posts/boots/FasthtmlTutorial.html) by Isaac Flath\n",
     "- [How to Build a Simple Login System in FastHTML](https://blog.mariusvach.com/posts/login-fasthtml) by Marius Vach\n",
     "- Your tutorial here!\n",