A one day Introduction to Go class with exercises
Python Go HTML
Latest commit 07fb449 Jun 13, 2015 @autarch Label exercise 9 as maybe a bonus exercise
Move exercise 10 slide to end since I don't think a class will ever get to it in one day
Permalink
Failed to load latest commit information.
gopath/src Updated submodule Jun 11, 2015
setup Update binaries May 4, 2015
.gitignore Ignore gopath/bin/ and gopath/pkg/ Mar 14, 2015
.gitmodules
LICENSE
README.md
intro-to-go.slide
license.html
more.html remove typo in go wiki link Jun 11, 2015
outline

README.md

Installing Go

See the Installing Go page golang.org for information on installing Go. This page has instructions for installing from a pre-compiled tarball on Linux, OSX, and FreeBSD. It also has links to an OSX package installer, an MSI installer for Windows, and a few other options.

If you're on Ubuntu, Jay R Wren's Go PPA may work for installing Go 1.4 on your system. There is also a project called godeb that lets you download the latest Go source and turn it into a Debian package. See http://blog.labix.org/2013/06/15/in-flight-deb-packages-of-go for details and links to download binaries.

Fedora 21 and 22 both include Go 1.4.

Operating Systems

Go should work identically on Linux, OSX, and Windows systems.

The exercises repository uses symlinks in the answer directories to avoid having to copy some files around. However, you don't need to run or edit any code in the answer directories (they're for the instructor).

Emacs Integration

If you're using Emacs as your editor, I highly recommend installing go-mode for syntax highlighting. You can install this using ELPA. Add the http://melpa.milkbox.net/packages package repo in order to get the latest go-mode package.

I also suggest binding a key to execute gofmt on the current buffer. Here's a snippet that binds M-t:

(add-hook 'go-mode-hook
          (lambda ()
            (local-set-key "\M-t" `gofmt)))

Vim Integration

Here are some useful Vim tools for Go:

Sublime Text Integration

Check out the GoSublime plugin collection if you're using Sublime Text. It supports code completion, syntax checking as you type, quick formatting, and much more.

General Editor Recommendations

Setting up your editor to integrate with go fmt and go vet makes your Go coding experience much better. You can have it run these checks on the currently loaded file and/or run these checks every time you save your code.

You may also want to be able to run golint easily, though I don't recommend this as a default action for every save. It will often complain about issues that you will not want to fix, especially when you write code for this class's exercises.

Getting Set Up for the Class

First, you'll want to check this repo out. Then run the appropriate binary for your platform from the setup directory. If you want to specify the GOPATH for the binary to use, simply set it on the command line:

GOPATH=$HOME/go class-setup.darwin.amd64

Note that on OSX you must set the GOPATH variable before running the binary.

If you're on a platform which doesn't have a binary, all it does is the following:

  • Makes a $GOPATH root directory under $HOME/go
  • Creates $GOPATH/src/github.com/autarch and clones https://github.com/autarch/intro-to-go-class-exercises.git from that subdirectory
  • Creates $GOPATH/src/github.com/stretchr and clones https://github.com/stretchr/testify.git from that subdirectory
  • Tells you to set your $GOPATH environment variable to $HOME/go if it's not already set

Note that you can use a different directory for your $GOPATH if you prefer.

Make sure that you set the GOPATH environment variable and add $GOPATH/bin to your PATH in your preferred shell's rc file(s) such as ~/.bashrc, ~/.zshrc, etc.

Reading the Slides on Your System

Being able to browse the slides while doing the exercises will be very helpful, so I recommend getting this set up in advance.

First, you'll need to clone this repo. Then in the checkout run the following two commands:

git submodule init
git submodule update

Next you'll need the present tool. After you have your $GOPATH set up, simply run:

go get golang.org/x/tools/cmd/present

The present binary will be installed as $GOPATH/bin/present, which you should have added to your PATH.

You can run present from the checkout directory, which contains the intro-to-go.slide file. Open up the URL that present gives you and you'll see a link to open the slides.