Acquisition module for the FIT Project, built using PySide6.

Utilities and base classes for content acquisition, shared across FIT scraper modules.

Main dependencies are:

• Python >=3.11,<3.14
• Poetry (recommended for development)
• PySide6 6.9.0
• requests ^2.31
• python-whois ^0.9.5
• scapy ^2.5.0
• nslookup ^1.3.0
• xhtml2pdf ^0.2.17
• jinja2 ^3.1.6
• rfc3161ng ^2.1.3
• pypdf >=5.8.0,<7.0.0
• fit-cases – Cases management

See pyproject.toml for full details.

Run these commands before opening a PR, so failures are caught locally first.

• pytest: runs automated tests (unit, contract, integration and e2e suites).
• ruff: checks code style and common static issues (lint).
• mypy: performs static type checking on annotated Python code.
• bandit: scans source code for common security anti-patterns.
• pip-audit: checks installed dependencies for known CVEs.

python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install -U pip
pip install . pytest ruff mypy "bandit[toml]" pip-audit
python -m pip install --upgrade "setuptools>=78.1.1"

export QT_QPA_PLATFORM=offscreen
export FIT_SCREEN_RECODER_PATH="<path>/fit-screen-recorder"
# example
export FIT_SCREEN_RECODER_PATH="/Users/zitelog/Developer/Workspace/fit-screen-recorder/build/fit-screen-recorder"

# unit tests
pytest -m unit -q tests

# contract tests
pytest -m contract -q tests

# integration tests
pytest -m integration -q tests

# end-to-end smoke tests
pytest -m e2e -q tests

ruff check fit_acquisition tests
mypy fit_acquisition
bandit -c pyproject.toml -r fit_acquisition -q -ll -ii
PIPAPI_PYTHON_LOCATION="$(python -c 'import sys; print(sys.executable)')" \
  python -m pip_audit --progress-spinner off

Note: pip-audit may print a skip message for fit-acquisition, fit-assets, fit-cases, fit-common and fit-configurations because they are a local packages and not published on PyPI.

    python3.11 -m venv .venv
    source .venv/bin/activate
    pip install --upgrade pip
    pip install poetry
    poetry lock
    poetry install
    poetry run python main.py

1. Fork this repository.
2. Create a new branch (git checkout -b feat/my-feature).
3. Commit your changes using Conventional Commits.
4. Submit a Pull Request describing your modification.