# use-docker
Feature-gated facade crate for `RustUse` Docker primitives.
`use-docker` re-exports focused crates for Dockerfile instruction fragments,
`.dockerignore` rules, image references, tags, registries, Compose-shaped data,
ports, volumes, networks, env files, healthchecks, labels, and build metadata.
It is not a Docker engine, client, registry client, Compose implementation, or
command runner.
## Basic Usage
```rust
#[cfg(feature = "full")]
{
use use_docker::{dockerfile, image, port};
let reference: image::DockerImageReference = "ghcr.io/rustuse/app:latest".parse()?;
let mapping: port::PortMapping = "8080:80".parse()?;
let instruction = dockerfile::DockerfileInstruction::run("cargo test");
assert_eq!(reference.repository(), "app");
assert_eq!(mapping.container_port().get(), 80);
assert_eq!(instruction.to_string(), "RUN cargo test");
}
# Ok::<(), Box<dyn std::error::Error>>(())
```
## Status
Experimental while the workspace remains below `0.3.0`.