Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Opening the Flask

Opening the Flask

Presented at PyCon Atlanta 2011

Armin Ronacher

March 21, 2011

Transcript

38 slides
  1. Opening the Flask How an April Fools’ Joke became a

    Framework with Good Intentions Armin Ronacher // @mitsuhiko // http://lucumr.pocoo.org/
  2. About Me My name is Armin Ronacher Part of the

    Pocoo Team @mitsuhiko on Twitter/github/bb http://lucumr.pocoo.org/
  3. Motivation ❧ web2py / bottle / web.py ❧ “single le

    framework” ❧ “web scale” ❧ NoSQL ❧ screencast
  4. The Story ❧ by Eirik Lahavre ❧ Entirely made up

    ❧ Jinja2 + Werkzeug zipped ❧ “Impressive Scaling Capabilities” ❧ RESTful
  5. What that taught me ❧ Nobody has time to properly

    test the framework and read the code ❧ Marketing beats Quality ❧ Features don't matter ❧ Does not have to be new
  6. Don't be evil™ ❧ Just because nobody looks at tests

    it does not mean that there shouldn't be tests ❧ Marketing and good code quality do not have to be mutually exclusive
  7. Enter Flask ❧ Wordplay on Bottle, probably a mistake ❧

    based on Jinja2 and Werkzeug ❧ tons of documentation ❧ “best of breed” code
  8. µ? ❧ Flask depends on Werkzeug, Jinja2 and optionally Blinker

    ❧ There is also a Kitchensink release that includes Flask and deps to drop next to your Project.
  9. Some Numbers ❧ 800 LOC Code ❧ 1500 LOC Tests

    ❧ 200 A4 Pages of Documentation
  10. Ecosystem ❧ over 30 extensions ❧ very active mailinglist ❧

    over 700 followers and 100 forks on github – yay
  11. hello.py from flask import Flask app = Flask(__name__) @app.route('/') def

    index(): return 'Hello Flask!' if __name__ == '__main__': app.run()
  12. hello.py from flask import Flask, render_template app = Flask(__name__) @app.route('/',

    defaults={'name': 'Flask'}) @app.route('/<name>') def index(name): return render_template('hello.html', name=name) if __name__ == '__main__': app.run()
  13. hello.html {% extends 'layout.html' %} {% block title %}Greetings{% endblock

    %} {% block body %} <h1>Hello {{ name }}!</h1> {% endblock %}
  14. layout.html <!doctype html> <head> <title>{% block title %}{% endblock %}</title>

    </head> <body> {% block body %}{% endblock %} </body>
  15. Context Locals ❧ either you have them everywhere or nowhere

    ❧ some things really need them or it becomes ugly (ORMs for instance) ❧ so we chose to embrace them
  16. Fighting the Python ❧ No import time side effects ❧

    Explicit application setup ❧ Circular imports ❧ Cached Imports
  17. Why not like this? from flask import route, run @route('/')

    def index(): return 'Hello Flask!' if __name__ == '__main__': run()
  18. Explicit Setup ❧ Applying WSGI middlewares ❧ More than one

    app ❧ Testing ❧ Create app in function
  19. Import Order ❧ Larger projects: module seem to import in

    arbitrary order ❧ URL rules are attached to functions ❧ Routing system has to reorder them intelligently
  20. Power and Simplicity def wsgi_app(self, environ, start_response): with self.request_context(environ): rv

    = self.preprocess_request() if rv is None: rv = self.dispatch_request() response = self.make_response(rv) return response( environ, start_response)
  21. Simple Things Simple import sqlite3 from flask import g DATABASE

    = '/path/to/database.db' @app.before_request def before_request(): g.db = sqlite3.connect(DATABASE) @app.after_request def after_request(response): g.db.close() return response
  22. Extensions ❧ Addons for Flask go into dedicated extensions. ❧

    Core stays small ❧ SQLAlchemy, Babel, Genshi, CouchDB, MongoDB, etc.
  23. Flask-SQLAlchemy from flask import Flask from flaskext.sqlalchemy import SQLAlchemy app

    = Flask(__name__) db = SQLAlchemy(app) class User(db.Model): name = db.Column(db.String(40), primary_key=True) email = db.Column(db.String(100)) @app.route('/user/<name>') def show_user(name): user = User.query.filter_by(name=name).first_or_404() return render_template('user.html', user=user)
  24. Not a Mistake ❧ Nice documentation design makes you actually

    write documentation ❧ Documentation style for extensions ❧ Simple visual design is easy to adapt for extension developers
  25. Thank you for listening and your interest in Flask. Feel

    free to ask questions! Slides available at http://lucumr.pocoo.org/talks/ Contact me on twitter @mitsuhiko or via mail: [email protected]
  26. Legal © Copyright 2011 by Armin Ronacher http://lucumr.pocoo.org/ — @mitsuhiko

    Content licensed under the Creative Commons attribution-noncommercial- sharealike License. Images vectorized from images from Wiki Commons (http://commons.wikimedia.org/) and public domain sources. Individual copyrights apply. Talk available for download at http://lucumr.pocoo.org/talks/

More Decks by Armin Ronacher

Other Decks in Programming