hyperflask 0.4.3__tar.gz → 0.5.0__tar.gz

{hyperflask-0.4.3 → hyperflask-0.5.0}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: hyperflask
-Version: 0.4.3
+Version: 0.5.0
 Summary: Full stack web framework
 Author: Maxime Bouroumeau-Fuseau
 Author-email: Maxime Bouroumeau-Fuseau <maxime.bouroumeau@gmail.com>
 License-Expression: MIT
 Requires-Dist: flask>=3.0.0,<4.0.0
-Requires-Dist: flask-assets-pipeline~=0.7
+Requires-Dist: flask-assets-pipeline~=0.8
 Requires-Dist: flask-babel-hyper~=5.1
-Requires-Dist: flask-collections~=0.2
+Requires-Dist: flask-collections~=0.3
 Requires-Dist: flask-configurator~=0.1
 Requires-Dist: flask-debugtoolbar~=0.16
 Requires-Dist: flask-file-routes~=0.3
@@ -32,6 +32,7 @@ Requires-Dist: jinja-wtforms~=0.2
 Requires-Dist: periodiq~=0.13
 Requires-Dist: python-slugify~=8.0.4
 Requires-Dist: watchdog>=6.0.0
+Requires-Dist: pillow>=11.3.0
 Requires-Python: >=3.10
 Project-URL: Repository, https://github.com/hyperflask/hyperflask
 Description-Content-Type: text/markdown

{hyperflask-0.4.3 → hyperflask-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hyperflask"
-version = "0.4.3"
+version = "0.5.0"
 description = "Full stack web framework"
 authors = [
     {"name" = "Maxime Bouroumeau-Fuseau", email = "maxime.bouroumeau@gmail.com"}
@@ -10,9 +10,9 @@ license = "MIT"
 requires-python = ">=3.10"
 dependencies = [
     "flask>=3.0.0,<4.0.0",
-    "flask-assets-pipeline ~=0.7",
+    "flask-assets-pipeline ~=0.8",
     "flask-babel-hyper ~=5.1",
-    "flask-collections ~=0.2",
+    "flask-collections ~=0.3",
     "flask-configurator ~=0.1",
     "flask-debugtoolbar ~=0.16",
     "flask-file-routes ~=0.3",
@@ -37,6 +37,7 @@ dependencies = [
     "periodiq ~=0.13",
     "python-slugify ~=8.0.4",
     "watchdog>=6.0.0",
+    "pillow>=11.3.0",
 ]
 
 [tool.uv.sources]

{hyperflask-0.4.3 → hyperflask-0.5.0}/src/hyperflask/__init__.py

@@ -1,6 +1,7 @@
 from flask import *
 from .app import Hyperflask
 from .utils.htmx import htmx_redirect, htmx_oob
+from .utils.freezer import StaticMode, static, dynamic
 from .security import csp_nonce
 
 # useful exports from hyperflask managed extensions

{hyperflask-0.4.3 → hyperflask-0.5.0}/src/hyperflask/app.py

@@ -20,7 +20,6 @@ from flask_suspense import Suspense, render_template, suspense_before_render_tem
 #from flask_observability import Observability
 # 3rd party extensions
 from flask_wtf.csrf import CSRFProtect
-from flask_frozen import Freezer
 from htmx_flask import Htmx
 from flask_mailman import Mail
 from flask_debugtoolbar import DebugToolbarExtension
@@ -31,6 +30,8 @@ from .utils.htmx import htmx_oob, respond_with_flash_messages
 from .utils.markdown import jinja_markdown, MarkdownExtension
 from .utils.html import sanitize_html, nl2br
 from .utils.metadata import metadata_tags
+from .utils.freezer import StaticMode, Freezer, freezer_url_generator
+from .utils.image import image_tag
 from .components import register_components
 from .model import Model, File as SQLFileType, UndefinedDatabase
 from .actors import AppContextMiddleware, discover_broker, make_actor_decorator
@@ -41,7 +42,6 @@ from jinja_super_macros.registry import FileLoader
 from jinja_wtforms.extractor import map_jinja_call_node_to_func
 from sqlorm.sql_template import SQLTemplate
 from periodiq import PeriodiqMiddleware
-import dramatiq
 import os
 
 
@@ -55,7 +55,7 @@ map_jinja_call_node_to_func(lazy_gettext, "lazy_gettext")
 class Hyperflask(Flask):
     config_class = Config
 
-    def __init__(self, *args, static_mode="hybrid", instrument=False, layouts_folder="layouts",
+    def __init__(self, *args, static_mode=StaticMode.DYNAMIC, instrument=False, layouts_folder="layouts",
                  emails_folder="emails", forms_folder="forms", assets_folder="assets", pages_folder="pages", migrations_folder="migrations",
                  config=None, config_filename="config.yml", database_uri=None, proxy_fix=True, **kwargs):
 
@@ -64,8 +64,12 @@ class Hyperflask(Flask):
             self.wsgi_app = ProxyFix(self.wsgi_app, x_for=1, x_proto=1, x_host=1, x_prefix=1)
 
         self.config.update({
-            "FREEZER_DESTINATION": os.path.join(self.root_path, "_site"),
+            "FREEZER_DESTINATION": "_site",
             "FREEZER_STATIC_IGNORE": [],
+            "FREEZER_IGNORE_404_NOT_FOUND": True,
+            "FREEZER_IGNORE_MIMETYPE_WARNINGS": True,
+            "FREEZER_REDIRECT_POLICY": "ignore",
+            "FREEZER_DEFAULT_FILE_EXTENSION": "html",
             "WTF_CSRF_CHECK_DEFAULT": False,
             "OTEL_INSTRUMENT": instrument,
             "DEBUG_TB_INTERCEPT_REDIRECTS": False,
@@ -92,7 +96,9 @@ class Hyperflask(Flask):
             "CSP_FRAME_ANCESTORS": True,
             "CSP_FRAME_ANCESTORS_SAFE_ENDPOINTS": [],
             "REFERRER_POLICY": "strict-origin-when-cross-origin",
-            "HSTS_HEADER": False
+            "HSTS_HEADER": False,
+            "IMAGES_DEFAULT_LOADING": "lazy",
+            "IMAGES_DEFAULT_DECODING": "async",
         })
         if config:
             self.config.update(config)
@@ -123,8 +129,13 @@ class Hyperflask(Flask):
         self.jinja_env.add_extension(LayoutExtension)
         self.jinja_env.add_extension(WtformExtension)
         self.jinja_env.add_extension(MarkdownExtension)
-        self.jinja_env.filters.update(markdown=jinja_markdown, sanitize=sanitize_html, nl2br=nl2br)
-        self.jinja_env.globals.update(page_action_url=page_action_url, app=self, csp_nonce=csp_nonce, metadata_tags=metadata_tags)
+        self.jinja_env.filters.update(markdown=jinja_markdown,
+                                      sanitize=sanitize_html,
+                                      nl2br=nl2br)
+        self.jinja_env.globals.update(page_action_url=page_action_url,
+                                      app=self,
+                                      csp_nonce=csp_nonce,
+                                      metadata_tags=metadata_tags)
         self.jinja_env.form_base_cls = Form
         self.jinja_env.default_layout = self.config["LAYOUT"]
         self.forms = self.jinja_env.forms
@@ -140,7 +151,7 @@ class Hyperflask(Flask):
         ])
 
         DebugToolbarExtension(self)
-        self.freezer = Freezer(self, with_no_argument_rules=False)
+        self.freezer = Freezer(self, with_no_argument_rules=False, log_url_for=self.config.get('FREEZER_LOG_URL_FOR', False))
         self.freezer.register_generator(lambda: freezer_url_generator(self))
         self.csrf = CSRFProtect(self)
         Htmx(self)
@@ -194,6 +205,7 @@ class Hyperflask(Flask):
         if hasattr(file_routes, "loader"):
             self.forms.register_from_loader(file_routes.loader, "pages")
         self.macros.create_from_func(htmx_oob, "HtmxOob", receive_caller=True, caller_alias="html")
+        self.macros.create_from_func(image_tag, "Image")
 
         self.components_loader, _ = register_components(self)
         if self.components_loader:
@@ -286,21 +298,3 @@ class HyperModuleView(ModuleView):
 
     def _render_template(self):
         return render_template(page.template)
-
-
-def static(func):
-    pass
-
-
-def dynamic(func=None, static_template=None):
-    def decorator(func):
-        pass
-    return decorator(func) if func else decorator
-
-
-def freezer_url_generator(app):
-    """URL generator for URL rules that take no arguments."""
-    for rule in app.url_map.iter_rules():
-        if not rule.arguments and 'GET' in rule.methods and not rule.endpoint.startswith('mercure'):
-            app.logger.info(rule.endpoint)
-            yield rule.endpoint, {}

{hyperflask-0.4.3 → hyperflask-0.5.0}/src/hyperflask/cli/__init__.py

@@ -4,6 +4,7 @@ from flask_assets_pipeline import cli as assets_cli
 import click
 from ..factory import create_app
 from ..security import generate_csp_policy
+from ..utils.freezer import StaticMode
 from .runner import serve_command, run_command, dev_command
 from .worker import worker_command, scheduler_command
 
@@ -31,16 +32,12 @@ def init_command():
     pass
 
 
-@cli.command("freeze")
-def freeze_command():
-    current_app.freezer.freeze()
-
-
 @cli.command("build")
 @click.pass_context
 def build_command(ctx):
     ctx.invoke(assets_cli.build)
-    ctx.invoke(freeze_command)
+    if StaticMode(current_app.config['STATIC_MODE']) != StaticMode.DYNAMIC:
+        current_app.freezer.freeze()
 
 
 @cli.command("csp-header")
@@ -48,6 +45,5 @@ def csp_header_command():
     click.echo(generate_csp_policy())
 
 
-
 def main():
     cli.main()

{hyperflask-0.4.3 → hyperflask-0.5.0}/src/hyperflask/components/core.py

@@ -4,6 +4,7 @@ from flask.views import http_method_funcs
 from flask_file_routes import page
 from flask_suspense import render_template
 from jinjapy import extract_frontmatter
+from ..utils.freezer import dynamic
 import importlib
 import re
 import os
@@ -43,6 +44,7 @@ class ComponentAdapter(BaseComponentAdapter):
         if methods:
             app.add_url_rule(url, self.name, view_func=self.view_func, methods=methods)
 
+    @dynamic
     def view_func(self):
         props = {}
         page.template = self.template

{hyperflask-0.4.3 → hyperflask-0.5.0}/src/hyperflask/components/jsx.py

@@ -1,7 +1,7 @@
 from .core import BaseComponentAdapter
 from markupsafe import Markup
 from flask import current_app
-from flask_assets_pipeline import Entrypoint
+from flask_assets_pipeline import BundleEntrypoint
 import json
 import html
 
@@ -13,7 +13,7 @@ class JsxComponentAdapter(BaseComponentAdapter):
             app.assets.state.bundles["@components"] = []
             app.assets.include("@components")
         app.assets.state.bundles["@components"].append(
-            Entrypoint.create(self.template, from_package="jinja"))
+            BundleEntrypoint.create(self.template, from_package="jinja"))
         app.assets.include(self.include_js)
 
     def render(self, caller, *args, **kwargs):

{hyperflask-0.4.3 → hyperflask-0.5.0}/src/hyperflask/components/webcomponent.py

@@ -1,6 +1,6 @@
 from .core import BaseComponentAdapter
 from jinja_super_macros import html_tag
-from flask_assets_pipeline import Entrypoint
+from flask_assets_pipeline import BundleEntrypoint
 from markupsafe import Markup
 import os
 
@@ -17,7 +17,7 @@ class WebComponentAdapter(BaseComponentAdapter):
             app.assets.state.bundles["@components"] = []
             app.assets.include("@components")
         app.assets.state.bundles["@components"].append(
-            Entrypoint.create(os.path.abspath(tpl.filename), self.template))
+            BundleEntrypoint.create(os.path.abspath(tpl.filename), self.template))
 
     def render(self, caller, *args, **kwargs):
         tag_name = self.name.replace("_", "-")

{hyperflask-0.4.3 → hyperflask-0.5.0}/src/hyperflask/layouts/web.html

@@ -5,7 +5,7 @@
         {% block head_metas %}
           {{ metadata_tags(page.get('metadata', {})) }}
         {% endblock %}
-        {% asset_tags nonce=csp_nonce %}
+        {% asset_tags(nonce=csp_nonce) %}
         {% block head_assets %}{% endblock %}
         {%- endblock %}
     </head>

hyperflask-0.5.0/src/hyperflask/utils/freezer.py

@@ -0,0 +1,56 @@
+from flask_frozen import Freezer as FlaskFreezer
+from pathlib import Path
+from enum import Enum
+
+
+class StaticMode(Enum):
+    STATIC = "static"
+    HYBRID = "hybrid"
+    DYNAMIC = "dynamic"
+
+
+class Freezer(FlaskFreezer):
+    @property
+    def root(self):
+        return Path(self.app.config['FREEZER_DESTINATION'])
+
+    def _check_endpoints(self, seen_endpoints):
+        if StaticMode(self.app.config['STATIC_MODE']) != StaticMode.STATIC:
+            return
+        super()._check_endpoints(seen_endpoints)
+
+    def urlpath_to_filepath(self, path):
+        """Convert URL path like /admin/ to file path like admin/index.html."""
+        if path.endswith('/'):
+            path += 'index.html'
+        # Remove the initial slash that should always be there
+        assert path.startswith('/')
+        if self.app.config.get('FREEZER_DEFAULT_FILE_EXTENSION') and '.' not in path.split('/')[-1]:
+            path += f".{self.app.config['FREEZER_DEFAULT_FILE_EXTENSION']}"
+        return path[1:]
+
+
+def static(func=None, values=None):
+    if func is None:
+        return lambda f: static(f, values=values)
+    func.__freezer__ = True
+    func.__freezer_values__ = values
+    return func
+
+
+def dynamic(func):
+    func.__freezer__ = False
+    return func
+
+
+def freezer_url_generator(app):
+    """URL generator for URL rules that take no arguments."""
+    for rule in app.url_map.iter_rules():
+        if rule.arguments or 'GET' not in rule.methods:
+            continue
+        if rule.endpoint.startswith('mercure_hub'):
+            continue
+        if rule.endpoint in app.view_functions and not getattr(app.view_functions[rule.endpoint], '__freezer__', True):
+            continue
+        values = getattr(app.view_functions.get(rule.endpoint), '__freezer_values__', None) or {}
+        yield rule.endpoint, values

hyperflask-0.5.0/src/hyperflask/utils/image.py

@@ -0,0 +1,26 @@
+from flask import current_app
+from jinja_super_macros import html_tag
+from flask_assets_pipeline import image_attrs
+
+
+def image_tag(src, priority=False, preload=False, placeholder=True, loading=None, decoding=None, **attrs):
+    if not loading:
+        loading = current_app.config["IMAGES_DEFAULT_LOADING"]
+    if not decoding:
+        decoding = current_app.config["IMAGES_DEFAULT_DECODING"]
+    if priority:
+        preload = True
+        attrs.setdefault("fetchpriority", "high")
+    if preload:
+        current_app.assets.include([(src, {"modifier": "preload", "content_type": "image"})])
+        if loading == "lazy":
+            loading = "eager"
+    _attrs = image_attrs(src)
+    if not placeholder and "style" in _attrs:
+        del _attrs["style"]
+    if loading:
+        _attrs["loading"] = loading
+    if decoding:
+        _attrs["decoding"] = decoding
+    _attrs.update(attrs)
+    return html_tag("img", **_attrs)