Question 1

How do I seed a database with test data using Gnomock?

Accepted Answer

Use preset options like WithQueriesFile for SQL databases or similar methods for other services; for example, in Postgres, you can load a schema SQL file directly during container setup, as shown in the getting started example.

Question 2

Gnomock vs testcontainers-go: which is better for Go projects?

Accepted Answer

Gnomock is better for teams wanting batteries-included presets and simpler APIs, while testcontainers-go offers more flexibility and customization. Gnomock's preset ecosystem reduces boilerplate, but testcontainers-go might be preferable for complex, custom container setups.

Question 3

Can I use Gnomock in a CI/CD pipeline like GitHub Actions?

Accepted Answer

Yes, but you need to ensure Docker is available in the CI environment. The README notes that images download quickly in CI, but you might need to pre-pull images or manage timeouts to avoid issues with parallel execution.

Question 4

Does Gnomock support custom Docker images not in the official presets?

Accepted Answer

In Go, you can use StartCustom for custom images, but the HTTP API only supports official presets. This limits flexibility for non-Go users who need to test with proprietary or unsupported services.

Question 5

How to handle timeouts when containers take too long to start?

Accepted Answer

Adjust timeouts using WithTimeout in Go or the timeout parameter in HTTP, but be cautious as low values can cause failures. The troubleshooting section recommends pre-pulling images locally to reduce startup delays.

Question 6

What are the performance implications of using Gnomock for large test suites?

Accepted Answer

Spinning up multiple Docker containers adds significant overhead, which can slow down test execution, especially in parallel. The README warns that running too many containers at once can lead to timeouts and requires splitting tests in CI.

gnomock

What is gnomock?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions