wasm-cli 0.10.2__tar.gz

wasm_cli-0.10.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 WASM Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wasm_cli-0.10.2/PKG-INFO

@@ -0,0 +1,532 @@
+Metadata-Version: 2.4
+Name: wasm-cli
+Version: 0.10.2
+Summary: Web App System Management - Deploy and manage web applications on Linux servers
+Author: WASM Team
+License: MIT
+Project-URL: Homepage, https://github.com/your-org/wasm
+Project-URL: Documentation, https://github.com/your-org/wasm#readme
+Project-URL: Repository, https://github.com/your-org/wasm.git
+Project-URL: Bug Tracker, https://github.com/your-org/wasm/issues
+Keywords: cli,deployment,nginx,apache,systemd,web-apps,server-management,certbot,ssl
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Installation/Setup
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: inquirer>=3.1.0
+Requires-Dist: Jinja2>=3.1.0
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: isort>=5.12; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: rich
+Requires-Dist: rich>=13.0; extra == "rich"
+Provides-Extra: monitor
+Requires-Dist: psutil>=5.9.0; extra == "monitor"
+Requires-Dist: httpx>=0.25.0; extra == "monitor"
+Dynamic: license-file
+Dynamic: requires-python
+
+# WASM - Web App System Management
+
+<p align="center">
+  <img src="docs/assets/logo.png" alt="WASM Logo" width="200">
+</p>
+
+<p align="center">
+  <strong>Deploy, manage, and monitor web applications with ease</strong>
+</p>
+
+<p align="center">
+  <a href="#installation">Installation</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#features">Features</a> •
+  <a href="#documentation">Documentation</a>
+</p>
+
+---
+
+## 🚀 What is WASM?
+
+**WASM (Web App System Management)** is a powerful CLI tool designed to simplify the deployment and management of web applications on Linux servers. It automates the entire process from cloning your code to serving it with Nginx/Apache, including SSL certificates and systemd services.
+
+### Key Capabilities
+
+- 🌐 **Site Management** - Create and manage Nginx/Apache virtual hosts
+- 🔒 **SSL Certificates** - Automated Let's Encrypt certificates via Certbot
+- ⚙️ **Service Management** - Create and control systemd services
+- 🚀 **One-Command Deployment** - Deploy full-stack applications instantly
+- 🎯 **Multi-Framework Support** - Next.js, Node.js, Vite, Python, and more
+- 🧭 **Interactive Mode** - Guided step-by-step deployment wizard
+
+---
+
+## 📦 Installation
+
+### Ubuntu/Debian - From PPA (Recommended)
+
+```bash
+sudo add-apt-repository ppa:yago2003/wasm
+sudo apt update
+sudo apt install wasm
+```
+
+Supported Ubuntu versions:
+- Ubuntu 24.04 LTS (Noble Numbat)
+- Ubuntu 24.10 (Plucky Puffin)
+- Ubuntu 25.04 (Questing Qetzal)
+
+### Fedora - From OBS Repository
+
+```bash
+# Add repository
+sudo dnf config-manager --add-repo \
+  https://download.opensuse.org/repositories/home:/Perkybeet/Fedora_40/home:Perkybeet.repo
+
+# Install
+sudo dnf install wasm-cli
+```
+
+### openSUSE - From OBS Repository
+
+```bash
+# Tumbleweed
+sudo zypper ar -f \
+  https://download.opensuse.org/repositories/home:/Perkybeet/openSUSE_Tumbleweed/ \
+  home_Perkybeet
+sudo zypper install wasm-cli
+
+# Leap 15.6
+sudo zypper ar -f \
+  https://download.opensuse.org/repositories/home:/Perkybeet/openSUSE_Leap_15.6/ \
+  home_Perkybeet
+sudo zypper install wasm-cli
+```
+
+### Debian - From OBS Repository
+
+```bash
+# Add repository key
+curl -fsSL https://download.opensuse.org/repositories/home:/Perkybeet/Debian_12/Release.key | \
+  gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/home_Perkybeet.gpg > /dev/null
+
+# Add repository
+echo 'deb https://download.opensuse.org/repositories/home:/Perkybeet/Debian_12/ /' | \
+  sudo tee /etc/apt/sources.list.d/home_Perkybeet.list
+
+# Install
+sudo apt update
+sudo apt install wasm-cli
+```
+
+### From .deb Package
+
+```bash
+wget https://github.com/Perkybeet/wasm/releases/latest/download/wasm_0.8.2_all.deb
+sudo dpkg -i wasm_0.8.2_all.deb
+sudo apt install -f  # Install dependencies if needed
+```
+
+### From PyPI
+
+```bash
+pip install wasm-cli
+```
+
+### From Source
+
+```bash
+git clone https://github.com/your-org/wasm.git
+cd wasm
+pip install -e .
+```
+
+---
+
+## 🏃 Quick Start
+
+### Deploy a Next.js Application
+
+```bash
+# One-liner deployment
+wasm webapp create \
+  --domain myapp.example.com \
+  --source git@github.com:user/my-nextjs-app.git \
+  --type nextjs \
+  --port 3000
+
+# Short version
+wasm wp create -d myapp.example.com -s git@github.com:user/app.git -t nextjs -p 3000
+```
+
+### Interactive Mode
+
+For a guided experience, simply run:
+
+```bash
+wasm
+```
+
+Or explicitly:
+
+```bash
+wasm --interactive
+```
+
+You'll be guided through all the options step by step:
+
+```
+┌─────────────────────────────────────────────────┐
+│           WASM - Web App System Management      │
+└─────────────────────────────────────────────────┘
+
+? What would you like to do?
+❯ 🚀 Deploy a Web Application
+  🌐 Manage Sites (Nginx/Apache)
+  ⚙️  Manage Services
+  🔒 Manage SSL Certificates
+  📊 View Status Dashboard
+  ⚡ Exit
+
+? Select application type:
+❯ Next.js
+  Node.js (Express, Fastify, etc.)
+  Vite (React, Vue, Svelte)
+  Python (Django, Flask, FastAPI)
+  Static Site
+  Custom
+
+? Enter the domain name: myapp.example.com
+? Enter the source (Git URL or path): git@github.com:user/app.git
+? Enter the port number: 3000
+? Configure SSL certificate? Yes
+
+[1/7] 📥 Cloning repository...
+[2/7] 📦 Installing dependencies...
+[3/7] 🔨 Building application...
+[4/7] 🌐 Creating Nginx configuration...
+[5/7] 🔒 Obtaining SSL certificate...
+[6/7] ⚙️  Creating systemd service...
+[7/7] 🚀 Starting application...
+
+✅ Deployment complete!
+
+   URL: https://myapp.example.com
+   Status: Running
+   Service: wasm-myapp-example-com
+```
+
+---
+
+## 📋 Features
+
+### Web Application Deployment
+
+```bash
+# Create a new web application
+wasm webapp create [options]
+
+Options:
+  -d, --domain DOMAIN     Target domain (e.g., example.com)
+  -s, --source SOURCE     Git URL or local path to source code
+  -t, --type TYPE         Application type (nextjs, nodejs, vite, python, static)
+  -p, --port PORT         Application port (default: auto-assigned)
+  -w, --webserver SERVER  Web server (nginx, apache) [default: nginx]
+  --no-ssl                Skip SSL certificate configuration
+  --branch BRANCH         Git branch to deploy [default: main]
+  --env-file FILE         Path to .env file to use
+  -v, --verbose           Enable verbose output
+
+# List deployed applications
+wasm webapp list
+
+# Get application status
+wasm webapp status myapp.example.com
+
+# Restart application
+wasm webapp restart myapp.example.com
+
+# Remove application
+wasm webapp delete myapp.example.com
+
+# Update application (pull & rebuild)
+wasm webapp update myapp.example.com
+```
+
+### Site Management
+
+```bash
+# Create a site (without deploying an app)
+wasm site create -d example.com -w nginx
+
+# List all sites
+wasm site list
+
+# Enable/disable site
+wasm site enable example.com
+wasm site disable example.com
+
+# Delete site
+wasm site delete example.com
+
+# Show site configuration
+wasm site show example.com
+```
+
+### Service Management
+
+```bash
+# Create a custom service
+wasm service create --name myservice --command "/usr/bin/myapp" --user www-data
+
+# List managed services
+wasm service list
+
+# Control services
+wasm service start myservice
+wasm service stop myservice
+wasm service restart myservice
+
+# View service status
+wasm service status myservice
+
+# View service logs
+wasm service logs myservice
+wasm service logs myservice --follow
+wasm service logs myservice --lines 100
+
+# Delete service
+wasm service delete myservice
+```
+
+### SSL Certificate Management
+
+```bash
+# Obtain certificate for a domain
+wasm cert create -d example.com
+
+# List certificates
+wasm cert list
+
+# Renew all certificates
+wasm cert renew
+
+# Revoke a certificate
+wasm cert revoke example.com
+
+# Show certificate info
+wasm cert info example.com
+```
+
+---
+
+## 🎯 Supported Application Types
+
+| Type | Framework | Auto-Detection |
+|------|-----------|----------------|
+| `nextjs` | Next.js | `next.config.js` |
+| `nodejs` | Express, Fastify, Koa, etc. | `package.json` with start script |
+| `vite` | React, Vue, Svelte (Vite) | `vite.config.js` |
+| `python` | Django, Flask, FastAPI | `requirements.txt`, `pyproject.toml` |
+| `static` | HTML/CSS/JS | `index.html` |
+
+Each type has a specific deployment workflow that includes:
+- Dependency installation
+- Build process
+- Environment configuration
+- Service setup
+- Health checks
+
+---
+
+## ⚙️ Configuration
+
+### Global Configuration
+
+Configuration file location: `/etc/wasm/config.yaml`
+
+```yaml
+# Default web server
+webserver: nginx
+
+# Default apps directory
+apps_directory: /var/www/apps
+
+# Default user for services
+service_user: www-data
+
+# SSL settings
+ssl:
+  enabled: true
+  provider: certbot
+  email: admin@example.com
+  
+# Logging
+logging:
+  level: info
+  file: /var/log/wasm/wasm.log
+
+# Node.js settings
+nodejs:
+  default_version: 20
+  use_nvm: false
+
+# Python settings
+python:
+  default_version: "3.11"
+  use_venv: true
+```
+
+### Per-Project Configuration
+
+You can include a `.wasm.yaml` file in your project root:
+
+```yaml
+type: nextjs
+port: 3000
+build_command: npm run build
+start_command: npm run start
+env_vars:
+  NODE_ENV: production
+health_check:
+  path: /api/health
+  timeout: 30
+```
+
+---
+
+## 📊 Verbose Mode
+
+Add `--verbose` or `-v` for detailed output:
+
+```bash
+wasm webapp create -d example.com -s git@github.com:user/app.git -t nextjs -v
+```
+
+**Verbose output example:**
+
+```
+[1/7] 📥 Cloning repository...
+      ├─ Source: git@github.com:user/app.git
+      ├─ Branch: main
+      ├─ Target: /var/www/apps/example-com
+      └─ Completed in 4.2s
+
+[2/7] 📦 Installing dependencies...
+      ├─ Package manager: npm
+      ├─ Command: npm ci --production=false
+      ├─ Packages installed: 1,247
+      └─ Completed in 45.3s
+
+[3/7] 🔨 Building application...
+      ├─ Command: npm run build
+      ├─ Output directory: .next
+      ├─ Build size: 12.4 MB
+      └─ Completed in 32.1s
+...
+```
+
+---
+
+## 🗂️ Directory Structure
+
+WASM organizes deployed applications as follows:
+
+```
+/var/www/apps/
+├── example-com/
+│   ├── current/          # Current deployment (symlink)
+│   ├── releases/         # Previous releases (for rollback)
+│   │   ├── 20241215120000/
+│   │   └── 20241214150000/
+│   ├── shared/           # Shared files (uploads, logs)
+│   └── .env              # Environment variables
+│
+└── another-app/
+    └── ...
+```
+
+---
+
+## 🔧 Requirements
+
+### System Requirements
+
+- **OS:** Ubuntu 20.04+, Debian 11+
+- **Python:** 3.10+
+- **Privileges:** sudo access for service management
+
+### Optional Dependencies
+
+- **nginx** or **apache2** - Web server
+- **certbot** - SSL certificates
+- **git** - Source code management
+- **nodejs** / **nvm** - For Node.js applications
+- **python3-venv** - For Python applications
+
+WASM will check and prompt for missing dependencies during installation.
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](.github/CONTRIBUTING.md) for details.
+
+```bash
+# Development setup
+git clone https://github.com/Perkybeet/wasm.git
+cd wasm
+python -m venv venv
+source venv/bin/activate
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Build .deb package
+make debian
+
+# Build and upload to PPA (all distributions)
+make ppa-upload
+
+# Or for specific distributions
+./build-and-upload-ppa.sh noble plucky
+```
+
+For detailed information about building and uploading to PPA, see [docs/PPA_UPLOAD.md](docs/PPA_UPLOAD.md).
+
+---
+
+## 📜 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- [Certbot](https://certbot.eff.org/) for SSL automation
+- [python-inquirer](https://github.com/magmax/python-inquirer) for interactive CLI
+- The open-source community
+
+---
+
+<p align="center">
+  Made with ❤️ for the DevOps community
+</p>