particle-academy / fancy-git

v0.4.0 2026-11-03 15:49 UTC

Requires

• php: ^8.4
• symfony/process: ^7.2|^8.0

Requires (Dev)

• phpunit/phpunit: ^11.0|^12.0

MIT

Published on Packagist.org on 2026-11-03 15:56 UTC

README

Framework-agnostic local Git operations and normalized provider contracts.

use FancyGit\GitRepository;

$repository = new GitRepository(getcwd());
$status = $repository->status();

The core runs the git it finds on an absolute PATH entry, once per process. The current directory and the repository are never searched, and a batch-file git is not run: if nothing else is on PATH you get a GitException with code NotFound. It uses Symfony Process on POSIX and starts the program directly with proc_open on Windows, so no cmd.exe is involved. To use a particular git, give GitRepository your own ProcessRunner, or call SymfonyProcessRunner::run() with an absolute path. GitHub, GitLab, and Bitbucket clients live in separate adapter packages.