How spack/spack works
Spack is a multi-platform package manager for building and installing software in multiple versions and configurations. The principal workflow starts with a user’s package spec, resolves it into a concrete dependency configuration, then builds and installs it into a non-destructive package store. Environments and configuration support that workflow; package repositories supply recipes. The README documents the user-facing install workflow, while source-index references support several internal links. Other README capabilities such as binary build caches, module files, containers, and CI are retained as distinct branches; unsampled wiring is left unasserted.
Main entry points: main.py CLI dispatch · database.py Install database · spec.py Spec model · package.py Package API
Components 27
CLI and environments
- CLI dispatch
lib/spack/spack/main.py - Environments
lib/spack/spack/environment/environment.py - Terminal output
lib/spack/spack/util/tty/color.py
Specs and recipes
- Spec model
lib/spack/spack/spec.py - Variant model
lib/spack/spack/variant.py - Package repositories
lib/spack/spack/repo.py - Dependency solver
lib/spack/spack/solver/asp.py - Dependency traversal
lib/spack/spack/traverse.py - Target platforms
lib/spack/spack/platforms
Build and install
- Package API
lib/spack/spack/package.py - Package base
lib/spack/spack/package_base.py - Build and install
lib/spack/spack/installer/core.py - Build environment
lib/spack/spack/util/environment.py - Process execution
lib/spack/spack/util/executable.py
Configuration and storage
- Configuration
lib/spack/spack/config.py - Install store
lib/spack/spack/store.py - Install database
lib/spack/spack/database.py - Filesystem utilities
lib/spack/spack/util/filesystem.py - File locking
lib/spack/spack/util/lock.py - YAML support
lib/spack/spack/util/spack_yaml.py - Language utilities
lib/spack/spack/util/lang.py
Distribution and integrations
- Git support
lib/spack/spack/util/git.py - Binary build caches
lib/spack/spack/binary_distribution.py - Environment modules
lib/spack/spack/modules/common.py - Containers
lib/spack/spack/container - Build pipelines
lib/spack/spack/ci
Other components
- Package user
Connections 32
- Package user → CLI dispatch: runs commands
README.md - CLI dispatch → Environments: supports environments
lib/spack/spack/main.py - CLI dispatch → Configuration: loads configuration
lib/spack/spack/main.py - CLI dispatch → Dependency solver: dispatches solving
lib/spack/spack/main.py - Package user → Spec model: specifies package
README.md - Dependency solver → Spec model: resolves specs
lib/spack/spack/solver/asp.py - Dependency solver → Dependency traversal: traverses dependencies
lib/spack/spack/solver/asp.py - Spec model → Package repositories: looks up package
lib/spack/spack/spec.py - Environments → Spec model: manages specs
lib/spack/spack/environment/environment.py - Package repositories → Package base: loads recipes
lib/spack/spack/repo.py - Package API → Build environment: uses environment changes
lib/spack/spack/package.py - Package API → Process execution: runs processes
lib/spack/spack/package.py - Package API → Filesystem utilities: uses file operations
lib/spack/spack/package.py - Package user → Build and install: requests installation
README.md - Build and install → Install store: installs packages
- Install store → Install database: tracks installs
lib/spack/spack/database.py - Install database → Package repositories: uses repositories
lib/spack/spack/database.py - Install database → Spec model: stores specs
lib/spack/spack/database.py - Install database → Dependency traversal: traverses records
lib/spack/spack/database.py - Install database → Filesystem utilities: uses file operations
lib/spack/spack/database.py - Install database → File locking: uses locks
lib/spack/spack/database.py - Configuration → Filesystem utilities: uses file operations
lib/spack/spack/config.py - Configuration → YAML support: reads YAML
lib/spack/spack/config.py - CLI dispatch → Binary build caches: offers build caches
README.md - CLI dispatch → Environment modules: offers module files
README.md - CLI dispatch → Containers: supports containers
README.md - CLI dispatch → Build pipelines: supports build pipelines
README.md - CLI dispatch → Target platforms: supports platforms
README.md - CLI dispatch → Git support: uses Git metadata
- CLI dispatch → Terminal output: uses terminal colors
lib/spack/spack/main.py - CLI dispatch → Language utilities: uses utilities
lib/spack/spack/main.py - Variant model → Spec model: models options
lib/spack/spack/spec.py