gostatus

README

gostatus

gostatus is a command line tool that shows the status of Go repositories.

Installation

go get -u github.com/shurcooL/gostatus

Usage

Usage: gostatus [flags] [packages]
       [newline separated packages] | gostatus -stdin [flags]
  -c  Compact output with inline notation.
  -debug
      Cause the repository data to be printed in verbose debug format.
  -f  Force not to verify that each package has been checked out from the source control repository implied by its import path. This can be useful if the source is a local fork of the original.
  -stdin
      Read the list of newline separated Go packages from stdin.
  -v  Verbose mode. Show all Go packages, not just ones with notable status.

Examples:
  # Show status of all packages.
  gostatus all

  # Show status of package in current directory.
  gostatus

  # Show status of all dependencies (recursive) of package in current dir.
  go list -f '{{join .Deps "\n"}}' . | gostatus -stdin -v

Legend:
  ? - Not under (recognized) version control
  b - Non-default branch checked out
  * - Uncommited changes in working dir
  + - Update available
  - - Local revision is ahead of remote
  ! - No remote
  # - Remote path doesn't match import path
  $ - Stash exists

Examples

# Show status of all packages.
$ gostatus all

# Show status of package in current directory.
$ gostatus

# Show status of specified package.
$ gostatus import/path

# Show status of all dependencies (recursive) of package in current dir.
$ go list -f '{{join .Deps "\n"}}' . | gostatus -stdin -v

# Show status of all dependencies (recursive) of specified package.
$ go list -f '{{join .Deps "\n"}}' import/path | gostatus -stdin -v

Sample Output

$ gostatus all
github.com/dchest/uniuri/...
	+ Update available
github.com/syndtr/goleveldb/...
	+ Update available
github.com/shurcooL/go-goon/...
	b Non-default branch checked out
github.com/shurcooL/Conception-go/...
	* Uncommited changes in working dir
github.com/russross/blackfriday/...
	# Remote path doesn't match import path
github.com/microcosm-cc/bluemonday/...
	$ Stash exists

There are a few observations that can be made from that sample output.

• uniuri and goleveldb repos are out of date, I should update them via go get -u.
• go-goon repo has a non-default branch checked out, I should be aware of that.
• Conception-go repo has uncommited changes. I should remember to commit or discard the changes.
• blackfriday repo has a remote that doesn't match its import path. It's likely my fork in place of the original repo for temporary development purposes.
• bluemonday repo has a stash. Perhaps I have some unfinished and uncommited work that I should take care of.
• All other repos are up to date and looking good (they're not displayed unless -v is used).

License

• MIT License

Documentation

Overview

gostatus is a command line tool that shows the status of Go repositories.