Update Maigret Site Database Safely

Maigret’s signature database evolves quickly as sites change HTML or close. Updating frequently keeps scans reliable.

Fast upgrade

cd ~/code/maigret
git pull origin main
pip install -U .

# or with Poetry
poetry install --with dev

Validate post-upgrade

maigret --version
maigret --self-check

Rebuild assets

# Regenerate supported sites list
python scripts/build_sites_md.py > sites.md

# Update translation strings if needed
poetry run python scripts/update_locales.py

Automating updates

  sequenceDiagram
    participant CI
    participant GitHub
    participant PyPI
    CI->>GitHub: schedule checkout
    CI->>CI: poetry install --with dev
    CI->>CI: pytest && maigret --self-check
    CI->>PyPI: publish if version bumped

When pip install is not enough

Some distributions lag behind PyPI. Clone the repository instead:

git clone https://github.com/soxoj/maigret.git
pip install --editable ./maigret

Editable mode (pip install -e) lets you track main and apply patches before they land upstream.

Keep an eye on the Maigret changelog for breaking changes and update cadence.