goclone

KO | EN

gitlite — search

#javascript #python #golang #typescript #game #vue #nodejs #python3 #docker #facebook #workflow #yaml

★ 35 Open GitHub ↗

Clone Go projects to a clean GOPATH and start hacking right away.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# `goclone(1)`

![goclone(1) demo screencast](https://raw.githubusercontent.com/ahmetb/goclone/master/demo.gif)

**goclone** is a tool to clone Go repositories from GitHub and other sources to
a clean `$GOPATH` and start working on them right away. No more turning your
`~/go` into a hot mess.

### Examples

Clone `ahmetb/govvv` from GitHub, and start a new shell:

$ goclone ahmetb/govvv

Clone `k8s.io/kubernetes` and run `cat LICENSE` in its directory.

$ goclone k8s.io/kubernetes -- cat LICENSE

Clone `https://github.com/rakyll/gops` and set GOPATH/PWD in the current shell:

$ eval $(goclone -q https://github.com/rakyll/gops)

## Features

- Creates clean GOPATH for each project, no more dependency version conflicts!
- Supports [`hub(1)`](https://hub.github.com/) tool if present. This allows
  cloning of private repositories.
- Supports various formats for cloning repositories:
    - `ahmetb/govvv`: GitHub repo name
    - `git@github.com:user/repo.git`: GitHub SSH format (works w/ private repos)
    - `https://github.com/rakyll/hey`: GitHub URL, pasted from web browser
    - `gopkg.in/mgo.v2`: Go import path, does not have to be GitHub
- Spawns a new shell with GOPATH/PWD correctly set.
- `$GOPATH/bin` is added to your `$PATH` automatically. This makes `go install`
  easier to use.

## Installation

Download [`goclone`](./goclone) file to your `/usr/local/bin` and `chmod +x` it.

One-line install script for macOS/Linux:

```sh
sudo wget -qO/usr/local/bin/goclone \
      https://rawgit.com/ahmetb/goclone/master/goclone && \
    sudo chmod +x /usr/local/bin/goclone
```

-----

Brought to you by [@ahmetb](https://github.com/ahmetb).

goclone

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README