Flask Web Microframework

Prerequisites

You need to have a functional Python 3 environment to run this project. I recommend pyenv and pyenv-virtualenv.

After you can download and install the python modules into a segregated virtualenv.

# install python and create virtualenv## NOTE: pcre grep requires GNU grep, e.g. grep -oP
LATEST_PYTHON3=$( pyenv install --list | tr -d ''| grep -oP '^3\.*\d+\.\d+$'| sort -V | tail -1)
pyenv install $LATEST_PYTHON3
pyenv virtualenv $LATEST_PYTHON3 webmf-python-flask
# change to virtualenvcd.# update pip module
pip install --upgrade pip

Running the Application

These instructions and scripts have been tested on macOS (aka Mac OS X) and Linux with Python installed.

Test using Python

# Install Required Packages
pip install -r requirements.txt
# Run Server
./app.py &# Manually Test
curl -i localhost:5000/
curl -i localhost:5000/hello/Simon

Using Docker Compose

# Start containerized service on Docker
docker-compose up -d
# Determine Guest is native Docker, Docker-Machine or Docker-Desktop
[ -z${DOCKER_MACHINE_NAME} ] || WEBSERVER=$(docker-machine ip ${DOCKER_MACHINE_NAME})
WEBSERVER=${WEBSERVER:-localhost}# Manually Test
curl -i $WEBSERVER:5000/
curl -i $WEBSERVER:5000/hello/Simon

Using Docker on Vagrant/Virtualbox

# Start containerized service on Vagrant/Virtualbox guest
vagrant up
# Manually Test
curl -i localhost:5000/
curl -i localhost:5000/hello/Simon

Running Automated Tests

./test.py

Resources

• Python Web Microframework
  • Flask
• Testing
  • Testing Flask Applications
  • Python unittests in Jenkins?
• Python Environment
  • python - language versions
  • pyenv - manage python versions
  • virtualenv to isolate packages with both Python 2 and Python 3.
  • pyenv-virtualenv - pyenv plugin for ease-of-use pyenv + virtualenv integration. Can automatically switch virtualenv based on setting in .python-version.