testcontainers_build/
image.rs1use crate::{ImageBuildBackend, Result};
2use std::sync::Arc;
3use testcontainers::{ContainerRequest, GenericImage};
4
5#[must_use = "call remove().await after disposing containers to clean up the built image"]
8pub struct BuiltImage {
9 reference: String,
10 tag: String,
11 backend: Arc<dyn ImageBuildBackend>,
12 removed: bool,
13}
14
15impl BuiltImage {
16 pub(crate) fn new(reference: String, tag: String, backend: Arc<dyn ImageBuildBackend>) -> Self {
17 Self {
18 reference,
19 tag,
20 backend,
21 removed: false,
22 }
23 }
24
25 pub fn reference(&self) -> &str {
28 &self.reference
29 }
30
31 pub fn image(&self) -> GenericImage {
34 GenericImage::new("testcontainers-build", &self.tag)
35 }
36
37 pub fn container_request(&self) -> ContainerRequest<GenericImage> {
40 self.image().into()
41 }
42
43 pub async fn remove(&mut self) -> Result<()> {
46 if !self.removed {
47 self.backend.remove(&self.reference).await?;
48 self.removed = true;
49 }
50 Ok(())
51 }
52}