testcontainers / testcontainers/testcontainers-java

[Enhancement]: Throw specific exception type if no Docker env found

Offen
#6,164 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

type/enhancement
Vorherrschende Sprache
Java
Sterne
8.7k
Forks
1.9k
Ø Merge
2 T. 17 Std.
Gemergte PRs (30 T.)
9

Beschreibung

Module

Core

Proposal

Currently, if DockerClientProviderStrategy cannot find a Docker environment on the host, it throws an IllegalStateException. I suggest that this should be a dedicated exception type (extending RuntimeException), so that it can be unambiguously caught and handled.

My use case is to catch that exception and rethrow an org.junit.AssumptionViolatedException if the test is running on an unsupported host. I can catch the IllegalStateException as it stands, but there may other causes of that type, so it's a little ambiguous.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne mit DockerClientProviderStrategy, insbesondere mit dem Pfad, der durchlaufen wird, wenn keine Docker-Umgebung gefunden wird. Verfolge das bestehende Ausnahmeverhalten und die Repository-Tests und prüfe anschließend, ob diese Bedingung einen dedizierten RuntimeException-Typ besitzt, den Aufrufer eindeutig abfangen können.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
docker, java
Bereich
devops, testing
Issue-Typ
Feature
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
38/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.