vm-tool 1.0.29__tar.gz → 1.0.32__tar.gz

vm_tool-1.0.32/.devcontainer/devcontainer.json

@@ -0,0 +1,18 @@
+{
+	"name": "VM Tool Dev",
+	"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
+	"features": {
+		"ghcr.io/devcontainers/features/docker-outside-of-docker:1": {}
+	},
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"ms-python.python",
+				"ms-python.flake8",
+				"charliermarsh.ruff",
+				"redhat.ansible"
+			]
+		}
+	},
+	"postCreateCommand": "pip install -e .[dev] && pip install pre-commit && pre-commit install"
+}

vm_tool-1.0.32/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      dependencies:
+        patterns:
+          - "*"
+  
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      dependencies:
+        patterns:
+          - "*"

vm_tool-1.0.32/.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: CI
+
+on:
+    push:
+        branches: [main]
+    pull_request:
+        branches: [main]
+
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        strategy:
+            matrix:
+                python-version: ["3.10", "3.11", "3.12"]
+
+        steps:
+            - uses: actions/checkout@v6
+
+            - name: Set up Python ${{ matrix.python-version }}
+              uses: actions/setup-python@v6
+              with:
+                  python-version: ${{ matrix.python-version }}
+
+            - name: Install dependencies
+              run: |
+                  python -m pip install --upgrade pip
+                  pip install flake8 pytest
+                  if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+                  pip install -e .[dev]
+
+            - name: Lint with flake8
+              run: |
+                  # stop the build if there are Python syntax errors or undefined names
+                  flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+                  # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+                  flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+            - name: Test with pytest
+              run: |
+                  pytest
+
+    security:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v6
+
+            - name: Set up Python
+              uses: actions/setup-python@v6
+              with:
+                  python-version: "3.12"
+
+            - name: Install Bandit
+              run: pip install bandit
+
+            - name: Run Bandit Scan
+              # -r: recursive, -ll: log level (only high/medium), -ii: confidence level
+              run: bandit -r vm_tool -ll -ii

vm_tool-1.0.32/.github/workflows/deploy.yml

@@ -0,0 +1,207 @@
+name: Deploy to EC2 with vm_tool
+
+on:
+  push:
+    branches: [ develop ]
+  pull_request:
+    branches: [ develop ]
+  workflow_dispatch:
+
+env:
+  EC2_HOST: ${{ secrets.EC2_HOST }}
+  EC2_USER: ${{ secrets.EC2_USER }}
+  APP_PORT: 8000
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Validate Required Secrets
+        run: |
+          echo "🔐 Validating GitHub Secrets..."
+          MISSING_SECRETS=()
+          
+          if [ -z "${{ secrets.EC2_HOST }}" ]; then
+            MISSING_SECRETS+=("EC2_HOST")
+          fi
+          
+          if [ -z "${{ secrets.EC2_USER }}" ]; then
+            MISSING_SECRETS+=("EC2_USER")
+          fi
+          
+          if [ -z "${{ secrets.EC2_SSH_KEY }}" ]; then
+            MISSING_SECRETS+=("EC2_SSH_KEY")
+          fi
+          
+          if [ ${#MISSING_SECRETS[@]} -ne 0 ]; then
+            echo ""
+            echo "❌ ERROR: Missing required GitHub Secrets!"
+            echo ""
+            echo "Missing: ${MISSING_SECRETS[*]}"
+            echo ""
+            echo "📝 How to add secrets:"
+            echo "1. Go to: Repository → Settings → Secrets → Actions"
+            echo "2. Add each secret:"
+            echo ""
+            
+            if [[ " ${MISSING_SECRETS[*]} " =~ " EC2_HOST " ]]; then
+              echo "   EC2_HOST: Your EC2 IP (e.g., 54.123.45.67)"
+            fi
+            
+            if [[ " ${MISSING_SECRETS[*]} " =~ " EC2_USER " ]]; then
+              echo "   EC2_USER: SSH username (e.g., ubuntu)"
+            fi
+            
+            if [[ " ${MISSING_SECRETS[*]} " =~ " EC2_SSH_KEY " ]]; then
+              echo "   EC2_SSH_KEY: Run 'cat ~/.ssh/id_rsa' and copy output"
+            fi
+            
+            echo ""
+            echo "📚 See: docs/ssh-key-setup.md"
+            exit 1
+          fi
+          
+          echo "✅ All secrets configured"
+
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '{self.python_version}'
+
+      - name: Install vm_tool
+        run: pip install vm-tool
+
+      - name: Lint with flake8
+        run: |
+          pip install flake8
+          # stop the build if there are Python syntax errors or undefined names
+          flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+          # exit-zero treats all errors as warnings.
+          flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+      - name: Test with pytest
+        run: |
+          pip install pytest
+          pytest
+
+      - name: Set up SSH
+        run: |
+          mkdir -p ~/.ssh
+          echo "${{ secrets.EC2_SSH_KEY }}" > ~/.ssh/deploy_key
+          chmod 600 ~/.ssh/deploy_key
+          ssh-keyscan -H ${{ secrets.EC2_HOST }} >> ~/.ssh/known_hosts
+
+      - name: Validate SSH Connection
+        run: |
+          echo "✅ Testing SSH connection..."
+          ssh -i ~/.ssh/deploy_key -o StrictHostKeyChecking=no \
+            ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} "echo 'Connected'" || {
+            echo "❌ SSH failed! Check docs/ssh-key-setup.md"
+            exit 1
+          }
+
+      - name: Copy docker-compose to EC2
+        run: |
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} \
+            'mkdir -p ~/app'
+          
+          scp -i ~/.ssh/deploy_key docker-compose.yml \
+            ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }}:~/app/
+          
+          # Copy any .env files if they exist
+          if [ -f .env.production ]; then
+            scp -i ~/.ssh/deploy_key .env.production \
+              ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }}:~/app/.env
+          fi
+
+      - name: Create backup
+        run: |
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            mkdir -p ~/backups
+            if [ -d ~/app ]; then
+              tar -czf ~/backups/backup-$(date +%Y%m%d-%H%M%S).tar.gz -C ~/app . 2>/dev/null || true
+              echo "✅ Backup created"
+            fi
+          EOF
+
+      - name: Dry-run
+        run: |
+          echo "🔍 DRY-RUN: Previewing deployment"
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            cd ~/app && docker-compose config
+          EOF
+
+      - name: Deploy with vm_tool (Ansible-based)
+        run: |
+          # Create inventory file for Ansible
+          cat > inventory.yml << EOF
+          all:
+            hosts:
+              production:
+                ansible_host: ${{ secrets.EC2_HOST }}
+                ansible_user: ${{ secrets.EC2_USER }}
+                ansible_ssh_private_key_file: ~/.ssh/deploy_key
+          EOF
+          
+          # Deploy using vm_tool (uses Ansible under the hood)
+          vm_tool deploy-docker \
+            --host ${{ secrets.EC2_HOST }} \
+            --user ${{ secrets.EC2_USER }} \
+            --compose-file ~/app/docker-compose.yml \
+            --inventory inventory.yml \
+            --force
+
+      - name: Health check
+        run: |
+          for i in {{1..30}}; do
+            if curl -f http://${{ secrets.EC2_HOST }}:8000/health 2>/dev/null; then
+              echo "✅ Health check passed"
+              exit 0
+            fi
+            sleep 2
+          done
+          echo "❌ Health check failed"
+          exit 1
+
+      - name: Verify
+        run: |
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            cd ~/app
+            docker-compose ps
+            docker-compose logs --tail=20
+          EOF
+
+      - name: Rollback on failure
+        if: failure()
+        run: |
+          echo "⚠️  Rolling back..."
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            BACKUP=$(ls -t ~/backups/*.tar.gz 2>/dev/null | head -1)
+            if [ -n "$BACKUP" ]; then
+              cd ~/app && tar -xzf $BACKUP
+              docker-compose up -d
+              echo "✅ Rolled back"
+            fi
+          EOF
+
+      - name: Cleanup
+        if: success()
+        run: |
+          ssh -i ~/.ssh/deploy_key ${{ secrets.EC2_USER }}@${{ secrets.EC2_HOST }} << 'EOF'
+            cd ~/backups 2>/dev/null || exit 0
+            ls -t *.tar.gz 2>/dev/null | tail -n +6 | xargs rm -f || true
+          EOF
+
+      - name: Notify
+        if: always()
+        run: |
+          if [ "${{ job.status }}" == "success" ]; then
+            echo "✅ Deployed to ${{ secrets.EC2_HOST }}:${{ env.APP_PORT }}"
+          else
+            echo "❌ Deployment failed"
+          fi

vm_tool-1.0.32/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-n-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/vm-tool
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

vm_tool-1.0.32/.gitignore

@@ -0,0 +1,35 @@
+# Project-specific files
+project/
+
+# Virtual environments
+venv/
+.env/
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+
+# Python-specific files
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+
+# Jupyter Notebook checkpoints
+.ipynb_checkpoints/
+
+# Logs
+*.log
+
+# OS-specific files
+.DS_Store
+Thumbs.db
+
+# IDE-specific files
+.vscode/
+.idea/
+*.sublime-project
+*.sublime-workspace
+
+dynamic_inventory.yml

vm_tool-1.0.32/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+    -   id: trailing-whitespace
+    -   id: end-of-file-fixer
+    -   id: check-yaml
+    -   id: check-added-large-files
+
+-   repo: https://github.com/pycqa/flake8
+    rev: 7.0.0
+    hooks:
+    -   id: flake8
+        args: [--max-line-length=127]

vm_tool-1.0.32/CONTRIBUTING

@@ -0,0 +1,57 @@
+## Initial Setup of the Application
+
+1. **Connect to the deployment machine using VSCode.**
+   - Open VSCode.
+   - Use the SSH extension to connect to your deployment machine.
+
+2. **Install the package and its dependencies:**
+   ```bash
+   pip install .
+   ```
+
+3. **Raise a Pull Request (PR):**
+   - Ensure the issue you are addressing is resolved.
+   - Write a clear and concise description of the changes made in the PR.
+
+---
+
+## Contributing Guidelines
+
+We welcome contributions to improve this tool! Here are the steps to contribute:
+
+1. **Fork the repository:**
+   - Navigate to the repository and click the "Fork" button.
+
+2. **Clone your fork:**
+   ```bash
+   git clone https://github.com/thesunnysinha/vm_tool.git
+   cd vm-tool
+   ```
+
+3. **Create a new branch:**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+4. **Make changes:**
+   - Ensure your code follows best practices.
+   - Test your changes locally before committing.
+
+5. **Commit and push your changes:**
+   ```bash
+   git add .
+   git commit -m "Add description of changes"
+   git push origin feature/your-feature-name
+   ```
+
+6. **Submit a PR:**
+   - Go to the original repository and click "New Pull Request."
+   - Provide a detailed description of your changes, including the issue it resolves.
+
+7. **Review process:**
+   - Wait for maintainers to review your PR.
+   - Address any feedback promptly.
+
+---
+
+Thank you for contributing to the VM Setup Tool!

vm_tool-1.0.32/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Contributing to VM Tool
+
+## Code Organization
+
+VM Tool follows a modular architecture with clear separation of concerns:
+
+- `vm_tool/core/` - Core infrastructure (config, state, history)
+- `vm_tool/strategies/` - Deployment strategies (blue-green, canary, A/B)
+- `vm_tool/operations/` - Operations (metrics, alerting, reporting)
+- `vm_tool/enterprise/` - Enterprise features (RBAC, audit, policy)
+- `vm_tool/integrations/` - External integrations (webhooks, notifications)
+
+## Adding Features
+
+1. Determine the appropriate module directory
+2. Create module with clear, focused responsibility
+3. Add comprehensive tests
+4. Update documentation
+5. Submit pull request
+
+See `docs/code_organization.md` for detailed guidelines.
+
+## Testing
+
+```bash
+# Run all tests
+pytest -v
+
+# Run specific module tests
+pytest tests/unit/test_<module>.py -v
+
+# Run integration tests
+pytest tests/integration/ -v
+```
+
+## Documentation
+
+- Update API docs in `docs/api/`
+- Add usage examples in `docs/guides/`
+- Update `CHANGELOG.md`

vm_tool-1.0.32/Makefile

@@ -0,0 +1,19 @@
+.PHONY: clean build upload install version-control
+
+# Clean up previous builds
+clean:
+	rm -rf dist
+
+# Build the source distribution
+build: clean
+	mkdir -p dist
+	python setup.py sdist
+
+# Upload the distribution to PyPI
+upload: build
+	pip install --upgrade twine
+	twine upload dist/* --verbose
+
+# Install dependencies
+install:
+	pip install -r requirements.txt

{vm_tool-1.0.29/vm_tool.egg-info → vm_tool-1.0.32}/PKG-INFO

@@ -1,15 +1,14 @@
 Metadata-Version: 2.4
 Name: vm_tool
-Version: 1.0.29
+Version: 1.0.32
 Summary: A Comprehensive Tool for Setting Up Virtual Machines.
 Home-page: https://github.com/thesunnysinha/vm_tool
 Author: Sunny Sinha
-Author-email: thesunnysinha@gmail.com
+Author-email: Sunny Sinha <thesunnysinha@gmail.com>
 License: MIT
-Project-URL: Documentation, https://github.com/thesunnysinha/vm_tool/README.md
+Project-URL: Documentation, https://vm-tool.sunnysinha.online/
 Project-URL: Source, https://github.com/thesunnysinha/vm_tool
 Project-URL: Tracker, https://github.com/thesunnysinha/vm_tool/issues
-Keywords: virtual machine setup ansible automation
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
@@ -21,7 +20,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: System :: Systems Administration
-Requires-Python: >=3.6
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: ansible
@@ -30,37 +29,40 @@ Requires-Dist: paramiko
 Requires-Dist: pydantic
 Requires-Dist: pyyaml
 Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: flake8; extra == "dev"
-Requires-Dist: bump2version; extra == "dev"
+Requires-Dist: pytest>=6.0.0; extra == "dev"
+Requires-Dist: check-manifest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: bump-my-version; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: mkdocs-material; extra == "dev"
+Requires-Dist: mkdocstrings[python]; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
 Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
 Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
 Dynamic: license-file
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-dist
 Dynamic: requires-python
-Dynamic: summary
 
 # 🚀 VM Setup Tool
 
 [![PyPI version](https://img.shields.io/pypi/v/vm-tool.svg)](https://pypi.org/project/vm-tool/) [![Python versions](https://img.shields.io/pypi/pyversions/vm-tool.svg)](https://pypi.org/project/vm-tool/)
 
-[**PyPI**](https://pypi.org/project/vm-tool/) • [**GitHub**](https://github.com/thesunnysinha/vm_tool) • [**Contributing**](CONTRIBUTING) • [**License**](LICENSE)
+[**Documentation**](https://vm-tool.sunnysinha.online/) • [**PyPI**](https://pypi.org/project/vm-tool/) • [**GitHub**](https://github.com/thesunnysinha/vm_tool) • [**Contributing**](CONTRIBUTING) • [**License**](LICENSE)
 
 A modern, user-friendly solution for automating and managing virtual machine (VM) setup and configuration using Ansible.
 
 ---
 
 ## ✨ Features
+
 - Automated VM setup with Docker & Docker Compose
 - Cloud VM provisioning via SSH
+- **Infrastructure Provisioning**: Terraform integration for cloud providers (AWS, etc.)
+- **Kubernetes Ready**: One-click K3s cluster setup
+- **Observability**: Instant Prometheus & Grafana deployment
+- **CI/CD Pipelines**: Auto-generate GitHub Actions workflows
 - SSH key management and configuration
 - Simple Python API for integration
 - One-command version check: `vm_tool --version`
@@ -68,6 +70,7 @@ A modern, user-friendly solution for automating and managing virtual machine (VM
 ---
 
 ## ⚡️ Installation
+
 Install the latest version from PyPI:
 
 ```bash
@@ -78,7 +81,44 @@ pip install vm-tool
 
 ## 🛠️ Usage Examples
 
-### Automated Local VM Setup
+### 🚀 Universal Deployment (CLI)
+
+#### 1. Generate CI/CD Pipeline
+
+Bootstrap your project with a complete GitHub Actions workflow:
+
+```bash
+vm_tool generate-pipeline
+```
+
+#### 2. Provision Infrastructure
+
+Provision cloud resources using Terraform (requires Terraform installed):
+
+```bash
+vm_tool provision --provider aws --action apply --vars region=us-east-1
+```
+
+#### 3. Setup Kubernetes (K3s)
+
+Deploy a lightweight Kubernetes cluster to your servers:
+
+```bash
+vm_tool setup-k8s --inventory inventory.yml
+```
+
+#### 4. Setup Observability
+
+Deploy Prometheus and Grafana for instant monitoring:
+
+```bash
+vm_tool setup-monitoring --inventory inventory.yml
+```
+
+### 🐍 Python API Usage
+
+#### Automated Local VM Setup
+
 ```python
 from vm_tool.runner import SetupRunner, SetupRunnerConfig
 
@@ -97,6 +137,7 @@ runner.run_setup()
 ```
 
 ### Cloud VM Setup (via SSH)
+
 ```python
 from vm_tool.runner import SetupRunner, SetupRunnerConfig, SSHConfig
 
@@ -125,6 +166,7 @@ runner.run_cloud_setup(ssh_configs)
 ```
 
 ### SSH Key Management
+
 ```python
 from vm_tool.ssh import SSHSetup
 
@@ -151,6 +193,7 @@ vm_tool --version
 ---
 
 ## ⚙️ Configuration Options
+
 - `github_username`: GitHub username (for private repos)
 - `github_token`: GitHub token (for private repos)
 - `github_project_url`: GitHub repository URL
@@ -162,7 +205,8 @@ vm_tool --version
 ---
 
 ## 📚 Learn More
-See the [PyPI page](https://pypi.org/project/vm-tool/) for more details, or visit the [GitHub repository](https://github.com/thesunnysinha/vm_tool) for full documentation, issues, and contributions.
+
+See the [Official Documentation](https://vm-tool.sunnysinha.online/) for complete guides. Visit the [PyPI page](https://pypi.org/project/vm-tool/) for generic details, or the [GitHub repository](https://github.com/thesunnysinha/vm_tool) for code and issues.
 
 ---