🐍 Add comprehensive Python support with complete project isolation (#1)

✨ Features:
- Project-local virtual environments for complete isolation
- Automatic requirements.txt installation in isolated environments
- System Python protection (no global modifications)
- Cross-platform support (Linux, macOS, Windows)
- Environment variable management for project isolation

🔧 Implementation:
- New PythonTool with isolation methods in pkg/tools/python.go
- Project-specific venv creation in {project}/.mvx/venv/
- Automatic dependency installation from requirements files
- Environment setup with PYTHONPATH, VIRTUAL_ENV, etc.
- Integration with existing tool management system
- Command-line interface integration in cmd/tools.go

🧪 Testing:
- Comprehensive test suite for Python isolation features
- All existing tests continue to pass
- Cross-platform compatibility verified

📚 Documentation:
- Updated README with Python examples and configuration
- Comprehensive tools documentation with isolation best practices
- Website content updated with Python ecosystem section

🎯 Benefits:
- Zero cross-project contamination
- No system Python modifications
- Seamless project switching
- Automatic dependency management
- Complete environment isolation

Each project gets its own isolated Python environment in:
{project}/.mvx/venv/

Follows existing tool patterns while adding Python-specific
isolation features essential for Python development.

🔧 CI Fixes:
- Fixed Go code formatting with gofmt
- Restored mvx bootstrap script (was accidentally compiled binary)
- Improved venv storage from global to project-local design

Author: gnodet

.mvx/config.json5

@@ -20,38 +20,34 @@
     node: {
       version: "lts"
     },
+    python: {
+      version: "3.12"
+    },
     go: {
       version: "1.24.2"
     }
   },
 
   // Custom commands
   commands: {
-    build: {
-      description: "Build mvx binary with platform-optimized settings",
-      script: "go build -o mvx-binary .",
-      override: true
-    },
-
-    test: {
-      description: "Run all tests",
-      script: "go test -v ./...",
-      override: true
+    deps: {
+      description: "Download dependencies",
+      script: "go mod download && go mod tidy"
     },
 
-    "build-all": {
-      description: "Build for all platforms",
-      script: "./scripts/build-all.sh"
+    hello: {
+      description: "Say hello",
+      script: "echo Hello from mvx! && mvn -v"
     },
 
-    checksums: {
-      description: "Generate checksums for release binaries",
-      script: "./scripts/checksums.sh"
+    benchmark: {
+      description: "Run benchmarks",
+      script: "cd test && go test -bench=. -benchtime=3s ./..."
     },
 
-    clean: {
-      description: "Clean build artifacts",
-      script: "rm -f mvx-binary mvx-dev && rm -rf dist/ && rm -rf .mvx/local/ .mvx/tools/ .mvx/versions/",
+    build: {
+      description: "Build mvx binary with platform-optimized settings",
+      script: "go build -o mvx-binary .",
       override: true
     },
 
@@ -65,26 +61,17 @@
       script: "golangci-lint run"
     },
 
-    deps: {
-      description: "Download dependencies",
-      script: "go mod download && go mod tidy"
+    test: {
+      description: "Run all tests",
+      script: "go test -v ./...",
+      override: true
     },
 
     "test-integration": {
       description: "Run integration tests",
       script: "cd test && go test -v -timeout=5m ./..."
     },
 
-    benchmark: {
-      description: "Run benchmarks",
-      script: "cd test && go test -bench=. -benchtime=3s ./..."
-    },
-
-    hello: {
-      description: "Say hello",
-      script: "echo Hello from mvx! && mvn -v"
-    },
-
     "website build": {
       description: "Build the website using ROQ",
       script: "cd website && QUARKUS_ROQ_GENERATOR_BATCH=true mvn clean package quarkus\\:run --no-transfer-progress",
@@ -95,6 +82,22 @@
       description: "Serve the website using ROQ dev mode",
       script: "cd website && mvn quarkus\\:dev -Dquarkus.http.port=8081 --no-transfer-progress",
       override: true
+    },
+
+    "build-all": {
+      description: "Build for all platforms",
+      script: "./scripts/build-all.sh"
+    },
+
+    checksums: {
+      description: "Generate checksums for release binaries",
+      script: "./scripts/checksums.sh"
+    },
+
+    clean: {
+      description: "Clean build artifacts",
+      script: "rm -f mvx-binary mvx-dev && rm -rf dist/ && rm -rf .mvx/local/ .mvx/tools/ .mvx/versions/",
+      override: true
     }
   }
 }

README.md

@@ -347,6 +347,9 @@ The bootstrap scripts (`mvx` and `mvx.cmd`) are **shell/batch scripts** (not bin
 - [x] **Java Development Kit** - Multiple distributions (Temurin, GraalVM, Oracle, Corretto, Liberica, Zulu, Microsoft)
 - [x] **Apache Maven** - All versions (3.x, 4.x including pre-releases)
 - [x] **Maven Daemon (mvnd)** - High-performance Maven alternative
+- [x] **Node.js** - All LTS and current versions with npm/yarn support
+- [x] **Go** - All stable versions from golang.org
+- [x] **Python** - All stable versions (3.8+) with pip support
 - [x] Tool installation and caching
 - [x] Environment setup and PATH management
 - [x] Version resolution (latest, major.minor, exact versions)
@@ -363,7 +366,7 @@ The bootstrap scripts (`mvx` and `mvx.cmd`) are **shell/batch scripts** (not bin
 #### Extended Tool Support
 
 - [x] **Node.js and npm/yarn support** ✅ **IMPLEMENTED**
-- [ ] Python and pip/poetry support
+- [x] **Python and pip/poetry support** ✅ **IMPLEMENTED**
 - [ ] Custom tool definitions and installers
 
 #### Enhanced Commands
@@ -516,6 +519,14 @@ mvx supports both **JSON5** and **YAML** configuration formats, inspired by [Mav
     mvnd: {
       version: "1.0.2",
     },
+
+    // Python for scripting and automation (with project isolation)
+    python: {
+      version: "3.12",
+      options: {
+        requirements: "requirements.txt", // Auto-install project dependencies
+      },
+    },
   },
 
   environment: {
@@ -573,6 +584,12 @@ tools:
   mvnd:
     version: "1.0.2"
 
+  # Python for scripting and automation (with project isolation)
+  python:
+    version: "3.12"
+    options:
+      requirements: "requirements.txt"  # Auto-install project dependencies
+
 environment:
   # Increase memory for large builds
   JAVA_OPTS: "-Xmx2g -XX:+UseG1GC"
@@ -630,8 +647,8 @@ The bootstrap system is fully functional and provides:
 **Phase 2: Multi-Tool Support** ✅ **COMPLETED**
 
 - [x] Node.js and npm integration ✅ **IMPLEMENTED**
+- [x] Python and pip support ✅ **IMPLEMENTED**
 - [x] Security improvements (checksum verification) ✅ **IMPLEMENTED**
-- [ ] Python and pip support
 
 ## 🤝 Contributing
 

cmd/tools.go

@@ -169,6 +169,19 @@ func listTools() error {
 		}
 	}
 
+	// Python
+	printInfo("🐍 Python Programming Language")
+	if versions, err := registry.GetPythonVersions(); err == nil && len(versions) > 0 {
+		shown := versions
+		if len(versions) > 8 {
+			shown = versions[:8]
+		}
+		printInfo("  Versions: %s", strings.Join(shown, ", "))
+		if len(versions) > 8 {
+			printInfo("  ... and %d more", len(versions)-8)
+		}
+	}
+
 	printInfo("")
 
 	printInfo("Usage:")
@@ -177,13 +190,15 @@ func listTools() error {
 	printInfo("  mvx tools search mvnd        # Search Maven Daemon versions")
 	printInfo("  mvx tools search node        # Search Node.js versions")
 	printInfo("  mvx tools search go          # Search Go versions")
+	printInfo("  mvx tools search python      # Search Python versions")
 	printInfo("  mvx tools info java          # Show Java details")
 	printInfo("")
 	printInfo("Add tools to your project:")
 	printInfo("  mvx tools add java 21        # Add Java 21 (Temurin)")
 	printInfo("  mvx tools add java 17 zulu   # Add Java 17 (Azul Zulu)")
 	printInfo("  mvx tools add maven 4.0.0-rc-4  # Add Maven 4.0.0-rc-4")
 	printInfo("  mvx tools add node lts       # Add Node.js LTS")
+	printInfo("  mvx tools add python 3.12    # Add Python 3.12")
 	printInfo("  mvx tools add go 1.23.1      # Add Go 1.23.1")
 
 	return nil
@@ -209,6 +224,8 @@ func searchTool(toolName string, filters []string) error {
 		return searchNodeVersions(registry, filters)
 	case "go":
 		return searchGoVersions(registry, filters)
+	case "python":
+		return searchPythonVersions(registry, filters)
 	default:
 		return fmt.Errorf("unknown tool: %s", toolName)
 	}
@@ -497,6 +514,57 @@ func searchGoVersions(registry *tools.ToolRegistry, filters []string) error {
 	return nil
 }
 
+// searchPythonVersions searches for Python versions
+func searchPythonVersions(registry *tools.ToolRegistry, filters []string) error {
+	versions, err := registry.GetPythonVersions()
+	if err != nil {
+		return fmt.Errorf("failed to get Python versions: %w", err)
+	}
+
+	printInfo("🐍 Python Versions")
+	printInfo("")
+
+	// Group by major.minor version
+	majorVersions := make(map[string][]string)
+	for _, v := range versions {
+		parts := strings.Split(v, ".")
+		if len(parts) >= 2 {
+			major := parts[0] + "." + parts[1]
+			majorVersions[major] = append(majorVersions[major], v)
+		}
+	}
+
+	// Sort major versions
+	var majors []string
+	for major := range majorVersions {
+		majors = append(majors, major)
+	}
+	sort.Slice(majors, func(i, j int) bool { return majors[i] > majors[j] })
+
+	for _, major := range majors {
+		versions := majorVersions[major]
+		printInfo("Python %s.x:", major)
+		shown := versions
+		if len(versions) > 5 {
+			shown = versions[:5]
+		}
+		for _, v := range shown {
+			printInfo("  %s", v)
+		}
+		if len(versions) > 5 {
+			printInfo("  ... and %d more", len(versions)-5)
+		}
+		printInfo("")
+	}
+
+	printInfo("Usage examples:")
+	printInfo("  version: \"3.12\"         # Latest Python 3.12.x")
+	printInfo("  version: \"3.11\"         # Latest Python 3.11.x")
+	printInfo("  version: \"3.12.0\"       # Exact version")
+
+	return nil
+}
+
 // showToolInfo shows detailed information about a tool
 func showToolInfo(toolName string) error {
 	manager, err := tools.NewManager()
@@ -571,10 +639,10 @@ func addTool(toolName, version, distribution string) error {
 
 	// Validate that the tool exists
 	switch toolName {
-	case "java", "maven", "mvnd", "node", "go":
+	case "java", "maven", "mvnd", "node", "go", "python":
 		// Valid tools
 	default:
-		return fmt.Errorf("unknown tool: %s (supported: java, maven, mvnd, node, go)", toolName)
+		return fmt.Errorf("unknown tool: %s (supported: java, maven, mvnd, node, go, python)", toolName)
 	}
 
 	// Validate version exists for the tool
@@ -723,6 +791,22 @@ func validateToolVersion(registry *tools.ToolRegistry, toolName, version, distri
 		printInfo("🔍 Go %s - version will be resolved during installation", version)
 		return nil
 
+	case "python":
+		versions, err := registry.GetPythonVersions()
+		if err != nil {
+			return fmt.Errorf("failed to get Python versions: %w", err)
+		}
+
+		// Check if exact version exists
+		for _, v := range versions {
+			if v == version {
+				return nil
+			}
+		}
+
+		printInfo("🔍 Python %s - version will be resolved during installation", version)
+		return nil
+
 	default:
 		return fmt.Errorf("unknown tool: %s", toolName)
 	}

pkg/tools/manager.go

@@ -76,6 +76,7 @@ func NewManager() (*Manager, error) {
 	manager.RegisterTool(&MvndTool{manager: manager})
 	manager.RegisterTool(&NodeTool{manager: manager})
 	manager.RegisterTool(&GoTool{manager: manager})
+	manager.RegisterTool(&PythonTool{manager: manager})
 
 	return manager, nil
 }
@@ -352,6 +353,71 @@ func (m *Manager) SetupEnvironment(cfg *config.Config) (map[string]string, error
 			env["MAVEN_HOME"] = toolPath
 		case "node":
 			env["NODE_HOME"] = toolPath
+		case "python":
+			env["PYTHON_HOME"] = toolPath
+		}
+	}
+
+	return env, nil
+}
+
+// SetupProjectEnvironment sets up project-specific environment for tools like Python
+func (m *Manager) SetupProjectEnvironment(cfg *config.Config, projectPath string) (map[string]string, error) {
+	env := make(map[string]string)
+
+	// Copy base environment
+	baseEnv, err := m.SetupEnvironment(cfg)
+	if err != nil {
+		return nil, err
+	}
+	for key, value := range baseEnv {
+		env[key] = value
+	}
+
+	// Handle Python project-specific environment
+	if pythonConfig, exists := cfg.Tools["python"]; exists {
+		tool, err := m.GetTool("python")
+		if err != nil {
+			return env, nil // Skip if Python tool not available
+		}
+
+		pythonTool, ok := tool.(*PythonTool)
+		if !ok {
+			return env, nil // Skip if not a Python tool
+		}
+
+		// Create project virtual environment if it doesn't exist
+		if err := pythonTool.CreateProjectVenv(pythonConfig.Version, pythonConfig, projectPath); err != nil {
+			return nil, fmt.Errorf("failed to create Python virtual environment: %w", err)
+		}
+
+		// Get project-specific Python environment
+		pythonEnv, err := pythonTool.GetProjectEnvironment(pythonConfig.Version, pythonConfig, projectPath)
+		if err != nil {
+			return nil, fmt.Errorf("failed to get Python project environment: %w", err)
+		}
+
+		// Merge Python environment variables
+		for key, value := range pythonEnv {
+			env[key] = value
+		}
+
+		// Install requirements if specified
+		if requirementsFile, ok := pythonConfig.Options["requirements"]; ok {
+			if err := pythonTool.InstallProjectRequirements(pythonConfig.Version, pythonConfig, projectPath, requirementsFile); err != nil {
+				return nil, fmt.Errorf("failed to install Python requirements: %w", err)
+			}
+		} else {
+			// Try common requirements file names
+			for _, reqFile := range []string{"requirements.txt", "requirements.pip", "pyproject.toml"} {
+				if _, err := os.Stat(filepath.Join(projectPath, reqFile)); err == nil {
+					if err := pythonTool.InstallProjectRequirements(pythonConfig.Version, pythonConfig, projectPath, reqFile); err != nil {
+						// Don't fail if requirements installation fails, just warn
+						fmt.Printf("  ⚠️  Warning: failed to install requirements from %s: %v\n", reqFile, err)
+					}
+					break
+				}
+			}
 		}
 	}
 
@@ -375,6 +441,8 @@ func (m *Manager) resolveVersion(toolName string, toolConfig config.ToolConfig)
 		return m.registry.ResolveNodeVersion(toolConfig.Version)
 	case "go":
 		return m.registry.ResolveGoVersion(toolConfig.Version)
+	case "python":
+		return m.registry.ResolvePythonVersion(toolConfig.Version)
 	default:
 		// For unknown tools, return version as-is
 		return toolConfig.Version, nil