Welcome to IVPM’s documentation!

IVPM (Integrated View Package Manager) is a project-local, polyglot package manager. It fetches dependencies from diverse sources – git, PyPI, npm, HTTP archives, GitHub releases, local directories, and more – and assembles unified views of your project through an extensible handler pipeline: a Python virtual environment, a Node.js environment, a FuseSoC library map, an agent skills directory, a merged direnv file.

One YAML file. One command. A complete, self-contained workspace.

Contents:

• Introduction
  • What is IVPM?
  • Key Capabilities
  • Where IVPM Fits
  • Example Domains
  • Next Steps
• Getting Started with IVPM
  • Installing IVPM
  • Quick Start: Clone an Existing Project
  • Creating a New IVPM Project
  • Using the Python Virtual Environment
  • Next Steps
• Core Concepts
  • Project-Local Management
  • The Update Pipeline
  • Source Types and Content Types
  • Dependency Sets
  • Recursive Sub-Dependencies
  • Lock File and Reproducibility
  • Next Steps
• Package Handlers
  • What Are Handlers?
  • How Handlers Fit into the Update Pipeline
  • Built-in Handlers
  • Handler Summary
  • Discovering Handlers
  • Writing Custom Handlers
• Dependency Sets
  • Defining Dependency Sets
  • Using Dependency Sets
  • Hierarchical Dependency Sets
  • Dependency Set Diagram
  • Common Patterns
  • Best Practices
  • See Also
• Variables
  • Overview
  • Declaring Variables
  • Referencing Variables
  • Overriding Variables
  • Examples
• Package Types & Sources
  • Understanding Package Attributes
  • Source Types
  • Package Types
  • Auto-Detection
  • Common Dependency Patterns
  • Complete Reference
  • See Also
• Caching
  • Overview
  • Cache Modes
  • Configuration
  • Cache Organization
  • Package Caching
  • Cache Management
  • Practical Examples
  • When to Use Caching
  • Performance Tips
  • Command Reference
  • See Also
• Package Lock File
  • Overview
  • Key Properties
  • Lock File Format
  • Change Detection
  • Reproduction Mode
  • CI/CD Reproducibility Pattern
  • Syncing and the Lock File
  • Python Package Version Locking
  • Format Versioning
  • See Also
• Python Package Management
  • Overview
  • Virtual Environment Creation
  • Configuring the Python Handler
  • Editable vs Binary Packages
  • Controlling Package-Level Options with type:
  • PyPI Package Configuration
  • Importing Dependencies from pyproject.toml
  • Source Packages
  • Setup Dependencies
  • Building Native Extensions
  • Using the Virtual Environment
  • Complete Examples
  • Best Practices
  • See Also
• Node.js Package Management
  • Overview
  • Node Environment Structure
  • Configuring the Node Handler
  • npm Registry Packages (src: npm)
  • Importing deps from an Existing package.json (src: package.json)
  • Source Package Linking (type: node)
  • Generated packages/node/package.json
  • Environment Activation
  • Node Version Management
  • Lockfile Recommendations
  • Complete Examples
  • Best Practices
  • See Also
• GitHub Releases
  • Overview
  • Basic Usage
  • Version Selection
  • Pre-release Handling
  • Platform Selection
  • Source Fallback
  • Complete Examples
  • Best Practices
  • Advanced Configuration
  • See Also
• Environment & Paths
  • Overview
  • Environment Variables
  • Project Paths
  • Practical Examples
  • Best Practices
  • See Also
• Development Workflows
  • Overview
  • Project Lifecycle
  • Working with Dependencies
  • Daily Development
  • Working with Editable Packages
  • Git Package Management
  • Building and Testing
  • Release Workflows
  • Team Workflows
  • Common Scenarios
  • Best Practices
  • See Also
• Git Integration
  • Overview
  • Clone Options
  • Version Selection
  • Clone Depth
  • Git Submodules
  • Status Command
  • Sync Command
  • Complete Git Workflows
  • Integration with Git Hooks
  • Advanced Patterns
  • Best Practices
  • Troubleshooting
  • See Also
• Inspecting Dependencies (show deps)
  • Flat table (default)
  • Dependency tree
  • Single-package detail
  • Machine-readable JSON
  • Selecting a dep-set
  • Inspecting another project
  • When the lock file is absent
• Integrations
  • Overview
  • CMake Integration
  • VSCode Integration
  • CI/CD Integration
  • Docker Integration
  • Make Integration
  • FuseSoC Integration
  • Pre-commit Hooks
  • Continuous Deployment
  • Best Practices
  • See Also
• Writing Custom Handlers
  • Overview
  • The PackageHandler Base Class
  • Conditions
  • Thread Safety
  • Progress Reporting
  • Fatal Errors
  • Registering a Handler via Entry Points
  • Complete Example
  • Handler Ordering
  • Testing Your Handler
  • See Also
• Troubleshooting
  • Common Issues and Solutions
  • Diagnostic Tools
  • Common Error Messages
  • Getting Help
  • Prevention Tips
  • See Also
• Reference
  • Commands
  • Command Details
  • Global Options
  • Environment Variables
  • YAML File Format
  • Common Patterns
  • See Also

Indices and tables

• Index

• Module Index

• Search Page