README.md

modenv

modenv is a Python CLI tool for managing layered virtual environments using .pth file linking. It allows multiple Python projects to share base environments while layering custom dependencies on top.

🚀 Features

• Share base dependencies across many projects
• Use .modenv to store layered config per Python version
• Link parents and children like an overlay filesystem
• Export/import setup using spec command
• Diagnose and fix broken links with doctor

📦 Install

See Installation Guide

🛠 Usage

modenv layer init
modenv layer parent add /path/to/base --name base --priority 1

📚 Docs

• Project Structure
• CLI Usage
• Commands Reference

🐍 Requirements

• Python >= 3.11
• tomli_w (installed automatically)

📜 License

MIT

Acknowledgments

Thanks ChatGPT for helping out with this.