Make sure you have docker and docker-compose installed on your computer. Then, run docker-compose run --service-ports app /bin/bash.

You'll be presented with a command line with all tools already preinstalled, connected to a test database.

Let's start by setting up the database schema by running ./setup-db. You can run ./db-connect to access the postgres db console.

Once we're done, we can install the dependencies by running dep ensure -v

Congratulations! You're now ready to start developing. Yay!

The codebase is a stripped down project with only the things you need for developing the feature at hand.

The code is structured into controllers/, models/ and serializers/ directories. Controllers handle the request, serializers are used to convert models to/from what gets transfered over the network and models deal with the database. Framework called BeeGo is used, although not much of your code will touch it.

Testing is of huge importance and lives in the unittest/ directory. The init.go file gets executed everytime the test package gets loaded and sets up BeeGo.

The recommended way of running tests is go test -v ./unittest. If you have followed all of the previous steps correctly, the test should pass. Give it a try!

If you need to run a specific test, then you can run go test -v ./test -run ^TestName$. Note that ^TestName$ is a regular expression - you can just write TestName, but in such case other tests with similar names may get executed as well.

To run the code, you can just run go run main.go and then access it at http://localhost:8080.

Now you should be ready to complete the work at hand. Please check the file TASK.md for details.