Without the facade

The facade is the recommended default, not the only way in. There are three equivalent entry points, and they all run the same code:

• The Git facade — the shortest form, used throughout these docs.
• The manager — RoundlyConsulting\Git\GitManager, the container singleton and the facade root. Inject it through the constructor for the same API with an explicit dependency and no static calls.
• The driver layer — the flat, path-taking methods of the Interfaces\Provider contract that every handle method delegates to. It is the contract every driver implements and the fake doubles.

Injecting the manager

use RoundlyConsulting\Git\GitManager;

final class ShipRelease
{
    public function __construct(private GitManager $git) {}

    public function __invoke(string $repository, int $number): string
    {
        return $this->git->github()->repo($repository)->pullRequest($number)->merge();
    }
}

Git::fake() swaps the injected instance too — GitFake extends GitManager, so a class that type-hints the manager receives the recording fake in tests rather than a TypeError.

No action classes

Git is a remote-API client, so there are no action classes: the drivers are the use cases. The handles are thin — every handle method is the matching flat method on the driver with the path filled in — so you can also call that layer directly:

use RoundlyConsulting\Git\Enums\MergeMethod;
use RoundlyConsulting\Git\GitManager;

$github = app(GitManager::class)->github();

$github->mergePullRequest('acme/app', 12, MergeMethod::Squash); // same call as ->repo()->pullRequest(12)->merge()
$github->contents('acme/app', 'README.md', ref: 'main');        // same call as ->repo()->contents()
$github->listInstallations();                                   // same call as ->installations()->all()

Handle method → driver method

The flat driver methods run the same scope checks as the handles, so they refuse the same out-of-scope paths. The fake records every call under the driver method it reached, whichever layer you called.