VNMA Documentation

Version: 0.3.2 (Beta) Runtime: CPython 3.11+ · Windows and Linux

Welcome to the official English documentation for VNMA, a dependency and vendoring manager that installs packages into a local project directory (vendor/) instead of creating virtual environments.

Documentation Index

01. Use

Installing VNMA, managing dependencies, configuring projects and packages, and running code.

• 01. Getting Started — Installing VNMA, initializing a project, and the first install.
• 02. Dependency Management — Installing from PyPI, local paths, and Git; updating, pruning, offline mode, and live links.
• 03. Configuration Specifications — Schema of vnma.toml and vnma_config.toml, and configuration precedence.
• 04. Runtime Execution — vnma run, hermetic loading, DLL registration, and vnma exec.
• 05. IDE Integration — VS Code and PyCharm configuration.
• 06. Nested Dependencies — Packages that depend on other packages, shared dependencies, and install order.
• 07. Entry Points Without vnma run — Running a script or CLI with plain python using vnma insert-import.

02. Advice

Stability, limitations, and direction of the project.

• 01. Beta Status — What has been validated and how to use VNMA during beta.
• 02. Known Limitations — Constraints that come from Python's runtime model and the current implementation.
• 03. Future Roadmap — Recently implemented work and planned enhancements.
• 04. Community Vision — Where VNMA fits and where it does not.

Changelog

Versioned release notes, one file per version.