perf: replace ulid with ferroid's ULID for better performance (#829)

Replaces the [ulid](https://github.com/dylanhart/ulid-rs) crate with
[ferroid](https://github.com/s0l0ist/ferroid/tree/main/crates/ferroid),
a drop-in alternative with identical behavior in this context, but
better performance for encode/decode.

Also saves an allocation (not that it is critical here).

There's no functional difference here, but `ferroid` provides a more
modern foundation for ULID.

Author: s0l0ist

testcontainers/Cargo.toml

@@ -44,7 +44,7 @@ tokio = { version = "1", features = ["macros", "fs", "rt-multi-thread"] }
 tokio-stream = "0.1.15"
 astral-tokio-tar = "0.5.6"
 tokio-util = { version = "0.7.10", features = ["io"] }
-ulid = { version = "1.1.3" }
+ferroid = { version = "0.8.2", features = ["std", "ulid", "base32"] }
 url = { version = "2", features = ["serde"] }
 
 [features]

testcontainers/src/core/client.rs

@@ -24,6 +24,7 @@ use bollard::{
     },
     Docker,
 };
+use ferroid::{base32::Base32UlidExt, id::ULID};
 use futures::{StreamExt, TryStreamExt};
 use tokio::sync::{Mutex, OnceCell};
 use url::Url;
@@ -466,15 +467,15 @@ impl Client {
             .await
             .map_err(ClientError::CopyToContainerError)?;
 
-        let session = ulid::Ulid::new().to_string();
+        let session = ULID::from_datetime(std::time::SystemTime::now()).encode();
 
         let mut builder = BuildImageOptionsBuilder::new()
             .dockerfile("Dockerfile")
             .t(descriptor)
             .rm(true)
             .nocache(options.no_cache)
             .version(BuilderVersion::BuilderBuildKit)
-            .session(&session);
+            .session(session.as_str());
 
         if !options.build_args.is_empty() {
             builder = builder.buildargs(&options.build_args);

testcontainers/src/core/containers/host.rs

@@ -1,5 +1,6 @@
 use std::{convert::TryFrom, future, sync::Arc, time::Duration};
 
+use ferroid::{base32::Base32UlidExt, id::ULID};
 use log::{debug, trace};
 use russh::{client, Channel, Disconnect};
 use tokio::{
@@ -8,7 +9,6 @@ use tokio::{
     time::sleep,
 };
 use tokio_util::sync::CancellationToken;
-use ulid::Ulid;
 use url::Host as UrlHost;
 
 use super::async_container::ContainerAsync;
@@ -166,7 +166,8 @@ fn prepare_host_exposure<I: Image>(
         }
     }
 
-    let password = format!("tc-{}", Ulid::new());
+    let suffix = ULID::from_datetime(std::time::SystemTime::now()).encode();
+    let password = format!("tc-{}", suffix.as_str());
 
     Ok(Some(HostExposurePlan {
         requested_ports,

testcontainers/src/runners/async_runner.rs

@@ -24,7 +24,8 @@ use crate::{
 
 const DEFAULT_STARTUP_TIMEOUT: Duration = Duration::from_secs(60);
 #[cfg(feature = "reusable-containers")]
-static TESTCONTAINERS_SESSION_ID: std::sync::OnceLock<ulid::Ulid> = std::sync::OnceLock::new();
+static TESTCONTAINERS_SESSION_ID: std::sync::OnceLock<ferroid::id::ULID> =
+    std::sync::OnceLock::new();
 
 #[doc(hidden)]
 /// A unique identifier for the currently "active" `testcontainers` "session".
@@ -39,8 +40,9 @@ static TESTCONTAINERS_SESSION_ID: std::sync::OnceLock<ulid::Ulid> = std::sync::O
 /// like [`Client::get_running_container_id`](Client::get_running_container_id),
 /// as the container name, labels, and network would all still match.
 #[cfg(feature = "reusable-containers")]
-pub(crate) fn session_id() -> &'static ulid::Ulid {
-    TESTCONTAINERS_SESSION_ID.get_or_init(ulid::Ulid::new)
+pub(crate) fn session_id() -> &'static ferroid::id::ULID {
+    TESTCONTAINERS_SESSION_ID
+        .get_or_init(|| ferroid::id::ULID::from_datetime(std::time::SystemTime::now()))
 }
 
 #[async_trait]

testcontainers/tests/host_port_exposure.rs

@@ -7,12 +7,12 @@ use std::{
 };
 
 use anyhow::Result;
+use ferroid::{base32::Base32UlidExt, id::ULID};
 use testcontainers::{
     core::{ExecCommand, Host},
     runners::AsyncRunner,
     ContainerAsync, GenericImage, ImageExt, TestcontainersError,
 };
-use ulid::Ulid;
 
 const ALPINE_IMAGE: &str = "alpine";
 const ALPINE_TAG: &str = "3.19";
@@ -194,10 +194,10 @@ async fn host_port_exposure_is_scoped_per_container() -> Result<()> {
     let second_host_port = start_test_http_server("second-host-service")?;
 
     // Generate unique identifiers for network and containers to avoid conflicts
-    let suffix = Ulid::new().to_string().to_lowercase();
-    let network_name = format!("tc-host-port-net-{suffix}");
-    let first_container_name = format!("host-port-first-{suffix}");
-    let second_container_name = format!("host-port-second-{suffix}");
+    let suffix = ULID::from_datetime(std::time::SystemTime::now()).encode();
+    let network_name = format!("tc-host-port-net-{}", suffix.as_str());
+    let first_container_name = format!("host-port-first-{}", suffix.as_str());
+    let second_container_name = format!("host-port-second-{}", suffix.as_str());
 
     // Create two containers, each with only one host port exposed
     let first_container =