Skip to content

bettblake08/Fast-Food-Fast

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 

Repository files navigation

Fast Food Fast

Build Status Coverage Status Test Coverage Maintainability Codacy Badge

This is an web project that implements the online restaurant business requirements set by the FastFoodFast restaurant. FastFoodFast is a restaurant thats serves fast food meals such as french fries, burgers, fried food, soda and much more. But to reach a larger market of customers that are not willing to visit their restaurant, they have decided to produce an online web platform for aspiring customers to make an order from their restaurant.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

  1. Fork the repo here fork me

  2. In your projects folder, open up your cmd/powershell/git bash/... and clone the repository by running the following by running the following, xxxx is your GitHub name:

git clone [email protected]:xxxx/Fast-Food-Fast.git 
  1. Move into the directory by running the following
cd Fast-Food-Fast/

Prerequisites

Before you can bet started on running and testing the project code, you need to do the following:

  1. Install GIT version control

If you do not have GIT on your local machine, to run git commands to retrieve this project, you should. Visit the installation guide for GIT on all platforms.

  1. Install your preferred text editor

If you do not have a text editor on your machine such as VSCode, Sublime and Atom, make it a point to have one. This is required to writing web development code much easier.

  1. Install python on your local machine

This project is running on Python as the backbone of the app was developed using the Flask framework. Ensure you have a running python program of version 3.5 or greater. The recommended version is python 3.7.

  1. Install Postgres Database on your machine

This project uses a Postgres database as the primary data storage of all the data the app handles. Click here for the installation guide.

Installing

The following is a step by step guide to install and run the app in a development environment on your local machine.

  1. If you have not installed virtualenv, a python virtual environment tool for generating a virtual environment where all the python modules can be installed, in your terminal, run the following:
pip install virtualenv
  1. Relocate to the project directory, then run the following to create the new python virtual environment:
virtualenv env

Note: I recommend specifying the python version of the new virtual environment. Click here to learn more.

  1. Activate your virtual environment by running the following:

In Linux,

source env/bin/activate

In Windows powershell,

env/Scripts/activate

In Windows CMD,

env/Scripts/activate.bat

When activated, in the terminal, you shall be able to see the virtual environment name in front of your project directory as such:

(env)<Local machine>:<Project Folder>$  

Note: Above is the representation in Linux

  1. When activated, to install the python modules required to run the application, run the following:
python setup.py build
python setup.py install

This will take care of installing all the dependencies required for the application to run

  1. When the above is done, run the following to host the application on the machine:
python app.py

You should be able to view the details on which the app is running in.

Running the tests

To run the application tests, run the following:

python -m pytest -v

This runs all the test scripts and provides a detailed view on each test scripts function status.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

See also the list of contributors who participated in this project.