This project demonstrates how to use Python to create web application. It is a primarily meant for educational purposes, specifically created for the WorldQuant University Introduction to Data Science Module.
The skills and tools used are:
- Python's
requests
package. - Python's
flask
web framework. - working with JSONs.
- modular programming
When a client visits the application, it
- gets the client's IP address.
- uses the IP address to look up their location.
- uses their location data to greet them with temperature of the city they are located in.
All required Python packages can be found in the requirements.txt
file. Additionally, the provided Makefile
can be used to created a virtual environment by running make venv
. You will also need a Heroku account and have installed the Heroku CLI. For more information on the Heroku CLI, go to https://devcenter.heroku.com/articles/heroku-cli#download-and-install.
You may want to run the app using Flask locally before deploying it to Heroku, especially if you have made any changes to the code. To run locally:
- clone the repository.
- in the repository, run
make deploy
. - open the link provided in the command line.
If you are using Windows, you can:
- create and activate the virtual environment.
set FLASK_APP=app.py
in the command line.- run
python -m flask run
. - open the link in the command line.
Make sure your app is ready to be deployed to Heroku by running Flask locally. To deploy to Heroku:
- clone the repository (if you haven't yet).
heroku login
and enter your credentials.heroku create
orheroku create app-name
where app-name is a custom app name.git push heroku master
.heroku open
or open the app online through your Heroku profile.
Since this is a short demonstration of what you can do using Python for creating web application, consider extensions to the project. Some ideas include:
- showing a plot of the forecast.
- using their location to display other location specific data.
This project is distributed under the GNU General Purpose License. Please see LICENSE
for more information.