Initial Setup: Windows

Go

If you haven't already, please follow the SRCT initial setup instructions for Windows to install the prerequisite software.

Open Git Bash and navigate to your SRCT projects directory.

1. Install Python

Install the latest Python3 from Chocolatey:

choco install python

Ensure python installed correctly by restarting Git Bash and running python --version.

Next, install Virtualenv using pip, the Python package manager. Virtualenv lets us install dependencies for each project individually, instead of installing them system wide.

pip install virtualenv

2. Clone Go

In your SRCT projects directory, run the following command to clone the Go codebase to your machine

git clone git@github.com:srct/go.git

Run cd go to enter into the project directory.

3. Install dependencies

In the go project directory, create a virtualenv by running the command virtualenv .venv. Next, activate it by running source .venv/scripts/activate. Always make sure to activate the virtualenv before starting work on Go. Deactivate at any time by running the deactivate command.

With the virtualenv activated, run pip install -r requirements.txt to install the Python dependencies.

5. Setup database

Open cmd.exe as an administrator and login to MySQL by running mysql -u root -p, then entering root as the password and hitting enter. Run the following commands:

CREATE DATABASE go;
CREATE USER 'go'@'localhost' IDENTIFIED BY 'go';
GRANT ALL PRIVILEGES ON go.* TO 'go'@'localhost';
FLUSH PRIVILEGES;

This will create the Go database and a corresponding user which is then granted the appropriate privileges.

Exit cmd.exe, go back to Git Bash, and run the following commands:

python go/manage.py makemigrations
python go/manage.py migrate

This will run the database migrations, which setup the MySQL database to the proper state.

6. Run Go!

Finally, run this to start the Go development server:

python go/manage.py runserver

Navigate in your web browser to http://127.0.0.1:8000 to see Go in action!