Skip to content

This is a simple python flask web app that implements geometric calculations for three shapes given the user's input for radius and height. It is recommended this app be run using a python virtual environment, but not necessary for success. Unit tests are also included.

foxster14/geometry_calculator_python_flask_web_app

Repository files navigation

Geometry Calculator Web

The is a simple Flask-based web application that uses a Geometry Calculator Tool created out of assignments from my Intro to Programming course. This project demonstrates simple implementations of the following methodologies:

  • Unit testing
  • Virtual environments for code deployment
  • And a dynamic web application using Python Flask as the framework

App Prep & Run Steps

To use this code do the following:

  1. Pick a location on disk and clone this code into a local repository:

    git clone https://github.com/foxster14/geometry_calculator_python_flask_web_app

    (Alternatively the new GitHub CLI could also be used)

    A new directory will be created: geometry_calculator_python_flask_web_app "cd" into it.

    cd ./geometry_calculator_python_flask_web_app

  2. Create a Python Virtual Environment

    It is advisable to use a Python Virtual Environment to keep this app's dependencies separate from other Python dependencies on the target machine. To create a Virtual Environment do the following from within the geometry_calculator_web directory:

    Unix OS's:

    python3 -m venv venv

    Windows:

    python -m venv venv

  3. Activate the Virtual Environment:

    Unix OS's:

    source venv/bin/activate

    Windows:

    venv\Scripts\activate.bat

  4. Install App Dependencies Using the Python Package Tool:

    Rather than using pip to install the required packages, such as Flask, etc., all dependencies are in the requirements.txt file.

    In a virtual environment that was create using Python 3, on Unix OS's there no need to use pip3. You can, but pip also works in this instance.

    pip install -r requirements.txt

    Windows:

    pip install -r requirements.txt

  5. Run the Application:

    python GeometryCalcWeb.py

    The App should now be running on port 5000. Access it via localhost:5000 --or-- 127.0.0.1:5000

Python Unit Testing

This repo also contains two sample Unit Tests. One for the cylinder.py module. One for the GeometryCalcWeb.py program.

You can run them by doing the following:

python cylinderTest.py

python GeometryCalcWeb.py

About

This is a simple python flask web app that implements geometric calculations for three shapes given the user's input for radius and height. It is recommended this app be run using a python virtual environment, but not necessary for success. Unit tests are also included.

Topics

Resources

Stars

Watchers

Forks