Skip to main content

Git-Pandas

![license](https://img.shields.io/pypi/l/Django.svg) [![Coverage Status](https://coveralls.io/repos/wdm0006/git-pandas/badge.svg?branch=master&service=github)](https://coveralls.io/github/wdm0006/git-pandas?branch=master) ![travis status](https://travis-ci.org/wdm0006/git-pandas.svg?branch=master) [![PyPI version](https://badge.fury.io/py/git-pandas.svg)](https://badge.fury.io/py/git-pandas) ![downloads](https://img.shields.io/pypi/dm/git-pandas.svg)

![Cumulative Blame](https://raw.githubusercontent.com/wdm0006/git-pandas/master/examples/img/githubblame.png)

A simple set of wrappers around gitpython for creating pandas dataframes out of git data. The project is centered around two primary objects:

  • Repository

  • ProjectDirectory

A Repository object contains a single git repo, and is used to interact with it. A ProjectDirectory references a directory in your filesystem which may have in it multiple git repositories. The subdirectories are all walked to find any child repos, and any analysis is aggregated up from all of those into a single output (pandas dataframe).

This is a pre-v1.0.0 project (just barely), so the interfaces and functionality may change.

Current functionality includes:

  • Commit history with extension and directory filtering

  • Edited files history with extension and directory filtering

  • Blame with extension and directory filtering

  • Branches

  • Tags

  • ProjectDirectory-level general information table

  • Approximate bus factor

  • Cumulative Blame as a time series

  • Github.com profile analysis via GitHubProfile object

  • Plotting helpers in utilities module

  • Punchcard dataframe and plotting utility

  • Filewise blame

  • File owner approximation

Please see examples for more detailed usage. The image above is generated using the repository object’s cumulative blame function on stravalib.

Installation

Git-pandas supports python 2.7+ and 3.3+. To install use:

pip install git-pandas

Documentation

Docs can be found here: [http://wdm0006.github.io/git-pandas/](http://wdm0006.github.io/git-pandas/)

Contributing

We are looking for contributors, so if you are interested, please review our contributor guidelines in CONTRIBUTING.md, which includes some proposed starter issues, or if you have an idea of your own, send us a pull request.

License

This is BSD licensed (see LICENSE.md)

Metadata

Release files for git-pandas 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for git-pandas 1.0.1
File Size Uploaded Provenance
git-pandas-1.0.1.tar.gz 18.3 kB Without provenance Details

Release files / git-pandas-1.0.1.tar.gz

Download URL git-pandas-1.0.1.tar.gz
Size 18.3 kB
Tags Source
SHA-256 checksum
How to use checksums
707c38d23452e600881d0460d8098e35a46be6b88e84db10e876979f19ffcc7f
BLAKE2b-256 checksum
How to use checksums
5045342af7aabbac654df9798bce0d7aaa3e4808654aec56ce68483305aa779b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for git-pandas 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page