gh-find

README

gh-find

Walk file hierarchies across GitHub repositories.

Installation

go get github.com/pmatseykanets/gh-tools/cmd/gh-find

Usage

Usage: gh-find [flags] [owner][/repo]
  owner         Repository owner (user or organization)
  repo          Repository name

Flags:
  -help         Print this information and exit
  -branch       Repository branch name if different from the default
  -grep         The pattern to match the file contents
  -maxdepth     Descend at most n directory levels
  -mindepth     Descend at least n directory levels
  -name         The pattern to match the last component of the pathname
  -no-name      The pattern to reject the last component of the pathname
  -path         The pattern to match the pathname
  -no-path      The pattern to reject the pathname
  -repo         The pattern to match repository names
  -type         File type f - file, d - directory
  -version      Print the version and exit

Environment variables

GITHUB_TOKEN shoud be set and contain GitHub personal access token

Examples

List all files in the default branch of the golang/go repository:

gh-find golang/go

List all files in the release-branch.go1.15 branch of the golang/go repository:

gh-find -branch 'release-branch.go1.15' golang/go

List all files in all repositories in the golang GitHub organization:

gh-find golang

List all README and LICENSE files in all repositories in the golang GitHub organization but skip the ones in the vendor directories:

gh-find -name '^README$' -name '^LICENSE$' -no-path '^vendor/' -no-path '^src/vendor/' golang

List README files in the root directories of all repositories in the golang GitHub organization:

gh-find -name '^README$' -maxdepth 1 golang

List all LICENSE files repositories which name starts with go in the golang GitHub organization:

gh-find -name '^LICENSE$' -repo '^go' golang

Find all go.mod files containing golang.org/x/sync in all repositories in the golang GitHub organization:

gh-find -name '^go.mod$' -grep 'golang.org/x/sync' golang