Coursework 1 Code Instruction

In coursework 1 you are required to perform a code-review, of a vulnerable web application

Getting the Target

The target is written in Python.
If you want to play with a running version of the code, use the Instructions below

I have tested the instructions below on both Windows and Linux

Important

For the assessment. Treat these as the Actual Install Instructions.

Unzip the source code (You must have done that to read this)
Change directory into your newly created project.

cd koala
Create a Python virtual environment.

python3 -m venv env
Activate the environment
- In Windows env/scripts/activate
- In Linux source env/bin/activate
Install the project in editable mode with its testing requirements.

python setup.py develop
Initialize and upgrade the database using Alembic.

Note

If alembic says it cant find the a directory you need to create one in koala\alembic\versions
- Generate your first revision.
  
  alembic -c development.ini revision --autogenerate -m "init"
- Upgrade to that revision.
  
  alembic -c development.ini upgrade head
Load default data into the database using a script.

initialize_koala_db development.ini
Run your project.

`pserve development.ini
Access the code

You now have an empty Koala project at (127.0.0.1:6543) You can login using the default admin credentials

I have also created a script to generate a demonstration site. You can add this by running

create_koala_demo  development.ini

This will create some example Modules, and Posts You will also get users

You shouldn't need to do any of the setup instructions after the first time Just start the site with

pserve development.ini