PHPackages                             sebastian/git-state - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing & Quality](/categories/testing)
4. /
5. sebastian/git-state

ActiveLibrary[Testing & Quality](/categories/testing)

sebastian/git-state
===================

Library for describing the state of a Git checkout

1.0.0(4mo ago)154.7M↑16967.8%[1 issues](https://github.com/sebastianbergmann/git-state/issues)2BSD-3-ClausePHPPHP >=8.4CI passing

Since Mar 21Pushed 1mo agoCompare

[ Source](https://github.com/sebastianbergmann/git-state)[ Packagist](https://packagist.org/packages/sebastian/git-state)[ Docs](https://github.com/sebastianbergmann/git-state)[ GitHub Sponsors](https://github.com/sebastianbergmann)[ Fund](https://liberapay.com/sebastianbergmann)[ RSS](/packages/sebastian-git-state/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (1)Dependencies (1)Versions (6)Used By (2)

[![Latest Stable Version](https://camo.githubusercontent.com/56d9d77280aea2338669646a71ec4c5b2bb7a07bfa1137f88ad866f69cee5fbc/68747470733a2f2f706f7365722e707567782e6f72672f73656261737469616e2f6769742d73746174652f76)](https://packagist.org/packages/sebastian/git-state)[![CI Status](https://github.com/sebastianbergmann/git-state/workflows/CI/badge.svg)](https://github.com/sebastianbergmann/git-state/actions)[![codecov](https://camo.githubusercontent.com/fd0399f60bebc1d86d3cacb3f193d722deb45a16811fcd089d0bc986a6b70680/68747470733a2f2f636f6465636f762e696f2f67682f73656261737469616e626572676d616e6e2f6769742d73746174652f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/sebastianbergmann/git-state)

sebastian/git-state
===================

[](#sebastiangit-state)

Library for describing the state of a Git checkout.

Installation
------------

[](#installation)

You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):

```
composer require sebastian/git-state

```

If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:

```
composer require --dev sebastian/git-state

```

Usage
-----

[](#usage)

#### `test.php`

[](#testphp)

```
use SebastianBergmann\GitState\Builder;

$builder = new Builder;
$state   = $builder->build();

if ($state === false) {
    // Not a Git repository or no origin remote configured
    exit(1);
}

print $state->originUrl() . PHP_EOL;
print $state->branch() . PHP_EOL;
print $state->commit() . PHP_EOL;

if ($state->isClean()) {
    print 'Working directory is clean' . PHP_EOL;
} else {
    print $state->status() . PHP_EOL;
}
```

```
github.com:sebastianbergmann/git-state.git
main
ab00820c3757dbd30a8caa185aa4515b98713238
M README.md
?? test.php

```

###  Health Score

55

—

FairBetter than 97% of packages

Maintenance82

Actively maintained with recent releases

Popularity52

Moderate usage in the ecosystem

Community15

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 57.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

140d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1089?v=4)[Sebastian Probst Eide](/maintainers/sebastian)[@sebastian](https://github.com/sebastian)

---

Top Contributors

[![sebastianbergmann](https://avatars.githubusercontent.com/u/25218?v=4)](https://github.com/sebastianbergmann "sebastianbergmann (31 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (23 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sebastian-git-state/health.svg)

```
[![Health](https://phpackages.com/badges/sebastian-git-state/health.svg)](https://phpackages.com/packages/sebastian-git-state)
```

###  Alternatives

[structuraphp/structura

Architectural testing for PHP

141.6k5](/packages/structuraphp-structura)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)