Go Game

A Go Game written in the Go Programming language.

The game starts by showing all the matches currently being played. If a user wants to create a match, they click 'New Match'

TODO

Allow new matches to be created from web
- implement POST /matches
- redirect to GET /matches/:id
New matches have black and white user equal to creator, join updates the white (second) user
match.Join(whiteUser) updates the white user
- implement PUT /matches to join the match
Make board UI for /matches/:match_id

Installation

Install PostgreSQL 9.4.x
Install Go 1.4.x, git, setup $GOPATH, and PATH=$PATH:$GOPATH/bin
Create PostgreSQL database.
```
createdb goga.me
```
Get the source code.
```
go get github.com/tlehman/goga.me
```

Run the PostgreSQL migration.

go get github.com/mattes/migrate
cd $GOPATH/src/github.com/tlehman/goga.me
migrate -url postgres://$(whoami)@$localhost:5432/goga.me?sslmode=disable -path ./migrations up

Run the server

cd $GOPATH/src/github.com/tlehman/goga.me
go run main.go

Environment Variables for Configuration

HTTP_ADDR: The host and port. Default: ":8888"
HTTP_CERT_FILE: Path to cert file. Default: ""
HTTP_KEY_FILE: Path to key file. Default: ""
HTTP_DRAIN_INTERVAL: How long application will wait to drain old requests before restarting. Default: "1s"
DSN: RDBMS database path. Default: postgres://$(whoami)@localhost:5432/goga.me?sslmode=disable
COOKIE_SECRET: Cookie secret for session. Default: Auto generated.

Running Migrations

Migration is handled by a separate project: github.com/mattes/migrate.

Here's a quick tutorial on how to use it. For more details, read the tutorial here.

# Installing the library
go get github.com/mattes/migrate

# Create a new migration file
migrate -url driver://url -path ./migrations create {filename}

# Migrate all the way up
migrate -url driver://url -path ./migrations up

# Migrate all the way down
migrate -url driver://url -path ./migrations down

# Roll back the most recently applied migration, then run it again.
migrate -url driver://url -path ./migrations redo

# Run down and then up command
migrate -url driver://url -path ./migrations reset

# Show the current migration version
migrate -url driver://url -path ./migrations version

Vendoring Dependencies

Vendoring is handled by a separate project: github.com/tools/godep.

Here's a quick tutorial on how to use it. For more details, read the readme here.

# Save all your dependencies after running go get ./...
godep save ./...

# Building with godep
godep go build

# Running tests with godep
godep go test ./...

Running in Vagrant

There are two potential gotchas you need to know when running in Vagrant:

GOPATH is not defined when you ssh into Vagrant. To fix the problem, do export GOPATH=/go immediately after ssh.
PostgreSQL is not installed inside Vagrant. You must connect to your host PostgreSQL. Here's an example on how to run your application inside vagrant while connecting to your host PostgreSQL:

GOPATH=/go DSN=postgres://$(whoami)@$(netstat -rn | grep "^0.0.0.0 " | cut -d " " -f10):5432/$PROJECT_NAME?sslmode=disable go run main.go