Skip to content

Latest commit

 

History

History
69 lines (53 loc) · 2.4 KB

README.md

File metadata and controls

69 lines (53 loc) · 2.4 KB
Raw

git-org-repolist

Command line utility to list the repositories available within an organization's (private or public) scope on Github.

Getting Started

  • Download the builds tarball/zip from the releases page.
  • Extract tarball/zip and find the relevant binary for your OS-architecture.
  • Place at a preferred location in your user path and mark executable (if necessary).
  • Generate a Github Personal Access Token with:
    • No additional oath2 scopes for Public Repos:
    • The following oath2 scopes for Private Repos:
      • repo:status
      • repo_deployment
      • public_repo
      • repo:invite
      • read:org
  • Place this token at ${HOME}/.gittoken (required).

NOTE: An improperly scoped token will return a successful return code (because the token is accepted) but will return no repository links or data.

Usage

# git-org-repolist --help
List repositories that exist within a private organization on Github.

Requires a personal access token be placed in $HOME/.gittoken
	https://github.com/settings/tokens

Required token scope:
	repo:status, repo_deployment, public_repo, repo:invite, read:org

Usage: git-org-repolist [OPTIONS] orgname
  -L	Print your Github API limits.
  -v	Display the version of this utility.

Example Output

# git-org-repolist supercool-org
-----------------------------------
         Name: supercool-repo
         Link: https://github.com/supercool-org/supercool-repo
  Clone (SSH): [email protected]:supercool-org/supercool-repo
Clone (HTTPS): https://github.com/supercool-org/supercool-repo
-----------------------------------
(...)

Hacking and Building for Multiple Platforms

Binaries are built using the following process for multiple platforms.

  • Clone this repository.
  • Change directory to repository path.
  • Use go get to build external dependencies.
  • Run build commands to compile for various platforms.
env GOOS=linux GOARCH=amd64 go build -o builds/linux-amd64/git-org-repolist
env GOOS=linux GOARCH=386 go build -o builds/linux-386/git-org-repolist
env GOOS=linux GOARCH=arm go build -o builds/linux-arm/git-org-repolist
env GOOS=linux GOARCH=arm64 go build -o builds/linux-arm64/git-org-repolist
env GOOS=windows GOARCH=amd64 go build -o builds/windows-amd64/git-org-repolist.exe
env GOOS=darwin GOARCH=amd64 go build -o builds/darwin-amd64/git-org-repolist