Testovanie

Git::fake() nahradí manažér zaznamenávajúcim GitFake — pre fasádu aj pre všetko, čo si injektovalo GitManager — a vráti ho. Každý driver, ktorý vydá, je ProviderFake, ktorý naplníte dátami, žiadne HTTP neopustí proces (Http::preventStrayRequests()) a zaznamená sa každé volanie, či už prešlo plochými metódami drivera, handlom repo() / pullRequest() / installations(), cez webhooks() alebo batch(). Naplňte, čo váš kód číta, spustite ho a overte:

use Illuminate\Support\Carbon;
use RoundlyConsulting\Git\Dto\Owner;
use RoundlyConsulting\Git\Dto\Repository;
use RoundlyConsulting\Git\Enums\ProviderName;
use RoundlyConsulting\Git\Facades\Git;

it('lists the connected repositories', function () {
    $fake = Git::fake();

    $fake->github()->seedRepositories([new Repository(
        provider: ProviderName::Github,
        id: '1',
        path: 'acme/api',
        name: 'api',
        description: null,
        defaultBranch: 'main',
        owner: new Owner(id: '1', name: 'acme', avatar: null),
        createdAt: Carbon::now(),
        lastActivityAt: Carbon::now(),
    )]);

    // run code that calls Git::github()->repositories() ...

    Git::assertSent(ProviderName::Github, 'repositories');
    Git::assertNotSent(ProviderName::Github, 'createRepository');
});

Prihlasovacie údaje vo fake

Fake sa prihlasuje presne tak ako skutočný manažér — len s prihlasovacími údajmi nikdy nič nepodpisuje ani neposiela. Každé volanie Git::github() / githubApp() / gitlab() / bitbucket() / provider() dostane vlastný fake driver, ktorý zdieľa seedy a záznamy providera, s odovzdanými údajmi, inak s nastavenými, inak bez nich:

• Zápis — aj listWebhooks() — bez prihlasovacích údajov vyhodí InvalidCredentialsException::missing(); čítania zostávajú anonymné a isAuthenticated() tomu zodpovedá.
• Typ údajov, ktorý platforma neprijíma, sa odmietne (unsupported() — napríklad OauthToken na Bitbuckete) a authenticationMethods() vracia zoznam skutočného drivera.
• installations() vyžaduje GithubApp a installationRepositories() GithubAppToken (wrongCredentialType()); Git::githubApp() bez nastavenej aplikácie vyhodí missingAppConfig().
• Dáta plňte cez fakeFor(ProviderName::…), ktorý prihlasovacie údaje nepotrebuje.

Testy hostiteľskej aplikácie preto nastavia fiktívne prihlasovacie údaje — akékoľvek hodnoty, nič sa nepodpisuje — alebo ich odovzdajú pri každom volaní (Git::github(Token::from('test'))):

config([
    'git.providers.github.token' => 'test-token',            // writes on Git::github()
    'git.providers.github.app.id' => '123',                   // Git::githubApp(): numeric id
    'git.providers.github.app.private_key' => 'test-key',     // … and any non-blank key
    // 'git.providers.github.app.installation_id' => '456',   // Git::github() as the installation
]);

Asercie

Každá asercia pomenúva metódu drivera, na ktorú volanie dorazilo — handly volajú ploché metódy, takže ->pullRequest(12)->merge() sa zaznamená ako mergePullRequest — a callback v assertSent() / assertNotSent() dostane argumenty tejto metódy pozične. Po Git::fake() fungujú všetky staticky na fasáde aj na vrátenom fake:

// run code that calls Git::github()->repo('acme/app')->pullRequest(12)->merge() ...

Git::assertSent(ProviderName::Github, 'mergePullRequest');
Git::assertSent(ProviderName::Github, 'mergePullRequest', fn (string $path, int $number) => $number === 12);
Git::assertSentTimes(ProviderName::Github, 'approvePullRequest', 1);
Git::assertNotSent(ProviderName::Github, 'closePullRequest');
Git::assertNotSent(ProviderName::Github, 'mergePullRequest', fn (string $path) => $path === 'acme/billing');
Git::assertNothingSent(ProviderName::Gitlab);   // nothing reached GitLab
Git::assertNothingSent();                       // nothing reached any provider
Git::assertBatched(ProviderName::Github, 'languages');
Git::assertNotBatched(ProviderName::Github, 'repositories');
Git::assertRepositoryCreated('new-repo');
Git::assertRepositoryCreated('new-repo', owner: 'acme', template: 'acme/package-template');
Git::assertNoRepositoryCreated();

Zaznamenané volania

$calls = Git::recorded(ProviderName::Github, 'mergePullRequest'); // list<RecordedCall>

$calls[0]->method;     // "mergePullRequest"
$calls[0]->arguments;  // ['acme/app', 12, MergeMethod::Merge, null, null, null]

Git::recorded(ProviderName::Github);                  // every GitHub call, oldest first
Git::fakeFor(ProviderName::Gitlab)->seedRepositories([$repositoryDto]);

Injektované manažéry

Keďže GitFake dedí z GitManager, fake dostane aj trieda, ktorá si manažér injektuje cez konštruktor — nič netreba prebindovať:

use RoundlyConsulting\Git\Facades\Git;

it('merges the release pull request', function () {
    config(['git.providers.github.token' => 'test-token']); // the fake authenticates like production

    Git::fake()->github()->seedMergeCommit('abc123');

    $sha = app(ShipRelease::class)('acme/app', 12);   // constructor-injects GitManager

    expect($sha)->toBe('abc123');
    Git::assertSent(ProviderName::Github, 'mergePullRequest', fn (string $path, int $number) => $number === 12);
});

Správanie bez seedu

Dvojník pokrýva celý kontrakt Provider — každé čítanie, zápis, vyhľadanie inštalácie aj dopyt na commity — takže hostiteľská aplikácia pri raste nikdy nenarazí na nedefinovanú metódu. Jeho správanie určujú tri pravidlá:

Každý fake driver podporuje presne to, čo jeho skutočný driver: supports(), capabilities() aj featureMatrix() odpovedajú rovnako a operácia, ktorú platforma nemá, vyhodí rovnakú FeatureNotSupportedException ešte pred zaznamenaním — fake Bitbucket odmietne ->pullRequest(1)->merge() rovnako ako Bitbucket, takže test nemôže prejsť pri toku, ktorý by produkcia odmietla. Vo fake bežia aj vlastné kontroly vstupu drivera — filtre commitov podľa autora či dátumu na Bitbuckete, komentár na GitLabe bez cieľa, komentár k issue na Bitbuckete, createRepository() na Bitbuckete s autoInit alebo defaultBranch, nečíselný owner na GitLabe, neaktívny webhook na GitLabe či webhook s neznámou udalosťou — a rovnako pravidlo veľkosti stránky, chybný odkaz pre batch()->pullRequest() aj porovnanie udalostí v register().

Seedery

Všetky sú reťaziteľné: seedRepositories, seedRepository, seedCreatedRepository, seedCommits, seedCommit, seedBranches, seedPullRequests, seedPullRequest, seedIssues, seedIssue, seedTags, seedReleases, seedRelease, seedContents, seedComparison, seedContributors, seedLanguages, seedSearchResults, seedComment, seedMergeCommit, seedApprovalState, seedSubmittedReview, seedPullRequestReviews, seedUser, seedInstallation, seedInstallations, seedWebhooks, seedCreatedWebhook, seedBatch, seedBranch, seedActivity, seedWorkflowRuns, seedWorkflowRun, seedWorkflowJobs, seedDispatchWithoutRunDetails.

use RoundlyConsulting\Git\Batch\BatchResult;

$fake->github()
    ->seedPullRequest($pullRequestDto)
    ->seedMergeCommit('abc123');

// ->pullRequest(n)->close() returns the seeded PR with state Closed; ->merge() returns 'abc123'

$fake->fakeFor(ProviderName::Gitlab)->seedRepositories([$repositoryDto]);

$fake->github()->seedBatch('languages', new BatchResult(['acme/api' => ['PHP' => 100]], []));

• review() nepotrebuje seed: vráti stav, ktorý udalosť skutočne znamená (Comment → COMMENTED, nikdy APPROVED), takže test overujúci verdikt nemôže prejsť proti fake, ak by proti GitHubu zlyhal; seedSubmittedReview() ho prepíše, keď test potrebuje konkrétne id alebo URL.
• seedPullRequestReviews($reviews, $comments) plní obe polovice zvlášť, pretože skutočné volanie ich číta z dvoch endpointov.
• createRepository() zostaví vrátené Repository zo vstupu — owner určí cestu a Owner; defaultBranch, prípadne main, ak autoInit alebo šablóna žiadali commit, inak prázdna hodnota, určí predvolenú vetvu — pokiaľ nie je nastavený seedCreatedRepository().
• Zámerné náhrady: installationRepositories() číta rovnaké dáta ako repositories(), installations()->all() použije jedinú naplnenú inštaláciu, searchRepositories() siahne po naplnených repozitároch, pullRequest() / issue() / release() vezmú prvú položku svojho zoznamu a pull request bez seedu sa vráti s číslom, na ktoré ste sa pýtali.
• Fiktívna URL na klonovanie nesie používateľské meno, ktoré používa skutočný driver — token (pri inštalačnom tokene x-access-token) na GitHube, oauth2 na GitLabe, vaše na Bitbuckete — a pri obnoviteľných údajoch zástupné tajomstvo; prázdne tajomstvo si ponechá dvojbodku, rovnako ako pri skutočných driveroch.

GitHub Actions vo fake

Fake zvládne celý tok spustenie → nájdenie → sledovanie → zrušenie. Na rozdiel od commits(), ktorého filtre sa len zaznamenajú, sa filtre runov a pokusy jobov naozaj uplatnia — ignorovaný filter by vrátil run iného workflowu:

use RoundlyConsulting\Git\Enums\ProviderName;
use RoundlyConsulting\Git\Facades\Git;

config(['git.providers.github.token' => 'test-token']);   // dispatch and cancel need a credential

$fake = Git::fake();
$actions = Git::github()->repo('acme/app')->actions();

$dispatched = $actions->dispatch('deploy.yml', 'refs/heads/main', ['request_id' => 'r-1']);
$run = $actions->runs('deploy.yml')->event('workflow_dispatch')->branch('main')->first(); // the queued run

$fake->fakeFor(ProviderName::Github)->seedWorkflowRun($completed);   // the next poll's state
$actions->cancel($dispatched->runId);                                 // false — already completed

$fake->assertWorkflowDispatched('deploy.yml', 'refs/heads/main', ['request_id' => 'r-1'], 'acme/app');

• dispatch() vyžaduje prihlasovacie údaje a vytvorí run vo fronte, ktorý hlási: ďalšie číselné id (na prázdnom fake 1), udalosť workflow_dispatch, headBranch z refu a headSha zo seedBranch(), inak fake-sha. Po seedDispatchWithoutRunDetails() odpovie bez runId ako GitHub Enterprise Server — run vznikne v oboch prípadoch, takže sa dá otestovať aj náhradné hľadanie.
• runs() vráti naplnené runy od najnovšieho, stránkované s total, a rešpektuje workflow aj každý filter. run($id) vráti naplnený run, inak RuntimeException s názvom seedWorkflowRun(); seedWorkflowRun() run podľa id vloží alebo prepíše, takže ním pripravíte stav pre ďalšie sledovanie.
• jobs() vráti seedWorkflowJobs($runId, …) — predvolene posledný pokus, po allAttempts() všetky, po attempt($n) jeden.
• cancel() vyžaduje prihlasovacie údaje a vráti false, keď je naplnený run dokončený, inak true. Seedy zostanú bez zmeny: GitHub ruší asynchrónne, takže ďalší stav si test pripraví sám.
• activity() stránkuje seedActivity() v poradí naplnenia, filtrované podľa refu; kurzor, ktorý fake nikdy nevydal, vyhodí InvalidArgumentException. compare() bez seedu vráti Identical bez commitov.
• Fake GitLab alebo Bitbucket odmietne každé volanie Actions aj activity(), rovnako ako produkcia.

Toky GitHub App

S nastavenými fiktívnymi kľúčmi aplikácie sa Git::githubApp() prihlási ako aplikácia a Git::github() ako inštalácia, takže celý tok inštalácie a overenia prebehne bez HTTP:

config([
    'git.providers.github.app.id' => '123',
    'git.providers.github.app.private_key' => 'test-key',
    'git.providers.github.app.installation_id' => '456',
]);

$fake = Git::fake();
$fake->fakeFor(ProviderName::Github)->seedInstallation($installation)->seedRepositories([$repositoryDto]);

Git::githubApp()->installations()->forOrganization('acme-inc');
Git::github()->installationRepositories();

Git::assertSent(ProviderName::Github, 'organizationInstallation');

installUrl() vyžaduje app.slug rovnako ako skutočný driver — bez neho vyhodí missingAppConfig() — a slug zakóduje rovnakým spôsobom.