Workspace

Manage multiple crates under one workspace.

Workspaces

A workspace groups several packages developed together under one roof. All members share one Cargo.lock and target/ folder; common dependencies are compiled once:

# root Cargo.toml
[workspace]
members = ["ortak", "api", "cli"]

[workspace.dependencies]
serde = "1"

# api/Cargo.toml
[dependencies]
ortak = { path = "../ortak" }
serde = { workspace = true }

cargo build processes all members, cargo test -p api just one.

Shared code layout

A typical layout: models and helpers in the ortak library, the server and command line in separate binary packages. Each package pulls only the dependencies it needs:

proje/
├── Cargo.toml        # [workspace]
├── ortak/src/lib.rs  # pub fn surum()
├── api/src/main.rs   # use ortak::surum;
└── cli/src/main.rs   # use ortak::surum;

Exercise Shared version

Imitate the workspace with modules: pub fn surum() returning "1.0.0" in mod ortak, and pub fn durum() -> String using super::ortak::surum() in mod api and mod cli. Produce the output api 1.0.0 | cli 1.0.0.

Show example solution

mod ortak {
    pub fn surum() -> &'static str {
        "1.0.0"
    }
}

mod api {
    pub fn durum() -> String {
        format!("api {}", super::ortak::surum())
    }
}

mod cli {
    pub fn durum() -> String {
        format!("cli {}", super::ortak::surum())
    }
}

fn main() {
    println!("{} | {}", api::durum(), cli::durum());
}

Test yourself

How does one workspace member depend on another?
- With a local path dependency, path = "../ortak"
- By downloading from crates.io
- By writing mod ortak;
- It links automatically
Show answer

With a local path dependency, path = "../ortak" — A path dependency lets changes be seen immediately without publishing.

List the members

[workspace]
____ = ["ortak", "api", "cli"]

Show answer

[workspace]
members = ["ortak", "api", "cli"]

Item and role

[workspace]

Workspace definition
path = "../ortak"

Local dependency
workspace = true

Use the shared version
cargo test -p api

Single member

Next lesson: Summary - Crates and packages

We Are Enhancing Your Experience

Cookie Preferences

Strictly Necessary Cookies

Analytical Cookies