feat!: support UDP and SCTP port mappings

[estigma88]

Resolves #234

Migration guide

A new way of defining exposed ports and port mappings is introduced to define the protocol, which could be
Tcp, Udp or Sctp. Changes impact the following methods:

• GenericImage.with_exposed_port
• GenericImage.with_mapped_port
• Container.get_host_port_ipv4
• Container.get_host_port_ipv6
• ContainerAsync.get_host_port_ipv4
• ContainerAsync.get_host_port_ipv6

Exposed ports

Having the following container configuration, that defines a Redis container running on TCP 6379 port:

use testcontainers::{core::{WaitFor}, runners::AsyncRunner, GenericImage};

async fn test_redis() {
     let container = GenericImage::new("redis", "7.2.4")
         .with_exposed_port(6379)
         .with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
         .start()
         .await;
 }

From now on, we should use ExposedPort enum instead, as follows:

use testcontainers::{core::{WaitFor, ExposedPort}, runners::AsyncRunner, GenericImage};

async fn test_redis() {
     let container = GenericImage::new("redis", "7.2.4")
         .with_exposed_port(ExposedPort::Tcp(6379))
         .with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
         .start()
         .await;
 }

Notice the ExposedPort::Tcp(6379), where we explicitly say which protocol we want to map the port. Most of your use
cases would use Tcp, like Redis container, but we recommend to check the containers documentation to be sure.

Port mappings

Having the following container configuration, that defines a Redis container running on TCP 6379 internal port, mapped to
1000 local port:

use testcontainers::{core::{WaitFor}, runners::AsyncRunner, GenericImage};

async fn test_redis() {
     let container = GenericImage::new("redis", "7.2.4")
         .with_mapped_port((1000, 6379))
         .with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
         .start()
         .await;
 }

From now on, we should use ExposedPort enum instead, as follows:

use testcontainers::{core::{WaitFor, ExposedPort}, runners::AsyncRunner, GenericImage};

async fn test_redis() {
     let container = GenericImage::new("redis", "7.2.4")
         .with_mapped_port((1000, ExposedPort::Tcp(6379)))
         .with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
         .start()
         .await;
 }

Notice the ExposedPort::Tcp(6379), where we explicitly say which protocol we want to map the port. Most of your use
cases would use Tcp, like Redis container, but we recommend to check the containers documentation to be sure.

If you are interested on getting the local port mapped to an internal port, before you use the following:

use testcontainers::{core::{WaitFor}, runners::AsyncRunner, GenericImage};

async fn test_redis() {
     let container = GenericImage::new("redis", "7.2.4")
         .with_mapped_port((1000, 6379))
         .with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
         .start()
         .await;
         
     let local_port = container.get_host_port_ipv4(6379).await?;
 }

From now on, you must specify the protocol, as follows:

use testcontainers::{core::{WaitFor}, runners::AsyncRunner, GenericImage};

async fn test_redis() {
     let container = GenericImage::new("redis", "7.2.4")
         .with_mapped_port((1000, ExposedPort::Tcp(6379)))
         .with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
         .start()
         .await;
         
     let local_port = container.get_host_port_ipv4(ExposedPort::Tcp(6379)).await?;
 }

Notice the ExposedPort::Tcp(6379) in the get_host_port_ipv4 invocation.

[netlify]

✅ Deploy Preview for testcontainers-rust ready!

Name	Link
🔨 Latest commit	f63c77e
🔍 Latest deploy log	https://app.netlify.com/sites/testcontainers-rust/deploys/666c39077d19ce0009f60cb1
😎 Deploy Preview	https://deploy-preview-655--testcontainers-rust.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[estigma88]

Initial approach to get early feedback, missing tests.

[estigma88]

Tests added, updated with main

[DDtKey]

Thank you for jumping on the task! 🙏

I've left some comments, please take a look and let me know WDYT

[DDtKey]

Please take a look at CI failures, should be minor things.

I'll take a look one more time a bit later, but it looks about ready to be merged!

Thank you for the contribution! 🙏
I really appreciate your help

[DDtKey]

Thank you very much! 🚀

[DDtKey]

JFYI: missed this part, we shouldn't panic anymore.

But don't worry, I'll prepare small refactoring