Initial commit

Author: mosi-sol

README.md

@@ -0,0 +1,278 @@
+# pyp - C++ Virtual Environment Manager
+
+<p align="center">
+  <img src="https://img.shields.io/badge/C%2B%2B-17-blue.svg" alt="C++17">
+  <img src="https://img.shields.io/badge/Version-2.0.0-green.svg" alt="Version">
+  <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License">
+  <img src="https://img.shields.io/badge/Platforms-Linux%20%7C%20macOS%20%7C-Windows-lightgrey.svg" alt="Platforms">
+</p>
+
+<p align="center">
+  <strong>A lightweight, high-performance Python virtual environment manager built in C++</strong>
+</p>
+
+---
+
+## 🌟 Features
+
+- **Blazing Fast** - Written in C++ for instant startup and minimal memory usage
+- **Zero Dependencies** - Built with only standard C++ libraries (no external dependencies)
+- **Cross-Platform** - Works on Linux, macOS, and Windows
+- **Beautiful Output** - Colorized terminal output for better readability
+- **User-Friendly** - Simple, intuitive commands
+- **Secure** - No Python runtime vulnerabilities, smaller attack surface
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Clone or download the source
+cd pyp-cpp
+
+# Make install script executable
+chmod +x install.sh
+
+# Run installation
+./install.sh
+
+# Restart your shell or source your config
+source ~/.bashrc  # or ~/.zshrc
+
+# Verify installation
+pyp --help
+```
+
+### Basic Usage
+
+```bash
+# Create a virtual environment
+pyp -b myenv
+
+# Create with specific Python version
+pyp -b myenv --python 3.11
+
+# Create with system site-packages
+pyp -b myenv --system-site-packages
+
+# Create and upgrade pip/setuptools
+pyp -b myenv --upgrade
+
+# Activate environment
+pyp -a myenv
+
+# List all environments
+pyp -l
+
+# Show environment info
+pyp -i myenv
+
+# Set default environment
+pyp --set-default myenv
+
+# Deactivate (run in shell)
+deactivate
+
+# Remove environment
+pyp --remove myenv
+```
+
+---
+
+## 📋 Command Reference
+
+| Command | Description |
+|---------|-------------|
+| `pyp -b <name>` | Create a new virtual environment |
+| `pyp -a <name>` | Activate a virtual environment |
+| `pyp -d` | Deactivate current environment |
+| `pyp -l` | List all environments |
+| `pyp -i <name>` | Show environment information |
+| `pyp --set-default <name>` | Set default environment |
+| `pyp --remove <name>` | Remove an environment |
+| `pyp --help` | Show help message |
+| `pyp --version` | Show version information |
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--python VERSION` | Python version (e.g., `3.11`) |
+| `--system-site-packages` | Include system site-packages |
+| `--upgrade` | Upgrade pip and setuptools after creation |
+
+---
+
+## 🏗️ Installation Options
+
+### Default Installation
+
+```bash
+./install.sh
+```
+
+- Installs to `~/.local/bin`
+- Automatically configures PATH
+- Creates backup of existing configuration
+
+### Custom Installation Directory
+
+```bash
+./install.sh --install-dir /usr/local/bin
+```
+
+### Skip PATH Configuration
+
+```bash
+./install.sh --no-path
+```
+
+### Force Reinstallation
+
+```bash
+./install.sh --force
+```
+
+---
+
+## 🗑️ Uninstallation
+
+### Standard Uninstallation
+
+```bash
+./uninstall.sh
+```
+
+### Keep Configuration
+
+```bash
+./uninstall.sh --keep-config
+```
+
+### Skip Confirmation
+
+```bash
+./uninstall.sh --force
+```
+
+---
+
+## 🔧 Technical Details
+
+### Compilation Requirements
+
+- **Compiler**: g++ or clang++
+- **Standard**: C++17 (for `<filesystem>` support)
+- **Flags**: `-std=c++17 -O2 -Wall -Wextra`
+
+### Built-in Libraries Used
+
+```cpp
+#include <iostream>      // Input/output streams
+#include <fstream>       // File operations
+#include <sstream>       // String streams
+#include <string>        // String manipulation
+#include <vector>        // Dynamic arrays
+#include <map>           // Key-value pairs
+#include <filesystem>    // File system operations (C++17)
+#include <cstdlib>       // System calls
+#include <chrono>        // Time operations
+```
+
+### Performance Comparison
+
+| Metric | Python Version | C++ Version |
+|--------|---------------|-------------|
+| Startup Time | ~50-100ms | ~1-5ms |
+| Memory Usage | ~10-20MB | ~1-5MB |
+| Dependencies | Python 3.6+ | None |
+
+---
+
+## 📁 Project Structure
+
+```
+pyp-cpp/
+├── main.cpp          # Main C++ source code
+├── install.sh        # Installation script
+├── uninstall.sh      # Uninstallation script
+├── test.sh          # Test script
+├── README.md        # This file
+└── LICENSE          # MIT License
+```
+
+---
+
+## 🐧 Platform-Specific Notes
+
+### Linux
+
+- Default install directory: `~/.local/bin`
+- Requires `g++` or `clang++`
+- Supports bash and zsh
+
+### macOS
+
+- Requires Xcode command line tools
+- Supports zsh (default shell on macOS 10.15+)
+- Uses BSD sed instead of GNU sed
+
+### Windows
+
+- Uses WSL or MinGW for compilation
+- Supports PowerShell and CMD
+- Binary: `pyp.exe`
+
+---
+
+## 📝 Configuration
+
+### Configuration File
+
+Location: `~/.pyp_config.json`
+
+```json
+{
+  "myenv": {
+    "path": "/home/user/projects/myenv",
+    "python": "/usr/bin/python3",
+    "created": "2024-01-01 12:00:00"
+  },
+  "default": {
+    "path": "/home/user/projects/myenv",
+    "python": "/usr/bin/python3"
+  }
+}
+```
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- Inspired by [mosi-sol/idea-factory/pyp-Secure_python_venv](https://github.com/mosi-sol/idea-factory/tree/main/pyp-Secure_python_venv) - **same creator**
+- Python Software Foundation for the venv module
+- C++ community for the excellent standard library
+
+---
+
+<p align="center">
+  LotusOS-Core , 2025-2026
+</p>