Metadata-Version: 2.1
Name: git-scan
Version: 0.2.1
Summary: Scan local or remote git repositories for history divergent from origin
Home-page: https://github.com/johnaparker/git-scan
Author: John Parker
Author-email: japarker@uchicago.edu
License: MIT
Description: # Git-Scan
        Git-Scan is a command-line utility to scan local or remote git repositories for history that is divergent from the remote branch.
        It is particularly useful when dealing with multiple git repositories across multiple machines where pulls and pushes are missed, stashes are forgotten about, files are left untracked, etc.
        
        ## Features
        + Scan repositories for missing push & pulls, uncommited changes, untracked files, leftover stashes, and dangling branches
        + Automatically pull or push a group of repositories
        + Open repositories in need of changes in TMUX windows
        + Execute over SSH to git-scan on a different computer
        + Configuration file to list scannable repositories
        
        ## Usage
        To run a git-scan
        ```
        git-scan [--push] [--pull] [--repo] [--tmux] [--ssh]
        ```
        where the optional arguments are
        + **``push:``**   push repository changes if ahead of remote
        + **``pull:``**   pull repository changes if behind remote and there are no merge conflicts
        + **``repo:``**   list of repositories to scan (defaults to all in the configuration file)
        + **``tmux:``**   open all repositories with problems to fix in a TMUX window
        + **``ssh:``**    run the git-scan on the provided ssh host
        
        To add a repository to the list of scannable repositories
        ```
        git-scan add /path/to/repository
        ```
        To remove a repository
        ```
        git-scan remove /path/to/repository
        ```
        To list all scannable repositories
        ```
        git-scan list [--resolve]
        ```
        
        ## Installation
        Git-Scan can be installed with pip
        ```shell
        pip install git-scan
        ```
        If installed with the ``--user`` flag, make sure to add ``~/.local/bin`` to your PATH
        
        ## Configuration File
        A configuration file located at ``~/.config/git-scan/git-scan.conf`` is created.
        This is a TOML file listing the scannable repositories:
        ```
        repositories = ["/path/to/repository_1", "/path/to/repository_2"]
        ```
        The config file can be editted manually or changed using the ``add`` and ``remove`` commands.
        Glob patterns and tilde expansions are allowed, i.e. ``"~/path/to/repos/*"``
        
        ## License
        Git-Scan is licensed under the terms of the MIT license.
        
Keywords: git scan ssh tmux repositories
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Software Development :: Version Control
Classifier: Topic :: Software Development :: Version Control :: Git
Description-Content-Type: text/markdown
