[{"_1":2,"_168":-5,"_169":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_143":144},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":17},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_134":-5,"_135":11,"_136":17,"_137":11,"_138":-5,"_139":11,"_140":-5,"_141":142},"canonicalUrl","https://hub.docker.com/r/chriamue/flask-unchained/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","chriamue","reponame","flask-unchained","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2019-01-28T18:15:57.285444Z","description","","is_private","last_updated","2019-02-07T10:06:46.389519Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",280,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Flask Unchained\n\n## The best way to build Flask apps\n\n**What is it?**\n\nFlask Unchained is a (*work-in-progress*) **fully integrated, optional-batteries-included web framework built on top of Flask** and its extension ecosystem. Flask Unchained aims to be a fresh, modern take on building web apps and APIs with Flask - while trying to stay as true as possible to the spirit and API of Flask.\n\n**Why?**\n\n- designed to be **easy to start with and even easier to grow** your app\n- **clean, predictable application structure** that encourages good design patterns (no circular imports!)\n- **documented with real-world-usage in mind** (*some sections are still a work-in-progress*)\n- **no integration headaches between supported libraries**; everything just works\n- absolutely **as little boilerplate as possible** (your focus should be on your app, not plumbing!)\n- out-of-the-box support for **testing** with `pytest`\n- **simple and consistent patterns for customizing, extending, and/or overriding almost everything** (e.g. configuration, views/controllers/resources, routes, templates, services, extensions, ...)\n - your customizations are easily distributable as a standalone bundle (Python package), which itself then supports the same patterns for customization, ad infinitum.\n\n**How?**\n\n**Flask Unchained implements the Application Factory Pattern, utilizing a standardized (but configurable) way to organize \"bundles\" of code, such that they become easily distributable, reusable, and customizable across multiple independent projects.** All of the code within bundles is automatically discovered and registered with the app. You can think of bundles as an enhanced replacement for both Flask blueprints and extensions. Bundles are somewhat comparable to Django's \"apps\", but I think you'll find bundles are more powerful and flexible.\n\nThe architecture is inspired by [Symfony](https://symfony.com/), which is enterprise-level awesome, aside from the fact that it isn't Python ;) If you've heard of [Laravel](https://laravel.com/), that framework is built on top of [the Symfony Components](https://symfony.com/components) - with Flask Unchained, the existing Flask/Python ecosystems constitute our \"components\".[*]\n\n[*] Don't like the default choices? Flask Unchained is almost completely customizable. The core architecture offers you the potential to use an entirely different stack of libraries, or swap out only certain components - the power to choose is yours.\n\n## Useful Links\n\n* [Read the Docs](https://flask-unchained.readthedocs.io/en/latest/)\n* [Fork it on GitHub](https://github.com/briancappello/flask-unchained)\n* [Releases on PyPI](https://pypi.org/project/Flask-Unchained/)\n\n### Table of Contents\n\n* [Features](https://github.com/briancappello/flask-unchained#features)\n* [Quickstart](https://github.com/briancappello/flask-unchained#quickstart)\n* [What does it look like?](https://github.com/briancappello/flask-unchained#what-does-it-look-like)\n * [Application Structure and Project Layout](https://github.com/briancappello/flask-unchained#application-structure-and-project-layout)\n * [Bundles](https://github.com/briancappello/flask-unchained#bundles)\n * [Configuration](https://github.com/briancappello/flask-unchained#configuration)\n * [Views](https://github.com/briancappello/flask-unchained#views)\n * [Templates](https://github.com/briancappello/flask-unchained#templates)\n * [Routes](https://github.com/briancappello/flask-unchained#routes)\n * [Commands](https://github.com/briancappello/flask-unchained#commands)\n* [Contributing](https://github.com/briancappello/flask-unchained#contributing)\n* [License](https://github.com/briancappello/flask-unchained#license)\n\n## Features\n\n* Python 3.6+\n* improved class-based views with the [Controller](https://flask-unchained.readthedocs.io/en/latest/api/controller_bundle.html#controller), [Resource](https://flask-unchained.readthedocs.io/en/latest/api/controller_bundle.html#resource), and [ModelResource](https://flask-unchained.readthedocs.io/en/latest/api/api_bundle.html#modelresource) base classes\n* declarative routing\n* dependency injection of services and extensions\n* includes out-of-the-box (mostly optional) integrations with:\n - [SQLAlchemy](https://www.sqlalchemy.org/) and [Flask-Migrate](https://flask-migrate.readthedocs.io/en/latest/) (database ORM and migrations, optional). [SQLAlchemy Unchained](https://sqlalchemy-unchained.readthedocs.io/en/latest/) builds some \"sugar\" on top of SQLAlchemy to make the best ORM in existence even quicker and easier to use:\n - models automatically get a primary key column, unless you define one yourself\n - models are (optionally) automatically timestamped when they are created and updated\n - super-simple polymorphic model class inheritance\n - a unified API for creating, querying, updating and deleting models with the [ModelManager](https://sqlalchemy-unchained.readthedocs.io/en/latest/api.html#modelmanager) service base class\n - [Flask-Login](http://flask-login.readthedocs.io/) (user authentication and sessions management) and [Flask-Principal](https://pythonhosted.org/Flask-Principal/) (user authorization with permissions and roles)\n - both session and token authentication are currently supported\n - includes optional support for registration (with optional required email confirmation before account activation)\n - optional change password and forgot password functionality\n - [Flask-Marshmallow](https://flask-marshmallow.readthedocs.io/en/latest/) (SQLAlchemy model serialization, optional)\n - the API Bundle provides a (*work-in-progress*) RESTful API framework integrating Marshmallow Serializers (aka Schemas) and SQLAlchemy models using [ModelResource](https://flask-unchained.readthedocs.io/en/latest/api/api_bundle.html#modelresource)\n - work-in-progress support for [OpenAPI](https://swagger.io/specification/) (aka Swagger) docs, using [ReDoc](https://github.com/Rebilly/ReDoc) as the frontend\n - [Flask-GraphQL](https://github.com/graphql-python/flask-graphql) (GraphQL support, integrates [Graphene](https://docs.graphene-python.org/en/latest/) with SQLAlchemy, optional)\n - [Flask-WTF](https://flask-wtf.readthedocs.io/en/stable/) (forms and CSRF protection, always enabled)\n - [Flask-Session](https://pythonhosted.org/Flask-Session/) (server-side sessions, optional)\n - [Celery](http://docs.celeryproject.org/en/latest/index.html) (distributed task queue, optional)\n - [Flask-Mail](https://pythonhosted.org/flask-mail/) (email sending support, optional)\n - [Flask-Admin](https://flask-admin.readthedocs.io/en/latest/) (admin interface, optional)\n - [Flask-BabelEx](https://pythonhosted.org/Flask-BabelEx/) (translations, always enabled but optional)\n - [pytest](https://docs.pytest.org/en/latest/) and [factory_boy](https://factoryboy.readthedocs.io/en/latest/) (testing framework)\n\n## Quickstart\n\n```bash\n# (create a virtual environment)\npip install flask-unchained[dev]\nflask new project \n\n# (answer the questions and `cd` into the new directory)\npip install -r requirements-dev.txt\nflask run\n```\n\n**NOTE:** If you enabled the SQLAlchemy Bundle, then you may need to run migrations before running the development server:\n\n```bash\nflask db init\nflask db migrate -m 'create initial tables'\nflask db upgrade\n```\n\n## What does it look like?\n\n### Application Structure and Project Layout\n\nUnlike stock Flask, Flask Unchained apps cannot be written in a single file. Instead, Flask Unchained's bundles define a (configurable) folder convention that must be followed for Flask Unchained to be able to correctly discover all of your code. A large application structure might look about like this:\n\n```\n/home/user/dev/project-root\n├── app # your app bundle package\n│ ├── admins # model admins\n│ ├── commands # Click CLI groups/commands\n│ ├── extensions # Flask extensions\n│ ├── models # SQLAlchemy models\n│ ├── fixtures # SQLAlchemy model fixtures (for seeding the dev db)\n│ ├── serializers # Marshmallow serializers (aka schemas)\n│ ├── services # dependency-injectable services\n│ ├── tasks # Celery tasks\n│ ├── templates # Jinja2 templates\n│ ├── views # Controllers, Resources and views\n│ └── __init__.py\n│ └── config.py # app config\n│ └── routes.py # declarative routes\n├── assets # static assets to be handled by Webpack\n│ ├── images\n│ ├── scripts\n│ └── styles\n├── bundles # custom bundles and/or bundle extensions/overrides\n│ └── security # a customized/extended Security Bundle\n│ ├── models\n│ ├── serializers\n│ ├── services\n│ ├── templates\n│ └── __init__.py\n├── db\n│ └── migrations # Alembic (SQLAlchemy) migrations (generated by Flask-Migrate)\n├── static # static assets (Webpack compiles to here, and Flask\n│ # serves this folder at /static (by default))\n├── templates # the top-level templates folder\n├── tests # your pytest tests\n├── webpack # Webpack configs\n└── unchained_config.py # the Flask Unchained config\n```\n\nTo learn how to build such a larger example application, check out the [official tutorial](https://flask-unchained.readthedocs.io/en/latest/tutorial/index.html).\n\nA minimal application structure looks about like this:\n\n```\n/home/user/dev/hello-flask-unchained\n├── app\n│ ├── templates\n│ │ └── site\n│ │ └── index.html\n│ ├── __init__.py\n│ ├── config.py\n│ ├── forms.py\n│ ├── models.py\n│ ├── routes.py\n│ ├── services.py\n│ └── views.py\n└── unchained_config.py\n```\n\nLet's built it!\n\n```bash\n# (create a virtualenv and activate it)\npip install flask-unchained[dev,sqlalchemy] \\\n && mkdir -p hello-flask-unchained/app && cd hello-flask-unchained \\\n && touch unchained_config.py && cd app \\\n && mkdir -p templates/site && touch templates/site/index.html \\\n && touch __init__.py config.py forms.py models.py routes.py services.py views.py\n```\n\n### Bundles\n\nThe first step is to create an app bundle module in your project root - we're calling ours `app` here - with an `AppBundle` subclass in it:\n\n```python\n# hello-flask-unchained/app/__init__.py\n\nfrom flask_unchained import AppBundle, FlaskUnchained\n\n\nclass App(AppBundle):\n # you only need to subclass AppBundle; everything below is optional. for example, these\n # attributes can be set to customize which bundle module to load from (defaults shown)\n config_module_name = 'config'\n models_module_name = 'models'\n routes_module_name = 'routes'\n services_module_name = 'services'\n\n # these two methods are optional callbacks which the app factory will call\n def before_init_app(self, app: FlaskUnchained):\n pass\n \n def after_init_app(self, app: FlaskUnchained):\n pass\n```\n\n### Configuration\n\nThe configuration for Flask Unchained itself is pretty minimal, for example:\n\n```python\n# hello-flask-unchained/unchained_config.py\n\nimport os\n\nPROJECT_ROOT = os.path.abspath(os.path.dirname(__file__))\n\ndef folder_or_none(folder_name):\n folder = os.path.join(PROJECT_ROOT, folder_name)\n return folder if os.path.exists(folder) else None\n\n# these get passed to the :class:`FlaskUnchained` constructor\nTEMPLATE_FOLDER = folder_or_none('templates')\nSTATIC_FOLDER = folder_or_none('static')\nSTATIC_URL_PATH = '/static' if STATIC_FOLDER else None\n\n# declare which bundles Flask Unchained should load\nBUNDLES = [\n 'flask_unchained.bundles.sqlalchemy',\n 'app', # your app bundle *must* be last\n]\n```\n\nAnd add the required app configuration to your app bundle:\n\n```python\n# hello-flask-unchained/app/config.py\n\nimport os\n\nfrom flask_unchained import AppBundleConfig\n\n\nclass Config(AppBundleConfig):\n SECRET_KEY = os.getenv('FLASK_SECRET_KEY', 'change-me-to-a-secret-key')\n\n\n# the following env-specific config classes are all optional\n\nclass DevConfig(Config):\n pass\n\nclass ProdConfig(Config):\n pass\n \nclass StagingConfig(ProdConfig):\n pass\n```\n\n### Models\n\n```python\n# hello-flask-unchained/app/models.py\n\nfrom flask_unchained.bundles.sqlalchemy import db\n\n\nclass NameSubmission(db.Model):\n class Meta:\n repr = ('id', 'name')\n\n name = db.Column(db.String(128))\n\n # the following primary key and timestamp columns are automatically added to models\n # (if necessary/not customized)\n # id = db.Column(db.Integer, primary_key=True)\n # created_at = db.Column(db.DateTime, server_default=sqlalchemy.func.now())\n # updated_at = db.Column(db.DateTime, server_default=sqlalchemy.func.now(),\n # onupdate=sqlalchemy.func.now())\n```\n\n### Services\n\n```python\n# hello-flask-unchained/app/services.py\n\nfrom flask_unchained.bundles.sqlalchemy import ModelManager\n\nfrom . import models\n\n\nclass NameSubmissionManager(ModelManager):\n class Meta:\n model = models.NameSubmission\n\n def create(self, name, commit: bool = False, **kwargs) -> models.NameSubmission:\n return super().create(name=name, commit=commit, **kwargs)\n```\n\n### Forms\n\n```python\n# hello-flask-unchained/app/forms.py\n\nfrom flask_unchained.bundles.sqlalchemy.forms import ModelForm\n\nfrom . import models\n\n\nclass NameSubmissionForm(ModelForm):\n class Meta:\n model = models.NameSubmission\n```\n\n### Views\n\nA hello world view:\n\n```python\n# hello-flask-unchained/app/views.py\n\nfrom flask_unchained import Controller, route, request, injectable, param_converter\n\nfrom . import forms, models, services\n\n\nclass SiteController(Controller):\n name_submission_manager: services.NameSubmissionManager = injectable\n\n @route('/', methods=['GET', 'POST'])\n @param_converter(id=models.NameSubmission) # converts the `id` query param to a model\n def index(self, name_submission=None):\n form = forms.NameSubmissionForm(request.form)\n if form.validate_on_submit():\n name_submission = self.name_submission_manager.create(name=form.name.data,\n commit=True)\n return self.redirect('index', id=name_submission.id)\n return self.render('index', form=form, name_submission=name_submission)\n```\n\n### Templates\n\n```jinja2\n{# hello-flask-unchained/app/templates/layout.html #}\n\n\n\n \n \n \n {% block title %}Flask Unchained Hello World{% endblock %}\n\n {% block stylesheets %}\n {% endblock stylesheets %}\n \n\n \n {% block body %}\n

\n {% block content %}\n {% endblock content %}\n

\n {% endblock body %}\n\n {% block javascripts %}\n {% endblock javascripts %}\n \n\n```\n\n```jinja2\n{# hello-flask-unchained/app/templates/site/index.html #}\n\n{% extends 'layout.html' %}\n\n{% set name = name_submission.name | default('World') %}\n\n{% block title %}Hello {{ name }}{% endblock %}\n\n{% block content %}\n

Hello {{ name }}

\n\n \n{% endblock %}\n```\n\n### Routes\n\nNow we can register the controller with our `routes`:\n\n```python\n# hello-flask-unchained/app/routes.py\n\nfrom flask_unchained import (controller, resource, func, include, prefix,\n get, delete, post, patch, put, rule)\n\nfrom .views import SiteController\n\n\nroutes = lambda: [\n controller(SiteController),\n]\n```\n\n### Commands\n\nAnd run it:\n\n```bash\nflask run\n * Environment: development\n * Debug mode: on\n * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)\n```\n\nNow you should be able to browse to [http://localhost:5000](http://localhost:5000) to view your new site!\n\n## Contributing\n\nContributions are more than welcome! This is a big project with a lot of different things that need doing. There's a TODO file in the project root, or if you've got an idea, open an issue or a PR and let's chat.\n\n## License\n\nMIT\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",1157905169,"orgData","recentTags",[87,124],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},"content_type","creator",1151297,"full_size",102319963,"id",45433975,"images",[97],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},"architecture","amd64","digest","sha256:a8af745c0b243d626ee59a3db864696f0720a158565667e559d6ce8e1bdf6806","features","last_pulled","2026-09-26T03:53:36.619538029Z","last_pushed","2019-02-07T09:52:34Z","os","linux","os_features","os_version","size","variant","2019-02-07T09:52:33.930596Z","last_updater","last_updater_username","media_type","latest","repository",6613028,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_88":40,"_89":90,"_91":125,"_93":126,"_95":127,"_46":132,"_114":90,"_115":29,"_116":52,"_53":133,"_118":119,"_120":130,"_121":132,"_122":62,"_123":17},382414691,46146977,[128],{"_98":99,"_100":129,"_102":44,"_103":130,"_105":131,"_107":108,"_109":44,"_110":-5,"_111":125,"_59":62,"_112":-5},"sha256:d04819cb13b52ee4187948963e5e289b3c4494fe9d319c09539603f9432e49f9","2026-09-23T21:23:07.013693337Z","2019-02-07T10:01:32Z","2019-02-07T10:06:45.629158Z","stretch","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":145,"_152":153,"_141":166,"_167":11},{"_36":146,"_38":147,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":148,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":149,"_75":11,"_76":151,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":150},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_154":155,"_156":-5,"_157":-5,"_158":159},"count",2,"next","previous","results",[160,163],{"_88":40,"_89":90,"_91":125,"_93":126,"_95":161,"_46":132,"_114":90,"_115":29,"_116":52,"_53":133,"_118":119,"_120":130,"_121":132,"_122":62,"_123":17},[162],{"_98":99,"_100":129,"_102":44,"_103":130,"_105":131,"_107":108,"_109":44,"_110":-5,"_111":125,"_59":62,"_112":-5},{"_88":40,"_89":90,"_91":92,"_93":94,"_95":164,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},[165],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},[],"canDeleteTags","actionData","errors"]

chriamue/flask-unchained

Tags for chriamue/flask-unchained