Skip to content

v0.17.0

Compare
Choose a tag to compare
@github-actions github-actions released this 26 May 20:47
· 71 commits to main since this release
03d534b

Migration guide

  • The largest change of this release is switch to fallible API (instead of panics)
    • the easiest way to use unwrap or expect for all testcontainers operations.
    • or you can cast error if your tests are already Result based
  • The Image::exec_after_start method returns a Result, so if you have an implementation of Image that uses exec_after_start, it's important to handle possible errors (e.g required port not found)
  • If you encounter container startup timeout, adjust it with RunnableImage::with_startup_timeout
  • Change testcontainers::CgroupnsMode to testcontainers::core::CgroupnsMode if your code rely on this.
  • exec now returns a result with ability to get exit code and logs of the command. You can ignore the result if you don't need this.

Details

Bug Fixes

  • Collect bridge IP address correctly (#626)

Features

  • Impl Error for WaitError (#629)
  • [❗] Extend exec interface to return logs and exec code (#631)
  • Ability to access container logs (#633)
  • [❗] Switch to fallible API (#636)
  • Make container and exec logs Sendable (#637)
  • Map container not found error to eof for container log streams (#639)
  • Expose follow flag for stdout and stderr (#640)
  • Add ability to read container logs into Vec (#641)
  • [❗] Add container startup timeout with default of 1 minute (#643)

Miscellaneous Tasks

  • Fix clippy warning without features enabled (#632)

Refactor

  • [❗] Drop re-export of CgroupnsMode accessible through core (#630)
  • [❗] Drop previously deprecated get_host_ip_address (#628)
  • [❗] Return PortNotExposed error from ContainerState::host_port_* (#644)