python-fasthtml 0.14.13__tar.gz → 0.14.14__tar.gz

{python_fasthtml-0.14.13 → python_fasthtml-0.14.14}/CONTRIBUTING.md

@@ -3,7 +3,7 @@
 Make sure you have read the [doc on code style](
 https://docs.fast.ai/dev/style.html) first. (Note that we don't follow PEP8, but instead follow a coding style designed specifically for numerical and interactive programming.)
 
-This project uses [nbdev](https://nbdev.fast.ai/getting_started.html) for development. Before beginning, make sure that nbdev and a jupyter-compatible client such as jupyterlab or nbclassic are installed. To make changes to the codebase, update the notebooks in the `nbs` folder, not the .py files directly. Then, run `nbdev_export`. For more details, have a look at the [nbdev tutorial](https://nbdev.fast.ai/tutorials/tutorial.html). Depending on the code changes, you might also need to run `tools/update.sh` to update python interface modules and [LLM reference material](https://github.com/AnswerDotAI/llms-txt).
+This project uses [nbdev](https://nbdev.fast.ai/getting_started.html) for development. Before beginning, make sure that nbdev and a jupyter-compatible client such as jupyterlab or nbclassic are installed. To make changes to the codebase, update the notebooks in the `nbs` folder, not the .py files directly. Then, run `nbdev-export`. For more details, have a look at the [nbdev tutorial](https://nbdev.fast.ai/tutorials/tutorial.html). Depending on the code changes, you might also need to run `tools/update.sh` to update python interface modules and [LLM reference material](https://github.com/AnswerDotAI/llms-txt).
 
 You may want to set up a `prep` alias in `~/.zshrc` or other shell startup file:
 
@@ -11,7 +11,7 @@ You may want to set up a `prep` alias in `~/.zshrc` or other shell startup file:
 alias prep='nbdev-export && nbdev-clean && nbdev-trust'
 ```
 
-Run `prep` before each commit to ensure your python files are up to date, and you notebooks cleaned of metadata and notarized.
+Run `prep` before each commit to ensure your python files are up to date, and your notebooks cleaned of metadata and notarized.
 
 ## Updating README.md
 
@@ -26,13 +26,13 @@ pip install -e '.[dev]'
 And install quarto too:
 
 ```
-nbdev_install_quarto
+nbdev-install-quarto
 ```
 
 Then, after you make subsequent changes to `nbs/index.ipynb`, run the following from the repo's root directory to (re)build `README.md`:
 
 ```
-nbdev_readme
+nbdev-readme
 ```
 
 ## Did you find a bug?

{python_fasthtml-0.14.13/python_fasthtml.egg-info → python_fasthtml-0.14.14}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: python-fasthtml
-Version: 0.14.13
+Version: 0.14.14
 Summary: The fastest way to create an HTML app
 Author-email: Jeremy Howard and contributors <github@jhoward.fastmail.fm>
-License: Apache-2.0
+License-Expression: Apache-2.0
 Project-URL: Repository, https://github.com/AnswerDotAI/fasthtml
 Project-URL: Documentation, https://www.fastht.ml/docs/
 Keywords: nbdev,jupyter,notebook,python

{python_fasthtml-0.14.13 → python_fasthtml-0.14.14}/fasthtml/__init__.py

@@ -4,5 +4,5 @@ Modules:
 
 - `fasthtml.core`: The `FastHTML` subclass of `Starlette`."""
 
-__version__ = "0.14.13"
+__version__ = "0.14.14"
 from .core import *

{python_fasthtml-0.14.13 → python_fasthtml-0.14.14}/fasthtml/_modidx.py

@@ -5,12 +5,9 @@ d = { 'settings': { 'branch': 'main',
                 'doc_host': 'https://www.fastht.ml',
                 'git_url': 'https://github.com/AnswerDotAI/fasthtml',
                 'lib_path': 'fasthtml'},
-  'syms': { 'fasthtml.authmw': {},
-            'fasthtml.basics': {},
-            'fasthtml.cli': { 'fasthtml.cli._run': ('api/cli.html#_run', 'fasthtml/cli.py'),
+  'syms': { 'fasthtml.cli': { 'fasthtml.cli._run': ('api/cli.html#_run', 'fasthtml/cli.py'),
                               'fasthtml.cli.railway_deploy': ('api/cli.html#railway_deploy', 'fasthtml/cli.py'),
                               'fasthtml.cli.railway_link': ('api/cli.html#railway_link', 'fasthtml/cli.py')},
-            'fasthtml.common': {},
             'fasthtml.components': { 'fasthtml.components.FT.__add__': ('api/components.html#ft.__add__', 'fasthtml/components.py'),
                                      'fasthtml.components.FT.__radd__': ('api/components.html#ft.__radd__', 'fasthtml/components.py'),
                                      'fasthtml.components.FT.__str__': ('api/components.html#ft.__str__', 'fasthtml/components.py'),
@@ -169,8 +166,6 @@ d = { 'settings': { 'branch': 'main',
                                'fasthtml.core.until_disconnect': ('api/core.html#until_disconnect', 'fasthtml/core.py'),
                                'fasthtml.core.uri': ('api/core.html#uri', 'fasthtml/core.py'),
                                'fasthtml.core.vurl': ('api/core.html#vurl', 'fasthtml/core.py')},
-            'fasthtml.fastapp': {},
-            'fasthtml.ft': {},
             'fasthtml.js': { 'fasthtml.js.HighlightJS': ('api/js.html#highlightjs', 'fasthtml/js.py'),
                              'fasthtml.js.KatexMarkdownJS': ('api/js.html#katexmarkdownjs', 'fasthtml/js.py'),
                              'fasthtml.js.MarkdownJS': ('api/js.html#markdownjs', 'fasthtml/js.py'),
@@ -196,7 +191,6 @@ d = { 'settings': { 'branch': 'main',
                                   'fasthtml.jupyter.render_ft': ('api/jupyter.html#render_ft', 'fasthtml/jupyter.py'),
                                   'fasthtml.jupyter.show': ('api/jupyter.html#show', 'fasthtml/jupyter.py'),
                                   'fasthtml.jupyter.ws_client': ('api/jupyter.html#ws_client', 'fasthtml/jupyter.py')},
-            'fasthtml.live_reload': {},
             'fasthtml.oauth': { 'fasthtml.oauth.AppleAppClient': ('api/oauth.html#appleappclient', 'fasthtml/oauth.py'),
                                 'fasthtml.oauth.AppleAppClient.__init__': ('api/oauth.html#appleappclient.__init__', 'fasthtml/oauth.py'),
                                 'fasthtml.oauth.AppleAppClient.client_secret': ( 'api/oauth.html#appleappclient.client_secret',
@@ -265,7 +259,6 @@ d = { 'settings': { 'branch': 'main',
                                'fasthtml.pico.PicoBusy': ('api/pico.html#picobusy', 'fasthtml/pico.py'),
                                'fasthtml.pico.Search': ('api/pico.html#search', 'fasthtml/pico.py'),
                                'fasthtml.pico.set_pico_cls': ('api/pico.html#set_pico_cls', 'fasthtml/pico.py')},
-            'fasthtml.starlette': {},
             'fasthtml.stripe_otp': { 'fasthtml.stripe_otp.Payment': ('explains/stripe.html#payment', 'fasthtml/stripe_otp.py'),
                                      'fasthtml.stripe_otp._search_app': ('explains/stripe.html#_search_app', 'fasthtml/stripe_otp.py'),
                                      'fasthtml.stripe_otp.account_management': ( 'explains/stripe.html#account_management',
@@ -305,7 +298,6 @@ d = { 'settings': { 'branch': 'main',
                               'fasthtml.svg.Text': ('api/svg.html#text', 'fasthtml/svg.py'),
                               'fasthtml.svg.ft_svg': ('api/svg.html#ft_svg', 'fasthtml/svg.py'),
                               'fasthtml.svg.transformd': ('api/svg.html#transformd', 'fasthtml/svg.py')},
-            'fasthtml.toaster': {},
             'fasthtml.xtend': { 'fasthtml.xtend.A': ('api/xtend.html#a', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.AX': ('api/xtend.html#ax', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.AnyNow': ('api/xtend.html#anynow', 'fasthtml/xtend.py'),

{python_fasthtml-0.14.13 → python_fasthtml-0.14.14}/fasthtml/core.py

@@ -18,7 +18,7 @@ The decorated function doubles as a URL builder, so links never need hardcoded p
 
 Handlers return FT trees (from `fastcore.xml`), rendered as HTML automatically: a full page for regular requests, a bare fragment for HTMX requests. In a full page, top-level `Title`, `Meta`, `Link`, and `Style` items go in `<head>`; the rest goes in `<body>`. Strings are sent as HTML, dicts as JSON, and a Starlette `Response` is sent untouched. A return tuple may mix content with special items: any `HttpHeader` (e.g. from `cookie()` or `HtmxResponseHeaders()`) becomes a response header, any `BackgroundTask` runs after the response is sent, and the rest renders as content. `Redirect` picks the right redirect mechanism for HTMX vs regular requests, and `FtResponse` wraps FT content when you need the status code or headers.
 
-Handler parameters are filled from the request: each is looked up in path, cookie, header (snake_case names match Hyphen-Case headers), query, then form data, and cast by calling its annotation on the value. `bool`, `int`, and `date` get smart string parsing; `UploadFile` passes through. Repeated params take the last value unless annotated `list[T]`, which collects them all. A param with no annotation and no special name is ignored, with a warning. A dataclass, TypedDict, namedtuple, or any annotated class collects the whole form body; a `__from_request__` classmethod customizes construction. A missing required param is a 400, a failed cast a 404. These special names need no annotation:
+Handler parameters are filled from the request: each is looked up in path, cookie, header (snake_case names match Hyphen-Case headers), query, then form data, and cast by calling its annotation on the value. Hyphens in form/query names match underscores in handler parameters and typed body fields. Exact names take precedence within each source. Dictionary and request access retain the original keys. `bool`, `int`, and `date` get smart string parsing; `UploadFile` passes through. Repeated params take the last value unless annotated `list[T]`, which collects them all. A param with no annotation and no special name is ignored, with a warning. A dataclass, TypedDict, namedtuple, or any annotated class collects the whole form body; a `__from_request__` classmethod customizes construction. A missing required param is a 400, a failed cast a 404. These special names need no annotation:
 
     req, ws   the Request / WebSocket connection
     sess      session dict
@@ -80,6 +80,7 @@ from base64 import b64encode,b64decode
 from email.utils import format_datetime
 
 from .starlette import *
+from python_multipart.exceptions import MultipartParseError
 
 # %% ../nbs/api/00_core.ipynb #19d3f2a7
 def _params(f): return signature_ex(f, True).parameters
@@ -189,7 +190,8 @@ def _is_body(anno): return issubclass(anno, (dict,ns)) or hasattr(anno,'__from_r
 
 # %% ../nbs/api/00_core.ipynb #ffdde66f
 def _formitem(form, k):
-    "Return single item `k` from `form` if len 1, otherwise return list"
+    "Return item `k`, accepting hyphens for underscores and unwrapping single-item form lists"
+    if k not in form: k = {o.replace('-', '_'):o for o in form}.get(k, k)
     if isinstance(form, dict): return form.get(k)
     o = form.getlist(k)
     return o[0] if len(o) == 1 else o if o else None
@@ -205,16 +207,21 @@ DEF_MAXPART = 100*1024*1024
 
 # %% ../nbs/api/00_core.ipynb #42c9cea0
 async def parse_form(req: Request) -> FormData:
-    "Starlette errors on empty multipart/json forms, so this checks for that situation"
+    "Starlette errors on empty multipart/json forms and 500s on malformed multipart, so this handles those situations"
     ctype = req.headers.get("Content-Type", "")
     maxpart = getattr(req, "max_part_size", DEF_MAXPART)
     if ctype.startswith("multipart/form-data"):
         try: boundary = ctype.split("boundary=")[1].strip()
         except IndexError: raise HTTPException(400, "Invalid form-data: no boundary")
         if int(req.headers.get("Content-Length", "0")) <= len(boundary) + 6: return FormData()
-        return await req.form(max_part_size=maxpart)
+        try: return await req.form(max_part_size=maxpart)
+        except MultipartParseError as e: raise HTTPException(400, f"Invalid form-data: {e}")
     body = await req.body()  # Cache body for non-multipart request types
-    if ctype == 'application/json': return await req.json() if body else {}
+    if ctype == 'application/json':
+        try: res = await req.json() if body else {}
+        except ValueError: raise HTTPException(400, "Invalid JSON body")
+        if not isinstance(res, dict): raise HTTPException(400, "JSON body must be an object")
+        return res
     return await req.form(max_part_size=maxpart)
 
 # %% ../nbs/api/00_core.ipynb #0caedd04
@@ -229,6 +236,7 @@ async def _from_body(conn, p, data):
         kwargs = await _find_ps(conn, data, conn.headers, ps)
         return await maybe_await(ctor(**kwargs))
     d = _annotations(anno)
+    if d: data = {k.replace('-', '_'):v for k,v in data.items()} | data
     cargs = {k: _form_arg(k, v, d) for k, v in data.items() if not d or k in d}
     return anno(**cargs)
 
@@ -286,10 +294,9 @@ async def _find_p(conn, data, hdrs, arg:str, p:Parameter):
     res = conn.path_params.get(arg, None)
     if res in (empty,None): res = conn.cookies.get(arg, None)
     if res in (empty,None): res = hdrs.get(snake2hyphens(arg), None)
-    if res in (empty,None): res = conn.query_params.getlist(arg)
-    if res==[]: res = None
-    if res in (empty,None): res = data.get(arg, None)
-    if res in (empty,None) and isinstance(vals := data.get('values'), dict): res = vals.get(arg)  # htmx v4 nests form data under `values`
+    if res in (empty,None): res = _formitem(conn.query_params, arg)
+    if res in (empty,None): res = _formitem(data, arg)
+    if res in (empty,None) and isinstance(vals := data.get('values'), dict): res = _formitem(vals, arg)  # htmx v4 nests form data under `values`
     if res in (empty,None):
         if p.default is empty:
             if isinstance(conn, Request): raise HTTPException(400, f"Missing required field: {arg}")

{python_fasthtml-0.14.13 → python_fasthtml-0.14.14}/fasthtml/oauth.py

@@ -249,7 +249,10 @@ class OAuth:
                 return RedirectResponse(self.error_path, status_code=303)
             scheme = 'http' if url_match(req,self.http_patterns) or not self.https else 'https'
             base_url = f"{scheme}://{get_host(req)}"
-            info = AttrDictDefault(await cli.retr_info_async(code, base_url+redir_path))
+            try: info = AttrDictDefault(await cli.retr_info_async(code, base_url+redir_path))
+            except httpx2.HTTPStatusError as e:
+                session['oauth_error'] = e.response.text
+                return RedirectResponse(self.error_path, status_code=303)
             ident = info.get(self.cli.id_key)
             if not ident: return self.redir_login(session)
             res = await _arun(self.get_auth(info, ident, session, state))

{python_fasthtml-0.14.13 → python_fasthtml-0.14.14}/pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=64"]
+requires = ["setuptools>=77"]
 build-backend = "setuptools.build_meta"
 
 [project]
@@ -8,7 +8,7 @@ dynamic = ["version"]
 description = "The fastest way to create an HTML app"
 readme = "README.md"
 requires-python = ">=3.10"
-license = {text = "Apache-2.0"}
+license = "Apache-2.0"
 authors = [{name = "Jeremy Howard and contributors", email = "github@jhoward.fastmail.fm"}]
 keywords = ['nbdev', 'jupyter', 'notebook', 'python']
 classifiers = ["Natural Language :: English", "Intended Audience :: Developers", "Development Status :: 3 - Alpha", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3 :: Only"]

{python_fasthtml-0.14.13 → python_fasthtml-0.14.14/python_fasthtml.egg-info}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: python-fasthtml
-Version: 0.14.13
+Version: 0.14.14
 Summary: The fastest way to create an HTML app
 Author-email: Jeremy Howard and contributors <github@jhoward.fastmail.fm>
-License: Apache-2.0
+License-Expression: Apache-2.0
 Project-URL: Repository, https://github.com/AnswerDotAI/fasthtml
 Project-URL: Documentation, https://www.fastht.ml/docs/
 Keywords: nbdev,jupyter,notebook,python