Package: pygitstat
gitstatAboutUsage: gitstat [OPTIONS] COMMAND [ARGS]...

  Succinctly display information about git repositories.

  Gitstat looks for unstaged changes, uncommitted changes,
  untracked/unignored files, unpushed commits, and whether a pull from
  upstream is required.

  Gitstat can maintain a list of repos about which it will report. Use
  "gitstat track" to add repo(s) to its list.

  If no paths to git repos are specified on the command line, gitstat will
  show information about the repos it is tracking.

  Run "gitstat COMMAND --help" for help about a specific command.

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  check*      Check repo(s).
  fetch       Fetch from origin.
  ignore      Ignore repo(s).
  is-tracked  Show whether one or more repos are tracked by gitstat.
  pull        Pull from origin (if no local changes).
  showclone   Show "git clone" commands needed to clone missing repos.
  track       Track repo(s).
  unignore    Un-ignore repo(s).
  untrack     Untrack repo(s).Gitstat has been designed with being careful in mind.
Gitstat makes no changes to git repos, except for the 'fetch' and 'pull' commands. (gitstat fetchsimply runsgit fetch,
andgitstat pullwill pull from originonly ifthere are no local changes and a pull is required.)RequirementsPython 3.6+gitInstallationpip install --user pygitstatQuick startShow information about a repository:gitstat ~/myprojectNote that this is the same as:gitstat check ~/myproject("check" is the default command.)You use~/myprojectall the time; let's tell gitstat to remember it:gitstat track ~/myprojectNow when you run Gitstat with no parameters, it will include the status of~/myproject.Try editing/adding files in~/myproject, and/or commit (but don't push) changes, and run Gitstat again:gitstatBy default, Gitstat will only output repos with changes.  To include repos that are up-to-date:gitstat --allGitstat can fetch from origin:gitstat fetchPull from origin:gitstat pullGitstat will pull only if there are no local changes and if a pull from upstream is required.  You can rungitstat fetchto fetch first.Gitstat can do more.  To get help with individual commands:gitstat --help
gitstat check --helpColor customizationThere are two config files,repos.confwhich contains the list of all repos that Gitstat is tracking, andgitstat.confwhich is used to configure Gitstat (currently it's just for colorization).  The config files live under$XDG_CONFIG_HOME/gitstat/(usually~/.config/gitstat/).You can rungitstat configto show the locations of the files and colorization options:# gitstat.conf# Run "gitstat config" to show the "Status" list and the default colors.# For each Status, a COLOR and STYLE can be specified.# STYLES can be: bold, dim, italic, underline, flash, reverse# COLORS can be:#   - a 6-hex string  #123456#   - an RGB tuple    (255, 0, 0)#   - a name          red[colors]# UNTRACKED_COLOR = (255, 0, 0)# UNTRACKED_STYLE = bold# PULL_REQUIRED_COLOR = #00FF11# UNCOMMITTED_COLOR = cyanTips & tricksUsing with scriptsSimilar togit,gitstat --quietprints no output (except on error), and returns 1 if there are changes, else 0.Clone missing reposIf moving to a new computer, or sharing Gitstat's config between multiple computers,gitstat showclonecan be used to output a list ofgit clonecommands for any repos Gitstat is tracking, but do not exist on the filesystem.  Then you can copy and paste the output to clone any missing repos.Track every repo in your home directoryfind ~/ -type d -name .git -exec gitstat track {} \;(Gitstat is "smart" enough to know that the parent directory of a directory named.gitis the actual repository.)Are you tracking all the repos you want to track?find ~/ -type d -name .git | xargs gitstat is-tracked --quiet-if-trackedLicenseCopyright 2019-2021  John Begenisich

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.