Renamed and changed the example to use the standard testing package, defined as the "statemachine_test" package, which makes it compatible with 'go get' and 'go test'.
Also updated the README with information about how to set $GOPATH correctly.