Go

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

Open Git Bash and navigate to your SRCT projects directory.

1. Install Python

Install the latest Python3 from Homebrew:

brew install python

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

pip3 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@git.gmu.edu: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/bin/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 pip3 install -r requirements.txt to install the Python dependencies.

5. Setup database

Login to MySQL by running mysql -u root -p, then entering root as the password and hitting enter. Create the Go database with the command CREATE DATABASE go;

Exit MySQL, then run the following commands:

python3 go/manage.py makemigrations python3 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:

python3 go/manage.py runserver

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