cookiecutter-flask ================== A Flask template for cookiecutter_. .. _cookiecutter: https://github.com/audreyr/cookiecutter Use it now ---------- :: $ pip install cookiecutter $ cookiecutter https://github.com/sloria/cookiecutter-flask.git You will be asked about your basic info (name, project name, app name, etc.). This info will be used in your new project. Features -------- - Bootstrap 3 and Font Awesome 4 with starter templates - Flask-SQLAlchemy with basic User model - Easy database migrations with Flask-Migrate - Flask-WTForms with login and registration forms - Flask-Login for authentication - Flask-Bcrypt for password hashing - Procfile for deploying to a PaaS (e.g. Heroku) - Flask-Testing, Flask-Webtest, nose, and Factory-Boy for testing (example tests included) - A simple ``manage.py`` script. - CSS and JS minification using Flask-Assets - Optional bower support for frontend package management - Caching using Flask-Cache - Useful debug toolbar - Utilizes best practices: `Blueprints `_ and `Application Factory `_ patterns Screenshots ----------- .. image:: https://dl.dropboxusercontent.com/u/1693233/github/cookiecutter-flask-01.png :target: https://dl.dropboxusercontent.com/u/1693233/github/cookiecutter-flask-01.png :alt: Home page .. image:: https://dl.dropboxusercontent.com/u/1693233/github/cookiecutter-flask-02.png.png :target: https://dl.dropboxusercontent.com/u/1693233/github/cookiecutter-flask-02.png.png :alt: Registration form Inspiration ----------- - `Building Websites in Python with Flask `_ - `Getting Bigger with Flask `_ - `Structuring Flask Apps `_ - `Flask-Foundation `_ by `@JackStouffer `_ - `flask-bones `_ by `@cburmeister `_ - `flask-basic-registration `_ by `@mjhea0 `_ - `Flask Official Documentation `_ License ------- BSD licensed. Changelog --------- 0.3.1 (02/20/2014) ****************** - Update default year in cookiecutter.json. Thanks @Omeryl - Correct testing of redirects in webtests. Thanks @Widdershin - Fix POST action in nav form. Thanks @Widdershin. - Update Bootstrap (3.1.1) and jQuery (2.1.0) - Optional support for bower. - Minified assets aren't used in dev environment. 0.3.0 (12/08/2013) ****************** - More modular organization: each blueprint contains its own view, models, and forms in a directory. There is still a single directory for templates and static assets. - Use Flask-Bcrypt for password hashing. - Flask-Login for authentication. - Simple test setup. Just create a subclass of ``DbTestCase``. - Flask-Testing support. - Use Factory-Boy for test factories. - Use WebTest for functional testing. - Add Flask-Debugtoolbar. - Migrations using Flask-Migrate. - Caching using Flask-Cache. - Add error page templates (404, 401, 500) - Add Font Awesome 4.0.3 for icons. 0.2.0 (09/21/2013) ****************** - Add manage.py script - Add Flask-Assets for CSS and JS bundling+minification - Use different configs for development and production environments, controlled by the MYFLASKAPP_ENV system environment variable - Use Blueprints and application factory pattern. The ``simple`` branch does not use these. 0.1.0 (08/20/2013) ****************** - First iteration - Bootstrap 3 final - Working User model and registration