k8s-helper-cli 0.1.2__tar.gz → 0.2.1__tar.gz

{k8s_helper_cli-0.1.2 → k8s_helper_cli-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: k8s-helper-cli
-Version: 0.1.2
+Version: 0.2.1
 Summary: A simplified Python wrapper for common Kubernetes operations
 Author-email: Harshit Chatterjee <harshitchatterjee50@gmail.com>
 License-Expression: MIT
@@ -14,6 +14,8 @@ Requires-Dist: kubernetes>=26.1.0
 Requires-Dist: typer>=0.9.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: pyyaml>=6.0
+Requires-Dist: boto3>=1.26.0
+Requires-Dist: botocore>=1.29.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
@@ -30,8 +32,13 @@ A simplified Python wrapper for common Kubernetes operations that makes it easy
 ## Features
 
 - ✅ **Pod Management**: Create, delete, and list pods
-- ✅ **Deployment Management**: Create, delete, scale, and list deployments
-- ✅ **Service Management**: Create, delete, and list services
+- ✅ **Deployment Management**: Create, delete, scale, and list deployments with init containers
+- ✅ **Service Management**: Create, delete, list services with URL retrieval
+- ✅ **AWS EKS Integration**: Create and manage EKS clusters with automatic configuration
+- ✅ **Secrets Management**: Create, list, and delete Kubernetes secrets
+- ✅ **Persistent Volume Claims**: Create, list, and delete PVCs with multiple access modes
+- ✅ **Service URL Discovery**: Get service URLs including AWS ELB DNS names
+- ✅ **Advanced Deployments**: Support for init containers, volume mounts, and complex configurations
 - ✅ **Resource Monitoring**: Get logs, events, and resource descriptions
 - ✅ **Easy Configuration**: Simple configuration management
 - ✅ **Formatted Output**: Beautiful table, YAML, and JSON output formats
@@ -60,6 +67,13 @@ pip install -e .
 
 **Important**: k8s-helper requires an active Kubernetes cluster connection. Without a properly configured kubectl and accessible cluster, the commands will fail with configuration errors.
 
+### AWS EKS Features Prerequisites
+
+For AWS EKS integration features:
+- AWS CLI configured with appropriate credentials (`aws configure`)
+- AWS IAM permissions for EKS, EC2, and IAM operations
+- boto3 package (automatically installed with k8s-helper-cli)
+
 ### Setting up Kubernetes (Choose one):
 
 1. **Local Development**: 
@@ -523,6 +537,9 @@ k8s-helper provides a command-line interface for Kubernetes operations. After in
 # Show help
 k8s-helper --help
 
+# Show version
+k8s-helper --version
+
 # Configure settings
 k8s-helper config --namespace my-namespace
 k8s-helper config --output-format yaml
@@ -699,6 +716,112 @@ k8s-helper --install-completion zsh
 k8s-helper --show-completion bash
 ```
 
+### AWS EKS Integration
+
+```bash
+# Create an EKS cluster
+k8s-helper create-eks-cluster my-cluster --region us-west-2 --version 1.29
+
+# Create EKS cluster with custom settings
+k8s-helper create-eks-cluster my-cluster \
+  --region us-east-1 \
+  --instance-types t3.medium,t3.large \
+  --min-size 2 \
+  --max-size 10 \
+  --desired-size 3 \
+  --node-group my-nodes \
+  --wait
+
+# Note: Requires AWS credentials configured (aws configure)
+```
+
+### Secrets Management
+
+```bash
+# Create a secret
+k8s-helper create-secret my-secret --data "username=admin,password=secret123"
+
+# Create a TLS secret
+k8s-helper create-secret tls-secret --data "tls.crt=cert_content,tls.key=key_content" --type kubernetes.io/tls
+
+# List secrets
+k8s-helper list-secrets --namespace my-namespace
+
+# Delete a secret
+k8s-helper delete-secret my-secret --namespace my-namespace
+```
+
+### Persistent Volume Claims (PVC)
+
+```bash
+# Create a PVC
+k8s-helper create-pvc my-storage 10Gi --access-modes ReadWriteOnce
+
+# Create PVC with specific storage class
+k8s-helper create-pvc my-storage 50Gi --storage-class fast-ssd --access-modes ReadWriteMany
+
+# List PVCs
+k8s-helper list-pvcs --namespace my-namespace
+
+# Delete a PVC
+k8s-helper delete-pvc my-storage --namespace my-namespace
+```
+
+### Service URL Retrieval
+
+```bash
+# Get service URL (including AWS ELB URLs)
+k8s-helper service-url my-service --namespace my-namespace
+
+# Watch for URL changes (useful for LoadBalancer provisioning)
+k8s-helper service-url my-service --watch --namespace my-namespace
+
+# Shows:
+# - ClusterIP access information
+# - NodePort URLs
+# - AWS ELB DNS names for LoadBalancer services
+# - External IPs and hostnames
+```
+
+### Enhanced Application Deployment
+
+```bash
+# Deploy with init container
+k8s-helper apply my-app nginx:latest \
+  --init-container "init-db:postgres:13:pg_isready -h db" \
+  --init-env "PGHOST=db,PGPORT=5432"
+
+# Deploy with PVC mount
+k8s-helper apply my-app nginx:latest \
+  --pvc "my-storage:/data" \
+  --replicas 2
+
+# Deploy with secret mount
+k8s-helper apply my-app nginx:latest \
+  --secret "my-secret:/etc/secrets" \
+  --port 8080
+
+# Deploy with LoadBalancer and show URL
+k8s-helper apply my-app nginx:latest \
+  --service-type LoadBalancer \
+  --wait \
+  --show-url
+
+# Complex deployment with multiple features
+k8s-helper apply my-app nginx:latest \
+  --replicas 3 \
+  --port 8080 \
+  --service-type LoadBalancer \
+  --env "ENV=production,DEBUG=false" \
+  --labels "app=my-app,version=v1.0" \
+  --init-container "migrate:migrate-tool:latest:migrate up" \
+  --init-env "DB_HOST=postgres,DB_PORT=5432" \
+  --secret "db-secret:/etc/db" \
+  --pvc "app-storage:/var/data" \
+  --wait \
+  --show-url
+```
+
 ## Real-World Examples
 
 ### 1. Simple Web Application

{k8s_helper_cli-0.1.2 → k8s_helper_cli-0.2.1}/README.md

@@ -5,8 +5,13 @@ A simplified Python wrapper for common Kubernetes operations that makes it easy
 ## Features
 
 - ✅ **Pod Management**: Create, delete, and list pods
-- ✅ **Deployment Management**: Create, delete, scale, and list deployments
-- ✅ **Service Management**: Create, delete, and list services
+- ✅ **Deployment Management**: Create, delete, scale, and list deployments with init containers
+- ✅ **Service Management**: Create, delete, list services with URL retrieval
+- ✅ **AWS EKS Integration**: Create and manage EKS clusters with automatic configuration
+- ✅ **Secrets Management**: Create, list, and delete Kubernetes secrets
+- ✅ **Persistent Volume Claims**: Create, list, and delete PVCs with multiple access modes
+- ✅ **Service URL Discovery**: Get service URLs including AWS ELB DNS names
+- ✅ **Advanced Deployments**: Support for init containers, volume mounts, and complex configurations
 - ✅ **Resource Monitoring**: Get logs, events, and resource descriptions
 - ✅ **Easy Configuration**: Simple configuration management
 - ✅ **Formatted Output**: Beautiful table, YAML, and JSON output formats
@@ -35,6 +40,13 @@ pip install -e .
 
 **Important**: k8s-helper requires an active Kubernetes cluster connection. Without a properly configured kubectl and accessible cluster, the commands will fail with configuration errors.
 
+### AWS EKS Features Prerequisites
+
+For AWS EKS integration features:
+- AWS CLI configured with appropriate credentials (`aws configure`)
+- AWS IAM permissions for EKS, EC2, and IAM operations
+- boto3 package (automatically installed with k8s-helper-cli)
+
 ### Setting up Kubernetes (Choose one):
 
 1. **Local Development**: 
@@ -498,6 +510,9 @@ k8s-helper provides a command-line interface for Kubernetes operations. After in
 # Show help
 k8s-helper --help
 
+# Show version
+k8s-helper --version
+
 # Configure settings
 k8s-helper config --namespace my-namespace
 k8s-helper config --output-format yaml
@@ -674,6 +689,112 @@ k8s-helper --install-completion zsh
 k8s-helper --show-completion bash
 ```
 
+### AWS EKS Integration
+
+```bash
+# Create an EKS cluster
+k8s-helper create-eks-cluster my-cluster --region us-west-2 --version 1.29
+
+# Create EKS cluster with custom settings
+k8s-helper create-eks-cluster my-cluster \
+  --region us-east-1 \
+  --instance-types t3.medium,t3.large \
+  --min-size 2 \
+  --max-size 10 \
+  --desired-size 3 \
+  --node-group my-nodes \
+  --wait
+
+# Note: Requires AWS credentials configured (aws configure)
+```
+
+### Secrets Management
+
+```bash
+# Create a secret
+k8s-helper create-secret my-secret --data "username=admin,password=secret123"
+
+# Create a TLS secret
+k8s-helper create-secret tls-secret --data "tls.crt=cert_content,tls.key=key_content" --type kubernetes.io/tls
+
+# List secrets
+k8s-helper list-secrets --namespace my-namespace
+
+# Delete a secret
+k8s-helper delete-secret my-secret --namespace my-namespace
+```
+
+### Persistent Volume Claims (PVC)
+
+```bash
+# Create a PVC
+k8s-helper create-pvc my-storage 10Gi --access-modes ReadWriteOnce
+
+# Create PVC with specific storage class
+k8s-helper create-pvc my-storage 50Gi --storage-class fast-ssd --access-modes ReadWriteMany
+
+# List PVCs
+k8s-helper list-pvcs --namespace my-namespace
+
+# Delete a PVC
+k8s-helper delete-pvc my-storage --namespace my-namespace
+```
+
+### Service URL Retrieval
+
+```bash
+# Get service URL (including AWS ELB URLs)
+k8s-helper service-url my-service --namespace my-namespace
+
+# Watch for URL changes (useful for LoadBalancer provisioning)
+k8s-helper service-url my-service --watch --namespace my-namespace
+
+# Shows:
+# - ClusterIP access information
+# - NodePort URLs
+# - AWS ELB DNS names for LoadBalancer services
+# - External IPs and hostnames
+```
+
+### Enhanced Application Deployment
+
+```bash
+# Deploy with init container
+k8s-helper apply my-app nginx:latest \
+  --init-container "init-db:postgres:13:pg_isready -h db" \
+  --init-env "PGHOST=db,PGPORT=5432"
+
+# Deploy with PVC mount
+k8s-helper apply my-app nginx:latest \
+  --pvc "my-storage:/data" \
+  --replicas 2
+
+# Deploy with secret mount
+k8s-helper apply my-app nginx:latest \
+  --secret "my-secret:/etc/secrets" \
+  --port 8080
+
+# Deploy with LoadBalancer and show URL
+k8s-helper apply my-app nginx:latest \
+  --service-type LoadBalancer \
+  --wait \
+  --show-url
+
+# Complex deployment with multiple features
+k8s-helper apply my-app nginx:latest \
+  --replicas 3 \
+  --port 8080 \
+  --service-type LoadBalancer \
+  --env "ENV=production,DEBUG=false" \
+  --labels "app=my-app,version=v1.0" \
+  --init-container "migrate:migrate-tool:latest:migrate up" \
+  --init-env "DB_HOST=postgres,DB_PORT=5432" \
+  --secret "db-secret:/etc/db" \
+  --pvc "app-storage:/var/data" \
+  --wait \
+  --show-url
+```
+
 ## Real-World Examples
 
 ### 1. Simple Web Application

{k8s_helper_cli-0.1.2 → k8s_helper_cli-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "k8s-helper-cli"
-version = "0.1.2"
+version = "0.2.1"
 description = "A simplified Python wrapper for common Kubernetes operations"
 readme = "README.md"
 authors = [
@@ -12,7 +12,9 @@ dependencies = [
   "kubernetes>=26.1.0",
   "typer>=0.9.0",         # CLI support
   "rich>=13.0.0",         # Pretty terminal output
-  "pyyaml>=6.0"           # YAML handling
+  "pyyaml>=6.0",          # YAML handling
+  "boto3>=1.26.0",        # AWS SDK
+  "botocore>=1.29.0"      # AWS core
 ]
 
 [project.optional-dependencies]

{k8s_helper_cli-0.1.2 → k8s_helper_cli-0.2.1}/src/k8s_helper/__init__.py

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