rust

type ContainerPublisher struct {
	// Client is the Dagger client used to construct the runtime image.
	Client daggerkit.DaggerClient
	// Config carries the registry username used alongside the creds
	// secret passed to Publish.
	Config shipwright.ArtifactConfig
}

type RustBuilder struct {
	// Client is the Dagger client used to construct the build container.
	Client daggerkit.DaggerClient
	// Config configures the output binary name (BinaryName) and cargo
	// build profile (BuildMode, e.g. "release", "debug", or a custom
	// named profile).
	Config shipwright.BuildConfig
	// RustVersion selects the Rust toolchain image tag. Kept as its own
	// field rather than overloading Config.GoVersion, because
	// shipwright.BuildConfig has no Rust-specific version field
	// (pkg/shipwright/config.go) — the same reasoning providers/go's
	// GoUnitTester applies to its own GoVersion field. Defaults to
	// defaultRustVersion when left empty.
	RustVersion string
	// ManifestPath selects a Cargo.toml other than the source root's own,
	// mirroring `cargo build --manifest-path`. Needed to build a single
	// member out of a large workspace (e.g. ego-rs's
	// examples/reference-app/Cargo.toml) without cd'ing into it.
	ManifestPath string
	// Package restricts the build to one workspace member via `cargo build
	// --package`, e.g. ego-rs's "reference-app" among its 19 members.
	Package string
	// Bin selects one binary target within the package via `cargo build
	// --bin`, needed when a package defines more than one (e.g.
	// examples/reference-app/src/bin/server.rs).
	Bin string
	// Locked maps to `--locked`, forbidding Cargo from updating
	// Cargo.lock so the same lockfile always produces the same dependency
	// graph in CI.
	Locked bool
}

type RustCommand struct {
	// Client is the Dagger client used to construct the command container.
	Client daggerkit.DaggerClient
	// RustVersion selects the Rust toolchain image. Defaults to
	// defaultRustVersion when left empty, same convention as every other
	// Tester in this package.
	RustVersion string
	// ManifestPath selects a Cargo.toml other than the source root's own.
	// The provider — not the caller — turns this into `--manifest-path`,
	// inserted right after the subcommand, so a manifest never duplicates
	// the same information inside Command (e.g. writing both
	// `manifestPath: integration-tests/Cargo.toml` and `--manifest-path
	// integration-tests/Cargo.toml` inside Command).
	ManifestPath string
	// Command is the Cargo invocation to run, without the leading "cargo"
	// (e.g. "run -p xtask -- verify-layers"). Required — Test rejects an
	// empty Command rather than running bare `cargo` with no subcommand.
	Command string
	// Docker opts into attaching a real Docker-in-Docker daemon (see
	// dockerdaemon.go) to the command container, giving it a
	// network-reachable DOCKER_HOST. Unlike RustIntegrationTester, where
	// Docker access is inherent to the capability and always attached, most
	// Cargo commands (xtask-style workspace tooling) must NOT get a Docker
	// daemon at all, so this defaults to false. Set it for a command that
	// needs one, e.g. a Testcontainers-backed run-suite binary.
	Docker bool
	// CacheKey isolates this step's `target` cache volume from every other
	// RustCommand step. Left empty, every RustCommand shares one default
	// cache volume — fine when a workflow only ever runs commands against
	// the same Cargo workspace. Two RustCommand steps against different
	// workspaces (e.g. the main workspace's xtask vs.
	// integration-tests/Cargo.toml's run-suite) must set distinct CacheKeys,
	// the same way rustIntegrationTesterTargetCacheKey is kept separate
	// from rustUnitTesterTargetCacheKey (cargocache.go) — otherwise
	// incremental-compilation state from one workspace corrupts the other's
	// target directory.
	CacheKey string
}

type RustIntegrationTester struct {
	// Client is the Dagger client used to construct the test container.
	Client daggerkit.DaggerClient
	// RustVersion selects the Rust toolchain image. Defaults to
	// defaultRustVersion when left empty, same convention as
	// RustUnitTester.RustVersion.
	RustVersion string
	// ManifestPath selects the integration workspace's own Cargo.toml
	// (e.g. "integration-tests/Cargo.toml"), distinct from the main
	// workspace cargo test never touches.
	ManifestPath string
	// Package restricts the run to one member of the integration
	// workspace via `cargo test --package`. Leaving it empty runs
	// `--workspace` against ManifestPath instead.
	Package string
	// Features lists the Cargo features to enable via `--features` —
	// e.g. ego-rs's own crash-test-failpoint, which its Cargo.toml
	// documents as belonging only inside this isolated workspace.
	// Ignored when AllFeatures is set.
	Features []string
	// AllFeatures maps to `--all-features`.
	AllFeatures bool
	// Locked maps to `--locked`.
	Locked bool
}

type RustLinter struct {
	// Client is the Dagger client used to construct the lint container.
	Client daggerkit.DaggerClient
	// RustVersion selects the Rust toolchain image tag. Unlike
	// golangci-lint (a standalone binary distributed in its own image),
	// clippy is a rustup component bound to a specific toolchain, so this
	// implementation needs its own version knob. Defaults to
	// defaultRustVersion when left empty.
	RustVersion string
}

type RustUnitTester struct {
	// Client is the Dagger client used to construct the test container.
	Client daggerkit.DaggerClient
	// Config carries the minimum required test coverage percentage.
	Config shipwright.TestConfig
	// RustVersion selects the Rust toolchain image. Kept as its own field
	// rather than reusing BuildConfig, mirroring GoUnitTester.GoVersion's
	// own rationale (TestConfig intentionally has no toolchain-version
	// field). Defaults to defaultRustVersion when left empty.
	RustVersion string
	// ManifestPath selects a Cargo.toml other than the source root's own,
	// mirroring `cargo test --manifest-path`. Needed for a workspace like
	// ego-rs's, which keeps its Testcontainers-backed integration suite in
	// a deliberately separate, non-member workspace
	// (integration-tests/Cargo.toml) precisely so `cargo test --workspace`
	// never touches Docker.
	ManifestPath string
	// Package restricts the run to one workspace member (`cargo test
	// --package`) instead of the whole workspace. Mutually exclusive with
	// --workspace in practice, so set it leaves --workspace off entirely
	// (see cargoTestArgs).
	Package string
	// Features lists the Cargo features to enable via `--features`.
	// Ignored when AllFeatures is set.
	Features []string
	// AllFeatures maps to `--all-features`. Left false by default
	// (previously always forced on) because a provider must not decide a
	// consumer's feature policy: ego-rs's own crash-test-failpoint feature
	// is documented to stay off outside its isolated integration-tests
	// workspace, which --all-features would silently violate.
	AllFeatures bool
	// Locked maps to `--locked`, forbidding Cargo from updating
	// Cargo.lock so the same lockfile always produces the same dependency
	// graph in CI.
	Locked bool
}

type RustVulnScanner struct {
	// Client is the Dagger client used to construct the scan container.
	Client daggerkit.DaggerClient
	// RustVersion selects the Rust toolchain image used to install and run
	// cargo-audit. Defaults to defaultRustVersion when left empty.
	RustVersion string
}