Skip to content

Latest commit

 

History

History
76 lines (43 loc) · 3.06 KB

README.md

File metadata and controls

76 lines (43 loc) · 3.06 KB

flask-minimal

This is a minimal Flask project, with no external dependencies except for Flask itself. It suggests deployment with meinheld + gunicorn, using Docker containers. Apache + mod_wsgi and nginx + uwsgi options are also available.

Usage

Install cookiecutter:

pip install --user cookiecutter

Create your application from this template:

cookiecutter https://github.com/bandaangosta/cookiecutter-flask-minimal.git

All set! Run the application:

cd yourapplication
make run

And then open it at http://127.0.0.1:5000/

Features

Included:

  • minimal production-ready Flask application: root package, sample static resource, sample template and an index view, as per Larger Applications

  • setuptools configuration to package and release the application, as well as to develop locally, as per Deploying with Setuptools

  • configuration system, as per Configuration Handling

  • basic logging configuration, as per Logging to a File

  • sample test and configuration necessary to run the tests, as per The Testing Skeleton

  • Makefile with few typical tasks automated (see generated README for details)

  • It suggests deployment with meinheld + gunicorn, using Docker containers. If you are interested in an out-of-the-box deployment automation, check out accompanying cookiecutter-flask-ansible; see generated README for more ideas about deployment

Not included:

  • everything else: there is no SQLAlchemy, or MongoKit, or Bootstrap CSS, or React, or whatever else here; it is up to you to chose how to implement your application

Contributions

... are welcome! Feel free to create a pull request to fix bugs or keep up to date.

If you think some additional feature is indispensable, feel free to create an issue or a pull request, but bare in mind that the goal of this template is to stay a "minimal" one. If you would like to add a feature, maybe best way to do so is to make it optional and off by default then. One can use cookiecutter's choice variables, and, ultimately, hooks, in order to create an optional feature.

If you do a change, use make test from root directory to test the updated template.

Attributions

Configuration of this entire project template is based on Flask documentation. Please, note however, that this template is not guaranteed to follow Flask documentation precisely.

Possible future improvements

  • add optional configuration for e-mail error reporting and/or Sentry
  • add choice for testng framework (and also make it entirely optional)
  • find a cross-platform replacement to a Makefile