68 lines
1.3 KiB
Markdown
68 lines
1.3 KiB
Markdown
# Persediaan dan Jalankan
|
|
|
|
🌐 [English](Setup-and-Run) · [Dansk](Setup-and-Run-da) · **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
|
|
|
|
```bash
|
|
python -m venv .venv
|
|
```
|
|
|
|
Aktifkannya:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
python -m pip install --upgrade pip
|
|
python -m pip install -e ".[dev]"
|
|
```
|
|
|
|
Keluar daripada persekitaran dengan `deactivate`.
|
|
|
|
## Jalankan
|
|
|
|
```bash
|
|
python -m scraping_wiki.interaction
|
|
```
|
|
|
|
Chrome dibuka, halaman utama Wikipedia dimuatkan, bilangan artikel dicetak dan pelayar ditutup. Tambah `--headless` untuk berjalan tanpa tetingkap:
|
|
|
|
```bash
|
|
scraping-wiki --headless
|
|
```
|
|
|
|
## Ujian
|
|
|
|
```bash
|
|
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](Docker-Testing-ms).
|
|
|
|
## Dokumentasi API
|
|
|
|
```bash
|
|
doxygen Doxyfile
|
|
```
|
|
|
|
HTML ditulis ke `docs/doxygen/html`.
|