chriamue/flask-unchained repository overview

# (create a virtual environment)
pip install flask-unchained[dev]
flask new project <your-project-folder-name>

# (answer the questions and `cd` into the new directory)
pip install -r requirements-dev.txt
flask run

flask db init
flask db migrate -m 'create initial tables'
flask db upgrade

/home/user/dev/project-root
├── app                 # your app bundle package
│   ├── admins          # model admins
│   ├── commands        # Click CLI groups/commands
│   ├── extensions      # Flask extensions
│   ├── models          # SQLAlchemy models
│   ├── fixtures        # SQLAlchemy model fixtures (for seeding the dev db)
│   ├── serializers     # Marshmallow serializers (aka schemas)
│   ├── services        # dependency-injectable services
│   ├── tasks           # Celery tasks
│   ├── templates       # Jinja2 templates
│   ├── views           # Controllers, Resources and views
│   └── __init__.py
│   └── config.py       # app config
│   └── routes.py       # declarative routes
├── assets              # static assets to be handled by Webpack
│   ├── images
│   ├── scripts
│   └── styles
├── bundles             # custom bundles and/or bundle extensions/overrides
│   └── security        # a customized/extended Security Bundle
│       ├── models
│       ├── serializers
│       ├── services
│       ├── templates
│       └── __init__.py
├── db
│   └── migrations      # Alembic (SQLAlchemy) migrations (generated by Flask-Migrate)
├── static              # static assets (Webpack compiles to here, and Flask
│                       #  serves this folder at /static (by default))
├── templates           # the top-level templates folder
├── tests               # your pytest tests
├── webpack             # Webpack configs
└── unchained_config.py # the Flask Unchained config

/home/user/dev/hello-flask-unchained
├── app
│   ├── templates
│   │   └── site
│   │       └── index.html
│   ├── __init__.py
│   ├── config.py
│   ├── forms.py
│   ├── models.py
│   ├── routes.py
│   ├── services.py
│   └── views.py
└── unchained_config.py

# (create a virtualenv and activate it)
pip install flask-unchained[dev,sqlalchemy] \
   && mkdir -p hello-flask-unchained/app && cd hello-flask-unchained \
   && touch unchained_config.py && cd app \
   && mkdir -p templates/site && touch templates/site/index.html \
   && touch __init__.py config.py forms.py models.py routes.py services.py views.py

# hello-flask-unchained/app/__init__.py

from flask_unchained import AppBundle, FlaskUnchained


class App(AppBundle):
    # you only need to subclass AppBundle; everything below is optional. for example, these
    # attributes can be set to customize which bundle module to load from (defaults shown)
    config_module_name = 'config'
    models_module_name = 'models'
    routes_module_name = 'routes'
    services_module_name = 'services'

    # these two methods are optional callbacks which the app factory will call
    def before_init_app(self, app: FlaskUnchained):
        pass
        
    def after_init_app(self, app: FlaskUnchained):
        pass

# hello-flask-unchained/unchained_config.py

import os

PROJECT_ROOT = os.path.abspath(os.path.dirname(__file__))

def folder_or_none(folder_name):
    folder = os.path.join(PROJECT_ROOT, folder_name)
    return folder if os.path.exists(folder) else None

# these get passed to the :class:`FlaskUnchained` constructor
TEMPLATE_FOLDER = folder_or_none('templates')
STATIC_FOLDER = folder_or_none('static')
STATIC_URL_PATH = '/static' if STATIC_FOLDER else None

# declare which bundles Flask Unchained should load
BUNDLES = [
    'flask_unchained.bundles.sqlalchemy',
    'app',  # your app bundle *must* be last
]

# hello-flask-unchained/app/config.py

import os

from flask_unchained import AppBundleConfig


class Config(AppBundleConfig):
    SECRET_KEY = os.getenv('FLASK_SECRET_KEY', 'change-me-to-a-secret-key')


# the following env-specific config classes are all optional

class DevConfig(Config):
    pass

class ProdConfig(Config):
    pass
    
class StagingConfig(ProdConfig):
    pass

# hello-flask-unchained/app/models.py

from flask_unchained.bundles.sqlalchemy import db


class NameSubmission(db.Model):
    class Meta:
        repr = ('id', 'name')

    name = db.Column(db.String(128))

    # the following primary key and timestamp columns are automatically added to models
    # (if necessary/not customized)
    # id = db.Column(db.Integer, primary_key=True)
    # created_at = db.Column(db.DateTime, server_default=sqlalchemy.func.now())
    # updated_at = db.Column(db.DateTime, server_default=sqlalchemy.func.now(),
    #                        onupdate=sqlalchemy.func.now())

# hello-flask-unchained/app/services.py

from flask_unchained.bundles.sqlalchemy import ModelManager

from . import models


class NameSubmissionManager(ModelManager):
    class Meta:
        model = models.NameSubmission

    def create(self, name, commit: bool = False, **kwargs) -> models.NameSubmission:
        return super().create(name=name, commit=commit, **kwargs)

# hello-flask-unchained/app/forms.py

from flask_unchained.bundles.sqlalchemy.forms import ModelForm

from . import models


class NameSubmissionForm(ModelForm):
    class Meta:
        model = models.NameSubmission

# hello-flask-unchained/app/views.py

from flask_unchained import Controller, route, request, injectable, param_converter

from . import forms, models, services


class SiteController(Controller):
    name_submission_manager: services.NameSubmissionManager = injectable

    @route('/', methods=['GET', 'POST'])
    @param_converter(id=models.NameSubmission)  # converts the `id` query param to a model
    def index(self, name_submission=None):
        form = forms.NameSubmissionForm(request.form)
        if form.validate_on_submit():
            name_submission = self.name_submission_manager.create(name=form.name.data,
                                                                  commit=True)
            return self.redirect('index', id=name_submission.id)
        return self.render('index', form=form, name_submission=name_submission)

{# hello-flask-unchained/app/templates/layout.html #}

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
    <title>{% block title %}Flask Unchained Hello World{% endblock %}</title>

    {% block stylesheets %}
    {% endblock stylesheets %}
  </head>

  <body>
    {% block body %}
      <div class="container">
        {% block content %}
        {% endblock content %}
      </div>
    {% endblock body %}

    {% block javascripts %}
    {% endblock javascripts %}
  </body>
</html>

{# hello-flask-unchained/app/templates/site/index.html #}

{% extends 'layout.html' %}

{% set name = name_submission.name | default('World') %}

{% block title %}Hello {{ name }}{% endblock %}

{% block content %}
  <h1>Hello {{ name }}</h1>

  <form name="{{ form._name }}" action="{{ url_for('site_controller.index') }}" method="POST">
    {{ form.hidden_tag() }}
    {{ form.name.label('Enter your name:') }}
    {{ form.name() }}
    <button type="submit">Submit</button>
  </form>
{% endblock %}

# hello-flask-unchained/app/routes.py

from flask_unchained import (controller, resource, func, include, prefix,
                             get, delete, post, patch, put, rule)

from .views import SiteController


routes = lambda: [
    controller(SiteController),
]

flask run
 * Environment: development
 * Debug mode: on
 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)