# baler-dev/baler architecture

> Architecture diagram of the GitHub repository baler-dev/baler, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/baler-dev/baler
- Repository: https://github.com/baler-dev/baler

## Overview

Baler is a Rust package manager for R `{box}` modules. Its user workflow scaffolds a module, bundles it, installs it from a local directory, archive, or GitHub, and can lock R-package versions or remove installed modules. Compilation handles native code, while dependency resolution and CRAN package installation support reproducible installs. The graph combines README-documented CLI workflows with source-index references and excerpts; unsampled command internals and some native-build wiring are not inferred.

Main entry points: [`crates/baler-cli/src/lib.rs`](https://github.com/baler-dev/baler/blob/main/crates/baler-cli/src/lib.rs) (Baler CLI), [`crates/baler-core/src/ops/install/archive.rs`](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/install/archive.rs) (Archive install), [`crates/baler-core/src/ops/resolve.rs`](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/resolve.rs) (Dependency resolver), [`crates/baler-core/src/baler_toml.rs`](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/baler_toml.rs) (Module manifest)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and lifecycle"]
  node_cli["Baler CLI<br/>[lib.rs]"]
  node_init["Scaffold module<br/>[init.rs]"]
  node_remove["Remove module<br/>[remove.rs]"]
end

subgraph group_module["Module packaging"]
  node_bundle["Bundle project<br/>[bundle.rs]"]
  node_tar["Archive format<br/>[tar.rs]"]
  node_manifest["Module manifest<br/>[baler_toml.rs]"]
  node_install["Install routing<br/>[install.rs]"]
  node_archive_install["Archive install<br/>[archive.rs]"]
  node_github["GitHub install<br/>[github.rs]"]
end

subgraph group_deps["Dependency management"]
  node_resolve["Dependency resolver<br/>[resolve.rs]"]
  node_lock["Lock workflow<br/>[lock.rs]"]
  node_lockfile["Lockfile<br/>[lockfile.rs]"]
  node_cran["CRAN installer<br/>[client.rs]"]
  node_cran_graph["CRAN resolution<br/>[graph.rs]"]
  node_cran_packages["CRAN package index<br/>[packages.rs]"]
  node_cran_download["CRAN downloads<br/>[download.rs]"]
  node_paths["Install paths<br/>[paths.rs]"]
end

subgraph group_native["Native code"]
  node_compile["Compile module<br/>[compile.rs]"]
  node_native_install["Native install<br/>[native.rs]"]
  node_native_detect["Native detection<br/>[detect.rs]"]
  node_native_scaffold["Native scaffolding<br/>[scaffold.rs]"]
  node_native_toolchain["Native toolchain<br/>[toolchain.rs]"]
  node_native_cache["Build cache<br/>[cache.rs]"]
  node_r_glue["R glue templates<br/>[r_glue.rs]"]
end

node_user(("Module author"))

node_user -->|"runs commands"| node_cli
node_cli -->|"initializes"| node_init
node_cli -->|"bundles"| node_bundle
node_cli -->|"installs"| node_install
node_cli -->|"locks versions"| node_lock
node_cli -->|"removes"| node_remove
node_cli -->|"compiles"| node_compile
node_bundle -->|"reads"| node_manifest
node_bundle -->|"invokes"| node_compile
node_bundle -->|"archives with"| node_tar
node_install -->|"routes to"| node_archive_install
node_install -->|"routes to"| node_github
node_archive_install -->|"unpacks with"| node_tar
node_archive_install -->|"reads"| node_manifest
node_archive_install -->|"plans dependencies"| node_resolve
node_archive_install -->|"reads"| node_lockfile
node_github -->|"installs archive"| node_archive_install
node_lock -.->|"writes"| node_lockfile
node_resolve -->|"uses dependencies"| node_manifest
node_resolve -->|"resolves locations"| node_paths
node_resolve -->|"queries packages"| node_cran
node_cran -->|"resolves versions"| node_cran_graph
node_cran -->|"downloads packages"| node_cran_download
node_cran -->|"uses package data"| node_cran_packages
node_cran -->|"uses lock"| node_lockfile
node_cran_graph -->|"uses package data"| node_cran_packages
node_cran_graph -->|"uses lock"| node_lockfile
node_cran_download -->|"uses locations"| node_paths
node_compile -->|"reads config"| node_manifest
node_compile -->|"resolves dependencies"| node_resolve
node_compile -->|"uses locations"| node_paths
node_native_install -->|"reads config"| node_manifest
node_native_install -->|"resolves dependencies"| node_resolve
node_manifest -->|"detects native dirs"| node_native_detect
node_native_scaffold -->|"uses templates"| node_r_glue
node_native_toolchain -->|"checks cache"| node_native_cache
node_native_toolchain -->|"detects toolchain"| node_native_detect

click node_cli "https://github.com/baler-dev/baler/blob/main/crates/baler-cli/src/lib.rs"
click node_init "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/init.rs"
click node_remove "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/remove.rs"
click node_bundle "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/bundle.rs"
click node_tar "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/formats/tar.rs"
click node_manifest "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/baler_toml.rs"
click node_install "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/install.rs"
click node_archive_install "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/install/archive.rs"
click node_github "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/install/github.rs"
click node_resolve "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/resolve.rs"
click node_lock "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/lock.rs"
click node_lockfile "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/lockfile.rs"
click node_cran "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/cran/client.rs"
click node_cran_graph "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/cran/client/graph.rs"
click node_cran_packages "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/cran/packages.rs"
click node_cran_download "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/cran/client/download.rs"
click node_paths "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/paths.rs"
click node_compile "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/compile.rs"
click node_native_install "https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/install/native.rs"
click node_native_detect "https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/detect.rs"
click node_native_scaffold "https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/scaffold.rs"
click node_native_toolchain "https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/toolchain.rs"
click node_native_cache "https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/cache.rs"
click node_r_glue "https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/templates/r_glue.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_init,node_remove toneBlue
class node_bundle,node_tar,node_manifest,node_install,node_archive_install,node_github toneAmber
class node_resolve,node_lock,node_lockfile,node_cran,node_cran_graph,node_cran_packages,node_cran_download,node_paths toneMint
class node_compile,node_native_install,node_native_detect,node_native_scaffold,node_native_toolchain,node_native_cache,node_r_glue toneRose
class node_user toneIndigo
```

## Components

### CLI and lifecycle

- [Baler CLI](https://github.com/baler-dev/baler/blob/main/crates/baler-cli/src/lib.rs): `crates/baler-cli/src/lib.rs`
- [Scaffold module](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/init.rs): `crates/baler-core/src/ops/init.rs`
- [Remove module](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/remove.rs): `crates/baler-core/src/ops/remove.rs`

### Module packaging

- [Bundle project](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/bundle.rs): `crates/baler-core/src/ops/bundle.rs`
- [Archive format](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/formats/tar.rs): `crates/baler-core/src/formats/tar.rs`
- [Module manifest](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/baler_toml.rs): `crates/baler-core/src/baler_toml.rs`
- [Install routing](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/install.rs): `crates/baler-core/src/ops/install.rs`
- [Archive install](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/install/archive.rs): `crates/baler-core/src/ops/install/archive.rs`
- [GitHub install](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/install/github.rs): `crates/baler-core/src/ops/install/github.rs`

### Dependency management

- [Dependency resolver](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/resolve.rs): `crates/baler-core/src/ops/resolve.rs`
- [Lock workflow](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/lock.rs): `crates/baler-core/src/ops/lock.rs`
- [Lockfile](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/lockfile.rs): `crates/baler-core/src/lockfile.rs`
- [CRAN installer](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/cran/client.rs): `crates/baler-core/src/cran/client.rs`
- [CRAN resolution](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/cran/client/graph.rs): `crates/baler-core/src/cran/client/graph.rs`
- [CRAN package index](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/cran/packages.rs): `crates/baler-core/src/cran/packages.rs`
- [CRAN downloads](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/cran/client/download.rs): `crates/baler-core/src/cran/client/download.rs`
- [Install paths](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/paths.rs): `crates/baler-core/src/paths.rs`

### Native code

- [Compile module](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/compile.rs): `crates/baler-core/src/ops/compile.rs`
- [Native install](https://github.com/baler-dev/baler/blob/main/crates/baler-core/src/ops/install/native.rs): `crates/baler-core/src/ops/install/native.rs`
- [Native detection](https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/detect.rs): `crates/native-code-handler/src/detect.rs`
- [Native scaffolding](https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/scaffold.rs): `crates/native-code-handler/src/scaffold.rs`
- [Native toolchain](https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/toolchain.rs): `crates/native-code-handler/src/toolchain.rs`
- [Build cache](https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/cache.rs): `crates/native-code-handler/src/cache.rs`
- [R glue templates](https://github.com/baler-dev/baler/blob/main/crates/native-code-handler/src/templates/r_glue.rs): `crates/native-code-handler/src/templates/r_glue.rs`

### Other components

- **Module author**

## Connections

- Module author → Baler CLI: runs commands (evidence: `README.md`)
- Baler CLI → Scaffold module: initializes (evidence: `README.md`)
- Baler CLI → Bundle project: bundles (evidence: `README.md`)
- Baler CLI → Install routing: installs (evidence: `README.md`)
- Baler CLI → Lock workflow: locks versions (evidence: `README.md`)
- Baler CLI → Remove module: removes (evidence: `README.md`)
- Baler CLI → Compile module: compiles
- Bundle project → Module manifest: reads (evidence: `crates/baler-core/src/ops/bundle.rs`)
- Bundle project → Compile module: invokes (evidence: `crates/baler-core/src/ops/bundle.rs`)
- Bundle project → Archive format: archives with (evidence: `crates/baler-core/src/ops/bundle.rs`)
- Install routing → Archive install: routes to (evidence: `crates/baler-core/src/ops/install.rs`)
- Install routing → GitHub install: routes to (evidence: `crates/baler-core/src/ops/install.rs`)
- Archive install → Archive format: unpacks with (evidence: `crates/baler-core/src/ops/install/archive.rs`)
- Archive install → Module manifest: reads (evidence: `crates/baler-core/src/ops/install/archive.rs`)
- Archive install → Dependency resolver: plans dependencies (evidence: `crates/baler-core/src/ops/install/archive.rs`)
- Archive install → Lockfile: reads (evidence: `crates/baler-core/src/ops/install/archive.rs`)
- GitHub install → Archive install: installs archive (evidence: `crates/baler-core/src/ops/install/github.rs`)
- Lock workflow → Lockfile: writes
- Dependency resolver → Module manifest: uses dependencies (evidence: `crates/baler-core/src/ops/resolve.rs`)
- Dependency resolver → Install paths: resolves locations (evidence: `crates/baler-core/src/ops/resolve.rs`)
- Dependency resolver → CRAN installer: queries packages (evidence: `crates/baler-core/src/ops/resolve.rs`)
- CRAN installer → CRAN resolution: resolves versions (evidence: `crates/baler-core/src/cran/client.rs`)
- CRAN installer → CRAN downloads: downloads packages (evidence: `crates/baler-core/src/cran/client.rs`)
- CRAN installer → CRAN package index: uses package data (evidence: `crates/baler-core/src/cran/client.rs`)
- CRAN installer → Lockfile: uses lock (evidence: `crates/baler-core/src/cran/client.rs`)
- CRAN resolution → CRAN package index: uses package data (evidence: `crates/baler-core/src/cran/client/graph.rs`)
- CRAN resolution → Lockfile: uses lock (evidence: `crates/baler-core/src/cran/client/graph.rs`)
- CRAN downloads → Install paths: uses locations (evidence: `crates/baler-core/src/cran/client/download.rs`)
- Compile module → Module manifest: reads config (evidence: `crates/baler-core/src/ops/compile.rs`)
- Compile module → Dependency resolver: resolves dependencies (evidence: `crates/baler-core/src/ops/compile.rs`)
- Compile module → Install paths: uses locations (evidence: `crates/baler-core/src/ops/compile.rs`)
- Native install → Module manifest: reads config (evidence: `crates/baler-core/src/ops/install/native.rs`)
- Native install → Dependency resolver: resolves dependencies (evidence: `crates/baler-core/src/ops/install/native.rs`)
- Module manifest → Native detection: detects native dirs (evidence: `crates/baler-core/src/baler_toml.rs`)
- Native scaffolding → R glue templates: uses templates (evidence: `crates/native-code-handler/src/scaffold.rs`)
- Native toolchain → Build cache: checks cache (evidence: `crates/native-code-handler/src/toolchain.rs`)
- Native toolchain → Native detection: detects toolchain (evidence: `crates/native-code-handler/src/toolchain.rs`)
