How vivo75/portuale works
Portuale is a Rust reimplementation of Gentoo Portage, exposed as a multicall CLI. The principal workflow is: a user invokes emerge; package configuration and dependency resolution produce an ordered merge plan; source packages are fetched, built, and merged, or binary packages are installed. Separate CLI paths support unmerge, package creation, and VDB operations. The README documents these capabilities; source excerpts confirm dispatch, phase execution, merge adapters, and VDB responsibilities, but not every runtime connection shown.
Main entry points: pretend.rs Pretend and plan · main.rs Applet dispatch · ebuild_merge.rs Source merge · emerge_build.rs Build scheduler
Components 23
CLI and planning
- Applet dispatch
rust/portuale/src/main.rs - Pretend and plan
rust/portuale/src/pretend.rs - Build scheduler
rust/portuale/src/emerge_build.rs
Configuration and resolution
- Profile config
rust/portage-profile/src/lib.rs - Dependency atoms
rust/portage-dep/src/lib.rs - USE reduction
rust/portage-use-reduce/src/lib.rs - Required USE
rust/portage-required-use/src/lib.rs - Repository metadata
rust/portage-repo/src/merge_order.rs - Merge ordering
rust/portage-repo/src/merge_order.rs
Package installation
- Source fetch
rust/portuale/src/fetch.rs - Ebuild phases
rust/portuale/src/ebuild_phases.rs - Source merge
rust/portuale/src/ebuild_merge.rs - Merge adapters
rust/portuale/src/merge_engines.rs - Binary packaging
rust/portuale/src/ebuild_package.rs - Binary packages
rust/portuale/src/binpkg.rs - Binary retrieval
rust/portuale/src/emerge_getbinpkg.rs - Unmerge
rust/portuale/src/ebuild_unmerge.rs
Installed state
- VDB commands
rust/portuale/src/vdb_cmd.rs - Installed database
rust/portage-vdb/src/lib.rs
Other components
- User
- System filesystem
- Package sources
- Binary host
Connections 26
- User → Applet dispatch: invokes
rust/portuale/src/main.rs - Applet dispatch → Pretend and plan: routes emerge
rust/portuale/src/main.rs - Pretend and plan → Profile config: reads config
- Pretend and plan → Dependency atoms: resolves atoms
- Pretend and plan → USE reduction: evaluates USE
- Pretend and plan → Required USE: checks constraints
- Pretend and plan → Repository metadata: resolves metadata
- Pretend and plan → Merge ordering: orders tasks
rust/portage-repo/src/merge_order.rs - Applet dispatch → Build scheduler: runs emerge
rust/portuale/src/main.rs - Build scheduler → Merge adapters: dispatches merges
rust/portuale/src/merge_engines.rs - Merge adapters → Source merge: executes source
rust/portuale/src/merge_engines.rs - Source merge → Ebuild phases: runs phases
rust/portuale/src/ebuild_merge.rs - Ebuild phases → Source fetch: fetches sources
rust/portuale/src/ebuild_phases.rs - Source fetch → Package sources: downloads
- Source merge → System filesystem: installs files
- Source merge → Installed database: writes records
- Build scheduler → Binary packaging: builds packages
rust/portuale/src/emerge_build.rs - Binary packaging → Binary packages: creates archive
rust/portuale/src/ebuild_package.rs - Applet dispatch → Binary retrieval: routes binary retrieval
rust/portuale/src/main.rs - Binary retrieval → Binary host: fetches packages
- Binary retrieval → Binary packages: installs binary
rust/portuale/src/emerge_getbinpkg.rs - Applet dispatch → Unmerge: routes unmerge
rust/portuale/src/main.rs - Unmerge → System filesystem: removes files
- Unmerge → Installed database: updates records
- Applet dispatch → VDB commands: routes VDB
rust/portuale/src/main.rs - VDB commands → Installed database: converts or verifies
rust/portuale/src/vdb_cmd.rs