Python Friday #32: First Steps With Flask

It is now time for me to do some web development. I choose the Flask framework because it allows me to start quickly and later add more functionality when I need it.

This post is part of my journey to learn Python. You can find the other parts of this series here.

 

Install Flask

Flask is a micro web framework that comes with a minimalistic core and uses existing packages to increase the functionality. This gives you a lot of flexibility and if you do not like something, you can replace it.

You can use this command to install Flask in a virtual environment:

 

A minimalistic application

The simplest possible application with Flask only needs a few lines of code:

I saved my app in a file called hello.py. You can choose a different name but be aware that you need to set the name for your app accordingly when you try to run it.

 

Run your Flask app on the command line

Depending on which environment you use to start, you need a different way to set environment variables to start Flask.

For PowerShell on Windows, you can run your app with these commands:

In the CMD for Windows you need this syntax:

On Linux and Mac, you can use these commands:

There is yet another way to run this minimalistic app. Thanks to the conventions of Flask and the code in the lines 9 and 10, we can run the file as we would run any other Python script:

Whichever command we use, we should find our application on the URL http://127.0.0.1:5000/ and see the Hello world! message:

 

Run your Flask app in VS Code

If we want to run our little application inside VS Code, we need to do some extra steps, but we get a working debugger in return.

Inside VS Code we need to open the run menu. It is tempting to click on the Run and Debug button, but this will require us to go through all the steps again whenever we want to run our application. Instead, click on the link called “create a launch.js file”:

In the middle of the top navigation bar starts a little wizard that will create the correct starter file. We need to select Flask as the type of our application:

If we did not name our application app.py we need to type in the name of our file:

That is all it takes. In our project folder next to our hello.py we now have a file with the name launch.json and this content:

Inside the run menu we now get no longer a button to run and debug our application, but instead we see our run configuration next to the green starter arrow:

If we click on this arrow, VS Code will start our application in the debugger:

Should you be unable to debug your application after you set a breakpoint, do not waste a lot of time. Go to the extension manager of VS Code and install the previous version of the Python plugin as described here.

 

Next

We now have a minimalistic Flask application that prints hello world. That is nothing spectacular, but everything we need to extend our application is present. Before we discover more about Flask, I have some more tips for a better development experience in VS Code.