Skip to main content

A command line interface to check git repositories within a directory

Project description


A simple utility script to check git repos contained underneath a given directory, reporting if any of the repos contain changes that need to be upstreamed.


usage: check_git_repos [-h] [--include-hidden] [path]

Check the status of git repositories in a directory

positional arguments:
  path              if given, the directory to start looking from, otherwise the directory will be used

optional arguments:
  -h, --help        show this help message and exit
  --include-hidden  whether to look in hidden directories

Checked issues:

Repo level issues:

  • untracked_files the repo has files which aren't tracked
  • dirty_files the repo has dirty files which need to be committed

Branch level issues:

The reporting format is branch_issues: [branch] ([issue])

  • missing_upstream a branch exists that has no upstream
  • unpushed_changes a branch has commits that don't exist upstream


The project is built using poetry, and has a makefile for development:

  • clean: clean up build artifacts
  • develop: install the project to a virtual environment
  • format: format files using black
  • publish: publish the project to pypi (given you have credentials)

Once make develop is run, you can run the development version with poetry run check_git_repos

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

check_git_repos-1.0.0.tar.gz (2.8 kB view hashes)

Uploaded Source

Built Distribution

check_git_repos-1.0.0-py3-none-any.whl (3.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page