flask-bones

Setup

docker-compose up -d

docker-compose run --rm app flask create-dbdocker-compose run --rm app flask populate-db --num_users 5

yarn install --modules-folder ./app/static/node_modules

Configuration

Features

Caching with Memcached

fromapp.extensionsimportcache# Cache somethingcache.set('some_key','some_value')# Fetch it latercache.get('some_key')

Email delivery

fromapp.extensionsimportmailfromflask_mailimportMessage# Build an emailmsg=Message('User Registration',sender='admin@flask-bones.com',recipients=[user.email])msg.body=render_template('mail/registration.mail',user=user,token=token)# Sendmail.send(msg)

Asynchronous job scheduling with RQ

@rq.jobdefsend_email(msg):mail.send(msg)

flask rq worker

send_email.queue(msg)

flask rq info --interval 3

flask rq --help

Stupid simple user management

fromapp.extensionsimportlogin_user,logout_user,login_required# Login userlogin_user(user)# You now have a global proxy for the usercurrent_user.is_authenticated# Secure endpoints with a decorator@login_required# Log out userlogout_user()

Password security that can keep up with Moores Law

fromapp.extensionsimportbcrypt# Hash passwordpw_hash=bcrypt.generate_password_hash('password')# Validate passwordbcrypt.check_password_hash(pw_hash,'password')

Easily swap between multiple application configurations

fromapp.configimportdev_config,test_configapp=Flask(__name__)classdev_config():DEBUG=Trueclasstest_config():TESTING=True# Configure for testingapp.config.from_object(test_config)# Configure for developmentapp.config.from_object(dev_config)

Form validation & CSRF protection with WTForms

{{ form.csrf_token }}

form.validate_on_submit()

Rate-limit routes

fromapp.extensionsimportlimiter@limiter.limit("5 per minute")@auth.route('/login',methods=['GET','POST'])deflogin():# ...return'your_login_page_contents'

Automated tests

pytest

Use any relational database using the SQLAlchemy ORM

fromapp.user.modelsimportUser# Fetch user by iduser=User.get_by_id(id)# Save current state of useruser.update()# Fetch a paginated set of usersusers=User.query.paginate(page,50)

Front-end asset management

yarn install --modules-folder ./app/static/node_modules

flask assets build

Version your database schema

flask db current

flask db revision

flask db upgrade

Internationalize the application for other languages (i18n)

pybabel extract -F babel.cfg -o i18n/messages.pot.

pybabel init -i i18n/messages.pot -d i18n -l de

pybabel compile -d i18n

pybabel update -i i18n/messages.pot -d i18n