docs: Update documentation for auto-update system and integration tests

This commit is contained in:
claudi 2026-01-30 08:43:52 +01:00
parent f701247fab
commit c1133ae8e9
9 changed files with 105 additions and 57 deletions

View file

@ -258,33 +258,19 @@ Startup: <1 second
- **Paths**: Forward slash `/` (native)
- **Permissions**: May require accessibility permissions
## Monitoring & Debugging
## Update Manager
### Debug Logging
The `UpdateManager` class checks for new releases using the Forgejo API. It caches results and only signals updates for newer versions. See `src/webdrop_bridge/core/updater.py` for implementation.
```python
# Enable debug logging
LOG_LEVEL=DEBUG
## Release Flow
# Output
2026-01-28 14:32:15 - webdrop_bridge - DEBUG - DragInterceptor: dragEnterEvent triggered
2026-01-28 14:32:15 - webdrop_bridge - DEBUG - PathValidator: Checking Z:\file.psd
2026-01-28 14:32:15 - webdrop_bridge - INFO - File dragged: Z:\file.psd
```
- Checks for new releases on startup or user request
- Parses release notes and assets
- Notifies UI if update is available
### Performance Profiling
## Integration Test Strategy
```python
import cProfile
import pstats
profiler = cProfile.Profile()
profiler.enable()
# ... drag operation ...
profiler.disable()
stats = pstats.Stats(profiler)
stats.print_stats()
```
Integration tests verify workflows across modules. The update workflow is covered in [tests/integration/test_update_flow.py](../tests/integration/test_update_flow.py).
---