Professional study and exam simulation toolkit for the Linux Professional Institute (LPI) 010-160 exam. Bash, PyQt6, and Kivy interfaces with a shared question bank for trainer and exam modes.

This repository provides multiple ways to practice for the LPI Linux Essentials (010-160) certification: a Bash-based interactive exam script, a PyQt6 graphical exam/trainer application, and an optional Kivy mobile-friendly UI. All tools share the same question bank and support multiple-choice and fill-in-the-blank questions.

• Features
• Repository Contents
• Requirements
• Installation
• Usage
• Question Bank Format
• Modes of Operation
• Contributing & License
• Documentation

• 80 exam-style questions aligned with LPI 010-160 (Linux Essentials).
• Two practice modes
  • Trainer: All 80 questions in random order (no time pressure).
  • Exam: 40 random questions with a running timer (exam-like conditions).
• Multiple interfaces
  • Bash (examLPI.sh): Terminal-based, runs anywhere Bash is available.
  • PyQt6 (LPIExam.py): Desktop GUI with checkboxes, timer, and score summary.
  • Kivy (main(1.0).py): Alternative GUI (legacy); useful for touch/tiled layouts.
• Question types
  • Multiple choice (single or multiple correct answers).
  • Fill-in-the-blank (keyword) for a subset of questions.
• Scoring
  • Right/wrong feedback per question.
  • Final score and list of question numbers answered incorrectly.
• Single question bank
  • One shared format (qst.txt) for all tools; see Question Bank Format and DOCUMENTATION.md.

• Linux (and macOS/WSL): ./linux/run.sh — finds repo root, uses .venv/venv if present, runs PyQt6 GUI.
• Windows: windows\run.bat or .\windows\run.ps1 — same behavior; use from the repository root.

See linux/README.md and windows/README.md for setup and requirements per platform.

• Bash (for examLPI.sh): Any system with Bash 4+ (associative arrays).
• Python 3.8+ (for LPIExam.py and Kivy app).
• PyQt6 (for LPIExam.py): Install via pip (see Installation).
• Kivy (optional, for main(1.0).py): Only if you use the legacy Kivy interface.

1. Clone or download the repository:

   git clone <repository-url>
   cd lpi

2. Python environment (for GUI apps):

   python3 -m venv .venv
   source .venv/bin/activate   # Linux/macOS
   # or:  .venv\Scripts\activate  on Windows
   pip install -r requirements.txt

3. Run from the project directory so that qst.txt is found:

   • Bash: ./examLPI.sh (ensure executable: chmod +x examLPI.sh).
   • PyQt6: python3 LPIExam.py.
   • Kivy: python3 "main(1.0).py" (optional).

cd /path/to/lpi
./examLPI.sh

• Follow on-screen prompts; answer by entering option letters (e.g. A, BE).
• No separate “trainer” vs “exam” mode; script defines one question flow.

python3 LPIExam.py

1. Start: Choose Trainer (80 questions) or Exam (40 questions).
2. Per question: Select one or more options (checkboxes) or type the keyword for fill-in questions, then click Submit.
3. Next: After feedback, click Next (or Next question) to continue.
4. End: Summary window shows total answered, correct count, score, and list of wrong question numbers.

• Exit: Use Exit / Stop and Exit to quit at any time.

python3 "main(1.0).py"

• See module docstring and DOCUMENTATION.md for behavior and current limitations.

The file qst.txt uses a line-oriented, structured format so that the same bank can drive the Bash script, PyQt6, and Kivy apps.

• Question number: One or two digits on its own line (e.g. 1, 2, 17).
• Stem: Lines of text until a line starting with A., B., … or FILL.
• Options: Lines starting with A., B., C., D., E. (content after the prefix).
• Fill-in: A line starting with FILL (and optional “BLANK”) marks a fill-in-the-blank question; the next logical block is the prompt; no A.–E. options.
• Explanation: Lines starting with Explanation/Reference: (and following text) are for reference only; parsers may skip them.

For full syntax, edge cases, and examples, see DOCUMENTATION.md.

Scoring in the PyQt6 app is linear: each question contributes equally to the total (e.g. 20 points per question for a 0–100 scale).

• Author: Andrey Pautov ([email protected]).
• License: GNU General Public License v3. See LICENSE.md.
• examLPI.sh: Do not modify in this repo if you rely on the reference version; maintain changes in a fork or separate branch.

• README.md (this file): Overview, installation, usage.
• DOCUMENTATION.md: Detailed qst.txt format, application design, and implementation notes.

For parsing and extending the question bank, always refer to DOCUMENTATION.md and the actual parsers in LPIExam.py (and optionally main(1.0).py).

• No secrets: The repo contains no API keys or credentials. qst.txt is data only.
• Reproducible install: Use pip install -r requirements.txt in a clean venv for a consistent environment.
• Artifacts: Build outputs (e.g. *.exe, dist/) are listed in .gitignore and should not be committed.
• Run from repo root: Start the app from the project directory so qst.txt is found (or place qst.txt next to the script).
• examLPI.sh: Make executable with chmod +x examLPI.sh after clone; no build step required.