moodlesolver 1.0.0__tar.gz → 2.1.0__tar.gz

moodlesolver-2.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 i-execute
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

moodlesolver-2.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: moodlesolver
+Version: 2.1.0
+Summary: Moodle quiz automation library and MCP server with local OCR
+Author: i-execute
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Requires-Dist: mcp
+Provides-Extra: ocr
+Requires-Dist: pix2tex; extra == "ocr"
+Requires-Dist: pillow; extra == "ocr"
+Provides-Extra: vision
+Dynamic: license-file
+
+# moodlesolver
+
+Асинхронная Python-библиотека и MCP-сервер для автоматизации прохождения тестов на платформе Moodle через браузерный API (camofox).
+
+## Возможности
+
+- **Авторизация и сессии** — вход по логину/паролю, реанимация попытки после обрыва (`resume_attempt`)
+- **Навигация по курсам** — список курсов, секций, ресурсов, тестов; полная выгрузка курса в JSON; скачивание файлов и картинок
+- **Прохождение тестов** — все типы вопросов: одиночный выбор, множественный (чекбоксы), выпадающие списки, ввод текста, вопросы с картинками и формулами
+- **JSON-протокол** — `JsonAPI` и MCP-тул `quiz_command` принимают команды JSON и возвращают состояние вопроса: текст, варианты, что реально отмечено, остаток таймера
+- **OCR без внешних API** — локально: tesseract (текст ru/en) и pix2tex (формулы LaTeX); параллельно, результаты в том же JSON
+- **Картинки в ответе** — base64 или HTTP-ссылки (встроенный файл-сервер `serve_dumps`)
+- **Коды ошибок** — структурированные `E_*` вместо тихих падений
+- **MCP-сервер** — 27 инструментов для подключения любой LLM-моделью
+
+## Установка
+
+```bash
+pip install moodlesolver
+```
+
+Зависимости для OCR (опционально, но рекомендуются):
+
+```bash
+apt-get install tesseract-ocr tesseract-ocr-rus
+pip install pix2tex
+```
+
+Требуется запущенный camofox-browser (API по умолчанию `http://localhost:9377`).
+
+## Быстрый старт
+
+```python
+import asyncio
+from moodlesolver import AsyncMoodle, QuizAPI, JsonAPI
+
+async def main():
+    m = AsyncMoodle(site="https://moodle.example.com")
+    await m.open_session("login", "password")
+
+    from moodlesolver import CtxAPI
+    ctx = CtxAPI(m)
+    quizzes = await ctx.get_quizzes(42)
+
+    q = QuizAPI(m)
+    api = JsonAPI(q)
+
+    st = await api.handle({"action": "state"})
+    print(st["question"], st["options"], st["timeleft"])
+
+    await api.handle({"action": "select", "answers": [{"index": 2}]})
+    st = await api.handle({"action": "confirm"})
+    print(st["question"])
+
+    await api.handle({"action": "submit"})
+    print(await api.handle({"action": "result"}))
+
+asyncio.run(main())
+```
+
+## JSON-протокол
+
+Каждый ответ содержит: `page`, `question`, `question_hash`, `qtype`, `options`, `checked` (что реально отмечено на сервере), `selects`, `text_inputs`, `timeleft`, `buttons`, а также:
+
+- `question_image_b64` / `option_images_b64` — картинки в base64 (или ссылки при `image_mode="url"`)
+- `ocr` — локальное превью каждой картинки: `{"formula": "…", "ru": "…", "en": "…"}`, а при `ai_preview=True` ещё `ai_preview` — описание картинок vision-моделью OpenCode (mimo-v2.6-flash-free по умолчанию)
+
+```python
+api = JsonAPI(q, ai_preview=True)          # включить AI-описание картинок
+api = JsonAPI(q, ai_preview=True, ai_model="opencode/longcat-2.5-preview-free")
+```
+
+Подробная схема: `moodlesolver/schema/quiz_protocol.json`.
+
+## MCP-сервер
+
+```json
+{
+  "mcpServers": {
+    "moodlesolver": {
+      "command": "python",
+      "args": ["-m", "moodlesolver.mcp_server"]
+    }
+  }
+}
+```
+
+Инструменты: connect, get_courses, get_quizzes, get_course, dump_course, download_images, download_resource, search_courses, resume_attempt, start_attempt, get_state, get_options, get_images, set_answer, set_text, set_select, next_page, submit_all, get_result, quiz_command, see_image и другие.
+
+## AIRunner
+
+Полный автопрогон теста одним процессом с решением через внешнюю LLM:
+
+```python
+from moodlesolver import AIRunner
+
+r = AIRunner(api_key="...", base_url="https://api.example.com/v1",
+             model="model-name").bind(q)
+await r.loop(quiz_id)
+```
+
+## Лицензия
+
+MIT

moodlesolver-2.1.0/README.md

@@ -0,0 +1,104 @@
+# moodlesolver
+
+Асинхронная Python-библиотека и MCP-сервер для автоматизации прохождения тестов на платформе Moodle через браузерный API (camofox).
+
+## Возможности
+
+- **Авторизация и сессии** — вход по логину/паролю, реанимация попытки после обрыва (`resume_attempt`)
+- **Навигация по курсам** — список курсов, секций, ресурсов, тестов; полная выгрузка курса в JSON; скачивание файлов и картинок
+- **Прохождение тестов** — все типы вопросов: одиночный выбор, множественный (чекбоксы), выпадающие списки, ввод текста, вопросы с картинками и формулами
+- **JSON-протокол** — `JsonAPI` и MCP-тул `quiz_command` принимают команды JSON и возвращают состояние вопроса: текст, варианты, что реально отмечено, остаток таймера
+- **OCR без внешних API** — локально: tesseract (текст ru/en) и pix2tex (формулы LaTeX); параллельно, результаты в том же JSON
+- **Картинки в ответе** — base64 или HTTP-ссылки (встроенный файл-сервер `serve_dumps`)
+- **Коды ошибок** — структурированные `E_*` вместо тихих падений
+- **MCP-сервер** — 27 инструментов для подключения любой LLM-моделью
+
+## Установка
+
+```bash
+pip install moodlesolver
+```
+
+Зависимости для OCR (опционально, но рекомендуются):
+
+```bash
+apt-get install tesseract-ocr tesseract-ocr-rus
+pip install pix2tex
+```
+
+Требуется запущенный camofox-browser (API по умолчанию `http://localhost:9377`).
+
+## Быстрый старт
+
+```python
+import asyncio
+from moodlesolver import AsyncMoodle, QuizAPI, JsonAPI
+
+async def main():
+    m = AsyncMoodle(site="https://moodle.example.com")
+    await m.open_session("login", "password")
+
+    from moodlesolver import CtxAPI
+    ctx = CtxAPI(m)
+    quizzes = await ctx.get_quizzes(42)
+
+    q = QuizAPI(m)
+    api = JsonAPI(q)
+
+    st = await api.handle({"action": "state"})
+    print(st["question"], st["options"], st["timeleft"])
+
+    await api.handle({"action": "select", "answers": [{"index": 2}]})
+    st = await api.handle({"action": "confirm"})
+    print(st["question"])
+
+    await api.handle({"action": "submit"})
+    print(await api.handle({"action": "result"}))
+
+asyncio.run(main())
+```
+
+## JSON-протокол
+
+Каждый ответ содержит: `page`, `question`, `question_hash`, `qtype`, `options`, `checked` (что реально отмечено на сервере), `selects`, `text_inputs`, `timeleft`, `buttons`, а также:
+
+- `question_image_b64` / `option_images_b64` — картинки в base64 (или ссылки при `image_mode="url"`)
+- `ocr` — локальное превью каждой картинки: `{"formula": "…", "ru": "…", "en": "…"}`, а при `ai_preview=True` ещё `ai_preview` — описание картинок vision-моделью OpenCode (mimo-v2.6-flash-free по умолчанию)
+
+```python
+api = JsonAPI(q, ai_preview=True)          # включить AI-описание картинок
+api = JsonAPI(q, ai_preview=True, ai_model="opencode/longcat-2.5-preview-free")
+```
+
+Подробная схема: `moodlesolver/schema/quiz_protocol.json`.
+
+## MCP-сервер
+
+```json
+{
+  "mcpServers": {
+    "moodlesolver": {
+      "command": "python",
+      "args": ["-m", "moodlesolver.mcp_server"]
+    }
+  }
+}
+```
+
+Инструменты: connect, get_courses, get_quizzes, get_course, dump_course, download_images, download_resource, search_courses, resume_attempt, start_attempt, get_state, get_options, get_images, set_answer, set_text, set_select, next_page, submit_all, get_result, quiz_command, see_image и другие.
+
+## AIRunner
+
+Полный автопрогон теста одним процессом с решением через внешнюю LLM:
+
+```python
+from moodlesolver import AIRunner
+
+r = AIRunner(api_key="...", base_url="https://api.example.com/v1",
+             model="model-name").bind(q)
+await r.loop(quiz_id)
+```
+
+## Лицензия
+
+MIT

moodlesolver-2.1.0/moodlesolver/__init__.py

@@ -0,0 +1,11 @@
+from .client import AsyncMoodle, AsyncTab, CamofoxError
+from .parse import parse_page
+from .quizapi import QuizAPI
+from .ctx import CtxAPI
+from .airunner import AIRunner
+from .jsonapi import JsonAPI
+from .vision import ocr_file, make_on_ocr
+from .aipreview import ai_preview, opencode_available
+from .cdn import serve_dumps
+from .mcp_server import main as mcp_main
+__all__ = ['AsyncMoodle', 'AsyncTab', 'CamofoxError', 'parse_page', 'QuizAPI', 'CtxAPI', 'AIRunner', 'JsonAPI', 'mcp_main', 'ai_preview', 'opencode_available', 'serve_dumps', 'ocr_file', 'make_on_ocr']

moodlesolver-2.1.0/moodlesolver/aipreview.py

@@ -0,0 +1,26 @@
+import shutil
+import subprocess
+
+OC_DEFAULT_MODEL = "opencode/mimo-v2.6-flash-free"
+
+
+def opencode_available():
+    return shutil.which("opencode") is not None
+
+
+def ai_preview(paths, prompt="Опиши что на картинке, весь текст перепиши",
+               model=OC_DEFAULT_MODEL, timeout=120):
+    if not opencode_available() or not paths:
+        return None
+    cmd = ["opencode", "run", prompt, "--model", model]
+    for p in paths:
+        cmd += ["-f", p]
+    try:
+        out = subprocess.run(cmd, capture_output=True, text=True,
+                             timeout=timeout).stdout.strip()
+    except Exception:
+        return None
+    if not out or "Error" in out.splitlines()[0]:
+        return None
+    lines = [ln for ln in out.splitlines() if not ln.startswith(">")]
+    return "\n".join(lines).strip() or None

moodlesolver-2.1.0/moodlesolver/airunner.py

@@ -0,0 +1,90 @@
+import asyncio
+import json
+import urllib.request
+
+class AIRunner:
+
+    def __init__(self, api_key=None, base_url=None, model=None):
+        self.key = api_key
+        self.base = base_url or 'https://integrate.api.nvidia.com/v1'
+        self.model = model or 'meta/llama-3.2-90b-vision-instruct'
+        self.qapi = None
+
+    def bind(self, quizapi):
+        self.qapi = quizapi
+        return self
+
+    def ocr(self, file, prompt=None):
+        from .vision import ocr_file
+        d = getattr(self.qapi.m, 'dumps_dir', None) if self.qapi else None
+        return ocr_file(file, prompt, d)
+
+    def send_ai_request(self, messages, images=None, max_tokens=400):
+        content = [{'type': 'text', 'text': json.dumps(messages, ensure_ascii=False)}] if isinstance(messages, (dict, list)) else [{'type': 'text', 'text': messages}]
+        for b64 in images or []:
+            content.append({'type': 'image_url', 'image_url': {'url': f'data:image/png;base64,{b64}'}})
+        body = json.dumps({'model': self.model, 'max_tokens': max_tokens, 'temperature': 0, 'messages': [{'role': 'user', 'content': content}]}).encode()
+        req = urllib.request.Request(f'{self.base}/chat/completions', data=body, headers={'Authorization': f'Bearer {self.key}', 'Content-Type': 'application/json'})
+        r = json.load(urllib.request.urlopen(req, timeout=120))
+        return r['choices'][0]['message']['content']
+
+    def receive_ai_response(self, text):
+        try:
+            return json.loads(text.strip().strip('`').removeprefix('json').strip())
+        except Exception:
+            return {'action': None, 'raw': text}
+
+    async def execute_ai_response(self, resp):
+        a = resp.get('action')
+        if a == 'answer':
+            for l in resp.get('labels') or ([resp['label']] if resp.get('label') else []):
+                await self.qapi.set_answer(label=l)
+            if resp.get('index') is not None:
+                await self.qapi.set_answer(index=resp['index'])
+        elif a == 'text':
+            await self.qapi.set_text(resp['value'], resp.get('index', 0))
+        elif a == 'select':
+            for v, i in zip(resp.get('values', [resp.get('value')]), range(99)):
+                await self.qapi.set_select(v, i)
+        elif a == 'next':
+            return await self.qapi.next_page()
+        elif a == 'submit':
+            return await self.qapi.submit_all()
+        return resp.get('action')
+
+    async def loop(self, quiz_id, max_steps=60, answer_bank=None):
+        info = await self.qapi.get_quiz_info(quiz_id)
+        if info.get('can_start'):
+            await self.qapi.start_attempt(quiz_id)
+        from .jsonapi import JsonAPI
+        j = JsonAPI(self.qapi, on_ocr=self.ocr)
+        for _ in range(max_steps):
+            st = await j.handle({'action': 'state', 'quiz_id': quiz_id})
+            if st.get('error') and 'summary' not in st.get('url', ''):
+                return st
+            if 'summary' in st.get('url', ''):
+                return await j.handle({'action': 'submit'})
+            bank = None
+            if answer_bank:
+                bank = answer_bank(st.get('question') or '', st.get('options') or [])
+            if bank is not None:
+                cmd = {'action': 'select', 'answers': [{'index': bank}]}
+                if st.get('qtype') == 'text':
+                    cmd = {'action': 'text', 'values': [bank]}
+                await j.handle(cmd)
+                await j.handle({'action': 'confirm'})
+                continue
+            prompt = 'You are solving a Moodle quiz question. Question: ' + json.dumps({'page': st.get('page'), 'question_hash': st.get('question_hash'), 'timeleft': st.get('timeleft'), 'q': st.get('question'), 'options': st.get('options'), 'checked': st.get('checked'), 'images': st.get('images')}, ensure_ascii=False) + ' Reply ONLY JSON: {"action": "answer|text|select|next|submit", "label": "...", "labels": [...], "index": 0, "value": "...", "values": [...]}'
+            if st.get('images'):
+                try:
+                    from .vision import ocr_file
+                    ocrs = await asyncio.to_thread(lambda: [ocr_file(f) for f in st['images']])
+                    prompt += '\nOCR of option images: ' + json.dumps(ocrs, ensure_ascii=False)
+                except Exception:
+                    pass
+            txt = await asyncio.to_thread(self.send_ai_request, prompt, st.get('option_images_b64') or ([st['question_image_b64']] if st.get('question_image_b64') else None))
+            resp = self.receive_ai_response(txt)
+            act = await self.execute_ai_response(resp)
+            if act in ('submit', None):
+                await j.handle({'action': 'confirm'})
+        return await self.qapi.get_result(quiz_id)

moodlesolver-2.1.0/moodlesolver/cdn.py

@@ -0,0 +1,13 @@
+import http.server
+import os
+import socketserver
+
+def serve_dumps(dumps_dir, port=8931):
+    os.chdir(dumps_dir)
+
+    class H(http.server.SimpleHTTPRequestHandler):
+
+        def log_message(self, *a):
+            pass
+    with socketserver.TCPServer(('0.0.0.0', port), H) as httpd:
+        httpd.serve_forever()