Tirsvad-Udemy-100-days-of-code/031-flash-card

Files

T

Tirsvad db87a6d33b MIL-010: release v0.1.0 results, the executable is not attached

The tag v0.1.0 and the release exist and the executable was rebuilt and
smoke-tested from the tagged commit, but the server's reverse proxy rejects
the upload (413). README, CHANGELOG and the wiki Install pages now say that
the executable is built from source until the limit is raised. Review
record RC-055 (Go-with-conditions).

Task: MIL-010#2
Task: MIL-010#3
Task: MIL-010#4
Task: MIL-010#6

2026-10-15 08:43:12 +08:00

2.6 KiB

Raw Blame History

Installation

🌐 English · Dansk · Bahasa Malaysia

Krav

Python 3.13 eller nyere med Tkinter (på Debian eller Ubuntu: sudo apt install python3-tk).
git.
Valgfrit: en internetforbindelse og tilvalget speech, hvis du vil høre det malajiske ord.

Hent koden

git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/031-flash-card.git
cd 031-flash-card

Opret og brug et lokalt virtuelt miljø

Windows (PowerShell):

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Linux og macOS:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

.[dev] tilføjer pytest, ruff, mypy og import-linter. Brug ., hvis du kun vil køre programmet.
Hvis PowerShell nægter at køre Activate.ps1, så kør Set-ExecutionPolicy -Scope CurrentUser RemoteSigned én gang.
Forlad miljøet med deactivate; slet mappen .venv for at starte forfra.

Udtalt malajisk ord (valgfrit)

python -m pip install -e ".[speech]"

Det installerer gTTS og playsound==1.2.2. Uden tilvalget virker programmet uden lyd.

Kør og test

python -m flash_card
python -m pytest

Vinduestesten i tests/e2e/ springes over, når der ikke er en skærm.

Udgivelse og programfil (Windows)

Udgivelsessiden for v0.1.0 har udgivelsesnoterne. Programfilen er endnu ikke vedhæftet, fordi serverens grænse for upload afviser en fil af denne størrelse (HTTP 413); byg den som beskrevet nedenfor. Filen er ikke signeret, så Windows kan vise en SmartScreen-advarsel.

Byg en programfil (Windows)

python -m pip install -e ".[build,speech]"
python tools/build_executable.py

Scriptet bruger PyInstaller og skriver dist/flash-card.exe: én fil uden konsolvindue, med billeder, ordliste og udtalen indeni. Dobbeltklik for at starte; Python er ikke nødvendigt for at køre den.

Din fremgang gemmes i en data/-mappe ved siden af programfilen (data/words_to_learn.csv).
En data/ms-da.csv ved siden af programfilen erstatter ordlisten indeni.
python tools/build_executable.py --no-speech udelader talepakkerne; --clean bygger forfra.
Programfilen er ikke i repositoryet. Byg den på det system, hvor den skal køre; Windows kan vise en SmartScreen-advarsel, fordi filen ikke er signeret.

Dokumentation af kildekoden

doxygen Doxyfile

HTML-filerne skrives til docs/doxygen/html/index.html.

2.6 KiB Raw Blame History