koneb71/Tutorial_SimpleTeacherAPI

Configuration of Project Environment

This is an API that manages a list of teachers using Python3, Flask, and SQLAlchemy.

Overview on How to Run this API

1. Either install a Python IDE or create a Python virtual environment to install the packages required
2. Install packages required
3. Install MySQL 5.7
4. Install Postman extension in Chrome or install curl

Setup procedure

A. Configure project environment (Either A. Install Pycharm OR B. Create a Virtual Environment)

1. Install Pycharm (www.jetbrains.com/pycharm/download/)

   • Open the Teacher API Directory (File -> Open)

   • Configure the Base Project Interpreter (File -> Settings -> Project Interpreter)

     • Base Project Interpreter: pyenv version 3.6.2 ('path to .pyenv version 3.6.2'/bin/python)

       (pyenv was installed before creating the new project through 'pyenv install 3.6.3')

     Note

     In my case, when I tried to use the suggested base interpreter set by Pycharm, installing packages only appeared to be successful according to the response message, but the packages do not appear in the package list and modules imported from them do not get resolved. Thus, I resorted to the pyenv.

   • Manually install packages to project interpreter (Pycharm -> Preferences -> Project -> Project Interpreter -> plus button on the lower left side of the package table) and apply changes OR type the command below on the activated virtual environment.

     pip install -r requirements.txt
     

2. Create a Python Virtual Environment

   • Install virtualenv:

     sudo pip install virtualenv
     

   • Create virtialenv:

     virtualenv -p python3 <name of virtualenv>
     

   • Install requirements:

     pip install -r requirements.txt
     

B. Install MySQL

1. Search on the web on how to install MySQL in your OS

2. Create database through piping

   mysql -u root < <Path to file>/create_db.sql

   • NOTE: depending on your mysql config, you need to provide your password if you have one

C. Initialize and Populate Company Database

1. Edit line 14 of teacherAPI/database.py and use the correct url to your mysql

   • In my case, I'm using the root and has a password of 'password'

   'mysql://root:<password>@localhost/Teacher'

2. Either (i) run the line below or (ii) Use the python interactive shell and run the lines below

   1. $ sh database_populator.sh

   2. $python

      >>> from teacherAPI.database import init_db;
      >>> init_db();
      >>> from teacherAPI.populate import populate;
      >>> populate()

D. Run app.py

python app.py

E. Refer to TeacherAPI/controller.py on how to test the code through curl

Endpoints of the Teacher API

1. Insert a new teacher record
2. Update an existing teacher record
3. Delete teacher record
4. Get teacher record details
5. List all teacher records
6. Filter list of teachers using wildcard search

Documentation

• Checkout my Medium Article to learn how to document this repo using Sphinx.
• Swagger is also another great option to document your API's