shiftboiler 0.4.2

Boilerplate setup for webapps, apis and cli applications with flask

shift-boiler

Boiler is a best-practices setup of flask framework integrated with a number of libraries to quickly bootstrap app development. You can do console applications, web apps or apis with boiler. It is also a good example of how to set up flask framework for large projects.

Here are some main features all of which are pluggable and optional:

• Click integration for CLI apps
• Web app scaffolding
• API app scaffolding and Restfulness
• ORM with SQLAlchemy
• Database migrations with Alembic
• Entity/model validation framework with shift-schema
• Localization and translations with Babel
• Web forms with WTForms
• User registration and authentication including OAuth support for facebook, google, twitter and vk
• RBAC and access control with Principal
• Routing with lazy-views and on-demand view import
• Set of useful Jinja additions and filters including support for versioned static assets.
• All of the features are pluggable and optional. Use whatever you need.

Ridiculously quick start

Create virtual environment:

mkdir boiler-testdrive && cd boiler-testdrive
virtualenv -p python3 env
source env/bin/activate

Install and run boiler:

pip install shiftboiler
boiler init .
boiler dependencies flask
./cli run

That was quickstart for robots. We also have a quickstart for humans, with some further exaplanations.

Versioning

We loosely follow semver except we did not have a major release yet to indicate the fact that the is still not entirely production ready. We however did successfully used it in production on multiple occasions for webapps and apis. Just remember to freeze your boiler version in requirements file and expect minor versions to introduce breaking changes.

Documentation

• Quickstart for humans
• Full configuration example
• Boiler features
• Testing: helpers and environment
• Working with collections
• Working with forms: entity validation and recaptcha
• MacOS: signing python interpreter