Testovanie

Attributes::fake() nahradí manager zaznamenávajúcim fakom — vo fasáde aj v kontajneri, takže sa zaznamená vložený AttributesManager, handle vlastníka, pripravovaný writer aj každá metóda HasAttributes na modeli. Fake zápisy neblokuje: naďalej idú do testovacej databázy, takže čítanie, validácia aj história fungujú bežne, a každý zápis sa zaznamená, keď uspeje. Definície ďalej používajú skutočný register a nezaznamenávajú sa.

Vráti fake (RoundlyConsulting\Attributes\Testing\AttributesFake) na asercie:

use App\Models\Product;
use RoundlyConsulting\Attributes\Facades\Attributes;

it('records attribute writes', function () {
    $fake = Attributes::fake();
    $product = Product::factory()->create();

    $product->attachAttribute('color', 'red');                    // model method — recorded
    Attributes::for($product)->meta('color', ['hex' => '#f00']);
    Attributes::for($product)->forget('size');
    Attributes::for($product)->sync(['color' => 'red', 'rating' => 5]);
    Attributes::prune(30);

    $fake->assertSet($product, 'color', 'red');                   // with exactly this value
    $fake->assertSet($product, 'color');                          // with any value
    $fake->assertMetaSet($product, 'color', ['hex' => '#f00']);
    $fake->assertForgotten($product, 'size');
    $fake->assertSynced($product, ['rating' => 5, 'color' => 'red']); // exact set, any order
    $fake->assertPruned();

    expect($product->fresh()->getAttachedAttributeValue('rating'))->toBe(5); // writes still hit the database
    expect($fake->recorded())->toHaveCount(5);                                 // list<RecordedWrite>
});

it('writes no attributes on a read-only page', function () {
    $fake = Attributes::fake();

    $this->get('/products')->assertOk();

    $fake->assertNothingSet();
    $fake->assertNothingForgotten();
    $fake->assertNothingSynced();
    $fake->assertNothingMetaSet();
    $fake->assertNothingPruned();
    $fake->assertNothingWritten(); // covers every verb at once
});

Asercie

Asercia	Negatívna	Zaznamená
`assertSet($owner, $name, $value?)`	`assertNothingSet()`	set(), setMany() a stage()->save() (jeden záznam na atribút), attachAttribute(s)(). Hodnota sa porovná (===), len ak ju odovzdáte — aj null.
`assertForgotten($owner, $name)`	`assertNothingForgotten()`	forget() a forgetExcept() (jeden záznam na odstránený názov), detachAttribute(s)(), destroyAttributes*().
`assertSynced($owner, ?array $attributes)`	`assertNothingSynced()`	sync(), stage()->sync(), syncAttributes(). S mapou presná množina name => value, v ľubovoľnom poradí.
`assertMetaSet($owner, $name, ?array $meta)`	`assertNothingMetaSet()`	meta(), syncAttributeMeta().
`assertPruned()`	`assertNothingPruned()`	prune() a attributes:prune.
—	`assertNothingWritten()`	Akýkoľvek zápis.

$fake->recorded() vráti surový zoznam objektov RecordedWrite (verb, owner, name, value, meta, attributes, forceDelete), keď potrebujete kontrolu, ktorú asercie nepokrývajú.

Testy nad skutočnými riadkami

Keďže fake zápisy prepúšťa, tabuľky potrebujete tak či tak — balík je obyčajný Eloquent. Publikujte migrácie do aplikácie ako v časti Inštalácia a použite RefreshDatabase:

use App\Models\Product;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Attributes\DataTransferObjects\AttributeDefinitionData;
use RoundlyConsulting\Attributes\Enums\AttributeType;
use RoundlyConsulting\Attributes\Events\AttributeAttached;
use RoundlyConsulting\Attributes\Exceptions\InvalidAttributeValueException;
use RoundlyConsulting\Attributes\Facades\Attributes;

uses(RefreshDatabase::class);

it('stores a typed rating', function () {
    Event::fake([AttributeAttached::class]);

    $product = Product::factory()->create();
    $product->attachAttribute('rating', 5);

    expect($product->getAttachedAttributeValue('rating'))->toBe(5);
    Event::assertDispatched(AttributeAttached::class);
});

it('rejects an out-of-range rating', function () {
    Attributes::define(new AttributeDefinitionData('rating', AttributeType::Integer, rules: ['min:1', 'max:5']));

    Product::factory()->create()->attachAttribute('rating', 9);
})->throws(InvalidAttributeValueException::class);

it('filters products by attribute', function () {
    $white = Product::factory()->create()->attachAttribute('color', 'white');
    Product::factory()->create()->attachAttribute('color', 'black');

    expect(Product::query()->whereAttribute('color', 'white')->pluck('id')->all())
        ->toBe([$white->id]);
});

Testovacie dáta cez factory

Model Attribute má factory so stavmi integerValue(), booleanValue() a withMeta(). K vlastníkovi ju pripojíte cez morph reláciu owner:

use RoundlyConsulting\Attributes\Models\Attribute;

Attribute::factory()
    ->for($product, 'owner')
    ->integerValue(5)
    ->withMeta(['source' => 'seed'])
    ->create(['name' => 'rating']);

Attribute::factory()->for($product, 'owner')->booleanValue()->create(['name' => 'on_sale']);

Tipy

Definície z konfigurácie sa načítajú raz pri štarte — definície pre konkrétny test registrujte cez Attributes::define(), nie zmenou konfigurácie.
Register je singleton v kontajneri; v rámci testu ho vynulujete cez Attributes::forget() alebo Attributes::flush().
Prísny režim aj história sa čítajú pri každom volaní, takže config()->set('attributes.strict', true) či config()->set('attributes.history.enabled', true) v teste platí okamžite.
Šifrované definície potrebujú kľúč aplikácie — v testovacom prostredí musí byť nastavený APP_KEY.

Vlastná sada testov balíka sa spúšťa príkazom:

composer test

Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

Ďalšie spôsoby podpory vrátane kryptomien

Odoslaním daru súhlasíte s našimi podmienkami prijímania darov.

Podporte našu open-source prácu Pridajte sa k nám na Patreone

Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

Ponuka do 48 hodín Prezrieť všetky balíky