feat!: add container startup timeout with default of 1 minute (#643)

Closes #247

- Sets default startup timeout to 1 minute
- Allows to override with `RunnableImage::with_startup_timeout`

Note: breaking change because of default timeout

For now, ENV variable to configure global timeout isn't introduced.
First of all, that's quote similar to other languages, (e.g
[Go](https://golang.testcontainers.org/features/wait/introduction/#startup-timeout-and-poll-interval),
[Java](https://java.testcontainers.org/features/startup_and_waits/))

Another question is which one should take precedence: ENV over
`with_startup_timeout` or vice versa?

We can extend it later in compatible way, so not that important at the
moment.

testcontainers/src/core/error.rs

@@ -58,6 +58,8 @@ pub enum WaitContainerError {
     HealthCheckNotConfigured(String),
     #[error("container is unhealthy")]
     Unhealthy,
+    #[error("container startup timeout")]
+    StartupTimeout,
 }
 
 impl TestcontainersError {

testcontainers/src/core/image/runnable_image.rs

@@ -1,4 +1,4 @@
-use std::{collections::BTreeMap, net::IpAddr};
+use std::{collections::BTreeMap, net::IpAddr, time::Duration};
 
 use crate::{
     core::{mounts::Mount, ContainerState, ExecCommand, WaitFor},
@@ -23,6 +23,7 @@ pub struct RunnableImage<I: Image> {
     shm_size: Option<u64>,
     cgroupns_mode: Option<CgroupnsMode>,
     userns_mode: Option<String>,
+    startup_timeout: Option<Duration>,
 }
 
 /// Represents a port mapping between a local port and the internal port of a container.
@@ -124,6 +125,11 @@ impl<I: Image> RunnableImage<I> {
     ) -> Result<Vec<ExecCommand>, TestcontainersError> {
         self.image.exec_after_start(cs)
     }
+
+    /// Returns the startup timeout for the container.
+    pub fn startup_timeout(&self) -> Option<Duration> {
+        self.startup_timeout
+    }
 }
 
 impl<I: Image> RunnableImage<I> {
@@ -246,6 +252,14 @@ impl<I: Image> RunnableImage<I> {
             ..self
         }
     }
+
+    /// Sets the startup timeout for the container. The default is 60 seconds.
+    pub fn with_startup_timeout(self, timeout: Duration) -> Self {
+        Self {
+            startup_timeout: Some(timeout),
+            ..self
+        }
+    }
 }
 
 impl<I> From<I> for RunnableImage<I>
@@ -275,6 +289,7 @@ impl<I: Image> From<(I, I::Args)> for RunnableImage<I> {
             shm_size: None,
             cgroupns_mode: None,
             userns_mode: None,
+            startup_timeout: None,
         }
     }
 }