Tests
Sur cette page
SocialPublisher::fake() remplace tout appel à l'API par un faux qui consigne chaque post : vos tests vérifient ce qui aurait été publié, et où, sans réseau ni clé API.
Le faux
use QuietSocial\Sdk\Post;
use QuietSocial\Social\Facades\SocialPublisher;
it('publishes a published article to LinkedIn', function (): void {
$fake = SocialPublisher::fake();
Article::factory()->create(['is_published' => true]);
$fake->assertPublished(Article::class, fn (Post $post, array $to): bool => in_array('linkedin', $to, true));
});
Le faux sert la synchronisation automatique comme le constructeur manuel : rien ne part, chaque post est consigné.
Les assertions
| Méthode | Vérifie |
|---|---|
assertPublished(Article::class, ?Closure $check) |
Un post de cette classe a été envoyé, et l'un d'eux passe la vérification, qui reçoit le Post et ses cibles. |
assertCancelled(Article::class, ?Closure $check) |
Un post de cette classe a été annulé ; la vérification reçoit le Post tel qu'il avait été envoyé. |
assertNothingPublished() |
Aucun post n'a été envoyé. |
published() rend chaque Post envoyé, dans l'ordre. Une assertion qui échoue dit ce qui a été publié, et passe par PHPUnit quand il est installé.
Ce que fait le faux
- Les fausses publications sont programmées (ou en brouillon, ou en attente de validation, selon le post) et peuvent être annulées.
- Chaque réseau a une destination capable de publier : un modèle sans cibles explicites vise tous les réseaux qu'il déclare.
markPublished(?string $class)fait passer les fausses publications, de toutes les classes ou d'une seule, pour publiées : la prochaine modification de leur modèle lèveSocialPostOutdatedau lieu de les remplacer.
use Illuminate\Support\Facades\Event;
use QuietSocial\Social\Events\SocialPostOutdated;
Event::fake([SocialPostOutdated::class]);
$fake = SocialPublisher::fake();
$article = Article::factory()->create(['is_published' => true]);
$fake->markPublished(Article::class);
$article->update(['excerpt' => 'Corrigé après publication.']);
Event::assertDispatched(SocialPostOutdated::class);
Ne faussez que les événements du paquet : un Event::fake() sans liste fausse aussi les événements Eloquent, et plus aucun enregistrement ne déclenche la synchronisation.
La file et le cache
Avec la file sync (celle d'une suite de tests Laravel par défaut), le job tourne pendant l'enregistrement et le faux voit le post aussitôt.
Avec Queue::fake(), le job ne tourne pas du tout et rien n'atteint le faux : vérifiez plutôt que le job a été mis en file.
use Illuminate\Support\Facades\Queue;
use QuietSocial\Social\Jobs\SyncSocialPost;
Queue::fake();
Article::factory()->create(['is_published' => true]);
Queue::assertPushed(SyncSocialPost::class);
Le cache array d'une suite de tests gère les verrous : la synchronisation y tourne comme en production.