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, etc.). This info will be used in your new project. Features -------- - Twitter Bootstrap 3 and 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 - 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 - 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.0 ***** - 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. 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