nextog-cli 1.0.0

nextOG CLI - Full QA Testing Automation Tool for Web, Mobile, API & Embedded Systems

🚀 nextOG CLI

Full QA Testing Automation CLI Tool

Web Apps • Mobile Apps • Embedded Systems • Web Systems — All-in-One Testing

---

✨ Features

• 🌐 Web Testing — Playwright-based: responsive, accessibility, cross-browser, performance
• 📱 Mobile Testing — Appium-based: Android, iOS, cross-platform
• 🔌 API Testing — REST, GraphQL, WebSocket testing with OpenAPI spec support
• 🔧 Embedded Systems — MQTT, CoAP, HTTP, Serial protocol testing
• 🛡️ Security Testing — SSL, headers, SQL injection, XSS, CORS checks
• 📊 Live Dashboard — Real-time testing panel with WebSocket updates
• 📑 Auto Excel Reports — Industrial Excel reports auto-generated after EVERY test (10 sheets)
• 🧠 Auto-Training — Learns from your usage patterns to optimize testing
• 🔐 Privacy-First — ALL data stays local, encrypted, zero external transfer
• 📈 Coverage Tracking — Track progress from 0% → 90% automated coverage
• 👥 User Permissions — Role-based access: admin, tester, viewer, CI

---

🚀 Installation

# Install from source
cd nextog-cli
pip install -e .

# Install with mobile support
pip install -e ".[mobile]"

# Install Playwright browsers
playwright install

# Verify installation
nextog --version

---

📖 Quick Start

Initialize a Project

# Create a new full-stack testing project
nextog init my-project --template full

# Web-only project
nextog my-web-app --template web

# API-only project
nextog my-api --template api

Run Tests

# Web testing
nextog test web --url https://example.com --browser chromium --responsive --accessibility

# Mobile testing
nextog test mobile --app ./myapp.apk --platform android

# API testing
nextog test api --spec ./openapi.yaml --base-url https://api.example.com

# Embedded systems
nextog test embedded --target 192.168.1.100 --protocol mqtt

# Run all tests
nextog test all --coverage-target 90

Live Dashboard

# Start real-time testing dashboard
nextog live --port 8080

View Coverage

# Show coverage table
nextog coverage

# Generate HTML report
nextog coverage --report --format html

# Generate JSON report
nextog coverage --report --format json

Generate Industrial Excel Reports

# Reports auto-generate after EVERY test run!
nextog test web --url https://example.com   # → Excel report auto-created
nextog test mobile --app ./app.apk           # → Excel report auto-created
nextog test api --spec ./openapi.yaml        # → Excel report auto-created

# Generate report manually from last test
nextog report

# Generate for specific test type
nextog report --type web
nextog report --type api
nextog report --type mobile
nextog report --type embedded
nextog report --type full

# Custom output path
nextog report --output ./my-report.xlsx

Each Excel Report Contains 10 Industrial Sheets:

1. 📋 Executive Summary — Key metrics, overall status, risk level, recommendations
2. 📝 Test Details — Every test case with ID, status, expected/actual results
3. 📊 Coverage Analysis — Phase-wise coverage (0% → 90%), element coverage matrix
4. 🔍 Elements & Components — All detected elements with purpose & test status
5. 🐛 Defect Log — All found defects with severity, priority, steps to reproduce
6. ⚡ Performance Metrics — Duration, throughput, response times, benchmarks
7. 📈 Charts & Graphs — Pie charts (pass/fail), Bar charts (coverage by phase)
8. 💡 Recommendations — Action items prioritized by effort & impact
9. 🖥️ Test Environment — System info, OS, RAM, CPU, tool versions
10. ✍️ Sign-Off Sheet — Approval section for QA Lead, Dev Lead, PM, Release Manager

Detect Elements

# Detect and explain all elements on a page
nextog elements https://example.com --explain

# Save elements to file
nextog elements https://example.com --output elements.json

---

👥 User Management

# Create users with roles
nextog user create john --role admin
nextog user create jane --role tester
nextog user create viewer1 --role viewer

# List users
nextog user list

# Change role
nextog user role john tester

Permission Levels

Role	Tests	Reports	Users	Config	Data
admin	✅ All	✅	✅ Manage	✅	✅
tester	✅ Run/Create	✅	❌	❌	✅ Export
viewer	❌	✅ View	❌	❌	✅ View
ci	✅ Run	✅	❌	❌	❌

---

🧠 Auto-Training

nextOG automatically learns from your testing patterns:

# Check training status
nextog train --action status

# Start training cycle
nextog train --action start --iterations 100

# Optimize test suite
nextog train --action optimize

What it learns:

• Which tests fail most often → runs them first (fail-fast)
• Common error patterns → suggests fixes
• User workflows → optimizes test order
• Coverage gaps → suggests new tests

---

🔐 Privacy Architecture

nextOG is 100% privacy-first:

• ✅ All data stored locally (SQLite + AES encryption)
• ✅ Zero external API calls for user data
• ✅ No telemetry, no analytics, no cloud sync
• ✅ User can export/delete all data anytime
• ✅ Data integrity verification built-in

# View storage stats
nextog data stats

# Export all data (encrypted)
nextog data export --output backup.json --encrypt

# Purge all data permanently
nextog data purge --yes

---

📊 Coverage Tracking

Testing progresses through 5 phases:

Phase	Coverage	Tests
🔥 Smoke	0% - 20%	Basic element detection, page loads
⚡ Functional	20% - 40%	Forms, navigation, API validation
🔗 Integration	40% - 60%	Cross-component, edge cases
🛡️ Performance	60% - 80%	Load, stress, security tests
🎯 Advanced	80% - 90%	Regression, advanced scenarios

---

📁 Project Structure

nextog-cli/
├── nextog/
│   ├── cli.py              # CLI entry point (Typer)
│   ├── core/
│   │   ├── engine.py       # Core testing engine
│   │   ├── runner.py       # Test runner & initializer
│   │   ├── reporter.py     # Coverage reporting
│   │   ├── permissions.py  # RBAC permissions
│   │   └── privacy.py      # Privacy engine
│   ├── engines/
│   │   ├── web/            # Web testing (Playwright)
│   │   ├── mobile/         # Mobile testing (Appium)
│   │   ├── api/            # API testing (httpx)
│   │   ├── embedded/       # Embedded systems (MQTT/CoAP)
│   │   └── system/         # Performance & security
│   ├── training/           # Auto-learning engine
│   ├── data/               # Local database & sync
│   ├── live/               # Live dashboard (FastAPI)
│   ├── config/             # Settings management
│   └── utils/              # Helpers & validators
├── pyproject.toml          # Package configuration
└── README.md

---

🛠️ Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/

# Format code
black nextog/
ruff check nextog/

# Type check
mypy nextog/

---

📄 License

MIT License - See LICENSE file for details.

---

Built with ❤️ for comprehensive QA automation