Flask Workshop

About

A simple Flask application with routing and Jinja templates. Accompanying slides can be found here.

Setup

Clone the repository

git clone http://github.com/hack4impact/flask-workshop.git
cd flask-workshop

If you do not have git installed on your computer, you can also download the .zip file.

Install Python

Tutorial

Another tutorial

Modifying your PATH environment variable

Install Pip

If you do not have pip already installed on your computer, follow this tutorial to install pip.

Install a virtual environment

pip install virtualenv
virtualenv -p python3 venv
source venv/bin/activate

Install dependencies

pip install -r requirements.txt

Creating the database

python manage.py recreate_db
python manage.py add_fake_data

Running the application

source venv/bin/activate
python run.py

Then navigate to http://localhost:5000/ on your preferred web browser.

Exiting the virtual environmment

deactivate

Related resources

• Flask Workshop Slides
• Flask-Base is a simple Flask boilerplate app with SQLAlchemy, Redis, User Authentication, and more. Check out our documentation as well!
• Flask documentation
• Jinja documentation
• Flask extensions

Tinkering

1. Play around with the templates.
   • Try changing the text, color, etc. and see what happens!
2. Add new routes.
   • Add a new route /noonoos in views.py that will render newbies.html.
   • Add a new route /newbiesf19 in views.py that redirects to /newbies.
     • Think about how these two might be different!
3. Create a new template and a new route.
   • Create a new template bootcamp.html. Put any HTML you want there (feel free to copy paste index.html!)
   • Create a new route /bootcamp in views.py.

Recording Every Newbie's Favorite Snack

1. Add a new column to the Newbie model.
   • Add a column called fave_snack in newbie.py. This should be of type String.
     • Since you modified the database, you'll need to recreate the database. This can be done by running python manage.py recreate_db.
2. Now that you've added a new column to Newbies, you'll need to change the form so that fave_snack can be inputed as well.
   • Add a StringField called fave_snack to AddNewbieForm in forms.py.
3. Next, you need to update the frontend for the form so that a user can actually input this new information.
   • In add_newbie.html, render the new field you just added to AddNewbieForm.
4. This additional information needs to be added to the database once a user submits the form.
   • Edit add_newbies() in views.py to also include the new fave_snack data.
5. Display this new information.
   • Edit newbies.html to also display every newbie's fave_snack as well.

Database Relationships Workshop

Learn about one-to-many and many-to-many relationships in the database-workshop branch by following this guide. To view the example code:

git pull
git checkout database-workshop