Initial Setup: Mac

Installing Go on MacOS

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@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/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. Run the follow 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 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!