k8s-helper-cli 0.5.1__py3-none-any.whl → 0.5.3__py3-none-any.whl

k8s_helper/__init__.py

@@ -20,7 +20,7 @@ from .utils import (
     create_service_manifest
 )
 
-__version__ = "0.5.1"
+__version__ = "0.5.3"
 __author__ = "Harshit Chatterjee"
 __email__ = "harshitchatterjee50@gmail.com"
 

k8s_helper/cli.py

@@ -1898,7 +1898,7 @@ def setup_monitoring_stack(
     wait: bool = typer.Option(True, "--wait/--no-wait", help="Wait for deployments to be ready"),
     install_ingress: bool = typer.Option(False, "--install-ingress", help="Install ingress for external access")
 ):
-    """Deploy monitoring stack using official Helm charts (Prometheus + Grafana)"""
+    """Deploy monitoring stack using official Helm charts (auto-installs Helm if needed)"""
     
     # Validate service type
     valid_service_types = ["NodePort", "LoadBalancer", "ClusterIP"]
@@ -1911,6 +1911,7 @@ def setup_monitoring_stack(
     console.print(f"🔧 Grafana service type: {grafana_service_type}")
     console.print(f"💾 Prometheus storage: {prometheus_storage_size}")
     console.print(f"💾 Grafana storage: {grafana_storage_size}")
+    console.print(f"⚙️  Note: Helm will be automatically installed if not present")
     
     # Show what will be deployed
     console.print("\n📋 Components to deploy via Helm:")
@@ -1990,11 +1991,19 @@ def setup_monitoring_stack(
         else:
             console.print(f"❌ Failed to deploy Helm monitoring stack: {result.get('error', 'Unknown error')}")
             
+            # Show suggestion if provided
+            if result.get('suggestion'):
+                console.print(f"💡 {result['suggestion']}")
+            
             console.print("\n🛠️  Troubleshooting:")
-            console.print("   • Ensure Helm is installed: helm version")
-            console.print("   • Check cluster connectivity: kubectl get nodes")
-            console.print("   • Verify namespace permissions")
-            console.print(f"   • View Helm status: helm status -n {namespace} kube-prometheus-stack")
+            if 'Helm' in str(result.get('error', '')):
+                console.print("   • Helm installation failed - you may need to install manually")
+                console.print("   • Visit: https://helm.sh/docs/intro/install/")
+                console.print("   • Restart your terminal after installation")
+            else:
+                console.print("   • Check cluster connectivity: kubectl get nodes")
+                console.print("   • Verify namespace permissions")
+                console.print(f"   • View Helm status: helm status -n {namespace} kube-prometheus-stack")
     
     except Exception as e:
         console.print(f"❌ Error setting up Helm monitoring: {e}")
@@ -2098,5 +2107,58 @@ def delete_monitoring_stack(
         console.print(f"❌ Error deleting Helm monitoring: {e}")
 
 
+@app.command()
+def install_helm(
+    force: bool = typer.Option(False, "--force", help="Force reinstall even if Helm is already installed")
+):
+    """Install Helm automatically on your system"""
+    try:
+        client = K8sClient()
+        
+        # Check if Helm is already installed
+        if not force and client._check_helm_available():
+            console.print("✅ Helm is already installed on your system")
+            
+            import subprocess
+            try:
+                result = subprocess.run(['helm', 'version'], capture_output=True, text=True)
+                console.print(f"📋 Version: {result.stdout.strip()}")
+            except:
+                pass
+            
+            console.print("💡 Use --force to reinstall")
+            return
+        
+        console.print("🔧 Installing Helm automatically...")
+        
+        with console.status("Installing Helm..."):
+            result = client._install_helm_automatically()
+        
+        if result['success']:
+            console.print(f"✅ {result['message']}")
+            console.print(f"📦 Installation method: {result['method']}")
+            
+            # Test the installation
+            if client._check_helm_available():
+                console.print("✅ Helm installation verified successfully")
+                console.print("\n🚀 You can now use Helm-based monitoring commands:")
+                console.print("   • k8s-helper setup-monitoring-stack")
+                console.print("   • k8s-helper monitoring-stack-status")
+                console.print("   • k8s-helper delete-monitoring-stack")
+            else:
+                console.print("⚠️  Helm was installed but may not be in your PATH")
+                console.print("💡 You may need to restart your terminal")
+        else:
+            console.print(f"❌ Failed to install Helm: {result.get('error', 'Unknown error')}")
+            console.print("\n🛠️  Manual installation:")
+            console.print("   • Windows: choco install kubernetes-helm")
+            console.print("   • macOS: brew install helm")
+            console.print("   • Linux: curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash")
+            console.print("   • Visit: https://helm.sh/docs/intro/install/")
+    
+    except Exception as e:
+        console.print(f"❌ Error installing Helm: {e}")
+
+
 if __name__ == "__main__":
     app()

k8s_helper/core.py

@@ -1694,6 +1694,261 @@ class K8sClient:
         except (subprocess.TimeoutExpired, FileNotFoundError):
             return False
     
+    def _install_helm_automatically(self) -> Dict[str, Any]:
+        """Automatically install Helm based on the operating system"""
+        import subprocess
+        import platform
+        import os
+        import tempfile
+        import urllib.request
+        
+        result = {
+            'success': False,
+            'method': None,
+            'error': None,
+            'message': None
+        }
+        
+        system = platform.system().lower()
+        print(f"🔧 Attempting to install Helm on {system}...")
+        
+        try:
+            if system == 'windows':
+                # Try to install via Chocolatey first, then Scoop, then direct download
+                methods = [
+                    {
+                        'name': 'Chocolatey',
+                        'check_cmd': ['choco', '--version'],
+                        'install_cmd': ['choco', 'install', 'kubernetes-helm', '-y']
+                    },
+                    {
+                        'name': 'Scoop',
+                        'check_cmd': ['scoop', '--version'],
+                        'install_cmd': ['scoop', 'install', 'helm']
+                    }
+                ]
+                
+                for method in methods:
+                    try:
+                        # Check if package manager is available
+                        subprocess.run(method['check_cmd'], capture_output=True, check=True, timeout=10)
+                        print(f"📦 Installing Helm via {method['name']}...")
+                        
+                        # Install Helm
+                        install_result = subprocess.run(
+                            method['install_cmd'], 
+                            capture_output=True, 
+                            text=True, 
+                            timeout=300  # 5 minutes timeout
+                        )
+                        
+                        if install_result.returncode == 0:
+                            result['success'] = True
+                            result['method'] = method['name']
+                            result['message'] = f"Helm installed successfully via {method['name']}"
+                            print(f"✅ {result['message']}")
+                            return result
+                        else:
+                            print(f"⚠️  {method['name']} installation failed: {install_result.stderr}")
+                            
+                    except (subprocess.TimeoutExpired, subprocess.CalledProcessError, FileNotFoundError):
+                        print(f"⚠️  {method['name']} not available")
+                        continue
+                
+                # If package managers fail, try direct download
+                print("📦 Attempting direct download installation...")
+                result = self._install_helm_direct_download()
+                
+            elif system == 'linux':
+                # Try different Linux package managers and methods
+                methods = [
+                    {
+                        'name': 'Snap',
+                        'check_cmd': ['snap', '--version'],
+                        'install_cmd': ['sudo', 'snap', 'install', 'helm', '--classic']
+                    },
+                    {
+                        'name': 'Script',
+                        'script_url': 'https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3'
+                    }
+                ]
+                
+                # Try snap first
+                try:
+                    subprocess.run(['snap', '--version'], capture_output=True, check=True, timeout=10)
+                    print("📦 Installing Helm via Snap...")
+                    
+                    install_result = subprocess.run(
+                        ['sudo', 'snap', 'install', 'helm', '--classic'],
+                        capture_output=True,
+                        text=True,
+                        timeout=300
+                    )
+                    
+                    if install_result.returncode == 0:
+                        result['success'] = True
+                        result['method'] = 'Snap'
+                        result['message'] = "Helm installed successfully via Snap"
+                        print(f"✅ {result['message']}")
+                        return result
+                        
+                except (subprocess.TimeoutExpired, subprocess.CalledProcessError, FileNotFoundError):
+                    print("⚠️  Snap not available")
+                
+                # Try installation script
+                print("📦 Installing Helm via official installation script...")
+                try:
+                    script_result = subprocess.run([
+                        'bash', '-c', 
+                        'curl -fsSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash'
+                    ], capture_output=True, text=True, timeout=300)
+                    
+                    if script_result.returncode == 0:
+                        result['success'] = True
+                        result['method'] = 'Installation Script'
+                        result['message'] = "Helm installed successfully via installation script"
+                        print(f"✅ {result['message']}")
+                        return result
+                    else:
+                        print(f"⚠️  Script installation failed: {script_result.stderr}")
+                        
+                except (subprocess.TimeoutExpired, subprocess.CalledProcessError):
+                    print("⚠️  Script installation failed")
+                
+            elif system == 'darwin':  # macOS
+                # Try Homebrew
+                try:
+                    subprocess.run(['brew', '--version'], capture_output=True, check=True, timeout=10)
+                    print("📦 Installing Helm via Homebrew...")
+                    
+                    install_result = subprocess.run(
+                        ['brew', 'install', 'helm'],
+                        capture_output=True,
+                        text=True,
+                        timeout=300
+                    )
+                    
+                    if install_result.returncode == 0:
+                        result['success'] = True
+                        result['method'] = 'Homebrew'
+                        result['message'] = "Helm installed successfully via Homebrew"
+                        print(f"✅ {result['message']}")
+                        return result
+                        
+                except (subprocess.TimeoutExpired, subprocess.CalledProcessError, FileNotFoundError):
+                    print("⚠️  Homebrew not available, trying installation script...")
+                    
+                    # Fallback to installation script
+                    try:
+                        script_result = subprocess.run([
+                            'bash', '-c',
+                            'curl -fsSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash'
+                        ], capture_output=True, text=True, timeout=300)
+                        
+                        if script_result.returncode == 0:
+                            result['success'] = True
+                            result['method'] = 'Installation Script'
+                            result['message'] = "Helm installed successfully via installation script"
+                            print(f"✅ {result['message']}")
+                            return result
+                            
+                    except (subprocess.TimeoutExpired, subprocess.CalledProcessError):
+                        print("⚠️  Script installation failed")
+            
+            # If we reach here, all methods failed
+            result['error'] = f"Could not install Helm automatically on {system}"
+            print(f"❌ {result['error']}")
+            
+        except Exception as e:
+            result['error'] = f"Error during Helm installation: {str(e)}"
+            print(f"❌ {result['error']}")
+        
+        return result
+    
+    def _install_helm_direct_download(self) -> Dict[str, Any]:
+        """Install Helm via direct download (Windows fallback)"""
+        import subprocess
+        import tempfile
+        import zipfile
+        import urllib.request
+        import os
+        import platform
+        
+        result = {
+            'success': False,
+            'method': 'Direct Download',
+            'error': None,
+            'message': None
+        }
+        
+        try:
+            # Determine architecture
+            arch = platform.machine().lower()
+            if arch == 'amd64' or arch == 'x86_64':
+                arch = 'amd64'
+            elif arch == 'arm64':
+                arch = 'arm64'
+            else:
+                arch = 'amd64'  # Default fallback
+            
+            # Download URL for latest Helm
+            download_url = f"https://get.helm.sh/helm-v3.13.0-windows-{arch}.zip"
+            
+            with tempfile.TemporaryDirectory() as temp_dir:
+                zip_path = os.path.join(temp_dir, "helm.zip")
+                
+                print(f"📥 Downloading Helm from {download_url}...")
+                urllib.request.urlretrieve(download_url, zip_path)
+                
+                print("📦 Extracting Helm...")
+                with zipfile.ZipFile(zip_path, 'r') as zip_ref:
+                    zip_ref.extractall(temp_dir)
+                
+                # Find helm.exe
+                helm_exe = None
+                for root, dirs, files in os.walk(temp_dir):
+                    if 'helm.exe' in files:
+                        helm_exe = os.path.join(root, 'helm.exe')
+                        break
+                
+                if helm_exe:
+                    # Try to move to a directory in PATH
+                    target_locations = [
+                        os.path.expanduser("~/bin"),
+                        "C:\\Program Files\\Helm",
+                        os.path.join(os.environ.get('LOCALAPPDATA', ''), 'Microsoft', 'WindowsApps')
+                    ]
+                    
+                    for target_dir in target_locations:
+                        try:
+                            os.makedirs(target_dir, exist_ok=True)
+                            target_path = os.path.join(target_dir, 'helm.exe')
+                            
+                            import shutil
+                            shutil.copy2(helm_exe, target_path)
+                            
+                            # Test if it works
+                            test_result = subprocess.run([target_path, 'version'], 
+                                                       capture_output=True, timeout=10)
+                            if test_result.returncode == 0:
+                                result['success'] = True
+                                result['message'] = f"Helm installed to {target_path}"
+                                print(f"✅ {result['message']}")
+                                print(f"💡 Please add {target_dir} to your PATH if not already present")
+                                return result
+                                
+                        except (OSError, subprocess.TimeoutExpired):
+                            continue
+                    
+                    result['error'] = "Downloaded Helm but could not install to PATH"
+                else:
+                    result['error'] = "Could not find helm.exe in downloaded archive"
+                    
+        except Exception as e:
+            result['error'] = f"Direct download failed: {str(e)}"
+        
+        return result
+    
     def _install_kube_state_metrics(self, namespace: str) -> Dict[str, Any]:
         """Install kube-state-metrics using Helm if available, or manual YAML if not"""
         import subprocess
@@ -3100,14 +3355,29 @@ scrape_configs:
         import os
         
         try:
-            # Check if Helm is available
-            try:
-                result = subprocess.run(['helm', 'version'], capture_output=True, text=True, check=True)
-            except (subprocess.CalledProcessError, FileNotFoundError):
-                return {
-                    'success': False,
-                    'error': 'Helm is not installed or not in PATH. Please install Helm first.'
-                }
+            # Check if Helm is available, and install if not
+            if not self._check_helm_available():
+                print("🔧 Helm not found. Attempting automatic installation...")
+                install_result = self._install_helm_automatically()
+                
+                if not install_result['success']:
+                    return {
+                        'success': False,
+                        'error': f"Helm is required but could not be installed automatically. {install_result.get('error', '')}",
+                        'suggestion': 'Please install Helm manually: https://helm.sh/docs/intro/install/'
+                    }
+                else:
+                    print(f"✅ {install_result['message']}")
+                    
+                    # Verify installation worked
+                    if not self._check_helm_available():
+                        return {
+                            'success': False,
+                            'error': 'Helm was installed but is not accessible. You may need to restart your terminal or add Helm to your PATH.',
+                            'suggestion': 'Please restart your terminal and try again, or install Helm manually.'
+                        }
+            
+            print("✅ Helm is available")
             
             # Create namespace if it doesn't exist
             try:
@@ -3127,14 +3397,14 @@ scrape_configs:
                 subprocess.run([
                     'helm', 'repo', 'add', 'prometheus-community', 
                     'https://prometheus-community.github.io/helm-charts'
-                ], check=True, capture_output=True)
+                ], check=True, capture_output=True, text=True)
                 
-                subprocess.run(['helm', 'repo', 'update'], check=True, capture_output=True)
+                subprocess.run(['helm', 'repo', 'update'], check=True, capture_output=True, text=True)
                 print("✅ Helm repository added and updated")
             except subprocess.CalledProcessError as e:
                 return {
                     'success': False,
-                    'error': f'Failed to add Helm repository: {e.stderr.decode() if e.stderr else str(e)}'
+                    'error': f'Failed to add Helm repository: {e.stderr if e.stderr else str(e)}'
                 }
             
             # Create Helm values file
@@ -3303,7 +3573,7 @@ scrape_configs:
                 os.unlink(values_file)
                 
         except subprocess.CalledProcessError as e:
-            error_msg = e.stderr.decode() if e.stderr else str(e)
+            error_msg = e.stderr if e.stderr else str(e)
             return {
                 'success': False,
                 'error': f'Helm installation failed: {error_msg}'
@@ -3408,7 +3678,7 @@ scrape_configs:
             }
             
         except subprocess.CalledProcessError as e:
-            error_msg = e.stderr.decode() if e.stderr else str(e)
+            error_msg = e.stderr if e.stderr else str(e)
             return {
                 'success': False,
                 'error': f'Failed to uninstall Helm release: {error_msg}'

{k8s_helper_cli-0.5.1.dist-info → k8s_helper_cli-0.5.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: k8s-helper-cli
-Version: 0.5.1
+Version: 0.5.3
 Summary: A simplified Python wrapper for common Kubernetes operations
 Author-email: Harshit Chatterjee <harshitchatterjee50@gmail.com>
 License-Expression: MIT

k8s_helper_cli-0.5.3.dist-info/RECORD

@@ -0,0 +1,11 @@
+k8s_helper/__init__.py,sha256=3GNylm6r22pm4iWnjRfi_QLWcPBP9GL0NqZSTtFnLdc,2666
+k8s_helper/cli.py,sha256=3eP3J7srPIM0bm_G5RxdU_RvtDwJHLX2xBguF2EmXtk,95115
+k8s_helper/config.py,sha256=P7YdfyvCHprrNs2J9DRb3RrClylfTTh5hfTtDzLug0A,6867
+k8s_helper/core.py,sha256=0a4juGOteVZ3xwPqhq8vA3Dai63El1nCHo4D9tt7UMM,160443
+k8s_helper/utils.py,sha256=wYgTd5ktyuI-EiVcfW7FrxA7MzXY5odrEKQgmMVdueY,9496
+k8s_helper_cli-0.5.3.dist-info/licenses/LICENSE,sha256=tXPvVl3gLVc6e0qCEoLH9KjeA7z4JVL78UybpvGtBCw,1096
+k8s_helper_cli-0.5.3.dist-info/METADATA,sha256=K-zPIghmapn0gBpCr0AAxR3Uulbu1ww3z_xxTbNIKEo,30789
+k8s_helper_cli-0.5.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+k8s_helper_cli-0.5.3.dist-info/entry_points.txt,sha256=IoCMWUZ6mn90LwzQzEy5YkWOwvogDdZ6ycqUWAzCFTQ,50
+k8s_helper_cli-0.5.3.dist-info/top_level.txt,sha256=x9A1jflyer-z2cFnkqk5B42juoH2q0fy5hkT9upsTG8,11
+k8s_helper_cli-0.5.3.dist-info/RECORD,,

k8s_helper_cli-0.5.1.dist-info/RECORD

@@ -1,11 +0,0 @@
-k8s_helper/__init__.py,sha256=Rm3LMlyreNv628XF3jVu7wszfxHHL0JWZKzmHFmq_D0,2666
-k8s_helper/cli.py,sha256=U4oPgjykRmkBvPli7jZLVvZrb13L6-wjV0hd-RQZN9g,92124
-k8s_helper/config.py,sha256=P7YdfyvCHprrNs2J9DRb3RrClylfTTh5hfTtDzLug0A,6867
-k8s_helper/core.py,sha256=P6nvVPuW44Jdvkm572__d4nycLin6cl8obZ-XqzuTY4,147614
-k8s_helper/utils.py,sha256=wYgTd5ktyuI-EiVcfW7FrxA7MzXY5odrEKQgmMVdueY,9496
-k8s_helper_cli-0.5.1.dist-info/licenses/LICENSE,sha256=tXPvVl3gLVc6e0qCEoLH9KjeA7z4JVL78UybpvGtBCw,1096
-k8s_helper_cli-0.5.1.dist-info/METADATA,sha256=Z2Il7mbkN4p29oc_83mIjxD3l13IPTihkzo5d0JPIT4,30789
-k8s_helper_cli-0.5.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-k8s_helper_cli-0.5.1.dist-info/entry_points.txt,sha256=IoCMWUZ6mn90LwzQzEy5YkWOwvogDdZ6ycqUWAzCFTQ,50
-k8s_helper_cli-0.5.1.dist-info/top_level.txt,sha256=x9A1jflyer-z2cFnkqk5B42juoH2q0fy5hkT9upsTG8,11
-k8s_helper_cli-0.5.1.dist-info/RECORD,,