hyperflask 0.1.0__tar.gz

hyperflask-0.1.0/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2024 Maxime Bouroumeau-Fuseau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hyperflask-0.1.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.1
+Name: hyperflask
+Version: 0.1.0
+Summary: Full stack web framework
+Home-page: https://github.com/hyperflask/hyperflask
+License: MIT
+Author: Maxime Bouroumeau-Fuseau
+Author-email: maxime.bouroumeau@gmail.com
+Requires-Python: >=3.10,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: dramatiq-sqlite (>=0.1,<0.2)
+Requires-Dist: flask (>=3.0,<4.0)
+Requires-Dist: flask-apispec-hyper (>=0.12,<0.13)
+Requires-Dist: flask-assets-pipeline (>=0.1,<0.2)
+Requires-Dist: flask-babel-hyper (>=5.0,<6.0)
+Requires-Dist: flask-collections (>=0.1,<0.2)
+Requires-Dist: flask-configurator (>=0.1,<0.2)
+Requires-Dist: flask-debugtoolbar (>=0.15,<0.16)
+Requires-Dist: flask-dramatiq (>=0.6,<0.7)
+Requires-Dist: flask-file-routes (>=0.1,<0.2)
+Requires-Dist: flask-files (>=0.1,<0.2)
+Requires-Dist: flask-geo (>=0.1,<0.2)
+Requires-Dist: flask-mailman-templates (>=0.1,<0.2)
+Requires-Dist: flask-mercure-sse (>=0.1,<0.2)
+Requires-Dist: flask-sqlorm (>=0.1,<0.2)
+Requires-Dist: flask-super-macros (>=0.1,<0.2)
+Requires-Dist: flask-talisman (>=1.1,<2.0)
+Requires-Dist: flask-wtf (>=1.2,<2.0)
+Requires-Dist: frozen-flask (>=1.0,<2.0)
+Requires-Dist: gunicorn (>=22.0,<23.0)
+Requires-Dist: honcho (>=1.1,<2.0)
+Requires-Dist: htmx-flask (>=0.1,<0.2)
+Requires-Dist: jinja-layout (>=0.4,<0.5)
+Requires-Dist: jinja-wtforms (>=0.1,<0.2)
+Requires-Dist: jinja2-fragments (>=1.3,<2.0)
+Requires-Dist: periodiq (>=0.12,<0.13)
+Requires-Dist: python-slugify (>=8.0.4,<9.0.0)
+Requires-Dist: redis (>=5.0,<6.0)
+Project-URL: Repository, https://github.com/hyperflask/hyperflask
+Description-Content-Type: text/markdown
+
+<div><img src="assets/banner.svg" width="100%"></div>
+<hr>
+<div align="center">
+
+**Full stack Python web framework to build websites and web apps with as little boilerplate as possible**
+
+**⚠️ This is a work in progress project which is not functionnal yet ⚠️**
+
+![Project Status](https://img.shields.io/badge/status-prototype-red) ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/hyperflask/hyperflask/python.yml?branch=main)
+
+[hyperflask.dev](https://hyperflask.dev) • [Get started](https://hyperflask.dev/getting-started) • [Docs](https://hyperflask.dev/guides) • [Example apps](https://github.com/hyperflask/examples)
+
+</div>
+
+A [Flask](https://flask.palletsprojects.com)-based (very) opiniated Python web framework where all the tech choices have been made. Hyperflask combines multiple Flask extensions and frontend libraries into a seamless experience.
+
+**This project is part of the [Hyperflask Stack](https://hyperflask.dev).**
+
+Features and technologies:
+
+ - Web framework built on top of [Flask](https://flask.palletsprojects.com) as a set of extensions
+ - File-based and/or app-based routing
+ - A new file format combining python code in frontmatter and html templates to define routes
+ - SQL focused ORM with [sqlorm](https://github.com/hyperflask/sqlorm), optimized for [sqlite](https://www.sqlite.org/)
+ - Modern asset pipeline using [esbuild](https://esbuild.github.io/) and [tailwindcss](https://tailwindcss.com/)
+ - Deep integration with [htmx](https://htmx.org/)
+ - Easily create reusable backend and frontend components, compatible with [Storybook](https://storybook.js.org)f
+ - Build frontend components using Web Components, [Alpine.js](https://alpinejs.dev/), [Stimulus](https://stimulus.hotwired.dev/) and more. Mix technologies at will.
+ - Component library based on [daisyUI](https://daisyui.com/) with icons from [Bootstrap Icons](https://icons.getbootstrap.com/)
+ - Seamless reactivity between frontend and backend
+ - Authentication and user management with social logins and MFA
+ - Static content collections to easily create blogs and manage static content
+ - File management with built-in image manipulation and S3 integration
+ - Template based emails with [mjml](https://mjml.io) support
+ - Background tasks using [dramatiq](https://dramatiq.io/)
+ - Push support for realtime pages using [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events)
+ - I18n using [gettext](https://www.gnu.org/software/gettext/)
+ - Easily create REST APIs and automatically generate documentation
+ - Static, hybrid or dynamic modes for content serving
+ - Observable with [OpenTelemetry](https://opentelemetry.io/)
+
+[Hyperflask-Start](https://github.com/hyperflask/hyperflask-start) should be used to create new projects:
+
+ - Dev environment based on [Development Containers](https://containers.dev/)
+ - Optimized for VScode with breakpoint debugging for frontend and backend
+ - [Mailpit](https://github.com/axllent/mailpit) for email testing
+ - Deployments using [Hyperflask-Deploy](https://github.com/hyperflask/hyperflask-deploy)
+
+## Project status
+
+**Hyperflask is being actively developed and is not yet ready to be used.**
+
+Checkout the list of all the projects developed as part of the Hyperflask Stack and their current development status on the [Hyperflask Github organization homepage](https://github.com/hyperflask).
+
+Status overview:
+
+| Feature | Status |
+| --- | --- |
+| Core experience (start project, dev, deploy) | 🚧 |
+| File based routing with mix code page format | ✅ |
+| ORM | ✅ |
+| Assets pipeline | ✅ |
+| Component system + component library | 🚧 (component system almost done, need to create macros for daisyui) |
+| SSE push | ✅ |
+| Collections | 🚧 (finalizing) |
+| Upload files | 🚧 (missing S3 improvements) |
+| Emails | 🚧 |
+| User management and auth | 🚧 |
+| Static site generation | ❌ |
+| I18n | 🚧 (finalizing) |
+| PWA | ❌ |
+| Runner | ✅ |
+
+## Flask extensions
+
+Hyperflask itself is minimal and mostly a collection of Flask extensions seamlessly integrated together.
+
+A good part of these extensions is developed as part of the Hyperflask project. Checkout the [Hyperflask organization page](https://github.com/hyperflask) for a list of all these projects.
+
+| Name | Description |
+| --- | --- |
+| [Flask-Apispec-Hyper](https://github.com/hyperflask/flask-apispec-hyper) | [Flask-Apispec](https://github.com/jmcarp/flask-apispec) fork with updates and fixes
+| [Flask-Assets-Pipeline](https://github.com/hyperflask/flask-assets-pipeline) | Modern asset pipeline using [esbuild](https://esbuild.github.io/)
+| [Flask-Babel-Hyper](https://github.com/hyperflask/flask-babel-hyper) | [Flask-Babel](https://github.com/python-babel/flask-babel) fork with additional utilities
+| [Flask-Collections](https://github.com/hyperflask/flask-collections) | Manage collections of static content
+| [Flask-Configurator](https://github.com/hyperflask/flask-configurator) | File based configuration
+| [Flask-DebugToolbar](https://github.com/pallets-eco/flask-debugtoolbar) | Debug Toolbar
+| [Flask-Dramatiq](https://flask-dramatiq.readthedocs.io) | Background tasks powered by [Dramatiq](https://dramatiq.io/) |
+| [Flask-File-Routes](https://github.com/hyperflask/flask-file-routes) | File-based routing with a new file format combining python and jinja template in a single file
+| [Flask-Files](https://github.com/hyperflask/flask-files) | [Fsspec](https://filesystem-spec.readthedocs.io/en/latest/) based files management (upload, storage and image manipulation)
+| [Frozen-Flask](https://github.com/Frozen-Flask/Frozen) | Generate a static website from your Flask app |
+| [Flask-Geo](https://github.com/hyperflask/flask-geo) | Geolocation using [Maxmind](https://www.maxmind.com/en/geoip-databases)
+| [Htmx-Flask](https://github.com/sponsfreixes/htmx-flask) | HTMX integration for Flask |
+| [Flask-Login](https://github.com/maxcountryman/flask-login) | User session management |
+| [Flask-Mailman](https://github.com/waynerv/flask-mailman) | Send emails |
+| [Flask-Mailman-Templates](https://github.com/hyperflask/flask-mailman-templates) | Email templates for [Flask-Mailman](https://github.com/waynerv/flask-mailman)
+| [Flask-Mercure-SSE](https://github.com/hyperflask/flask-mercure-sse) | Push events via server-sent events using the [Mercure](https://mercure.rocks) protocol
+| [Flask-Observability](https://github.com/hyperflask/flask-observability) | Observable Flask apps with [OpenTelemetry](https://opentelemetry.io/), logging and more
+| [Flask-SQLORM](https://github.com/hyperflask/flask-sqlorm) | Flask integration of [sqlorm](https://github.com/hyperflask/sqlorm)
+| [Flask-Super-Macros](https://github.com/hyperflask/flask-super-macros) | Better macro management for Jinja
+| [Flask-Talisman](https://github.com/wntrblm/flask-talisman) | HTTP security headers for Flask
+| [Flask-WTF](https://flask-wtf.readthedocs.io) | [WTForms](https://wtforms.readthedocs.io) integration
+
+## Using without Hyperflask-Start
+
+1. Create your project directory: `mkdir example-project && cd example-project`
+2. Create and activate a virtualenv: `python -m venv .venv && source .venv/bin/activate`
+3. `pip install hyperflask`
+4. Create a pages directory: `mkdir pages`
+5. Create your index page: `echo "hello world" > pages/index.html`
+6. Start a development server using `hyperflask dev`
+

hyperflask-0.1.0/README.md

@@ -0,0 +1,111 @@
+<div><img src="assets/banner.svg" width="100%"></div>
+<hr>
+<div align="center">
+
+**Full stack Python web framework to build websites and web apps with as little boilerplate as possible**
+
+**⚠️ This is a work in progress project which is not functionnal yet ⚠️**
+
+![Project Status](https://img.shields.io/badge/status-prototype-red) ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/hyperflask/hyperflask/python.yml?branch=main)
+
+[hyperflask.dev](https://hyperflask.dev) • [Get started](https://hyperflask.dev/getting-started) • [Docs](https://hyperflask.dev/guides) • [Example apps](https://github.com/hyperflask/examples)
+
+</div>
+
+A [Flask](https://flask.palletsprojects.com)-based (very) opiniated Python web framework where all the tech choices have been made. Hyperflask combines multiple Flask extensions and frontend libraries into a seamless experience.
+
+**This project is part of the [Hyperflask Stack](https://hyperflask.dev).**
+
+Features and technologies:
+
+ - Web framework built on top of [Flask](https://flask.palletsprojects.com) as a set of extensions
+ - File-based and/or app-based routing
+ - A new file format combining python code in frontmatter and html templates to define routes
+ - SQL focused ORM with [sqlorm](https://github.com/hyperflask/sqlorm), optimized for [sqlite](https://www.sqlite.org/)
+ - Modern asset pipeline using [esbuild](https://esbuild.github.io/) and [tailwindcss](https://tailwindcss.com/)
+ - Deep integration with [htmx](https://htmx.org/)
+ - Easily create reusable backend and frontend components, compatible with [Storybook](https://storybook.js.org)f
+ - Build frontend components using Web Components, [Alpine.js](https://alpinejs.dev/), [Stimulus](https://stimulus.hotwired.dev/) and more. Mix technologies at will.
+ - Component library based on [daisyUI](https://daisyui.com/) with icons from [Bootstrap Icons](https://icons.getbootstrap.com/)
+ - Seamless reactivity between frontend and backend
+ - Authentication and user management with social logins and MFA
+ - Static content collections to easily create blogs and manage static content
+ - File management with built-in image manipulation and S3 integration
+ - Template based emails with [mjml](https://mjml.io) support
+ - Background tasks using [dramatiq](https://dramatiq.io/)
+ - Push support for realtime pages using [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events)
+ - I18n using [gettext](https://www.gnu.org/software/gettext/)
+ - Easily create REST APIs and automatically generate documentation
+ - Static, hybrid or dynamic modes for content serving
+ - Observable with [OpenTelemetry](https://opentelemetry.io/)
+
+[Hyperflask-Start](https://github.com/hyperflask/hyperflask-start) should be used to create new projects:
+
+ - Dev environment based on [Development Containers](https://containers.dev/)
+ - Optimized for VScode with breakpoint debugging for frontend and backend
+ - [Mailpit](https://github.com/axllent/mailpit) for email testing
+ - Deployments using [Hyperflask-Deploy](https://github.com/hyperflask/hyperflask-deploy)
+
+## Project status
+
+**Hyperflask is being actively developed and is not yet ready to be used.**
+
+Checkout the list of all the projects developed as part of the Hyperflask Stack and their current development status on the [Hyperflask Github organization homepage](https://github.com/hyperflask).
+
+Status overview:
+
+| Feature | Status |
+| --- | --- |
+| Core experience (start project, dev, deploy) | 🚧 |
+| File based routing with mix code page format | ✅ |
+| ORM | ✅ |
+| Assets pipeline | ✅ |
+| Component system + component library | 🚧 (component system almost done, need to create macros for daisyui) |
+| SSE push | ✅ |
+| Collections | 🚧 (finalizing) |
+| Upload files | 🚧 (missing S3 improvements) |
+| Emails | 🚧 |
+| User management and auth | 🚧 |
+| Static site generation | ❌ |
+| I18n | 🚧 (finalizing) |
+| PWA | ❌ |
+| Runner | ✅ |
+
+## Flask extensions
+
+Hyperflask itself is minimal and mostly a collection of Flask extensions seamlessly integrated together.
+
+A good part of these extensions is developed as part of the Hyperflask project. Checkout the [Hyperflask organization page](https://github.com/hyperflask) for a list of all these projects.
+
+| Name | Description |
+| --- | --- |
+| [Flask-Apispec-Hyper](https://github.com/hyperflask/flask-apispec-hyper) | [Flask-Apispec](https://github.com/jmcarp/flask-apispec) fork with updates and fixes
+| [Flask-Assets-Pipeline](https://github.com/hyperflask/flask-assets-pipeline) | Modern asset pipeline using [esbuild](https://esbuild.github.io/)
+| [Flask-Babel-Hyper](https://github.com/hyperflask/flask-babel-hyper) | [Flask-Babel](https://github.com/python-babel/flask-babel) fork with additional utilities
+| [Flask-Collections](https://github.com/hyperflask/flask-collections) | Manage collections of static content
+| [Flask-Configurator](https://github.com/hyperflask/flask-configurator) | File based configuration
+| [Flask-DebugToolbar](https://github.com/pallets-eco/flask-debugtoolbar) | Debug Toolbar
+| [Flask-Dramatiq](https://flask-dramatiq.readthedocs.io) | Background tasks powered by [Dramatiq](https://dramatiq.io/) |
+| [Flask-File-Routes](https://github.com/hyperflask/flask-file-routes) | File-based routing with a new file format combining python and jinja template in a single file
+| [Flask-Files](https://github.com/hyperflask/flask-files) | [Fsspec](https://filesystem-spec.readthedocs.io/en/latest/) based files management (upload, storage and image manipulation)
+| [Frozen-Flask](https://github.com/Frozen-Flask/Frozen) | Generate a static website from your Flask app |
+| [Flask-Geo](https://github.com/hyperflask/flask-geo) | Geolocation using [Maxmind](https://www.maxmind.com/en/geoip-databases)
+| [Htmx-Flask](https://github.com/sponsfreixes/htmx-flask) | HTMX integration for Flask |
+| [Flask-Login](https://github.com/maxcountryman/flask-login) | User session management |
+| [Flask-Mailman](https://github.com/waynerv/flask-mailman) | Send emails |
+| [Flask-Mailman-Templates](https://github.com/hyperflask/flask-mailman-templates) | Email templates for [Flask-Mailman](https://github.com/waynerv/flask-mailman)
+| [Flask-Mercure-SSE](https://github.com/hyperflask/flask-mercure-sse) | Push events via server-sent events using the [Mercure](https://mercure.rocks) protocol
+| [Flask-Observability](https://github.com/hyperflask/flask-observability) | Observable Flask apps with [OpenTelemetry](https://opentelemetry.io/), logging and more
+| [Flask-SQLORM](https://github.com/hyperflask/flask-sqlorm) | Flask integration of [sqlorm](https://github.com/hyperflask/sqlorm)
+| [Flask-Super-Macros](https://github.com/hyperflask/flask-super-macros) | Better macro management for Jinja
+| [Flask-Talisman](https://github.com/wntrblm/flask-talisman) | HTTP security headers for Flask
+| [Flask-WTF](https://flask-wtf.readthedocs.io) | [WTForms](https://wtforms.readthedocs.io) integration
+
+## Using without Hyperflask-Start
+
+1. Create your project directory: `mkdir example-project && cd example-project`
+2. Create and activate a virtualenv: `python -m venv .venv && source .venv/bin/activate`
+3. `pip install hyperflask`
+4. Create a pages directory: `mkdir pages`
+5. Create your index page: `echo "hello world" > pages/index.html`
+6. Start a development server using `hyperflask dev`

hyperflask-0.1.0/hyperflask/__init__.py

@@ -0,0 +1,15 @@
+from flask import *
+from .app import Hyperflask, db
+from .utils.htmx import htmx_redirect, htmx_oob
+
+# useful exports from hyperflask managed extensions
+from flask_babel import _, _p, _n, _np, lazy_gettext
+from flask_file_routes import page
+from flask_files import save_file, validate_file
+from flask_mailman_templates import send_mail
+
+# useful exports from 3rd party libs
+from htmx_flask import request, make_response
+from jinja2_fragments.flask import render_block
+from flask_apispec import use_args, use_kwargs, marshal_with
+from slugify import slugify

hyperflask-0.1.0/hyperflask/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()

hyperflask-0.1.0/hyperflask/api.py

@@ -0,0 +1,57 @@
+import flask_apispec
+from flask_apispec.extension import FlaskApiSpec
+from flask_apispec.annotations import activate
+import functools
+import inspect
+from .resources import Resource
+
+
+class Api:
+    def __init__(self, app, version="v1", **kwargs):
+        self.url_prefix = f"/api/{version}"
+        self.endpoint_prefix = f"api_{version}_"
+        kwargs.setdefault("url_prefix", self.url_prefix)
+        kwargs.setdefault("spec_url", "/spec.json")
+        kwargs.setdefault("doc_url", "/")
+        self.app = app
+        self.docs = FlaskApiSpec(app, version=version, **kwargs)
+        self.spec = self.docs.spec
+
+    def expose(self, rule, endpoint=None, **kwargs):
+        def decorator(target):
+            nonlocal endpoint
+            if inspect.isclass(target) and issubclass(target, Resource):
+                for e in target.register(self.app, self.url_prefix, self.endpoint_prefix + (endpoint or "")):
+                    self.docs.register(self.app.view_functions[e], endpoint=e)
+            else:
+                view_func = create_view_func(target)
+                endpoint = self.endpoint_prefix + (endpoint or view_func.__name__)
+                self.app.add_url_rule(self.url_prefix + rule, endpoint, view_func, **kwargs)
+                self.docs.register(view_func, endpoint)
+            return target
+        return decorator
+
+    @staticmethod
+    def args(*args, **kwargs):
+        kwargs["activate"] = False
+        return flask_apispec.use_args(*args, **kwargs)
+
+    @staticmethod
+    def kwargs(*args, **kwargs):
+        kwargs["activate"] = False
+        return flask_apispec.use_kwargs(*args, **kwargs)
+
+    @staticmethod
+    def marshal_with(*args, **kwargs):
+        kwargs["activate"] = False
+        return flask_apispec.marshal_with(*args, **kwargs)
+
+
+def create_view_func(func):
+    @functools.wraps(func)
+    def view_func(*args, **kwargs):
+        return func(*args, **kwargs)
+    if hasattr(func, "__apispec__"):
+        view_func.__apispec__ = func.__apispec__
+        func.view_func = activate(view_func)
+    return view_func

hyperflask-0.1.0/hyperflask/app.py

@@ -0,0 +1,176 @@
+# flask
+from flask import Flask
+from jinja2 import ChoiceLoader, FileSystemLoader, PrefixLoader
+# hyperflask extensions
+from jinja_layout import LayoutExtension
+from jinja_wtforms import WtformExtension
+from flask_assets_pipeline import AssetsPipeline
+from flask_super_macros import SuperMacros
+from flask_collections import Collections
+from flask_file_routes import FileRoutes
+from flask_configurator import Config
+from flask_babel import Babel, _, _p, _n, _np, lazy_gettext
+from flask_geo import Geolocation
+from flask_files import Files
+from flask_sqlorm import FlaskSQLORM
+from flask_mercure_sse import MercureSSE
+from flask_mailman_templates import MailTemplates
+from flask_observability import Observability
+# 3rd party extensions
+from flask_wtf.csrf import CSRFProtect
+from flask_talisman import Talisman
+from flask_frozen import Freezer
+from htmx_flask import Htmx
+from flask_mailman import Mail
+from flask_dramatiq import Dramatiq
+from flask_debugtoolbar import DebugToolbarExtension
+# from hyperflask
+from .forms import Form
+from .utils.page_actions import page_action_url
+from .utils.htmx import htmx_oob
+from .components import register_components
+from . import page_helpers
+# others
+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 os
+
+
+db = FlaskSQLORM()
+
+
+map_jinja_call_node_to_func(_)
+map_jinja_call_node_to_func(_p)
+map_jinja_call_node_to_func(_n)
+map_jinja_call_node_to_func(_np)
+map_jinja_call_node_to_func(lazy_gettext)
+
+
+class Hyperflask(Flask):
+    config_class = Config
+
+    def __init__(self, *args, static_mode="hybrid", instrument=False, layouts_folder="layouts", partials_folder="partials",
+                 emails_folder="emails", forms_folder="forms", assets_folder="assets", pages_folder="pages", migrations_folder="migrations",
+                 config=None, config_filename="config.yml", **kwargs):
+        super().__init__(*args, **kwargs)
+
+        self.config.update({
+            "FREEZER_DESTINATION": os.path.join(self.root_path, "_site"),
+            "FREEZER_STATIC_IGNORE": [],
+            "WTF_CSRF_CHECK_DEFAULT": False,
+            "OTEL_INSTRUMENT": instrument,
+            "DRAMATIQ_BROKER": "dramatiq.brokers.redis:RedisBroker",
+            "DEBUG_TB_INTERCEPT_REDIRECTS": False,
+            "PAGES_MARKDOWN_OPTIONS": {"extensions": ["fenced_code", "nl2br", "attr_list", "admonition", "codehilite"]},
+            # Hyperflask specific
+            "LAYOUT": "layout.html",
+            "STATIC_MODE": static_mode,
+            "ASSETS_INCLUDE_HTMX": True,
+            "HTMX_BOOST_SITE": False
+        })
+        if config:
+            self.config.update(config)
+        if config_filename:
+            self.config.load(config_filename)
+        if self.debug:
+            self.config.setdefault("MAIL_BACKEND", "console")
+
+        self.otel = Observability(self)
+
+        self.jinja_env.add_extension(LayoutExtension)
+        self.jinja_env.add_extension(WtformExtension)
+        self.jinja_env.form_base_cls = Form
+        self.jinja_env.default_layout = self.config["LAYOUT"]
+        self.forms = self.jinja_env.forms
+
+        self.jinja_env.loader = ChoiceLoader([self.jinja_env.loader])
+        if layouts_folder and os.path.exists(os.path.join(self.root_path, layouts_folder)):
+            layout_loader = FileSystemLoader(os.path.join(self.root_path, layouts_folder))
+            self.jinja_env.loader.loaders.append(layout_loader)
+            self.jinja_env.loader.loaders.append(PrefixLoader({os.path.basename(layouts_folder): layout_loader}))
+        self.jinja_env.loader.loaders.extend([
+            FileLoader(os.path.join(os.path.dirname(__file__), "layout.html")),
+            FileLoader(os.path.join(os.path.dirname(__file__), "layout.html"), "hyperflask_layout.html"),
+            PrefixLoader({"ui": FileSystemLoader(os.path.join(os.path.dirname(__file__), "ui"))})
+        ])
+
+        DebugToolbarExtension(self)
+        self.freezer = Freezer(self)
+        self.csrf = CSRFProtect(self)
+        #self.talisman = Talisman(self)
+        Htmx(self)
+        Mail(self)
+        self.dramatiq = Dramatiq(self)
+        self.dramatiq.broker.add_middleware(PeriodiqMiddleware())
+        self.actor = self.dramatiq.actor
+
+        SuperMacros(self)
+        Babel(self)
+        Geolocation(self)
+        Files(self)
+        MailTemplates(self, template_folder=emails_folder)
+        file_routes = FileRoutes(self, pages_folder=pages_folder, partials_folder=partials_folder)
+        self.page_helper = file_routes.page_helper
+        self.collections = Collections(self)
+        MercureSSE(self)
+
+        self.assets = AssetsPipeline(self, assets_folder=assets_folder, inline=True, include_inline_on_demand=False)
+        self.assets.state.watch_template_folders.extend([
+            os.path.join(self.root_path, "pages"),
+            os.path.join(self.root_path, "macros"),
+            os.path.join(self.root_path, "components"),
+            os.path.join(self.root_path, "forms")
+        ])
+        self.assets.state.esbuild_aliases.update({
+            "assets": self.assets.state.assets_folder,
+            "@hyperflask": os.path.abspath(os.path.join(os.path.dirname(__file__), "static"))
+        })
+        self.assets.state.tailwind_suggested_content.extend(filter(bool, [
+            os.path.join(os.path.dirname(__file__), "ui") + "/**/*.html",
+            os.path.join(self.root_path, pages_folder) + "/**/*.html" if pages_folder else None,
+            os.path.join(self.root_path, pages_folder) + "/**/*.jpy" if pages_folder else None,
+            os.path.join(self.root_path, partials_folder) + "/**/*.html" if partials_folder else None,
+            os.path.join(self.root_path, partials_folder) + "/**/*.jpy" if partials_folder else None,
+            os.path.join(self.root_path, layouts_folder) + "/**/*.html" if layouts_folder else None,
+            os.path.join(self.root_path, "components") + "/**/*.html",
+            os.path.join(self.root_path, "components") + "/**/*.jpy",
+        ]))
+        self.assets.state.copy_files_from_node_modules.update({
+            "bootstrap-icons/font": "bootstrap-icons"
+        })
+        self.assets.bundle(
+            {"@hyperflask": ["app.js"],
+             "@hyperflask/reactive": ["reactive.js"],
+             "@hyperflask/alpine": ["alpine.js"]},
+            assets_folder=os.path.join(os.path.dirname(__file__), "static")
+        )
+        self.assets.include("@hyperflask", 0)
+
+        self.macros.register_from_directory(os.path.join(os.path.dirname(__file__), "ui"))
+        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")
+        register_components(self)
+
+        if forms_folder and os.path.isdir(os.path.join(self.root_path, forms_folder)):
+            for macro in self.macros.create_from_directory(os.path.join(self.root_path, forms_folder)):
+                self.forms.register(self.macros.resolve_template(macro), macro)
+
+        self.jinja_env.globals.update(page_action_url=page_action_url)
+
+        self.collections.register_freezer_generator(self.freezer)
+
+        SQLTemplate.eval_globals.update(app=self)
+        db.init_app(self, migrations_folder=migrations_folder)
+
+
+def static(func):
+    pass
+
+
+def dynamic(func=None, static_template=None):
+    def decorator(func):
+        pass
+    return decorator(func) if func else decorator