A go command line tool to help you manage your go projects into a single and consistent workspace. This tool is still under development, but is currently stable enough to use (I do). Check out the releases page.
- Have you Go projects in a seperate folder, and the rest of your projects in a 'workspace' folder because Go code needs to be in a valid
$GOPATH - Like having your Go projects together in single folder, not in
$GOPATH/github.com/jsimnz/gotter - Are always battling between wanting to
git cloneyour repo orgo get - Move your code into a 'workspace' folder after
go gethas put it in an ackward$GOPATHlocation - Always updating the
remote originof your packages thatgo getdownload ashttps:// - Like trying new tools 😄
It uses the same syntax as go get so you should already be firmiliar with it. When you call gotter get it uses the go toolchain to download your package/repo into it's appropriate fully quantified name folder. Then creates a symlink between that and a defined $WORKSPACE, and finally, if possible updates the git remote origin of the package to use ssh so you can use your public key authentication.
$WORKSPACE, and $GOPATH enviroment variables must be set
Example
~
+-- Workspace/
+-- Go/
+-- bin/
+-- pkg/
+-- src/
Then set your enviroment variables as follows
$ export WORKSPACE=~/Workspace
$ export GOPATH=~/Workspace/Go
$ gotter get github.com/jsimnz/gotter
This will download your package using the go tool chain, create a symlink from your package folder in your $GOPATH and will update the remote origin URL.
Notice that it uses the same syntax as go get for the URL. The package FQN. But it also supports other git URLs such as git://URL. http(s)://URL. and even git@URL:repo.git. If you use the latter URLs and not the FQN, It will keep the remote origin URL as is.
$ gotter clone github.com/jsimnz/gotter
This will use the go tool chain to download your package, just like before, but won't create a symlink to your $WORKSPACE, and won't update the origin URL.
$ gotter link github.com/jsimnz/gotter
This will create a symlink from your $GOPATH/project to your $WORKSPACE/project
$ gotter update-remote github.com/jsimnz/gotter
This will update the local git repo's remote origin url to use SSH. This is only actually run if the origin url isn't already using SSH.
$ gotter --help OR gotter -h
You can simply
$ go get github.com/jsimnz/gotter
Both x86 & x64. Go >= Go1
- Linux (Tested)
- OSX
- Windows (Not sure, love for someone to test it)
Finish remote origin URL updateExpose remote origin as a sub command- Use config file to set
$WORKSPACEand other settings - Write bootstrap script to generate a config file, move to /etc/gotter, and install tool
The MIT License (MIT)
Copyright (c) 2014 John-Alan Simmons
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.