ImmigrantApp

A small Django application that allows the user to search through records of immigrants and insert, update, and delete records.

The main page of our application shows the list of immigrant records.

• To filter this list, select values from the drop down boxes and click 'Filter'.
• To delete or edit an entry from this list, select the corresponding option in the 'Actions' column.
• To add a new entry to the database, click the 'Create' button and select values for each field.

Prerequisites to run:

1. Install Python 3.5.2
2. Double check that pip is installed by running which pip

• If the console prints somthing starting with which: no pip in..., then install pip manually here

3. Once Pip is installed, navigate to the code directory and run pip install -r requirements.txt to install all dependencies for the project
4. Set up MySQL database

• The database can be generated by running the database.sql file in the Database directory
• Django expects the database to be hosted on localhost on port 3306, with username 'root' and password 'root'

If there are any issues with the automatic dependency install, you can install Django 1.10 and PyMySQL 0.7.9 by running pip install Django==1.10.3 and pip install PyMySQl==0.7.9

To Run:

• Navigate to the root directory and run the command python manage.py runserver
• Find the port number for the development server in the console log and type them into your internet browser
• By default, it should be accessable at http://localhost:3000/