python-fasthtml 0.1.4__tar.gz → 0.1.6__tar.gz

{python_fasthtml-0.1.4/python_fasthtml.egg-info → python_fasthtml-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-fasthtml
-Version: 0.1.4
+Version: 0.1.6
 Summary: The fastest way to create an HTML app
 Home-page: https://github.com/AnswerDotAI/fasthtml
 Author: Jeremy Howard
@@ -20,7 +20,7 @@ Requires-Dist: python-dateutil
 Requires-Dist: starlette>0.33
 Requires-Dist: oauthlib
 Requires-Dist: itsdangerous
-Requires-Dist: uvicorn[standard]
+Requires-Dist: uvicorn[standard]>=0.30
 Requires-Dist: httpx
 Requires-Dist: fastlite>=0.0.6
 Requires-Dist: python-multipart

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/fasthtml/__init__.py

@@ -1,8 +1,7 @@
-__version__ = "0.1.4"
+__version__ = "0.1.6"
 from .core import *
 from .authmw import *
 from .components import *
 from .xtend import *
 from .live_reload import *
 from .toaster import *
-

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/fasthtml/_modidx.py

@@ -10,7 +10,8 @@ d = { 'settings': { 'branch': 'main',
                               'fasthtml.cli.railway_deploy': ('cli.html#railway_deploy', 'fasthtml/cli.py'),
                               'fasthtml.cli.railway_link': ('cli.html#railway_link', 'fasthtml/cli.py')},
             'fasthtml.common': {},
-            'fasthtml.components': { 'fasthtml.components.__getattr__': ('components.html#__getattr__', 'fasthtml/components.py'),
+            'fasthtml.components': { 'fasthtml.components.File': ('components.html#file', 'fasthtml/components.py'),
+                                     'fasthtml.components.__getattr__': ('components.html#__getattr__', 'fasthtml/components.py'),
                                      'fasthtml.components._fill_item': ('components.html#_fill_item', 'fasthtml/components.py'),
                                      'fasthtml.components.fill_dataclass': ('components.html#fill_dataclass', 'fasthtml/components.py'),
                                      'fasthtml.components.fill_form': ('components.html#fill_form', 'fasthtml/components.py'),
@@ -55,6 +56,7 @@ d = { 'settings': { 'branch': 'main',
                                'fasthtml.core._wrap_ws': ('core.html#_wrap_ws', 'fasthtml/core.py'),
                                'fasthtml.core._ws_endp': ('core.html#_ws_endp', 'fasthtml/core.py'),
                                'fasthtml.core._xt_resp': ('core.html#_xt_resp', 'fasthtml/core.py'),
+                               'fasthtml.core.cookie': ('core.html#cookie', 'fasthtml/core.py'),
                                'fasthtml.core.date': ('core.html#date', 'fasthtml/core.py'),
                                'fasthtml.core.flat_xt': ('core.html#flat_xt', 'fasthtml/core.py'),
                                'fasthtml.core.form2dict': ('core.html#form2dict', 'fasthtml/core.py'),
@@ -89,6 +91,7 @@ d = { 'settings': { 'branch': 'main',
                                 'fasthtml.xtend.Checkbox': ('xtend.html#checkbox', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.Container': ('xtend.html#container', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.DialogX': ('xtend.html#dialogx', 'fasthtml/xtend.py'),
+                                'fasthtml.xtend.Favicon': ('xtend.html#favicon', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.Grid': ('xtend.html#grid', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.Group': ('xtend.html#group', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.Hidden': ('xtend.html#hidden', 'fasthtml/xtend.py'),
@@ -96,6 +99,7 @@ d = { 'settings': { 'branch': 'main',
                                 'fasthtml.xtend.Script': ('xtend.html#script', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.ScriptX': ('xtend.html#scriptx', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.Search': ('xtend.html#search', 'fasthtml/xtend.py'),
+                                'fasthtml.xtend.Socials': ('xtend.html#socials', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.Style': ('xtend.html#style', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.StyleX': ('xtend.html#stylex', 'fasthtml/xtend.py'),
                                 'fasthtml.xtend.Titled': ('xtend.html#titled', 'fasthtml/xtend.py'),

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/fasthtml/components.py

@@ -1,9 +1,9 @@
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/01_components.ipynb.
 
 # %% auto 0
-__all__ = ['voids', 'named', 'html_attrs', 'hx_attrs', 'show', 'xt_html', 'xt_hx', 'fill_form', 'fill_dataclass', 'find_inputs',
-           'html2xt', 'A', 'Abbr', 'Address', 'Area', 'Article', 'Aside', 'Audio', 'B', 'Base', 'Bdi', 'Bdo',
-           'Blockquote', 'Body', 'Br', 'Button', 'Canvas', 'Caption', 'Cite', 'Code', 'Col', 'Colgroup', 'Data',
+__all__ = ['voids', 'named', 'html_attrs', 'hx_attrs', 'show', 'xt_html', 'xt_hx', 'File', 'fill_form', 'fill_dataclass',
+           'find_inputs', 'html2xt', 'A', 'Abbr', 'Address', 'Area', 'Article', 'Aside', 'Audio', 'B', 'Base', 'Bdi',
+           'Bdo', 'Blockquote', 'Body', 'Br', 'Button', 'Canvas', 'Caption', 'Cite', 'Code', 'Col', 'Colgroup', 'Data',
            'Datalist', 'Dd', 'Del', 'Details', 'Dfn', 'Dialog', 'Div', 'Dl', 'Dt', 'Em', 'Embed', 'Fencedframe',
            'Fieldset', 'Figcaption', 'Figure', 'Footer', 'Form', 'H1', 'Head', 'Header', 'Hgroup', 'Hr', 'Html', 'I',
            'Iframe', 'Img', 'Input', 'Ins', 'Kbd', 'Label', 'Legend', 'Li', 'Link', 'Main', 'Map', 'Mark', 'Menu',
@@ -65,7 +65,12 @@ _all_ = [
     'Td', 'Template', 'Textarea', 'Tfoot', 'Th', 'Thead', 'Time', 'Title', 'Tr', 'Track', 'U', 'Ul', 'Var', 'Video', 'Wbr']
 for o in _all_: _g[o] = partial(xt_hx, o.lower())
 
-# %% ../nbs/01_components.ipynb 12
+# %% ../nbs/01_components.ipynb 9
+def File(fname):
+    "Use the unescaped text in file `fname` directly"
+    return NotStr(Path(fname).read_text())
+
+# %% ../nbs/01_components.ipynb 14
 def _fill_item(item, obj):
     if not isinstance(item,list): return item
     tag,cs,attr = item
@@ -81,19 +86,19 @@ def _fill_item(item, obj):
         if tag=='textarea': cs=(val,)
     return XT(tag,cs,attr)
 
-# %% ../nbs/01_components.ipynb 13
+# %% ../nbs/01_components.ipynb 15
 def fill_form(form:XT, obj)->XT:
     "Fills named items in `form` using attributes in `obj`"
     if not isinstance(obj,dict): obj = asdict(obj)
     return _fill_item(form, obj)
 
-# %% ../nbs/01_components.ipynb 15
+# %% ../nbs/01_components.ipynb 17
 def fill_dataclass(src, dest):
     "Modifies dataclass in-place and returns it"
     for nm,val in asdict(src).items(): setattr(dest, nm, val)
     return dest
 
-# %% ../nbs/01_components.ipynb 17
+# %% ../nbs/01_components.ipynb 19
 def find_inputs(e, tags='input', **kw):
     # Recursively find all elements in `e` with `tags` and attrs matching `kw`
     if not isinstance(e, (list,tuple)): return []
@@ -107,14 +112,14 @@ def find_inputs(e, tags='input', **kw):
     for o in cs: inputs += find_inputs(o, tags, **kw)
     return inputs
 
-# %% ../nbs/01_components.ipynb 21
+# %% ../nbs/01_components.ipynb 23
 def __getattr__(tag):
     if tag.startswith('_') or tag[0].islower(): raise AttributeError
     tag = tag.replace("_", "-")
     def _f(*c, target_id=None, **kwargs): return xt_hx(tag, *c, target_id=target_id, **kwargs)
     return _f
 
-# %% ../nbs/01_components.ipynb 22
+# %% ../nbs/01_components.ipynb 24
 def html2xt(html):
     rev_map = {'class': 'cls', 'for': 'fr'}
     

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/fasthtml/components.pyi

@@ -1,3 +1,57 @@
+__all__ = ['voids', 'named', 'html_attrs', 'hx_attrs', 'show', 'xt_html', 'xt_hx', 'File', 'fill_form', 'fill_dataclass', 'find_inputs', 'html2xt', 'A', 'Abbr', 'Address', 'Area', 'Article', 'Aside', 'Audio', 'B', 'Base', 'Bdi', 'Bdo', 'Blockquote', 'Body', 'Br', 'Button', 'Canvas', 'Caption', 'Cite', 'Code', 'Col', 'Colgroup', 'Data', 'Datalist', 'Dd', 'Del', 'Details', 'Dfn', 'Dialog', 'Div', 'Dl', 'Dt', 'Em', 'Embed', 'Fencedframe', 'Fieldset', 'Figcaption', 'Figure', 'Footer', 'Form', 'H1', 'Head', 'Header', 'Hgroup', 'Hr', 'Html', 'I', 'Iframe', 'Img', 'Input', 'Ins', 'Kbd', 'Label', 'Legend', 'Li', 'Link', 'Main', 'Map', 'Mark', 'Menu', 'Meta', 'Meter', 'Nav', 'Noscript', 'Object', 'Ol', 'Optgroup', 'Option', 'Output', 'P', 'Picture', 'PortalExperimental', 'Pre', 'Progress', 'Q', 'Rp', 'Rt', 'Ruby', 'S', 'Samp', 'Script', 'Search', 'Section', 'Select', 'Slot', 'Small', 'Source', 'Span', 'Strong', 'Style', 'Sub', 'Summary', 'Sup', 'Table', 'Tbody', 'Td', 'Template', 'Textarea', 'Tfoot', 'Th', 'Thead', 'Time', 'Title', 'Tr', 'Track', 'U', 'Ul', 'Var', 'Video', 'Wbr']
+from dataclasses import dataclass, asdict, is_dataclass, make_dataclass, replace, astuple, MISSING
+from bs4 import BeautifulSoup
+from fastcore.utils import *
+from fastcore.xml import *
+from fastcore.meta import use_kwargs, delegates
+import types
+try:
+    from IPython import display
+except ImportError:
+    display = None
+
+def show(xt, *rest):
+    ...
+voids = set('area base br col command embed hr img input keygen link meta param source track wbr !doctype'.split())
+named = set('a button form frame iframe img input map meta object param select textarea'.split())
+html_attrs = 'id cls title style accesskey contenteditable dir draggable enterkeyhint hidden inert inputmode lang popover spellcheck tabindex translate'.split()
+hx_attrs = 'get post put delete patch trigger target swap include select indicator push_url confirm disable replace_url on'
+hx_attrs = html_attrs + [f'hx_{o}' for o in hx_attrs.split()]
+
+def xt_html(tag: str, *c, id=None, cls=None, title=None, style=None, **kwargs):
+    ...
+
+@use_kwargs(hx_attrs, keep=True)
+def xt_hx(tag: str, *c, target_id=None, **kwargs):
+    ...
+_g = globals()
+_all_ = ['A', 'Abbr', 'Address', 'Area', 'Article', 'Aside', 'Audio', 'B', 'Base', 'Bdi', 'Bdo', 'Blockquote', 'Body', 'Br', 'Button', 'Canvas', 'Caption', 'Cite', 'Code', 'Col', 'Colgroup', 'Data', 'Datalist', 'Dd', 'Del', 'Details', 'Dfn', 'Dialog', 'Div', 'Dl', 'Dt', 'Em', 'Embed', 'Fencedframe', 'Fieldset', 'Figcaption', 'Figure', 'Footer', 'Form', 'H1', 'Head', 'Header', 'Hgroup', 'Hr', 'Html', 'I', 'Iframe', 'Img', 'Input', 'Ins', 'Kbd', 'Label', 'Legend', 'Li', 'Link', 'Main', 'Map', 'Mark', 'Menu', 'Meta', 'Meter', 'Nav', 'Noscript', 'Object', 'Ol', 'Optgroup', 'Option', 'Output', 'P', 'Picture', 'PortalExperimental', 'Pre', 'Progress', 'Q', 'Rp', 'Rt', 'Ruby', 'S', 'Samp', 'Script', 'Search', 'Section', 'Select', 'Slot', 'Small', 'Source', 'Span', 'Strong', 'Style', 'Sub', 'Summary', 'Sup', 'Table', 'Tbody', 'Td', 'Template', 'Textarea', 'Tfoot', 'Th', 'Thead', 'Time', 'Title', 'Tr', 'Track', 'U', 'Ul', 'Var', 'Video', 'Wbr']
+for o in _all_:
+    _g[o] = partial(xt_hx, o.lower())
+
+def File(fname):
+    """Use the unescaped text in file `fname` directly"""
+    ...
+
+def _fill_item(item, obj):
+    ...
+
+def fill_form(form: XT, obj) -> XT:
+    """Fills named items in `form` using attributes in `obj`"""
+    ...
+
+def fill_dataclass(src, dest):
+    """Modifies dataclass in-place and returns it"""
+    ...
+
+def find_inputs(e, tags='input', **kw):
+    ...
+
+def __getattr__(tag):
+    ...
+
+def html2xt(html):
+    ...
 def xt_html(tag: str, *c, id:str|None=None, cls:str|None=None, title:str|None=None, style:str|None=None, accesskey:str|None=None, contenteditable:str|None=None, dir:str|None=None, draggable:str|None=None, enterkeyhint:str|None=None, hidden:str|None=None, inert:str|None=None, inputmode:str|None=None, lang:str|None=None, popover:str|None=None, spellcheck:str|None=None, tabindex:str|None=None, translate:str|None=None, id:str|None=None, cls:str|None=None, title:str|None=None, style:str|None=None, accesskey:str|None=None, contenteditable:str|None=None, dir:str|None=None, draggable:str|None=None, enterkeyhint:str|None=None, hidden:str|None=None, inert:str|None=None, inputmode:str|None=None, lang:str|None=None, popover:str|None=None, spellcheck:str|None=None, tabindex:str|None=None, translate:str|None=None, hx_get:str|None=None, hx_post:str|None=None, hx_put:str|None=None, hx_delete:str|None=None, hx_patch:str|None=None, hx_trigger:str|None=None, hx_target:str|None=None, hx_swap:str|None=None, hx_include:str|None=None, hx_select:str|None=None, hx_indicator:str|None=None, hx_push_url:str|None=None, hx_confirm:str|None=None, hx_disable:str|None=None, hx_replace_url:str|None=None, hx_on:str|None=None, **kwargs): ...
 def xt_hx(tag: str, *c, id:str|None=None, cls:str|None=None, title:str|None=None, style:str|None=None, accesskey:str|None=None, contenteditable:str|None=None, dir:str|None=None, draggable:str|None=None, enterkeyhint:str|None=None, hidden:str|None=None, inert:str|None=None, inputmode:str|None=None, lang:str|None=None, popover:str|None=None, spellcheck:str|None=None, tabindex:str|None=None, translate:str|None=None, id:str|None=None, cls:str|None=None, title:str|None=None, style:str|None=None, accesskey:str|None=None, contenteditable:str|None=None, dir:str|None=None, draggable:str|None=None, enterkeyhint:str|None=None, hidden:str|None=None, inert:str|None=None, inputmode:str|None=None, lang:str|None=None, popover:str|None=None, spellcheck:str|None=None, tabindex:str|None=None, translate:str|None=None, hx_get:str|None=None, hx_post:str|None=None, hx_put:str|None=None, hx_delete:str|None=None, hx_patch:str|None=None, hx_trigger:str|None=None, hx_target:str|None=None, hx_swap:str|None=None, hx_include:str|None=None, hx_select:str|None=None, hx_indicator:str|None=None, hx_push_url:str|None=None, hx_confirm:str|None=None, hx_disable:str|None=None, hx_replace_url:str|None=None, hx_on:str|None=None, **kwargs): ...
 def A(*c, name:str|None=None, id:str|None=None, cls:str|None=None, title:str|None=None, style:str|None=None, accesskey:str|None=None, contenteditable:str|None=None, dir:str|None=None, draggable:str|None=None, enterkeyhint:str|None=None, hidden:str|None=None, inert:str|None=None, inputmode:str|None=None, lang:str|None=None, popover:str|None=None, spellcheck:str|None=None, tabindex:str|None=None, translate:str|None=None, id:str|None=None, cls:str|None=None, title:str|None=None, style:str|None=None, accesskey:str|None=None, contenteditable:str|None=None, dir:str|None=None, draggable:str|None=None, enterkeyhint:str|None=None, hidden:str|None=None, inert:str|None=None, inputmode:str|None=None, lang:str|None=None, popover:str|None=None, spellcheck:str|None=None, tabindex:str|None=None, translate:str|None=None, hx_get:str|None=None, hx_post:str|None=None, hx_put:str|None=None, hx_delete:str|None=None, hx_patch:str|None=None, hx_trigger:str|None=None, hx_target:str|None=None, hx_swap:str|None=None, hx_include:str|None=None, hx_select:str|None=None, hx_indicator:str|None=None, hx_push_url:str|None=None, hx_confirm:str|None=None, hx_disable:str|None=None, hx_replace_url:str|None=None, hx_on:str|None=None, **kwargs): ...

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/fasthtml/core.py

@@ -3,7 +3,7 @@
 # %% auto 0
 __all__ = ['empty', 'htmx_hdrs', 'htmxscr', 'htmxwsscr', 'surrsrc', 'scopesrc', 'viewport', 'charset', 'all_meths',
            'is_typeddict', 'is_namedtuple', 'date', 'snake2hyphens', 'HtmxHeaders', 'str2int', 'HttpHeader',
-           'form2dict', 'flat_xt', 'Beforeware', 'WS_RouteX', 'RouteX', 'RouterX', 'get_key', 'FastHTML',
+           'form2dict', 'flat_xt', 'Beforeware', 'WS_RouteX', 'RouteX', 'RouterX', 'get_key', 'FastHTML', 'cookie',
            'reg_re_param', 'MiddlewareBase']
 
 # %% ../nbs/00_core.ipynb 3
@@ -20,7 +20,7 @@ from dataclasses import dataclass,fields,is_dataclass,MISSING,asdict
 from collections import namedtuple
 from inspect import isfunction,ismethod,signature,Parameter,get_annotations
 from functools import wraps, partialmethod
-from copy import deepcopy
+from http import cookies
 
 from .starlette import *
 
@@ -162,7 +162,8 @@ async def _find_p(req, arg:str, p:Parameter):
     # We can cast str and list[str] to types; otherwise just return what we have
     if not isinstance(res, (list,str)) or anno is empty: return res
     anno = _fix_anno(anno)
-    return [anno(o) for o in res] if isinstance(res,list) else anno(res)
+    try: return [anno(o) for o in res] if isinstance(res,list) else anno(res)
+    except ValueError: raise HTTPException(404, req.url.path) from None
 
 async def _wrap_req(req, params):
     return [await _find_p(req, arg, p) for arg,p in params.items()]
@@ -194,7 +195,7 @@ def _wrap_resp(req, resp, cls, hdrs, **bodykw):
     if isinstance(resp, FileResponse) and not os.path.exists(resp.path): raise HTTPException(404, resp.path)
     if isinstance(resp, Response): return resp
     if cls is not empty: return cls(resp)
-    if isinstance(resp, (list,tuple)) or hasattr(resp, '__xt__'): return _xt_resp(req, resp, hdrs, **bodykw)
+    if isinstance(resp, (list,tuple,HttpHeader)) or hasattr(resp, '__xt__'): return _xt_resp(req, resp, hdrs, **bodykw)
     if isinstance(resp, str): cls = HTMLResponse
     elif isinstance(resp, Mapping): cls = JSONResponse
     else:
@@ -374,16 +375,34 @@ all_meths = 'get post put delete patch head trace options'.split()
 for o in all_meths: setattr(FastHTML, o, partialmethod(FastHTML.route, methods=o))
 
 # %% ../nbs/00_core.ipynb 59
+def cookie(key: str, value="", max_age=None, expires=None, path="/", domain=None, secure=False, httponly=False, samesite="lax",):
+    "Create a 'set-cookie' `HttpHeader`"
+    cookie = cookies.SimpleCookie()
+    cookie[key] = value
+    if max_age is not None: cookie[key]["max-age"] = max_age
+    if expires is not None:
+        cookie[key]["expires"] = format_datetime(expires, usegmt=True) if isinstance(expires, datetime) else expires
+    if path is not None: cookie[key]["path"] = path
+    if domain is not None: cookie[key]["domain"] = domain
+    if secure: cookie[key]["secure"] = True
+    if httponly: cookie[key]["httponly"] = True
+    if samesite is not None:
+        assert samesite.lower() in [ "strict", "lax", "none", ], "must be 'strict', 'lax' or 'none'"
+        cookie[key]["samesite"] = samesite
+    cookie_val = cookie.output(header="").strip()
+    return HttpHeader("set-cookie", cookie_val)
+
+# %% ../nbs/00_core.ipynb 60
 def reg_re_param(m, s):
     cls = get_class(f'{m}Conv', sup=StringConvertor, regex=s)
     register_url_convertor(m, cls())
 
-# %% ../nbs/00_core.ipynb 60
+# %% ../nbs/00_core.ipynb 61
 # Starlette doesn't have the '?', so it chomps the whole remaining URL
 reg_re_param("path", ".*?")
 reg_re_param("static", "ico|gif|jpg|jpeg|webm|css|js|woff|png|svg|mp4|webp|ttf|otf|eot|woff2|txt|xml|html")
 
-# %% ../nbs/00_core.ipynb 61
+# %% ../nbs/00_core.ipynb 62
 class MiddlewareBase:
     async def __call__(self, scope, receive, send) -> None:
         if scope["type"] not in ["http", "websocket"]:

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/fasthtml/fastapp.py

@@ -15,7 +15,9 @@ def get_tbl(dt, nm, schema):
 def fast_app(db=None, render=None, hdrs=None, tbls=None, before=None, middleware=None, live=False, debug=False, routes=None, exception_handlers=None,
              on_startup=None, on_shutdown=None, lifespan=None, default_hdrs=True, secret_key=None, session_cookie='session_', max_age=365*24*3600,
              sess_path='/', same_site='lax', sess_https_only=False, sess_domain=None, key_fname='.sesskey', **kwargs):
-    h = (picolink,)
+
+    h = ()
+    if default_hdrs: h += (picolink, )
     if hdrs: h += tuple(hdrs)
     app_cls = FastHTMLWithLiveReload if live else FastHTML
     app = app_cls(hdrs=h, before=before, middleware=middleware, debug=debug, routes=routes, exception_handlers=exception_handlers,
@@ -43,7 +45,7 @@ def run_uv(fname=None, app='app', host='0.0.0.0', port=None, reload=True):
         if not fname: fname = Path(glb.get('__file__', '')).stem
         if not port: port=int(os.getenv("PORT", default=5001))
         print(f'Link: http://{"localhost" if host=="0.0.0.0" else host}:{port}')
-        uvicorn.run(f"{fname}:app", host=host, port=port, reload=reload)
+        uvicorn.run(f"{fname}:{app}", host=host, port=port, reload=reload)
 
 def clear(id): return Div(hx_swap_oob='innerHTML', id=id)
 def ContainerX(*cs, **kwargs): return Main(*cs, **kwargs, cls='container', hx_push_url='true', hx_swap_oob='true', id='main')

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/fasthtml/xtend.py

@@ -3,7 +3,7 @@
 # %% auto 0
 __all__ = ['picocss', 'picolink', 'picocondcss', 'picocondlink', 'set_pico_cls', 'Html', 'A', 'AX', 'Checkbox', 'Card', 'Group',
            'Search', 'Grid', 'DialogX', 'Hidden', 'Container', 'Script', 'Style', 'double_braces', 'undouble_braces',
-           'loose_format', 'ScriptX', 'replace_css_vars', 'StyleX', 'run_js', 'Titled', 'jsd']
+           'loose_format', 'ScriptX', 'replace_css_vars', 'StyleX', 'run_js', 'Titled', 'Socials', 'Favicon', 'jsd']
 
 # %% ../nbs/02_xtend.ipynb 2
 from dataclasses import dataclass, asdict
@@ -148,7 +148,7 @@ def loose_format(s, **kw):
 
 # %% ../nbs/02_xtend.ipynb 34
 def ScriptX(fname, type=None, _async=None, defer=None, charset=None, crossorigin=None, integrity=None, **kw):
-    "Create a Script from the text of a file"
+    "A `script` element with contents read from `fname`"
     attrs = ['src', 'type', 'async', 'defer', 'charset', 'crossorigin', 'integrity', 'nomodule']
     scr_kw = {k:kw.pop(k) for k in attrs if k in kw}
     s = loose_format(Path(fname).read_text(), **kw)
@@ -156,6 +156,7 @@ def ScriptX(fname, type=None, _async=None, defer=None, charset=None, crossorigin
 
 # %% ../nbs/02_xtend.ipynb 35
 def replace_css_vars(css, pre='tpl', **kwargs):
+    "Replace `var(--)` CSS variables with `kwargs` if name prefix matches `pre`"
     def replace_var(m):
         var_name = m.group(1).replace('-', '_')
         return kwargs.get(var_name, m.group(0))
@@ -163,6 +164,7 @@ def replace_css_vars(css, pre='tpl', **kwargs):
 
 # %% ../nbs/02_xtend.ipynb 36
 def StyleX(fname, **kw):
+    "A `style` element with contents read from `fname` and variables replaced from `kw`"
     s = Path(fname).read_text()
     attrs = ['type', 'media', 'scoped', 'title', 'nonce', 'integrity', 'crossorigin']
     sty_kw = {k:kw.pop(k) for k in attrs if k in kw}
@@ -182,6 +184,32 @@ def Titled(title:str="FastHTML app", *args, **kwargs)->XT:
     return Title(title), Main(H1(title), *args, cls="container", **kwargs)
 
 # %% ../nbs/02_xtend.ipynb 39
+def Socials(title, site_name, description, image, url, w=1200, h=630, twitter_site=None, creator=None, card='summary'):
+    "OG and Twitter social card headers"
+    res = [Meta(property='og:image', content=image),
+        Meta(property='og:site_name', content=site_name),
+        Meta(property='og:image:type', content='image/png'),
+        Meta(property='og:image:width', content=w),
+        Meta(property='og:image:height', content=h),
+        Meta(property='og:type', content='website'),
+        Meta(property='og:url', content=url),
+        Meta(property='og:title', content=title),
+        Meta(property='og:description', content=description),
+        Meta(name='twitter:image', content=image),
+        Meta(name='twitter:card', content=card),
+        Meta(name='twitter:title', content=title),
+        Meta(name='twitter:description', content=description)]
+    if twitter_site is not None: res.append(Meta(name='twitter:site',    content=twitter_site))
+    if creator      is not None: res.append(Meta(name='twitter:creator', content=creator))
+    return tuple(res)
+
+# %% ../nbs/02_xtend.ipynb 40
+def Favicon(light_icon, dark_icon):
+    "Light and dark favicon headers"
+    return (Link(rel='icon', type='image/x-ico', href=light_icon, media='(prefers-color-scheme: light)'),
+            Link(rel='icon', type='image/x-ico', href=dark_icon, media='(prefers-color-scheme: dark)'))
+
+# %% ../nbs/02_xtend.ipynb 41
 def jsd(org, repo, root, path, prov='gh', typ='script', ver=None, esm=False, **kwargs)->XT:
     "jsdelivr `Script` or CSS `Link` tag, or URL"
     ver = '@'+ver if ver else ''

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/fasthtml/xtend.pyi

@@ -1,6 +1,7 @@
-__all__ = ['picocss', 'picolink', 'picocondcss', 'picocondlink', 'set_pico_cls', 'Html', 'A', 'AX', 'Checkbox', 'Card', 'Group', 'Search', 'Grid', 'DialogX', 'Hidden', 'Container', 'Script', 'Style', 'Titled', 'jsd']
+__all__ = ['picocss', 'picolink', 'picocondcss', 'picocondlink', 'set_pico_cls', 'Html', 'A', 'AX', 'Checkbox', 'Card', 'Group', 'Search', 'Grid', 'DialogX', 'Hidden', 'Container', 'Script', 'Style', 'double_braces', 'undouble_braces', 'loose_format', 'ScriptX', 'replace_css_vars', 'StyleX', 'run_js', 'Titled', 'Socials', 'Favicon', 'jsd']
 from dataclasses import dataclass, asdict
 from fastcore.utils import *
+from fastcore.xtras import partial_format
 from fastcore.xml import *
 from fastcore.meta import use_kwargs, delegates
 from .components import *
@@ -64,14 +65,50 @@ def Script(code: str='', *, id=None, cls=None, title=None, style=None, **kwargs)
     """A Script tag that doesn't escape its code"""
     ...
 
-def Style(css: str='', *, id=None, cls=None, title=None, style=None, **kwargs) -> XT:
+def Style(*c, id=None, cls=None, title=None, style=None, **kwargs) -> XT:
     """A Style tag that doesn't escape its code"""
     ...
 
+def double_braces(s):
+    """Convert single braces to double braces if next to special chars or newline"""
+    ...
+
+def undouble_braces(s):
+    """Convert double braces to single braces if next to special chars or newline"""
+    ...
+
+def loose_format(s, **kw):
+    """String format `s` using `kw`, without being strict about braces outside of template params"""
+    ...
+
+def ScriptX(fname, type=None, _async=None, defer=None, charset=None, crossorigin=None, integrity=None, **kw):
+    """A `script` element with contents read from `fname`"""
+    ...
+
+def replace_css_vars(css, pre='tpl', **kwargs):
+    """Replace `var(--)` CSS variables with `kwargs` if name prefix matches `pre`"""
+    ...
+
+def StyleX(fname, **kw):
+    """A `style` element with contents read from `fname` and variables replaced from `kw`"""
+    ...
+
+def run_js(js, id=None, **kw):
+    """Run `js` script, auto-generating `id` based on name of caller if needed, and js-escaping any `kw` params"""
+    ...
+
 def Titled(title: str='FastHTML app', *args, target_id=None, id=None, cls=None, style=None, accesskey=None, contenteditable=None, dir=None, draggable=None, enterkeyhint=None, hidden=None, inert=None, inputmode=None, lang=None, popover=None, spellcheck=None, tabindex=None, translate=None, hx_get=None, hx_post=None, hx_put=None, hx_delete=None, hx_patch=None, hx_trigger=None, hx_target=None, hx_swap=None, hx_include=None, hx_select=None, hx_indicator=None, hx_push_url=None, hx_confirm=None, hx_disable=None, hx_replace_url=None, hx_on=None, **kwargs) -> XT:
     """An HTML partial containing a `Title`, and `H1`, and any provided children"""
     ...
 
+def Socials(title, site_name, description, image, url, w=1200, h=630, twitter_site=None, creator=None, card='summary'):
+    """OG and Twitter social card headers"""
+    ...
+
+def Favicon(light_icon, dark_icon):
+    """Light and dark favicon headers"""
+    ...
+
 def jsd(org, repo, root, path, prov='gh', typ='script', ver=None, esm=False, **kwargs) -> XT:
     """jsdelivr `Script` or CSS `Link` tag, or URL"""
     ...

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6/python_fasthtml.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-fasthtml
-Version: 0.1.4
+Version: 0.1.6
 Summary: The fastest way to create an HTML app
 Home-page: https://github.com/AnswerDotAI/fasthtml
 Author: Jeremy Howard
@@ -20,7 +20,7 @@ Requires-Dist: python-dateutil
 Requires-Dist: starlette>0.33
 Requires-Dist: oauthlib
 Requires-Dist: itsdangerous
-Requires-Dist: uvicorn[standard]
+Requires-Dist: uvicorn[standard]>=0.30
 Requires-Dist: httpx
 Requires-Dist: fastlite>=0.0.6
 Requires-Dist: python-multipart

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/python_fasthtml.egg-info/requires.txt

@@ -3,7 +3,7 @@ python-dateutil
 starlette>0.33
 oauthlib
 itsdangerous
-uvicorn[standard]
+uvicorn[standard]>=0.30
 httpx
 fastlite>=0.0.6
 python-multipart

{python_fasthtml-0.1.4 → python_fasthtml-0.1.6}/settings.ini

@@ -1,10 +1,10 @@
 [DEFAULT]
 repo = fasthtml
 lib_name = fasthtml
-version = 0.1.4
+version = 0.1.6
 min_python = 3.10
 license = apache2
-requirements = fastcore>=1.5.46 python-dateutil starlette>0.33 oauthlib itsdangerous uvicorn[standard] httpx fastlite>=0.0.6 python-multipart beautifulsoup4
+requirements = fastcore>=1.5.46 python-dateutil starlette>0.33 oauthlib itsdangerous uvicorn[standard]>=0.30 httpx fastlite>=0.0.6 python-multipart beautifulsoup4
 dev_requirements = ipython lxml
 black_formatting = False
 conda_user = fastai