https://github.com/craigiansmith/gitlist
GitList is a handy wrapper around git to recurse through a directory tree and tell you where are the Git repositories and do they have uncommitted changes or local changes that haven't yet been pushed. Perfect for the end of the day wrap up.
https://github.com/craigiansmith/gitlist
git workflow
Last synced: 2 months ago
JSON representation
GitList is a handy wrapper around git to recurse through a directory tree and tell you where are the Git repositories and do they have uncommitted changes or local changes that haven't yet been pushed. Perfect for the end of the day wrap up.
- Host: GitHub
- URL: https://github.com/craigiansmith/gitlist
- Owner: craigiansmith
- License: gpl-3.0
- Created: 2021-02-22T01:45:26.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-03-01T05:52:45.000Z (over 5 years ago)
- Last Synced: 2025-11-27T16:35:18.334Z (7 months ago)
- Topics: git, workflow
- Language: Python
- Homepage:
- Size: 43 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# GitList
_Displays the state of your local git repos_
If you've ever wanted a quick and easy overview of your git repos from the
command line - **GitList** - is for you.

## Installing
At present, clone this repo and then move _gitlist.py_ to a directory on your
PATH, and make it executable.
## Usage
`python3 -m gitlist.py [PARENT_DIRECTORY]`
If you omit the optional PARENT\_DIRECTORY `gitlist` will report on the tree
starting at the current directory. Running `gitlist` will show relative paths to
each git repository in green. If there are uncommitted changes or unpushed local
changes that are committed, then relevant messages will be displayed in yellow.
## Testing
Run the following commands:
```
git clone --recurse-submodules git@github.com:craigiansmith/gitlist.git
pipenv install --dev
pipenv shell
python -m pytest
```