Ir al contenido
Quiet Social

Pruebas

Esta documentación está traducida del francés. Si ambas versiones difieren, prevalece la versión francesa.

SocialPublisher::fake() sustituye cualquier llamada a la API por un doble que registra cada post: tus pruebas comprueban lo que se habría publicado, y dónde, sin red ni clave API.

El doble

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));
});

El doble sirve tanto a la sincronización automática como al constructor manual: no sale nada, y cada post queda registrado.

Las aserciones

Método Comprueba
assertPublished(Article::class, ?Closure $check) Se ha enviado un post de esta clase, y uno de ellos pasa la comprobación, que recibe el Post y sus destinos.
assertCancelled(Article::class, ?Closure $check) Se ha cancelado un post de esta clase; la comprobación recibe el Post tal como se había enviado.
assertNothingPublished() No se ha enviado ningún post.

published() devuelve cada Post enviado, en orden. Una aserción que falla dice lo que se ha publicado, y pasa por PHPUnit cuando está instalado.

Lo que hace el doble

  • Las publicaciones falsas quedan programadas (o en borrador, o pendientes de validación, según el post) y pueden cancelarse.
  • Cada red tiene un destino capaz de publicar: un modelo sin destinos explícitos apunta a todas las redes que declara.
  • markPublished(?string $class) hace pasar las publicaciones falsas, de todas las clases o de una sola, por publicadas: la siguiente modificación de su modelo emite SocialPostOutdated en lugar de sustituirlas.
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' => 'Corregido tras la publicación.']);

Event::assertDispatched(SocialPostOutdated::class);

Falsea solo los eventos del paquete: un Event::fake() sin lista también falsea los eventos de Eloquent, y entonces ningún guardado dispara la sincronización.

La cola y la caché

Con la cola sync (la de una suite de pruebas de Laravel por defecto), el job se ejecuta durante el guardado y el doble ve el post enseguida.

Con Queue::fake(), el job no se ejecuta en absoluto y nada llega al doble: comprueba más bien que el job se ha puesto en cola.

use Illuminate\Support\Facades\Queue;
use QuietSocial\Social\Jobs\SyncSocialPost;

Queue::fake();

Article::factory()->create(['is_published' => true]);

Queue::assertPushed(SyncSocialPost::class);

La caché array de una suite de pruebas admite bloqueos: la sincronización se ejecuta en ella como en producción.