|
|
|
|
.. _tutorial-introduction:
|
|
|
|
|
|
|
|
|
|
Introducing Flaskr
|
|
|
|
|
==================
|
|
|
|
|
|
|
|
|
|
This tutorial will demonstrate a blogging application named Flaskr, but feel
|
|
|
|
|
free to choose your own less Web-2.0-ish name ;) Essentially, it will do the
|
|
|
|
|
following things:
|
|
|
|
|
|
|
|
|
|
1. Let the user sign in and out with credentials specified in the
|
|
|
|
|
configuration. Only one user is supported.
|
|
|
|
|
2. When the user is logged in, they can add new entries to the page
|
|
|
|
|
consisting of a text-only title and some HTML for the text. This HTML
|
|
|
|
|
is not sanitized because we trust the user here.
|
|
|
|
|
3. The index page shows all entries so far in reverse chronological order
|
|
|
|
|
(newest on top) and the user can add new ones from there if logged in.
|
|
|
|
|
|
|
|
|
|
SQLite3 will be used directly for this application because it's good enough
|
|
|
|
|
for an application of this size. For larger applications, however,
|
|
|
|
|
it makes a lot of sense to use `SQLAlchemy`_, as it handles database
|
|
|
|
|
connections in a more intelligent way, allowing you to target different
|
|
|
|
|
relational databases at once and more. You might also want to consider
|
|
|
|
|
one of the popular NoSQL databases if your data is more suited for those.
|
|
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
If you're following the tutorial from a specific version of the docs, be
|
|
|
|
|
sure to check out the same tag in the repository, otherwise the tutorial
|
|
|
|
|
may be different than the example.
|
|
|
|
|
|
|
|
|
|
Here is a screenshot of the final application:
|
|
|
|
|
|
|
|
|
|
.. image:: ../_static/flaskr.png
|
|
|
|
|
:align: center
|
|
|
|
|
:class: screenshot
|
|
|
|
|
:alt: screenshot of the final application
|
|
|
|
|
|
|
|
|
|
Continue with :ref:`tutorial-folders`.
|
|
|
|
|
|
|
|
|
|
.. _SQLAlchemy: https://www.sqlalchemy.org/
|
