# Dane testowe z build-test-data

Strona opisuje, jak tworzyć obiekty domenowe w testach integracyjnych `apollo-backend` za pomocą pluginu build-test-data. Jest dla programistów, którzy piszą specyfikacje w `src/integration-test`. Uruchamianie testów i infrastrukturę opisuje strona [Testy integracyjne z Testcontainers](<https://docs.logintegra.com/apollo-backend/testy-integracyjne-testcontainers/index.md>).

## Zasada działania

Plugin `io.github.longwa:build-test-data` w wersji `5.0.0` dodaje do każdej encji domenowej metodę `build()`. Metoda wypełnia wszystkie wymagane pola, czyli `nullable: false`, i buduje wymagane powiązania. Na końcu zapisuje obiekt w bazie. Nowe pole wymagane w encji zwykle nie wymaga zmiany w testach.

Plugin buduje tylko właściwości wymagane. Opcjonalne powiązania zostają puste, dopóki test ich nie poda.

## Podstawowe użycie

```
Company.build()                          // wszystkie wartości domyślne, encja zapisana
Company.build(name: 'ACME')              // nadpisanie jednego pola
Checkpoint.build()                       // buduje też Transport, Task, Workflow i Person
Task.build(workflow: workflow)           // przekazane powiązanie jest używane ponownie
Company.build(save: false)               // poprawna, ale niezapisana encja
Company.findOrBuild()                    // istniejąca encja albo nowa
build(Company, [name: 'ACME'])           // metoda traitu TestDataBuilder
```

Specyfikacja dziedziczy po `IntegrationSpec`, który implementuje trait `TestDataBuilder`. Trait dostarcza metodę `build(Class, props)` i sprząta cache między testami.

Gotowe przykłady zawiera `src/integration-test/groovy/logintegra/BuildTestDataSampleSpec.groovy`.

## Gdzie trzymać wartości

| Miejsce | Co tam trafia |
| --- | --- |
| Test | Tylko wartości istotne dla asercji, na przykład `Checkpoint.build(expectedDate: yesterday)`. |
| `src/integration-test/resources/TestDataConfig.groovy` | Reguły obowiązujące wszędzie: pola `unique`, wartości o określonym formacie, reguły sprawdzane w kodzie zamiast w constraintach. |
| Metoda pomocnicza w `support/` | Powtarzalne scenariusze z wieloma encjami, na przykład transport na checkpoincie załadunku z potwierdzonym awizo. |

Wpis w `TestDataConfig.groovy` dodajemy dopiero wtedy, gdy `build()` zgłasza błąd walidacji. Wartość podana jako domknięcie liczy się przy każdym wywołaniu `build()`.

```
testDataConfig {
    sampleData {
        'logintegra.user.Person' {
            username = { -> "user-${System.nanoTime()}".toString() }
        }
    }
}
```

Plik leży w `src/integration-test/resources`, więc nie trafia do artefaktu produkcyjnego. Nie umieszczamy go w `grails-app/conf`.

## Konfiguracja dla jednego testu

Metoda `doWithTestDataConfig()` zwraca domknięcie z konfiguracją, która scala się z globalną na poziomie encji. Po teście trzeba przywrócić konfigurację globalną.
