1
Setup and Run ms
Tirsvad edited this page 2026-10-28 09:30:42 +01:00

Persediaan dan Jalankan

🌐 English · Dansk · Bahasa Malaysia

Keperluan

  • Python 3.13 atau lebih baharu
  • Google Chrome (Selenium memuat turun pemandu yang sepadan)
  • Pilihan: Docker untuk larian end to end; Doxygen untuk dokumentasi API

Cipta dan guna .venv setempat

python -m venv .venv

Aktifkannya:

# Windows (PowerShell)
.venv\Scripts\Activate.ps1

# Windows (Git Bash)
source .venv/Scripts/activate

# Linux / macOS
source .venv/bin/activate

Naik taraf pip dan pasang projek bersama alat ujian:

python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Keluar daripada persekitaran dengan deactivate.

Jalankan

python -m scraping_wiki.interaction

Chrome dibuka, halaman utama Wikipedia dimuatkan, bilangan artikel dicetak dan pelayar ditutup. Tambah --headless untuk berjalan tanpa tetingkap:

scraping-wiki --headless

Ujian

python -m pytest
python -m ruff check src tests
python -m mypy src tests

Ujian unit menggunakan pemandu palsu dan tidak memulakan pelayar. Untuk larian end to end lihat Ujian dalam Docker.

Dokumentasi API

doxygen Doxyfile

HTML ditulis ke docs/doxygen/html.