wup 0.1.5__tar.gz → 0.1.7__tar.gz

wup-0.1.7/PKG-INFO

@@ -0,0 +1,255 @@
+Metadata-Version: 2.4
+Name: wup
+Version: 0.1.7
+Summary: WUP (What's Up) - Intelligent file watcher for regression testing in large projects
+Author-email: Tom Sapletta <tom@sapletta.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/yourusername/wup
+Project-URL: Repository, https://github.com/yourusername/wup
+Keywords: wup,watcher,testing,regression,file-monitoring
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: watchdog>=4.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Dynamic: license-file
+
+# WUP (What's Up)
+
+
+## AI Cost Tracking
+
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.7-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$0.15-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-2.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+
+- 🤖 **LLM usage:** $0.1500 (1 commits)
+- 👤 **Human dev:** ~$200 (2.0h @ $100/h, 30min dedup)
+
+Generated on 2026-04-29 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+
+---
+
+![PyPI](https://img.shields.io/badge/pypi-wup-blue) ![Version](https://img.shields.io/badge/version-0.1.7-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+
+**WUP (What's Up)** - Intelligent file watcher for regression testing in large projects.
+
+WUP monitors file changes and runs intelligent regression tests using a 3-layer approach:
+1. **Detection Layer**: File watching with heuristics
+2. **Priority Layer**: Quick tests of related services (3 endpoints max)
+3. **Detail Layer**: Full tests with blame reports (only on failure)
+
+## Features
+
+- 🎯 **Intelligent Testing**: Only tests related services when files change
+- ⚡ **CPU Throttling**: Respects system resources with configurable CPU limits
+- 🔄 **3-Layer Architecture**: Quick smoke tests first, detailed tests only on failure
+- 📊 **Live Dashboard**: Real-time status monitoring with Rich CLI
+- 🔍 **Dependency Mapping**: Automatic detection of files → endpoints → services
+- 🚀 **Framework Support**: FastAPI, Flask, Django, Express.js, and more
+- 📝 **Blame Reports**: Detailed regression reports with file/line/commit info
+
+## Installation
+
+```bash
+# Install from source
+pip install -e .
+
+# Install with development dependencies
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```bash
+# 1. Build dependency map (one-time setup)
+wup map-deps ./my-project
+
+# 2. Start watching for changes
+wup watch ./my-project
+
+# 3. Start with live dashboard
+wup watch ./my-project --dashboard
+```
+
+## Usage
+
+### Build Dependency Map
+
+```bash
+# Auto-detect framework
+wup map-deps ./my-project
+
+# Specify framework
+wup map-deps ./my-project --framework fastapi
+
+# Custom output file
+wup map-deps ./my-project --output my-deps.json
+```
+
+### Watch Project
+
+```bash
+# Basic watching
+wup watch ./my-project
+
+# With custom settings
+wup watch ./my-project \
+  --cpu-throttle 0.5 \
+  --debounce 3 \
+  --cooldown 600
+
+# With live dashboard
+wup watch ./my-project --dashboard
+```
+
+### Check Status
+
+```bash
+# View dependency map status
+wup status
+
+# Custom deps file
+wup status --deps my-deps.json
+```
+
+## Architecture
+
+### 3-Layer Testing Approach
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    DETECTION LAYER                           │
+│  File watching with watchdog + heuristics                   │
+│  Skips: .git, __pycache__, node_modules, .venv              │
+└──────────────────────┬──────────────────────────────────────┘
+                       │ File change
+                       ▼
+┌─────────────────────────────────────────────────────────────┐
+│                   PRIORITY LAYER                             │
+│  Quick test: 3 endpoints max per service                    │
+│  Duration: ~1-2 seconds                                      │
+│  Result: Pass → Done, Fail → Escalate                        │
+└──────────────────────┬──────────────────────────────────────┘
+                       │ Failure
+                       ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    DETAIL LAYER                              │
+│  Full test: All endpoints with blame report                 │
+│  Duration: ~3-5 seconds                                      │
+│  Result: Regression report with file/line/commit            │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Performance Characteristics
+
+```
+Idle:           0.1% CPU, 10MB RAM
+File change:    5s test → 2% CPU spike
+Full regression: 15s test → 15% CPU spike
+200+ files/min: 100 req/s → OK (throttled)
+```
+
+## Configuration
+
+### CLI Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--cpu-throttle` | 0.8 | CPU usage threshold (0.0-1.0) |
+| `--debounce` | 2 | Debounce time in seconds |
+| `--cooldown` | 300 | Test cooldown in seconds |
+| `--dashboard` | false | Enable live dashboard |
+| `--deps` | deps.json | Dependency map file path |
+
+### Environment Variables
+
+```bash
+# Set default CPU throttle
+export WUP_CPU_THROTTLE=0.5
+
+# Set default debounce time
+export WUP_DEBOUNCE=3
+```
+
+## Integration with Test Frameworks
+
+WUP is designed to work with any test framework. The current implementation includes placeholder test methods that you can customize:
+
+```python
+# In wup/core.py, customize these methods:
+
+async def run_quick_test(self, service: str, endpoints: List[str]) -> bool:
+    # Integrate with your test framework (pytest, unittest, TestQL, etc.)
+    # Example:
+    result = subprocess.run([
+        "pytest", f"tests/{service}/test_smoke.py",
+        "--maxfail=1", "-q"
+    ])
+    return result.returncode == 0
+
+async def run_detail_test(self, service: str, endpoints: List[str]) -> Dict:
+    # Run full test suite with blame reporting
+    # Example:
+    result = subprocess.run([
+        "pytest", f"tests/{service}/",
+        "--cov", f"app/{service}",
+        "--cov-report=json"
+    ])
+    return parse_coverage_report("coverage.json")
+```
+
+## Project Structure
+
+```
+wup/
+├── wup/
+│   ├── __init__.py           # Package exports
+│   ├── core.py               # WupWatcher implementation
+│   ├── dependency_mapper.py  # Dependency mapping logic
+│   └── cli.py                # CLI interface
+├── tests/
+│   └── test_wup.py           # Unit tests
+├── pyproject.toml           # Package configuration
+└── README.md                 # This file
+```
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=wup
+
+# Run specific test
+pytest tests/test_wup.py::TestDependencyMapper::test_init
+```
+
+### Building for Distribution
+
+```bash
+# Build wheel and source distribution
+python -m build
+
+# Install from dist
+pip install dist/wup-0.1.6-py3-none-any.whl
+```
+
+## License
+
+Licensed under Apache-2.0.
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

wup-0.1.7/README.md

@@ -0,0 +1,230 @@
+# WUP (What's Up)
+
+
+## AI Cost Tracking
+
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.7-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$0.15-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-2.0h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+
+- 🤖 **LLM usage:** $0.1500 (1 commits)
+- 👤 **Human dev:** ~$200 (2.0h @ $100/h, 30min dedup)
+
+Generated on 2026-04-29 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+
+---
+
+![PyPI](https://img.shields.io/badge/pypi-wup-blue) ![Version](https://img.shields.io/badge/version-0.1.7-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+
+**WUP (What's Up)** - Intelligent file watcher for regression testing in large projects.
+
+WUP monitors file changes and runs intelligent regression tests using a 3-layer approach:
+1. **Detection Layer**: File watching with heuristics
+2. **Priority Layer**: Quick tests of related services (3 endpoints max)
+3. **Detail Layer**: Full tests with blame reports (only on failure)
+
+## Features
+
+- 🎯 **Intelligent Testing**: Only tests related services when files change
+- ⚡ **CPU Throttling**: Respects system resources with configurable CPU limits
+- 🔄 **3-Layer Architecture**: Quick smoke tests first, detailed tests only on failure
+- 📊 **Live Dashboard**: Real-time status monitoring with Rich CLI
+- 🔍 **Dependency Mapping**: Automatic detection of files → endpoints → services
+- 🚀 **Framework Support**: FastAPI, Flask, Django, Express.js, and more
+- 📝 **Blame Reports**: Detailed regression reports with file/line/commit info
+
+## Installation
+
+```bash
+# Install from source
+pip install -e .
+
+# Install with development dependencies
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```bash
+# 1. Build dependency map (one-time setup)
+wup map-deps ./my-project
+
+# 2. Start watching for changes
+wup watch ./my-project
+
+# 3. Start with live dashboard
+wup watch ./my-project --dashboard
+```
+
+## Usage
+
+### Build Dependency Map
+
+```bash
+# Auto-detect framework
+wup map-deps ./my-project
+
+# Specify framework
+wup map-deps ./my-project --framework fastapi
+
+# Custom output file
+wup map-deps ./my-project --output my-deps.json
+```
+
+### Watch Project
+
+```bash
+# Basic watching
+wup watch ./my-project
+
+# With custom settings
+wup watch ./my-project \
+  --cpu-throttle 0.5 \
+  --debounce 3 \
+  --cooldown 600
+
+# With live dashboard
+wup watch ./my-project --dashboard
+```
+
+### Check Status
+
+```bash
+# View dependency map status
+wup status
+
+# Custom deps file
+wup status --deps my-deps.json
+```
+
+## Architecture
+
+### 3-Layer Testing Approach
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    DETECTION LAYER                           │
+│  File watching with watchdog + heuristics                   │
+│  Skips: .git, __pycache__, node_modules, .venv              │
+└──────────────────────┬──────────────────────────────────────┘
+                       │ File change
+                       ▼
+┌─────────────────────────────────────────────────────────────┐
+│                   PRIORITY LAYER                             │
+│  Quick test: 3 endpoints max per service                    │
+│  Duration: ~1-2 seconds                                      │
+│  Result: Pass → Done, Fail → Escalate                        │
+└──────────────────────┬──────────────────────────────────────┘
+                       │ Failure
+                       ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    DETAIL LAYER                              │
+│  Full test: All endpoints with blame report                 │
+│  Duration: ~3-5 seconds                                      │
+│  Result: Regression report with file/line/commit            │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Performance Characteristics
+
+```
+Idle:           0.1% CPU, 10MB RAM
+File change:    5s test → 2% CPU spike
+Full regression: 15s test → 15% CPU spike
+200+ files/min: 100 req/s → OK (throttled)
+```
+
+## Configuration
+
+### CLI Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--cpu-throttle` | 0.8 | CPU usage threshold (0.0-1.0) |
+| `--debounce` | 2 | Debounce time in seconds |
+| `--cooldown` | 300 | Test cooldown in seconds |
+| `--dashboard` | false | Enable live dashboard |
+| `--deps` | deps.json | Dependency map file path |
+
+### Environment Variables
+
+```bash
+# Set default CPU throttle
+export WUP_CPU_THROTTLE=0.5
+
+# Set default debounce time
+export WUP_DEBOUNCE=3
+```
+
+## Integration with Test Frameworks
+
+WUP is designed to work with any test framework. The current implementation includes placeholder test methods that you can customize:
+
+```python
+# In wup/core.py, customize these methods:
+
+async def run_quick_test(self, service: str, endpoints: List[str]) -> bool:
+    # Integrate with your test framework (pytest, unittest, TestQL, etc.)
+    # Example:
+    result = subprocess.run([
+        "pytest", f"tests/{service}/test_smoke.py",
+        "--maxfail=1", "-q"
+    ])
+    return result.returncode == 0
+
+async def run_detail_test(self, service: str, endpoints: List[str]) -> Dict:
+    # Run full test suite with blame reporting
+    # Example:
+    result = subprocess.run([
+        "pytest", f"tests/{service}/",
+        "--cov", f"app/{service}",
+        "--cov-report=json"
+    ])
+    return parse_coverage_report("coverage.json")
+```
+
+## Project Structure
+
+```
+wup/
+├── wup/
+│   ├── __init__.py           # Package exports
+│   ├── core.py               # WupWatcher implementation
+│   ├── dependency_mapper.py  # Dependency mapping logic
+│   └── cli.py                # CLI interface
+├── tests/
+│   └── test_wup.py           # Unit tests
+├── pyproject.toml           # Package configuration
+└── README.md                 # This file
+```
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=wup
+
+# Run specific test
+pytest tests/test_wup.py::TestDependencyMapper::test_init
+```
+
+### Building for Distribution
+
+```bash
+# Build wheel and source distribution
+python -m build
+
+# Install from dist
+pip install dist/wup-0.1.6-py3-none-any.whl
+```
+
+## License
+
+Licensed under Apache-2.0.
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

{wup-0.1.5 → wup-0.1.7}/pyproject.toml

@@ -4,27 +4,34 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wup"
-version = "0.1.5"
-description = "A Python package for wup-related operations"
+version = "0.1.7"
+description = "WUP (What's Up) - Intelligent file watcher for regression testing in large projects"
 readme = "README.md"
-requires-python = ">=3.7"
+requires-python = ">=3.9"
 license = "Apache-2.0"
 authors = [
-    {name = "Your Name"},
     {name = "Tom Sapletta", email = "tom@sapletta.com"},
 ]
-keywords = ["wup", "web", "framework"]
+keywords = ["wup", "watcher", "testing", "regression", "file-monitoring"]
+dependencies = [
+    "watchdog>=4.0.0",
+    "psutil>=5.9.0",
+    "rich>=13.0.0",
+    "typer>=0.9.0",
+]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.7",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
 ]
 
+[project.scripts]
+wup = "wup.cli:app"
+
 [project.urls]
 Homepage = "https://github.com/yourusername/wup"
 Repository = "https://github.com/yourusername/wup"