Workspace & Feature Flag

npm workspaces → cargo workspaces

เมื่อ TypeScript monorepo เติบโตเกิน package เดียว คุณจะใช้ npm (หรือ pnpm/yarn) workspaces Cargo มีเทียบเท่าแบบ first-class: workspace คือ Cargo.toml เดียวที่ root ซึ่งระบุ member crate ทั้งหมด member ทั้งหมดใช้ Cargo.lock เดียวและ target/ build directory เดียวร่วมกัน

TypeScript

# package.json (root)
{
  "name": "my-monorepo",
  "workspaces": [
    "packages/api",
    "packages/core",
    "packages/cli"
  ]
}

# packages/core/package.json
{
  "name": "@my/core",
  "version": "1.0.0"
}

Rust

# Cargo.toml (root — workspace manifest)
[workspace]
members = [
    "crates/api",
    "crates/core",
    "crates/cli",
]
resolver = "2"   # ใช้ resolver version 2 เสมอ

# crates/core/Cargo.toml
[package]
name = "core"
version = "0.1.0"
edition = "2024"

รัน command ทั้ง workspace

# TypeScript (npm workspaces)
npm run test --workspaces
npm run build --workspace packages/api

# Cargo
cargo build --workspace         # build every member
cargo test --workspace          # test every member
cargo build -p api              # build only the "api" crate
cargo test -p core              # test only the "core" crate

Share dependency version ข้าม crate

# Cargo.toml (root workspace manifest)
[workspace.dependencies]
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }

# crates/api/Cargo.toml  — inherit without repeating the version
[dependencies]
tokio = { workspace = true }
serde = { workspace = true }

วิธีนี้กัน version drift ข้าม workspace member ที่เป็นปัญหาที่พบบ่อยใน Node monorepo ที่ package ต่างตัวดึง patch version ไม่ตรงกันโดยไม่รู้ตัว

Feature flag — conditional compilation

Feature flag คือคำตอบของ Rust สำหรับ optional peer dependency และการเรียก require() แบบมีเงื่อนไข ช่วยให้ผู้ใช้เลือกใช้ฟังก์ชันเพิ่มเติมโดยไม่ต้องจ่าย compile cost เมื่อไม่ต้องการ

Cargo.toml

[features]
default = ["json"]          # features enabled by default
json = ["dep:serde_json"]   # "json" feature pulls in serde_json
async = ["dep:tokio"]       # "async" feature pulls in tokio
full = ["json", "async"]    # convenience: enable everything

[dependencies]
serde_json = { version = "1", optional = true }
tokio = { version = "1", optional = true }

src/lib.rs

#[cfg(feature = "json")]
pub mod json_support {
    pub fn parse(s: &str) -> serde_json::Value {
        serde_json::from_str(s).unwrap()
    }
}

# Build with no default features
cargo build --no-default-features

# Enable specific features
cargo build --features "async,json"

# Enable all features
cargo build --all-features

Workspace และ feature flag ต้องการ project layout หลาย file จึงไม่มี browser Playground สำหรับบทนี้ สร้าง workspace ใน local ด้วย cargo new --lib และทดลองกับตัวอย่างข้างต้น

🟦 Path dependency — local crate คืออะไร

ภายใน workspace crate อ้างอิงกันโดยใช้ path dependency แทน version number นี่เทียบเท่ากับ "@my/core": "*" กับ npm link

crates/api/Cargo.toml

[dependencies]
core = { path = "../core" }

Cargo resolve path ตอน build time และ recompile core อัตโนมัติเมื่อมีการเปลี่ยนแปลง — ไม่ต้องทำ npm link dance

ใน Cargo workspace ไฟล์ Cargo.lock ที่ share เดียวอยู่ที่ไหน?

ใน directory ของ member crate แต่ละตัว ที่ workspace root ข้าง root Cargo.toml ใน directory target/ ไม่มี Cargo.lock ใน workspace

จะ build เฉพาะ crate หนึ่งใน workspace ได้อย่างไร?

cargo build --only api cargo build -p api cargo build --crate api cargo build --member api

Cargo feature flag มีจุดประสงค์อะไร?

เป็น compile-time flag ที่เปิดใช้ฟังก์ชันและ dependency แบบ optional เป็น environment variable ที่ใช้ runtime ควบคุมว่า crate ใช้ Rust edition ใด ใช้สำหรับ testing เท่านั้น

Submit

Mark as complete