Skip to content

Comments

docs: rustdoc for builder API#820

Merged
DDtKey merged 7 commits intotestcontainers:mainfrom
mbodmer:feat/build-image-doc
Aug 1, 2025
Merged

docs: rustdoc for builder API#820
DDtKey merged 7 commits intotestcontainers:mainfrom
mbodmer:feat/build-image-doc

Conversation

@mbodmer
Copy link
Contributor

@mbodmer mbodmer commented Jul 23, 2025

For a start I have now documented the relevant parts of the builder API here.

I have added no_run to examples as the needed resources are missing, they should be built however to ensure correctness.

Signed-off-by: Marc Bodmer <marc.bodmer@securiton.ch>
Signed-off-by: Marc Bodmer <marc.bodmer@securiton.ch>
Signed-off-by: Marc Bodmer <marc.bodmer@securiton.ch>
Signed-off-by: Marc Bodmer <marc.bodmer@securiton.ch>
@netlify
Copy link

netlify bot commented Jul 23, 2025

Deploy Preview for testcontainers-rust ready!

Name Link
🔨 Latest commit 17f1a07
🔍 Latest deploy log https://app.netlify.com/projects/testcontainers-rust/deploys/6887660edfa70e0008fb6fcb
😎 Deploy Preview https://deploy-preview-820--testcontainers-rust.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@mbodmer mbodmer changed the title doc: rustdoc for builder API docs: rustdoc for builder API Jul 23, 2025
@mbodmer mbodmer marked this pull request as draft July 23, 2025 12:45
mbodmer added 2 commits July 28, 2025 13:37
Signed-off-by: mbodmer <marc.bodmer@email.ch>
Signed-off-by: mbodmer <marc.bodmer@email.ch>
@mbodmer mbodmer marked this pull request as ready for review July 28, 2025 12:20
Copy link
Contributor

@mervyn-mccreight mervyn-mccreight left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for taking the time to add the documentation! 🚀

Copy link
Contributor

@DDtKey DDtKey left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for wrapping up this with documentation! ❤️

@DDtKey DDtKey merged commit 392d634 into testcontainers:main Aug 1, 2025
18 checks passed
amab8901 pushed a commit to amab8901/testcontainers-rs that referenced this pull request Aug 4, 2025
For a start I have now documented the relevant parts of the builder API
here.

I have added no_run to examples as the needed resources are missing,
they should be built however to ensure correctness.

---------

Signed-off-by: Marc Bodmer <marc.bodmer@securiton.ch>
Signed-off-by: mbodmer <marc.bodmer@email.ch>
amab8901 pushed a commit to amab8901/testcontainers-rs that referenced this pull request Aug 4, 2025
For a start I have now documented the relevant parts of the builder API
here.

I have added no_run to examples as the needed resources are missing,
they should be built however to ensure correctness.

---------

Signed-off-by: Marc Bodmer <marc.bodmer@securiton.ch>
Signed-off-by: mbodmer <marc.bodmer@email.ch>
@github-actions github-actions bot mentioned this pull request Oct 27, 2025
DDtKey added a commit that referenced this pull request Oct 27, 2025
## 🤖 New release

* `testcontainers`: 0.25.0 -> 0.25.1

### ⚠ `testcontainers` breaking changes

`cargo-semver-checks` suggests to release `0.26.0` as new methods added
to the public trait, which is generally breaking.
But it only affects `ImageExt` which isn't generally expected to be
implemented by users. It's already implemented for all `I: Image`

So these should be safe to ignore here


```text
--- failure trait_method_added: pub trait method added ---

Description:
A non-sealed public trait added a new method without a default implementation, which breaks downstream implementations of the trait
        ref: https://doc.rust-lang.org/cargo/reference/semver.html#trait-new-item-no-default
       impl: https://github.com/obi1kenobi/cargo-semver-checks/tree/v0.43.0/src/lints/trait_method_added.ron

Failed in:
  trait method testcontainers::core::ImageExt::with_hostname in file /tmp/.tmpDpXBCy/testcontainers-rs/testcontainers/src/core/image/image_ext.rs:99
  trait method testcontainers::core::ImageExt::with_exposed_host_port in file /tmp/.tmpDpXBCy/testcontainers-rs/testcontainers/src/core/image/image_ext.rs:125
  trait method testcontainers::core::ImageExt::with_exposed_host_ports in file /tmp/.tmpDpXBCy/testcontainers-rs/testcontainers/src/core/image/image_ext.rs:129
  trait method testcontainers::core::ImageExt::with_device_requests in file /tmp/.tmpDpXBCy/testcontainers-rs/testcontainers/src/core/image/image_ext.rs:248
  trait method testcontainers::ImageExt::with_hostname in file /tmp/.tmpDpXBCy/testcontainers-rs/testcontainers/src/core/image/image_ext.rs:99
  trait method testcontainers::ImageExt::with_exposed_host_port in file /tmp/.tmpDpXBCy/testcontainers-rs/testcontainers/src/core/image/image_ext.rs:125
  trait method testcontainers::ImageExt::with_exposed_host_ports in file /tmp/.tmpDpXBCy/testcontainers-rs/testcontainers/src/core/image/image_ext.rs:129
  trait method testcontainers::ImageExt::with_device_requests in file /tmp/.tmpDpXBCy/testcontainers-rs/testcontainers/src/core/image/image_ext.rs:248
```

<details><summary><i><b>Changelog</b></i></summary><p>

<blockquote>

## [0.25.1] - 2025-10-27

### Details
#### Bug Fixes
- Replace tokio-tar with astral-tokio-tar
([#852](#852))

#### Documentation
- Rustdoc for builder API
([#820](#820))

#### Features
- Use DOCKER_DEFAULT_PLATFORM env var to specify platform
([#800](#800))
- Fallback to platform linux/amd64 when image pull fails
([#837](#837))
- Add support for devices request
([#832](#832))
- Add configurable tmpfs mount sizes
([#853](#853))
- Support `http_wait` functionallity without tls dependencies
([#850](#850))
- Add container hostname support
([#848](#848))
- Expose host ports between host and containers via ssh sidecar
([#846](#846))

#### Miscellaneous Tasks
- Update bollard-stubs requirement from =1.48.3-rc.28.0.4 to
=1.49.0-rc.28.3.3
([#828](#828))

#### Refactor
- Remove bollard_stubs dependency as bollard re-exports it
([#844](#844))

#### Testing
- Avoid flakiness in `platform` test
- Switch to testcontainers/helloworld and reduce some flakiness
([#855](#855))
</blockquote>


</p></details>

---
This PR was generated with
[release-plz](https://github.com/release-plz/release-plz/).

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Artem Medvedev <i@ddtkey.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants