Metadata-Version: 2.1
Name: git-inquisitor
Version: 2024.7.26
Summary: Git Inquizitor is an analysis and reporting tool for git repositories.
License: MIT
Author: JP White
Author-email: jpwhite3@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: GitPython (>=3.1.43,<4.0.0)
Requires-Dist: Jinja2 (>=3.1.3,<4.0.0)
Requires-Dist: click (>=8.1.7,<9.0.0)
Requires-Dist: jinja2-humanize-extension (>=0.4.0,<0.5.0)
Requires-Dist: matplotlib (>=3.8.2,<4.0.0)
Requires-Dist: pytz (>=2024.1,<2025.0)
Requires-Dist: toml (>=0.10.2,<0.11.0)
Requires-Dist: tqdm (>=4.66.1,<5.0.0)
Description-Content-Type: text/markdown

# Git Inquisitor

## Description

A git repository analysis tool designed to provide teams with useful information about a repository and its contributors. It provides history details from the HEAD of the provided repository, file level contribution statistics (enhanced blame), and contributor level statistics similar to what is provided by GitHub.

## Table of Contents

- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)

## Installation

**Mac and Linux:**

It is recommended to use [pipx](https://github.com/pypa/pipx) for installation. This will put the tool on your path so it can be used from anywhere.

```
pipx install git-inquisitor
```

### Manual Install (Mac/Linux)

It is highly recommended you install this within a virtual environment (venv). The instructions below assume you already have created and activated a venv, and are installing the package within.

```
python3 -m pip install git-inquisitor
```

## Usage

```
❯ git-inquisitor --help
Usage: git-inquisitor [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  collect
  report
```

**Collecting repository information:**

```
❯ git-inquisitor collect --help
Usage: git-inquisitor collect [OPTIONS] REPO_PATH

Options:
  --help  Show this message and exit.
```

**Produce report against collected information:**

```
❯ git-inquisitor report --help
Usage: git-inquisitor report [OPTIONS] REPO_PATH {html|json}

Options:
  -o, --output-file-path TEXT  Output file path
  --help                       Show this message and exit.
```

