v1.1.0 - Diagnostic Tools and Improved Error Handling
What's New in v1.1.0
Added
-
--doctorcommand for diagnosing installation and dependency issues- Checks all core dependencies (requests, beautifulsoup4, html2text, defusedxml, aiohttp, rich)
- Checks optional dependencies (PyYAML, Playwright) with installation suggestions
- Tests network connectivity
- Verifies output directory write permissions
- Works even when dependencies are missing
-
requirements.txtfile for transparent dependency listing -
Comprehensive TROUBLESHOOTING.md documentation with:
- Installation troubleshooting (missing dependencies, pipx issues)
- Runtime issue solutions (YAML config errors, JavaScript rendering)
- Diagnostic tools usage guide
- Common error messages reference table
- Quick reference commands
Changed
-
Improved error handling for missing dependencies
- Early dependency checking at CLI entry point
- Clear, actionable error messages with installation instructions
- Specific recommendations for pipx, pip, and development installations
-
Enhanced YAML configuration error handling
- Auto-fallback to JSON when PyYAML is not installed
- Clear error messages for YAML-related import errors
- Helpful suggestions for installing optional dependencies
-
Updated README.md with:
--doctorcommand in Quick Start section- Reference to TROUBLESHOOTING.md
- Better troubleshooting guidance
Fixed
- Improved user experience when dependencies are missing (no more confusing tracebacks)
- Better handling of optional dependency errors (PyYAML, Playwright)
Installation
```bash
pip install docpull
docpull --doctor # Verify installation
```
Full Changelog
https://github.com/raintree-technology/docpull/blob/main/CHANGELOG.md#110---2025-11-14