Add a wait_for_healthcheck method to DockerCompose #241

Activity

1. tillahoffmann

   added

   🛟 help wanted

   📦 package: compose

   🚀 enhancement

   on Jan 6, 2023
2. rhoban13 commented on Jan 17, 2024

   

   rhoban13

   on Jan 17, 2024

   Contributor

   More actions

   Ideally this should work for even the DockerContainer as well.

   👍React with 👍1Reacted by Fabrice Baranski
3. github-actions

   added

   👀 requires attention

   on Jan 17, 2024
4. lukasz-matter commented on Sep 19, 2024

   

   lukasz-matter

   on Sep 19, 2024

   More actions

   A very simple implementation for a DockerContainer can look like this:

       with container:
           start_time = time.time()
           underlying_container = container.get_wrapped_container()
           while time.time() - start_time < 10:
               underlying_container.reload()
               if underlying_container.health == 'healthy':
                   print(f"Container is healthy!")
                   break
               time.sleep(.1)
           else:
               raise TimeoutError(
                   f"Container status is not healthy after 10s - it's {underlying_container.health}!"
               )
           yield container
5. aligator commented on Apr 2, 2025

   

   aligator

   on Apr 2, 2025

   More actions

   .health didn't work for me somehow...

   I got it working with using the attributes directly.

   Could something like this wait_for_healthy be added to testcontainers-python?

   from testcontainers.core.container import DockerContainer
   from testcontainers.core.waiting_utils import wait_container_is_ready
   
   class UnhealthyError(Exception):
      pass
      
   @wait_container_is_ready(UnhealthyError)
   def wait_for_healthy(container: DockerContainer):
     if container._container is None:
       raise UnhealthyError
     
     container._container.reload()
     if container._container.attrs.get('State', {}).get('Health', {}).get('Status', 'unknown') != "healthy":
       raise UnhealthyError
   
   def create_rabbit_container() -> DockerContainer:
       container = (DockerContainer(image="rabbitmq:3")
           .with_env("RABBITMQ_DEFAULT_USER", "test")
           .with_env("RABBITMQ_DEFAULT_PASS", "test")
           .with_exposed_ports("5672")
           .with_kwargs(
               healthcheck={
                   "test": ["CMD", "rabbitmq-diagnostics", "-q", "ping"],
                   "interval": 30000000000,  # 30s in nanoseconds
                   "timeout": 5000000000,    # 5s in nanoseconds
                   "retries": 3,
                   "start_period": 60000000000  # 60s in nanoseconds
               }
           ))
   
       container.start()
   
       wait_for_healthy(container)
       
       return container
6. CaptainDriftwood

   added a commit that references this issue on Jan 2, 2026

   chore: filter testcontainers deprecation warning and document bug

   ...

   be47e0a
7. CaptainDriftwood

   added a commit that references this issue on Jan 11, 2026

   feat: RFC 3507 ICAP client with async, SSL/TLS, and pytest plugin (#20)

   ...

   501b13e