Exploring the Flask web framework in Python
Hip Flask
The Flask micro framework emerged from an April Fool's prank, but this simple and easy web development aid is no joke.
Developers who are looking for a Python web framework often turn to the popular Django framework [1], but Django isn't the best choice for every situation. For instance, developers occasionally face tasks that are very difficult to solve with Django's object relational mapper (ORM) or that require additional applications or other frameworks. In some cases, the versatility of Django leads to a complexity that simply isn't needed for a quick and simple project. When less is actually more, a micro web framework such as Flask [2] is often a better option.
This article demonstrates the Flask web framework by putting it to work on a real-world web application: a handy little brainstorming tool known as Geistesblitze. The word Geistesblitze is German for brainstorms or flashes of genius. The tool consists of a web application with graphical Web UI for quickly capturing and associating ideas. This simple example will introduce you to the most important and interesting aspects of Flask. The complete code is available under a BSD license on GitHub [3].
April Fool!
In 2010, the Denied [4] micro web framework popped up on the web for the first time. Python developer Armin Ronacher published it as April Fool's day joke; he wanted to poke fun at the business model of various micro web frameworks that were popular at the time. He bundled all the code into a single file called deny.py
and posted a badly programmed web page (Figure 1) with fake quotes. He also shot a movie with a Dutch friend posing as the French developer of Denied [5].
To his surprise, the reactions to Denied were mostly positive and significantly exceeded those of his other projects. Some developers found the ideas interesting and refreshingly new, and the Flask project was born.
Flask is also available under a BSD-style license and is based on the Werkzeug Toolkit [6], as well as the Jinja 2 template engine [7]. Both projects come from the Pocoo team [8] led by Georg Brandl and Armin Ronacher.
Flask comes with everything you need to design Web applications. Developers will especially appreciate the elegance, the intuitive interface, and the ease with which they can adapt Flask features to suit their needs via extensions. The framework supports Unicode and Python's web server gateway interface (WSGI), as well as several popular security features.
Flashes of Genius
The Geistesblitze project gives users the ability to register and sketch out their ideas, their flashes of genius. Every idea gets a name and a description. The application demonstrates the use of some features of Flask, including templates (render_template
), redirects (redirect
), and messages (flash
). The project also uses the Flask Bootstrap [9], Flask Login [10], Flask SQL Alchemy [11], and Flask WTF [12] extensions.
The structure of a Flask application is largely open. The only requirements are that the static
and templates
directories must exist and reside in the same directory as the application. Even these requirements can change, however, if you use the appropriate parameters when creating the app object.
The rest of the application can live in a single app.py
Python file. You can also break down the complete application into various files, such as models.py
, forms.py
, and views.py
. Separate files are recommended as soon as the code becomes complex and large. For a sample application, a complex file structure is not worth the trouble; the Geistesblitze application consists of the files app.py
, create_all.py
, run.py
; the folders templates
and static
; and some standard files, including requirements.txt
, README.md
, and LICENSE
.
Virtually Secured
Flask supports versions 2.7 and 3.4 of Python. I used a system with Ubuntu 14.04 (64 bit) and Python 3.4.
The first step is to download the Geistesblitze files [3], unpack them, and change to the newly created directory (Listing 1). Use pyvenv
to create a virtual environment and enable it via the commands in line 2. Because Ubuntu 14.04 does not deliver the Pip Python package manager, line 3 retrieves it from a web page and then proceeds to install. Pip, in turn, retrieves all the Geistesblitze dependencies, which are listed in the requirements.txt
file.
The create_all.py
file, which the Flask user executes in the penultimate step, consists of four lines of code and is used to create two tables, users
and ideas
, separately from the application itself in a local SQLite file: geistesblitze.sqlite
. Also the run.py
file is only four lines in length; it starts the actual application by the name of app.py
.
You can then type http://localhost: 5000/register
(Figure 2) to run Geistesblitze in a browser like Firefox. To exit the virtual Python environment, type the (venv) deactivate
command.
If Python 2.7 is used, you also need virtualenv
, which you can install using sudo apt-get install python-virtualenv
. Then follow the steps 1, 2, and 5, through 7 from Listing 1, but change line 1 to virtualenv venv
.
Listing 1
Installing Geistesblitze
Buy this article as PDF
(incl. VAT)
Buy Linux Magazine
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Support Our Work
Linux Magazine content is made possible with support from readers like you. Please consider contributing when you’ve found an article to be beneficial.
News
-
Latest Cinnamon Desktop Releases with a Bold New Look
Just in time for the holidays, the developer of the Cinnamon desktop has shipped a new release to help spice up your eggnog with new features and a new look.
-
Armbian 24.11 Released with Expanded Hardware Support
If you've been waiting for Armbian to support OrangePi 5 Max and Radxa ROCK 5B+, the wait is over.
-
SUSE Renames Several Products for Better Name Recognition
SUSE has been a very powerful player in the European market, but it knows it must branch out to gain serious traction. Will a name change do the trick?
-
ESET Discovers New Linux Malware
WolfsBane is an all-in-one malware that has hit the Linux operating system and includes a dropper, a launcher, and a backdoor.
-
New Linux Kernel Patch Allows Forcing a CPU Mitigation
Even when CPU mitigations can consume precious CPU cycles, it might not be a bad idea to allow users to enable them, even if your machine isn't vulnerable.
-
Red Hat Enterprise Linux 9.5 Released
Notify your friends, loved ones, and colleagues that the latest version of RHEL is available with plenty of enhancements.
-
Linux Sees Massive Performance Increase from a Single Line of Code
With one line of code, Intel was able to increase the performance of the Linux kernel by 4,000 percent.
-
Fedora KDE Approved as an Official Spin
If you prefer the Plasma desktop environment and the Fedora distribution, you're in luck because there's now an official spin that is listed on the same level as the Fedora Workstation edition.
-
New Steam Client Ups the Ante for Linux
The latest release from Steam has some pretty cool tricks up its sleeve.
-
Gnome OS Transitioning Toward a General-Purpose Distro
If you're looking for the perfectly vanilla take on the Gnome desktop, Gnome OS might be for you.