Metadata-Version: 2.1
Name: is-git-repo-clean
Version: 0.1.2
Summary: A simple function to test whether your git repo is clean
Home-page: https://github.com/olsonpm/py_is-git-repo-clean
Author: phil
Author-email: philip.olson@pm.me
License: WTFNMFPL-1.0
Description: ## Is Git Repo Clean
        
        *Note: This document is best viewed [on github](github.com/olsonpm/py_simple-chalk).
        Pypi's markdown headers are all caps which presents innacurate information*
        
        <!-- START doctoc generated TOC please keep comment here to allow auto update -->
        <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
        **Table of Contents**
        
        - [Intro](#intro)
            - [What is it?](#what-is-it)
            - [Why create it?](#why-create-it)
        - [Install](#install)
        - [Usage](#usage)
            - [programmatic](#programmatic)
            - [cli](#cli)
        - [Api](#api)
            - [`check` async (dir=os.getcwd()) => bool](#check-async-dirosgetcwd--bool)
            - [`checkSync` (dir=os.getcwd()) => bool](#checksync-dirosgetcwd--bool)
            - [NotAGitRepoException](#notagitrepoexception)
        - [Test](#test)
        
        <!-- END doctoc generated TOC please keep comment here to allow auto update -->
        
        
        ### Intro
        
        ##### What is it?
        
        A simple function that tests whether your git repo is clean.
        
        by *clean* I mean it has:
        - no untracked files
        - no staged changes
        - no unstaged changes
        
        Installing this also exposes a cli command `is-git-repo-clean`
        
        
        ##### Why create it?
        
        I wanted to write a build script that would exit early if the git repo
        wasn't clean
        
        
        ### Install
        
        ```sh
        $ pip install is_git_repo_clean
        ```
        
        
        ### Usage
        
        ##### programmatic
        
        ```python
        import is_git_repo_clean
        
        
        async def isCleanAsync(pathToGitRepo = None):
          # async by default
           return await is_git_repo_clean.check(pathToGitRepo)
        
        
        def isCleanSync(pathToGitRepo = None):
          # sync available
          return is_git_repo_clean.checkSync(pathToGitRepo)
        ```
        
        ##### cli
        
        ```sh
        $ is-git-repo-clean --help
        
        Usage
        is-git-repo-clean [--dir <path>] [--silent]
        is-git-repo-clean --help
        
        Options
          dir:      path to the git repo to test.  Defaults to `os.getcwd()`
          silent:   disables output
          help:     print this
        ```
        
        
        ### Api
        
        `is_git_repo_clean` exports the following
        
        ##### `check` async (dir=os.getcwd()) => bool
         - an asynchronous function that returns whether the git repo is clean
         - if the directory is not a git repo, then
           [NotAGitRepoException](#NotAGitRepoException) is thrown
        
        ##### `checkSync` (dir=os.getcwd()) => bool
         - a synchronous function that returns whether the git repo is clean
         - if the directory is not a git repo, then
           [NotAGitRepoException](#NotAGitRepoException) is thrown
        
        ##### NotAGitRepoException
         - A class which inherits Exception which you can handle separately
        
        
        ### Test
        
        ```sh
        hub clone olsonpm/py_is-git-repo-clean
        cd py_is-git-repo-clean
        python runTests.py
        ```
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
