requirements.txt

# ─────────────────────────────────────────────
# LeadGen Pro — Python dependencies
# ─────────────────────────────────────────────
# Install:  pip install -r requirements.txt
# Browser:  playwright install chromium
# ─────────────────────────────────────────────

# ── Core scraping ─────────────────────────────
requests>=2.31.0            # HTTP client
beautifulsoup4>=4.12.0      # HTML parsing
lxml>=5.1.0                 # Fast HTML/XML parser (BS4 backend)

# ── Browser automation (Google Maps) ─────────
playwright>=1.43.0          # Headless Chromium

# ── Data processing ───────────────────────────
pandas>=2.2.0               # DataFrame manipulation
numpy>=1.26.0               # Numerical ops (pandas dependency)

# ── PDF generation ────────────────────────────
reportlab>=4.1.0            # Professional PDF creation

# ── Web dashboard ─────────────────────────────
flask>=3.0.0                # Web framework
flask-cors>=4.0.0           # Cross-origin requests

# ── Validation & intelligence ─────────────────
phonenumbers>=8.13.0        # Phone number parsing & validation
dnspython>=2.6.0            # DNS MX record checking for email validation

# ── PDF enhancements ─────────────────────────
qrcode[pil]>=7.4.0          # QR code generation for PDF reports
matplotlib>=3.8.0           # Chart generation for PDF reports

# ── Utilities ─────────────────────────────────
python-dotenv>=1.0.0        # .env file support
tqdm>=4.66.0                # Progress bars (CLI)
colorama>=0.4.6             # Cross-platform ANSI colours (Windows)
urllib3>=2.2.0              # HTTP internals (requests dependency)

# ── Optional / dev ────────────────────────────
# pytest>=8.0.0             # Unit testing
# pytest-cov>=5.0.0         # Coverage
# responses>=0.25.0         # Mock HTTP
# black>=24.0.0             # Code formatter
# ruff>=0.4.0               # Linter