dockertest
CLAUDE.md4.5k starsChanged 13 months agoApache-2.0View on GitHub
- Always pass context.Context from caller (never use context.Background or TODO). - Follow idiomatic Go conventions (Effective Go). - Prefer simple, clean architectures versus overengineering. - Think about how you can remove, simplify, and reduce code (not tests!). LLMs and AI agents have a tendency to generate useless helpers that already exist in the stdlib or other libraries. Instead, I want you to delete and simplify code (do not delete test cases though) and not generate useless/duplicated/existing code. Generating useless…
Trending
More talk lately.about the whole repository
Who's talking about ory/dockertest
- Stack Overflow“Mocking MongoDB response in Go”Stack Overflow · Jun 9, 2022 · 5 votes
- A Hacker News story“Show HN: Write better Go integration tests with open source dockertest v4”Hacker News · Apr 14, 2026 · 3 points
- classic-terra/core“Review”GitHub · Feb 26, 2025 · 3 reactions
- buildpacks/imgutil“Revert docker version upgrade”GitHub · Oct 22, 2020 · 3 reactions
- openbao/openbao-plugins“Fork mongodb plugin”GitHub · Jun 23, 2026 · 2 reactions
The biggest 5 of 57 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 57
Talked about on GitHub, Stack Overflow, Bluesky and Hacker News (57 times).
On GitHub · 50
- Feb 26, 2025Review — classic-terra/core3 reactions · 2 comments
- Oct 22, 2020Revert docker version upgrade — buildpacks/imgutil3 reactions · 1 comment
- Jun 23, 2026Fork mongodb plugin — openbao/openbao-plugins2 reactions · 10 comments
- Nov 25, 2022[Golang docs feedback] Extend the existing tutorial using more testing libraries — docker/docssays it tested it2 reactions · 7 comments
- Aug 5, 2022e2e testing should clear existing containers automatically — osmosis-labs/osmosissays it tested it2 reactions · 5 comments
45 more on GitHub
- May 15, 2020`pq: invalid input syntax for type json` When setup default value tag for `json.RawMessage` — t-tiger/gorm-bulk-insert2 reactions · 6 comments
- May 5, 2026cerbos 0.53.0 — chenrui333/homebrew-tap1 reaction
- Jan 22, 2026test: dockertest instead of docker-compose-go-otel.yml — open-telemetry/opentelemetry-ebpf-instrumentation1 reaction · 5 comments
- Nov 12, 2024Writing from browser to streams opened on webtransport connection sometimes raises StopSending — libp2p/go-libp2p1 reaction · 35 comments
- Jan 9, 2024NO-ISSUE: Bump the go-minor-dependencies group with 26 updates — openshift/assisted-service1 reaction · 13 comments
- Jan 8, 2024NO-ISSUE: Bump the go-minor-dependencies group with 25 updates — openshift/assisted-service1 reaction · 9 comments
- Jan 5, 2024NO-ISSUE: Bump the go-minor-dependencies group with 25 updates — openshift/assisted-service1 reaction · 9 comments
- Jan 1, 2024NO-ISSUE: Bump the go-minor-dependencies group with 23 updates — openshift/assisted-service1 reaction · 12 comments
- Dec 29, 2023NO-ISSUE: Bump the go-minor-dependencies group with 23 updates — openshift/assisted-service1 reaction · 10 comments
- Dec 28, 2023NO-ISSUE: Bump the go-minor-dependencies group with 23 updates — openshift/assisted-service1 reaction · 9 comments
- Dec 27, 2023NO-ISSUE: Bump the go-minor-dependencies group with 21 updates — openshift/assisted-service1 reaction · 11 comments
- Dec 25, 2023NO-ISSUE: Bump the go-minor-dependencies group with 21 updates — openshift/assisted-service1 reaction · 9 comments
- Dec 22, 2023NO-ISSUE: Bump the go-minor-dependencies group with 21 updates — openshift/assisted-service1 reaction · 12 comments
- Dec 21, 2023NO-ISSUE: Bump the go-minor-dependencies group with 21 updates — openshift/assisted-service1 reaction · 11 comments
- Dec 20, 2023NO-ISSUE: Bump the go-minor-dependencies group with 21 updates — openshift/assisted-service1 reaction · 10 comments
- Dec 19, 2023NO-ISSUE: Bump the go-minor-dependencies group with 21 updates — openshift/assisted-service1 reaction · 12 comments
- Dec 18, 2023NO-ISSUE: Bump the go-minor-dependencies group with 20 updates — openshift/assisted-service1 reaction · 10 comments
- Dec 15, 2023NO-ISSUE: Bump the go-minor-dependencies group with 23 updates — openshift/assisted-service1 reaction · 12 comments
- Dec 14, 2023NO-ISSUE: Bump the go-minor-dependencies group with 23 updates — openshift/assisted-service1 reaction · 12 comments
- Dec 13, 2023NO-ISSUE: Bump the go-minor-dependencies group with 24 updates — openshift/assisted-service1 reaction · 10 comments
- Dec 12, 2023NO-ISSUE: Bump the go-minor-dependencies group with 23 updates — openshift/assisted-service1 reaction · 12 comments
- Dec 11, 2023NO-ISSUE: Bump the go-minor-dependencies group with 23 updates — openshift/assisted-service1 reaction · 12 comments
- Dec 8, 2023NO-ISSUE: Bump the go-minor-dependencies group with 24 updates — openshift/assisted-service1 reaction · 10 comments
- Dec 7, 2023NO-ISSUE: Bump the go-minor-dependencies group with 24 updates — openshift/assisted-service1 reaction · 9 comments
- Dec 6, 2023NO-ISSUE: Bump the go-minor-dependencies group with 24 updates — openshift/assisted-service1 reaction · 12 comments
- Dec 4, 2023NO-ISSUE: Bump the go-minor-dependencies group with 24 updates — openshift/assisted-service1 reaction · 12 comments
- Dec 1, 2023NO-ISSUE: Bump the go-minor-dependencies group with 23 updates — openshift/assisted-service1 reaction · 11 comments
- Nov 30, 2023NO-ISSUE: Bump the go-minor-dependencies group with 27 updates — openshift/assisted-service1 reaction · 10 comments
- Nov 29, 2023NO-ISSUE: Bump the go-minor-dependencies group with 27 updates — openshift/assisted-service1 reaction · 13 comments
- Nov 28, 2023NO-ISSUE: Bump the go-minor-dependencies group with 27 updates — openshift/assisted-service1 reaction · 12 comments
- Nov 27, 2023NO-ISSUE: Bump the go-minor-dependencies group with 25 updates — openshift/assisted-service1 reaction · 12 comments
- Nov 22, 2023NO-ISSUE: Bump the go-minor-dependencies group with 25 updates — openshift/assisted-service1 reaction · 11 comments
- Nov 22, 2023NO-ISSUE: Bump the go-minor-dependencies group with 25 updates — openshift/assisted-service1 reaction · 11 comments
- Nov 21, 2023NO-ISSUE: Bump the go-minor-dependencies group with 31 updates — openshift/assisted-service1 reaction · 11 comments
- Nov 20, 2023NO-ISSUE: Bump the go-minor-dependencies group with 31 updates — openshift/assisted-service1 reaction · 12 comments
- Nov 17, 2023NO-ISSUE: Bump the go-minor-dependencies group with 31 updates — openshift/assisted-service1 reaction · 10 comments
- Oct 21, 2023x/tools/gopls: 'Check for upgrades' codelens argument can be lazily computed — golang/go1 reaction · 1 comment
- Apr 3, 2023Wrongly reports runc 1.1.5 as vulnerable — sonatype-nexus-community/nancy1 reaction · 1 comment
- Mar 30, 2023cannot use uintptr(unsafe.Pointer(&sd[0])) — aunum/gold1 reaction
- Oct 7, 2020Broken on Darwin/macOS — albenik/go-serial1 reaction · 1 comment
- Aug 4, 2019stuck at pushing image to docker hub — docker/buildx1 reaction · 19 comments
- Jun 4, 2019Cloud BuildでGoogle Cloud * Emulator を使う — gcpug/nouhau1 reaction · 4 comments
- May 29, 2019go get command from readme failes — parca-dev/parca1 reaction · 6 comments
- Oct 27, 2026Dependency Dashboard — metallb/frr-k8s0 reactions
- Oct 16, 2026Dependency Dashboard — livekit/storage0 reactions
On Stack Overflow · 4
- Jun 9, 2022Mocking MongoDB response in Go5 votes
- Aug 23, 2022Mock sql query Golang1 vote
- Jul 16, 2020How to prevent github.com/ory/dockertest from assigning containers to random ports?1 vote · 2 answers
- Jul 24, 2023Mock sql query Golang0 votes
On Bluesky · 2
- Jul 24, 2025Ça fait bien le taff et c'est propre. Tu peux aussi définir tes propres containers mais si tu veux avoir le controle total sur les… — @sapk.bsky.social1 likes and repost · 1 reply
- Sep 29, 2023ory/dockertest ほんと好き😊 github.com/ory/dockertest — @micheam.com1 likes and repost
On Hacker News · 1
- Apr 14, 2026Show HN: Write better Go integration tests with open source dockertest v43 points
The file
We split this CLAUDE.md into the rules it gives an agent
6 rules. About 0 are common, 4 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 1
Always pass context.Context from caller (never use context.Background or TODO).
- Distinctive: line 3
Follow idiomatic Go conventions (Effective Go).
- Distinctive: line 5
Prefer simple, clean architectures versus overengineering.
- Distinctive: line 16
When tests fail, do not remove or disable them.
- Distinctive: line 27
Do not use equality for error comparison.
- Very specific: line 30
DO NOT use github.com/docker/docker but only github.com/moby/moby/client
≈ “Common” is an estimate: at least 1 in 5 of the 27,641 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
- Always pass
context.Contextfrom caller (never usecontext.BackgroundorTODO). - Follow idiomatic Go conventions (Effective Go).
- Prefer simple, clean architectures versus overengineering.
- Think about how you can remove, simplify, and reduce code (not tests!). LLMs and AI agents have a tendency to generate useless helpers that already exist in the stdlib or other libraries. Instead, I want you to delete and simplify code (do not delete test cases though) and not generate useless/duplicated/existing code. Generating useless code or duplicating already existing functionality results in contract termination.
- Implementation notes and plans and documents generated while developing belong
in
./docs/notes/. Ensure that notes have a frontmatter withdate, andreasonfields. Specifically, the current date is important and the reason why the note was created. - When tests fail, do not remove or disable them. A failing test - especially if it already exists on the main branch - indicates a fault in the business logic. Removing or disabling that test leads to immediate contract termination.
- Determinism is key, especially in tests and conformity checks. Avoid any sources of non-determinism such as random number generation, time-based functions, or reliance on external systems that may introduce variability. Non-deterministic behavior can lead to flaky tests and unpredictable application behavior, which is unacceptable. It is also unacceptable to have thresholds in tests (e.g. 99% match X) - tests must be deterministic and exact.
- Do not use equality for error comparison. Always use errors.Is() or errors.As() for error comparisons.
- In tests don't use
deferfor cleanup butt.Cleanup. - DO NOT use
github.com/docker/dockerbut onlygithub.com/moby/moby/client
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

