🚀 Announcing Pythonaibrain-Warden (v0.1.0): Industrial-Grade, npm-Inspired Package & Environment Manager for Python

I am excited to announce the official release of warden (pythonaibrain-warden v0.1.1)!

Python package management often forces developers to choose between low-level speed and high-level reproducibility. I built warden to bridge this gap by introducing an npm-inspired workflow centered on a deterministic lockfile architecture, native virtual environment isolation, and hard offline build guarantees.

🌟 Why I Built warden

• 🔐 Deterministic Lockfile Enforcement (warden.lock): warden locks exact artifact URLs and SHA-256 hashes. Every installation executes via pip install <exact-artifact> --no-deps, preventing pip’s resolver from silently substituting different package versions.

• 🔌 Thin CLI over Core API Architecture: I designed every CLI subcommand as a light wrapper around warden.core. Whether called from terminal scripts, unit tests, or programmatically via import warden.core as core, execution behavior remains identical.

• 🛠️ Warden-Native Environments & Absolute Paths: warden wenv constructs standard CPython virtual environments natively. Subprocess calls resolve executables to absolute paths inside the active environment (resolve_executable), eliminating cross-platform PATH resolution bugs on Windows.

• 🎯 Per-File Dependency Targets: Need to run two files with mutually exclusive package requirements in the same repository? warden target set provisions isolated sub-environments (.warden/venvs/target-<slug>/) and dedicated lockfiles, allowing scripts like numpy==1.24.0 and numpy==1.26.4 to live side-by-side.

• 🏷️ Platform Wheel Selection: Artifact resolution ranks PyPI binaries against packaging.tags.sys_tags(), preventing platform mismatch errors on C-extension wheels.

• 🛑 fix vs. install Separation: warden fix repairs installed-vs-locked environment drift without ever modifying project requirements in warden.toml or warden.lock.

• 📦 Self-Contained Offline Bundling (.warden.wheel): warden build packages project source code, manifests, locked dependencies, and build-system tools (setuptools/wheel) into zero-network archives.

• 🚦 CI Reproducibility Gate (warden verify): Runs deep validation across manifests, lockfile consistency, SHA-256 digests, and active environment states with stable non-zero exit codes on failure.

⚡ Quick Start

# Install warden from PyPI
pip install pythonaibrain-warden==0.1.1

# Initialize a new project layout
warden init myapp
cd myapp

# Add dependencies & sync active environment
warden install requests
warden install "[email protected]"

# Execute project entry point or verify reproducibility
warden run
warden verify

Enter fullscreen mode Exit fullscreen mode

📋 Command Summary

Category Commands Dependencies install • update • uninstall • lock
Environments wenv • use • fix
Execution run • run-file • exec • target
Quality & Audit verify • show • clean • cache
Bundles & Deploy build • install-wheel • backup • restore • publish

🌐 Links & Resources

• PyPI Release: pythonaibrain-warden 0.1.1

• GitHub Repository: DivyanshuSinha136/Pythonaibrain-Warden