chore: release v0.18.0

[github-actions]

🤖 New release

• testcontainers: 0.17.0 -> 0.18.0

Changelog

[0.18.0] - 2024-06-15

Details

Bug Fixes

• [❗] Make DOCKER_CONFIG usage consistent with Docker CLI (#654)

Features

• [❗] Support UDP and SCTP port mappings (#655)
• Impl From<u16> for ContainerPort with TCP default (#658)
• Support HTTP wait strategy (#659)
• Allow passing u16 to Ports

Miscellaneous Tasks

• Use nightly rustfmt (#657)

Refactor

• [❗] Get rid of associated type ImageArgs and rename to cmd (#649)
• Avoid unnecessary owned structs and boxing (#651)
• [❗] Add ImageExt trait to avoid explicit conversion to RunnableImage (#652)
• [❗] Rename RunnableImage to ContainerRequest (#653)
• [❗] Exposed and mapped ports api (#656)
• Preliminary refactoring of wait strategies (#661)

---

This PR was generated with release-plz.

Migration Guide

Overview

Most of the breaking changes introduced in this version primarily impact developers who implement their own images. For general usage, the API remains mostly the same, with some improvements and enhancements for better performance and flexibility.

1. Renaming of RunnableImage

• Old: RunnableImage
• New: ContainerRequest
  • Update: The explicit conversion from Image to ContainerRequest (formerly RunnableImage) is no longer necessary. Instead, you can now directly import testcontainers::ImageExt and override image parameters as needed.

2. Changes to Image Methods

• Method: Image::tag and Image::name
  • Old Return Type: String
  • New Return Type: &str
  • Update: Update any code that relies on these methods to handle the new return type &str. This change helps improve performance by avoiding unnecessary allocations.

3. Changes to Image::exposed_ports

• Method: Image::exposed_ports
  • Old Return Type: Implementation-specific or previously different.
  • New Return Type: &[ContainerPort]
  • Update: The method now returns a slice of ContainerPort, which supports exposing ports with protocols TCP, UDP, and SCTP. Update your code to handle the slice accordingly.

4. Removal of Associated Type Args in Image

• Old: Image had an associated type Args.
• New: The associated type Args is removed.
  • Update: Command arguments are now part of Image::cmd, which returns impl IntoIterator<Item = impl Into<String>>. This change allows more flexibility in specifying command arguments. Ensure your code is updated to work with the new method signature.

5. Simplification of Trait Implementation in Image

• Old: Image required Box<dyn ..> for certain traits.
• New: Utilizes Return Position impl Trait in Trait (RPITIT).
  • Update: Instead of requiring Box<dyn ..>, Image now uses RPITIT for trait returns. This change simplifies the code and improves readability and performance. Familiarize yourself with RPITIT to understand its benefits and applications in your implementation.

6. Changes to RunnableImage::with_mapped_port

• Old: RunnableImage::with_mapped_port
• New: Accessible through ImageExt::with_mapped_port
  • Update: This method now accepts two parameters instead of a tuple. Adjust your method calls to pass the parameters separately.

[netlify]

✅ Deploy Preview for testcontainers-rust ready!

Name	Link
🔨 Latest commit	c8e0ec6
🔍 Latest deploy log	https://app.netlify.com/sites/testcontainers-rust/deploys/666dfcdb4bcd9d0008f5d92d
😎 Deploy Preview	https://deploy-preview-663--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.