skill-tester 1.1.0__tar.gz

skill_tester-1.1.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: skill-tester
+Version: 1.1.0
+Summary: Secure terminal-based exam client for the Live Exam System.
+Author-email: Louis MUKAMA <kimuludoviko@gmail.com>
+License: ICT Hand Ltd.
+Keywords: training,education,cli,terminal,skill-tester
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# skill-tester (Python)
+
+Terminal skill assessment client for the **ICT Hand Training System**.  
+Students install this package once and practice directly from their terminal — no browser required.
+
+## Requirements
+
+- Python 3.8 or newer
+
+## Installation
+
+```bash
+pip install skill-tester
+```
+
+## Usage
+
+Open a terminal and run:
+
+```bash
+skill-tester
+```
+
+The CLI will:
+
+1. Ask for your school email address
+2. Display the topics available to you
+3. Walk you through each question one by one
+4. Submit your answers automatically when done
+
+## Answering questions
+
+- Type your answer and press **Enter**
+- For multi-line answers, press **Enter** on a blank line to finish
+- Press **Ctrl+C** at any time to exit
+
+## License
+
+&copy; ICT Hand Ltd. All rights reserved.

skill_tester-1.1.0/README.md

@@ -0,0 +1,39 @@
+# skill-tester (Python)
+
+Terminal skill assessment client for the **ICT Hand Training System**.  
+Students install this package once and practice directly from their terminal — no browser required.
+
+## Requirements
+
+- Python 3.8 or newer
+
+## Installation
+
+```bash
+pip install skill-tester
+```
+
+## Usage
+
+Open a terminal and run:
+
+```bash
+skill-tester
+```
+
+The CLI will:
+
+1. Ask for your school email address
+2. Display the topics available to you
+3. Walk you through each question one by one
+4. Submit your answers automatically when done
+
+## Answering questions
+
+- Type your answer and press **Enter**
+- For multi-line answers, press **Enter** on a blank line to finish
+- Press **Ctrl+C** at any time to exit
+
+## License
+
+© ICT Hand Ltd. All rights reserved.

skill_tester-1.1.0/main.py

@@ -0,0 +1,345 @@
+import builtins
+import json
+import keyword
+import base64
+import random
+import re
+import sys
+import time
+from urllib.parse import urlparse, urlencode
+
+import requests
+
+
+def _r(s: str) -> str:
+    return bytes(b ^ 0x4B for b in base64.b64decode(s)).decode()
+
+ANSI = sys.stdout.isatty()
+
+
+def _c(code: str) -> str:
+    return code if ANSI else ""
+
+
+C = {
+    "keyword":   _c("\033[94m"),
+    "string":    _c("\033[92m"),
+    "number":    _c("\033[95m"),
+    "comment":   _c("\033[90m"),
+    "function":  _c("\033[96m"),
+    "builtin":   _c("\033[93m"),
+    "class":     _c("\033[36m"),
+    "decorator": _c("\033[35m"),
+    "operator":  _c("\033[91m"),
+    "constant":  _c("\033[31m"),
+    "reset":     _c("\033[0m"),
+}
+
+_STRING_RE    = r"(\"\"\".*?\"\"\"|'''.*?'''|\".*?\"|'.*?')"
+_COMMENT_RE   = r"(\#.*?$)"
+_NUMBER_RE    = r"\b(\d+(?:\.\d*)?)\b"
+_FUNCTION_RE  = r"\b([A-Za-z_]\w*)(?=\()"
+_CLASS_RE     = r"class\s+([A-Za-z_]\w*)"
+_DECORATOR_RE = r"(@[A-Za-z_]\w*)"
+_OPERATOR_RE  = r"([\+\-\*/%=<>!&|^~]+)"
+_CONSTANTS    = {"True", "False", "None"}
+_BUILTINS     = set(dir(builtins))
+
+
+def highlight_code(code: str) -> str:
+    if not ANSI:
+        return code
+    R = C["reset"]
+    code = re.sub(_COMMENT_RE,   lambda m: f"{C['comment']}{m.group()}{R}",   code, flags=re.MULTILINE)
+    code = re.sub(_STRING_RE,    lambda m: f"{C['string']}{m.group()}{R}",    code, flags=re.DOTALL)
+    code = re.sub(_NUMBER_RE,    lambda m: f"{C['number']}{m.group()}{R}",    code)
+    for kw in keyword.kwlist:
+        code = re.sub(rf"\b{kw}\b", f"{C['keyword']}{kw}{R}", code)
+    for const in _CONSTANTS:
+        code = re.sub(rf"\b{const}\b", f"{C['constant']}{const}{R}", code)
+    for b in _BUILTINS:
+        code = re.sub(rf"\b{b}\b", f"{C['builtin']}{b}{R}", code)
+    code = re.sub(_FUNCTION_RE,  lambda m: f"{C['function']}{m.group()}{R}",  code)
+    code = re.sub(_CLASS_RE,     lambda m: f"class {C['class']}{m.group(1)}{R}", code)
+    code = re.sub(_DECORATOR_RE, lambda m: f"{C['decorator']}{m.group()}{R}", code)
+    code = re.sub(_OPERATOR_RE,  lambda m: f"{C['operator']}{m.group()}{R}",  code)
+    return code
+
+
+_SUBMIT_PATH      = _r("Iz8/OzhxZGQiKD8jKiUvZSQlJyIlLmQvKjgjKSQqOS9kKSooIC4lLxQqOyJlOyM7")
+_FILES_PATH       = _r("Iz8/OzhxZGQiKD8jKiUvZSQlJyIlLmQvKjgjKSQqOS9kLC4/FC4zKiYULSInLjhlOyM7")
+_REMOTE_SUBMIT    = _SUBMIT_PATH
+_TIMEOUT_MS       = "8000"
+_TOPIC_RETRIES    = "20"
+_QUESTION_RETRIES = "100"
+
+
+def _get_config():
+    return (
+        _SUBMIT_PATH,
+        _FILES_PATH,
+        _REMOTE_SUBMIT,
+        int(_TIMEOUT_MS) / 1000,
+        int(_TOPIC_RETRIES),
+        int(_QUESTION_RETRIES),
+    )
+
+
+def _normalize(ans: str) -> str:
+    return str(ans).replace(" ", "").lower()
+
+
+def _coerce_answer(q: dict) -> str:
+    if not isinstance(q, dict):
+        return ""
+    raw = q.get("answer") or q.get("correct_answer")
+    if raw is None:
+        return ""
+    if isinstance(raw, list):
+        return ", ".join(str(x).strip() for x in raw if x is not None)
+    if isinstance(raw, dict):
+        for k in ("value", "text", "answer"):
+            if k in raw and raw[k] is not None:
+                return str(raw[k]).strip()
+        return json.dumps(raw, ensure_ascii=False)
+    return str(raw).strip()
+
+
+def _base_url(url: str) -> str:
+    u = urlparse(url)
+    return f"{u.scheme}://{u.netloc}/"
+
+
+def _friendly_err(e) -> str:
+    msg = str(e).lower()
+    if isinstance(e, requests.exceptions.ConnectionError) or "connection" in msg or "refused" in msg:
+        return "Cannot reach the server. Check your connection and try again."
+    if isinstance(e, requests.exceptions.Timeout) or "timeout" in msg or "timed out" in msg:
+        return "Connection timed out. The server took too long to respond."
+    if "not found" in msg or "nodename" in msg or "name or service" in msg:
+        return "Server not found. Check your internet connection."
+    return "An unexpected error occurred. Please try again."
+
+
+def _multiline_input() -> str:
+    print("\nEnter your answer (ENTER on empty line to finish):")
+    lines = []
+    while True:
+        line = input().rstrip()
+        if not line:
+            break
+        lines.append(line)
+    return "\n".join(lines)
+
+
+def _check_email(email: str, api_url: str, timeout: float) -> dict:
+    """POST check_email → { exists, msg, school_id, class_id }"""
+    try:
+        resp = requests.post(api_url, json={"type": "check_email", "email": email}, timeout=timeout)
+        try:
+            data = resp.json()
+        except Exception as e:
+            return {"exists": False, "msg": f"The server returned an unexpected response. Please try again....{e}",
+                    "school_id": None, "class_id": None}
+        if resp.status_code == 200:
+            return {
+                "exists":    data.get("exists", False),
+                "msg":       data.get("msg", "No message from server"),
+                "school_id": data.get("school_id"),
+                "class_id":  data.get("class_id"),
+            }
+        return {"exists": False, "msg": data.get("msg", "The server returned an error. Please try again."),
+                "school_id": None, "class_id": None}
+    except Exception as e:
+        return {"exists": False, "msg": _friendly_err(e), "school_id": None, "class_id": None}
+
+
+def _fetch_topics(
+    api_url: str,
+    student_email: str,
+    timeout: float,
+    retries: int,
+    school_id=None,
+    class_id=None,
+) -> dict:
+    """
+    GET get_exam_files.php?student_email=...&school_id=...&class_id=...
+    Passing school_id / class_id (from check_email) lets the server skip
+    its own redundant DB lookup.
+    Returns a numbered dict of topic items, or {} on failure.
+    """
+    params: dict = {"student_email": student_email}
+    if school_id is not None:
+        params["school_id"] = school_id
+    if class_id is not None:
+        params["class_id"] = class_id
+    full_url = f"{api_url}?{urlencode(params)}"
+    dots = [" .", " ..", " ..."]
+
+    for attempt in range(retries):
+        try:
+            print(f"\rLoading your enrolled topics{dots[attempt % 3]}", end="", flush=True)
+            resp = requests.get(full_url, timeout=timeout)
+            try:
+                data = resp.json()
+            except Exception:
+                data = []
+            if isinstance(data, list) and data:
+                print("\n✔ Topic list loaded.")
+                return {str(i + 1): item for i, item in enumerate(data)}
+            if isinstance(data, dict) and data.get("message"):
+                print(f"\n{C['operator']}{data['message']}{C['reset']}")
+                return {}
+        except Exception:
+            pass
+        time.sleep(1)
+    print("\n❌ Could not fetch your topics. Check your connection and try again.")
+    return {}
+
+
+def _fetch_questions(url: str, timeout: float, retries: int) -> list:
+    dots = [" .", " ..", " ..."]
+    for attempt in range(retries):
+        try:
+            print(f"\rLoading questions{dots[attempt % 3]}", end="", flush=True)
+            resp = requests.get(url, timeout=timeout)
+            data = resp.json()
+            if data:
+                print()
+                return data
+        except Exception:
+            if attempt == 0:
+                print("\n  (connection issue, retrying...)")
+        time.sleep(1)
+    print("\n❌ Could not load questions. Check your connection and try again.")
+    sys.exit(1)
+
+
+def _submit(email: str, answers: list, exam_id: int, api_url: str, timeout: float) -> None:
+    payload = {
+        "type":    "prep_submission",
+        "email":   email,
+        "exam_id": exam_id,
+        "answers": answers,
+    }
+    try:
+        resp = requests.post(api_url, json=payload, timeout=timeout)
+        try:
+            data = resp.json()
+        except Exception:
+            print("\n❌ The server returned an unexpected response. Please try again.")
+            return
+        status = data.get("status", "")
+        msg    = data.get("msg", "No message from server")
+        if status == "success":
+            suffix = f" (recorded as attempt #{data['attempt']})" if data.get("attempt") else ""
+            print(f"\n{C['string']}{msg}{suffix}{C['reset']}")
+        else:
+            print(f"\n{C['operator']}{msg}{C['reset']}")
+    except Exception as e:
+        print(f"\n❌ {_friendly_err(e)}")
+
+
+def run() -> None:
+    try:
+        submit_api, files_api, remote_submit_api, timeout, topic_retries, question_retries = _get_config()
+
+        print("=" * 45)
+        print("          TERMINAL EXAM SYSTEM")
+        print("=" * 45)
+        print()
+        print("Sign in with your school email.\nWe'll fetch topics from your enrolled course(s).\n")
+
+        school_id = None
+        class_id  = None
+
+        while True:
+            email = input("Enter your email: ").strip()
+            if not email:
+                print(f"{C['operator']}Email is required.{C['reset']}")
+                continue
+            print("Checking email on server...")
+            result = _check_email(email, submit_api, timeout)
+            tint = C["string"] if result.get("exists") else C["operator"]
+            print(f"{tint}{result.get('msg', 'No response from server')}{C['reset']}")
+            if result.get("exists"):
+                school_id = result.get("school_id")
+                class_id  = result.get("class_id")
+                break
+
+        # Pass school_id / class_id so get_exam_files.php skips its own DB lookup.
+        topics = _fetch_topics(files_api, email, timeout, topic_retries,
+                               school_id=school_id, class_id=class_id)
+        if not topics:
+            print(f"\n{C['operator']}No topics available yet. Contact your teacher or school master.{C['reset']}")
+            sys.exit(0)
+
+        by_course: dict = {}
+        for key, item in topics.items():
+            cname = (item.get("course_name") or "Other").strip() or "Other"
+            by_course.setdefault(cname, []).append((key, item))
+
+        print("\nTopics available to you:")
+        for cname, entries in by_course.items():
+            print(f"\n  {C['function']}{cname}{C['reset']}")
+            for key, item in entries:
+                print(f"    {key}. {item['file_name'].replace('.json', '')}")
+
+        choice = input("\nEnter option: ").strip()
+        if choice not in topics:
+            print("Invalid choice.")
+            sys.exit(1)
+
+        picked   = topics[choice]
+        full_url = picked.get("full_url")
+
+        if full_url and remote_submit_api:
+            if _base_url(full_url) != _base_url(submit_api):
+                submit_api = remote_submit_api
+
+        exam_id = picked.get("id")
+        if not exam_id:
+            print("❌ Topic is missing a database id — cannot submit.")
+            sys.exit(1)
+
+        questions = _fetch_questions(full_url, timeout, question_retries)
+        random.shuffle(questions)
+        collected = []
+
+        for i, q in enumerate(questions, 1):
+            print(f"\nQuestion {i}/{len(questions)}")
+            print("-" * 39)
+            print()
+            print(q["question"]["text"])
+
+            if "code" in q["question"]:
+                print("\n" + highlight_code("\n".join(q["question"]["code"])))
+
+            ans     = _multiline_input()
+            correct = _coerce_answer(q)
+
+            collected.append({
+                "question_id":    q["id"],
+                "user_answer":    (ans or "").strip(),
+                "correct_answer": correct,
+            })
+
+            if correct and _normalize(ans) == _normalize(correct):
+                print(f"{C['string']}✔ Correct!{C['reset']}")
+            elif correct:
+                explanation = q.get("explanation", "")
+                expl_line   = f"\n{C['string']}{explanation}{C['reset']}" if explanation else ""
+                print(f"{C['operator']}✘ Incorrect.{C['reset']}\n{C['function']}Answer is: {correct}{C['reset']}{expl_line}")
+            else:
+                print(f"{C['comment']}(No reference answer — your response was recorded.){C['reset']}")
+
+        print("\nSubmitting your answers…")
+        _submit(email, collected, exam_id, submit_api, timeout)
+
+    except KeyboardInterrupt:
+        print("\n\n👋 Exam session interrupted. Goodbye!")
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    run()

skill_tester-1.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "skill-tester"
+version = "1.1.0"
+
+description = "Secure terminal-based exam client for the Live Exam System."
+readme = "README.md"
+requires-python = ">=3.8"
+
+authors = [
+    { name = "Louis MUKAMA", email = "kimuludoviko@gmail.com" }
+]
+
+license = { text = "ICT Hand Ltd." }
+
+keywords = [
+    "training",
+    "education",
+    "cli",
+    "terminal",
+    "skill-tester"
+]
+
+dependencies = [
+    "requests>=2.31.0"
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "License :: Other/Proprietary License",
+    "Operating System :: OS Independent",
+    "Environment :: Console",
+    "Intended Audience :: Education",
+    "Topic :: Education",
+]
+
+
+[project.scripts]
+skill-tester = "main:run"
+
+[tool.setuptools]
+py-modules = ["main"]
+
+# -----------------------------
+# bump-my-version configuration
+# -----------------------------
+[tool.bumpversion]
+current_version = "1.1.0"
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+serialize = [
+    "{major}.{minor}.{patch}"
+]
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = 'version = "{current_version}"'
+replace = 'version = "{new_version}"'

skill_tester-1.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

skill_tester-1.1.0/skill_tester.egg-info/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: skill-tester
+Version: 1.1.0
+Summary: Secure terminal-based exam client for the Live Exam System.
+Author-email: Louis MUKAMA <kimuludoviko@gmail.com>
+License: ICT Hand Ltd.
+Keywords: training,education,cli,terminal,skill-tester
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# skill-tester (Python)
+
+Terminal skill assessment client for the **ICT Hand Training System**.  
+Students install this package once and practice directly from their terminal — no browser required.
+
+## Requirements
+
+- Python 3.8 or newer
+
+## Installation
+
+```bash
+pip install skill-tester
+```
+
+## Usage
+
+Open a terminal and run:
+
+```bash
+skill-tester
+```
+
+The CLI will:
+
+1. Ask for your school email address
+2. Display the topics available to you
+3. Walk you through each question one by one
+4. Submit your answers automatically when done
+
+## Answering questions
+
+- Type your answer and press **Enter**
+- For multi-line answers, press **Enter** on a blank line to finish
+- Press **Ctrl+C** at any time to exit
+
+## License
+
+&copy; ICT Hand Ltd. All rights reserved.

skill_tester-1.1.0/skill_tester.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+main.py
+pyproject.toml
+skill_tester.egg-info/PKG-INFO
+skill_tester.egg-info/SOURCES.txt
+skill_tester.egg-info/dependency_links.txt
+skill_tester.egg-info/entry_points.txt
+skill_tester.egg-info/requires.txt
+skill_tester.egg-info/top_level.txt

skill_tester-1.1.0/skill_tester.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

skill_tester-1.1.0/skill_tester.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+skill-tester = main:run

skill_tester-1.1.0/skill_tester.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.31.0

skill_tester-1.1.0/skill_tester.egg-info/top_level.txt

@@ -0,0 +1 @@
+main