matthew-ide 1.2.0__py3-none-any.whl

matthew_ide/__init__.py

@@ -0,0 +1,15 @@
+from importlib.metadata import version
+from typing import Literal
+
+__version__ = version(__name__)
+
+
+APP_PACKAGE_NAME = "analyst-klondike"
+APP_FOLDER_NAME = "AnalystKlondike"
+
+
+WELLCOME_SCREEN_APP_NAME = "Клондайк аналитика"
+WELCOME_SCREEN_APP_TITLE = "Klondike"
+WELCOME_SCREEN_APP_SUBTITLE = "code editor"
+
+EVENT_DESTINATION: Literal["local_db", "remote_db", "no_events"] = "local_db"

matthew_ide/app/dev_runner.py

@@ -0,0 +1,3 @@
+from matthew_ide.app.matthew_app import MatthewApp
+
+app = MatthewApp()

matthew_ide/app/matthew_app.py

@@ -0,0 +1,114 @@
+from importlib.metadata import PackageNotFoundError, version
+from typing import Callable
+
+
+import pyperclip  # type: ignore
+from textual import on, work
+from textual.reactive import reactive
+from textual.app import App
+
+from matthew_ide import APP_PACKAGE_NAME
+from matthew_ide.features.app_folder import init_app_working_folder
+from matthew_ide.features.events import send_event
+from matthew_ide.features.update import is_outdated
+from matthew_ide.screens.code_simulator import CodeSimulatorScreen
+from matthew_ide.screens.message_box.mb_screen import MessageBoxScreen
+from matthew_ide.screens.save_question import SaveQuestion, SaveQuestionModalResult
+
+
+class MatthewApp(App[int]):
+
+    MODES = {  # type: ignore
+        "code_simulator": CodeSimulatorScreen,
+    }
+
+    demo_file_name = reactive("demo.yaml")
+    save_func: reactive[Callable[[], None] | None] = reactive(None)
+
+    @work
+    async def on_mount(self) -> None:
+        self.theme = "textual-dark"
+        self.title = self.app_title
+        self.sub_title = "Интерактивный тренажер Python на вашем компьютере"
+
+        self._try_init_app()
+        self.send_event("app_opened")
+        await self._display_message_if_app_outdated()
+
+        self.switch_mode("code_simulator")
+
+    def send_event(
+            self,
+            event_name: str,
+            event_json: dict[str, str | int | bool] | None = None) -> None:
+        send_event(self, event_name, event_location="/", event_json=event_json)
+
+    async def _display_message_if_app_outdated(self) -> None:
+        update_check = is_outdated()
+
+        if update_check is None:
+            await self.push_screen_wait(MessageBoxScreen(
+                message="Ошибка при загрузке последней версии приложения"
+            ))
+            self.send_event("fail_to_get_latest_version")
+            self.exit()
+        if update_check and update_check.is_outdated:
+            await self.push_screen_wait(MessageBoxScreen(
+                message=f"Доступна новая версия {update_check.latest_version} " +
+                f"(сейчас установлена {update_check.current_version}). \n"
+                "Обновите приложение. \n" +
+                "Для этого закройте приложение и запустите команду: \n" +
+                "[@click=app.copy_update_str_to_clipboard]uv tool upgrade analyst-klondike[/]"
+            ))
+            self.send_event("app_is_outdated")
+            self.exit()
+
+    @on(CodeSimulatorScreen.NotifyToChangeAppTitle)
+    def on_task_selected(self, event: CodeSimulatorScreen.NotifyToChangeAppTitle) -> None:
+        self.sub_title = event.task_title
+
+    @property
+    def app_title(self) -> str:
+        try:
+            return f"Клондайк аналитика {version(APP_PACKAGE_NAME)}"
+        except PackageNotFoundError:
+            return "Клондайк аналитика"
+
+    # Copy to clipboard update string
+    def action_copy_update_str_to_clipboard(self) -> None:
+        try:
+            pyperclip.copy('uv tool upgrade analyst-klondike')
+            self.notify(
+                message="Скопировано uv tool upgrade analyst-klondike",
+                title="Клондайк аналитика",
+                severity="information"
+            )
+            self.send_event("update_command_is_copied")
+        except Exception:  # pylint: disable=W0718
+            self.notify(
+                message="Ошибка при копировании uv tool upgrade analyst-klondike в буфер обмена",
+                title="Клондайк аналитика",
+                severity="error"
+            )
+
+    async def action_quit(self) -> None:
+        def _callback(res: SaveQuestionModalResult | None) -> None:
+            if res == "save":
+                if self.save_func:
+                    self.save_func()
+            if res != "cancel":
+                self.send_event("app_normally_closed")
+                self.exit(0)
+
+        self.push_screen(SaveQuestion(), _callback)
+
+    def _try_init_app(self) -> None:
+        try:
+            init_app_working_folder()
+            self.send_event("app_folder_created")
+        except Exception:  # pylint: disable=broad-exception-caught
+            self.send_event("fail_to_create_app_folder")
+            self.notify(
+                "Не удалось создать папку с данными приложения",
+                severity="error"
+            )

matthew_ide/app/runner.py

@@ -0,0 +1,10 @@
+from matthew_ide.app.matthew_app import MatthewApp
+
+
+def run_matthew():
+    app = MatthewApp()
+    app.run()
+
+
+if __name__ == "__main__":
+    run_matthew()

matthew_ide/assets/demo.yaml

@@ -0,0 +1,421 @@
+quiz_info:
+  min_supported_app_version: 1.0.17
+user_info:
+  email: analyst_klondike
+quizes:
+  python_basics:
+    title: Основы Python
+    questions:
+      Изменить порядок слов в предложении:
+        text: "Дано предложение, без запятых, только английские символы, используются\
+          \ только строчные буквы. \n\nНаписать функцию, меняющую порядок слов в предложении\
+          \ на обратный. \n\nНапример 'the sky is blue' -> 'blue is sky the'"
+        code_template: "def solution(s: str) -> str:\n    pass"
+        code: "def solution(s: str) -> str:\n    words = s.split()\n    rev = reversed(words)\n\
+          \    return \" \".join(rev)      "
+        test_cases:
+        - s: hello
+          expected: hello
+        - s: hello world
+          expected: world hello
+        - s: all work and no play makes jack a dull boy
+          expected: boy dull a jack makes play no and work all
+        is_passed: passed
+        params:
+          s: str
+          return: str
+      Сумма всех четных чисел до N:
+        text: Напишите функцию, которая вычисляет сумму всех четных чисел в промежутке
+          от 1 до N, включая N.
+        code_template: "def solution(n: int):\n    return 0"
+        code: "def solution(n: int):\n    return 0"
+        test_cases:
+        - n: 1
+          expected: 0
+        - n: 10
+          expected: 30
+        - n: 19
+          expected: 90
+        is_passed: failed
+        params:
+          n: int
+          return: int
+      Разворот числа:
+        text: 'Напишите программу, которая развернет число: 12345 -> 54321. Для отрицательных
+          чисел вернуть тоже самое число (без разворотов). Считаем, что функция принимает
+          только натуральные числа.'
+        code_template: "def solution(n: int):\n    return n"
+        code: "def solution(n: int):\n    print(\"Hello, world\")\n    return n"
+        test_cases:
+        - n: 0
+          expected: 0
+        - n: 123
+          expected: 321
+        - n: 123456
+          expected: 654321
+        is_passed: failed
+        params:
+          n: int
+          return: int
+  more_difficult_tasks:
+    title: Сложные задачи по Python
+    questions:
+      Самый длинный префикс:
+        text: "Дан список слов. \nНаписать функцию, которая вернет самый длинный префикс.\n\
+          Префикс - набор букв, с которых начинается слово.\nНапример:\n - solution(['flower',\
+          \ 'flow', 'flight']) -> 'fl'"
+        code_template: "def solution(words: list[str]) -> str:\n    return ''"
+        code: "def solution(words: list[str]) -> str:\n    return ''"
+        test_cases:
+        - words:
+          - flower
+          - flow
+          - flight
+          expected: fl
+        - words:
+          - abc
+          - xyz
+          - hgf
+          expected: ''
+        - words:
+          - europe
+          - europe
+          - europe
+          expected: europe
+        is_passed: not_runned
+        params:
+          words: list
+          return: str
+      Сумма чисел:
+        text: 'Дан массив чисел и число target. Написать функцию, которая вернет список,
+          состоящий из двух индексов элементов, которые в сумме дают число target.
+          Допустим, что в массиве существует только одна пара таких элементов.
+
+          Например:
+
+          - solution([2,7,11,15], 9) -> [0,1], т.к. 2 + 7 = 9, числа находятся на
+          позициях 0 и 1 соответственно.'
+        code_template: "def solution(nums: list, target: int) -> list[int]:\n    return\
+          \ []"
+        code: "def solution(nums: list, target: int) -> list[int]:\n    return []"
+        test_cases:
+        - nums:
+          - 2
+          - 7
+          - 11
+          - 15
+          target: 9
+          expected:
+          - 0
+          - 1
+        - nums:
+          - 2
+          - 7
+          - 11
+          - 15
+          target: 18
+          expected:
+          - 1
+          - 2
+        is_passed: not_runned
+        params:
+          nums: list
+          target: int
+          return: list
+      Группировка анаграмм:
+        text: 'Написать функцию, которая группирует слова-анаграммы вместе.
+
+          Например для списка слов [''eat'',''tea'',''the'',''teh'',''hte'',''abc'',''edf'']
+          функция должна вернуть
+
+          [[''eat'',''tea''], [''the'',''teh'',''hte''], ''abc'',''edf''].
+
+          Два слова являются анаграммами если они состоят из одних и тех же букв,
+          но в разном порядке.'
+        code_template: "def solution(words: list):\n    return []"
+        code: "def solution(words: list):\n    return []"
+        test_cases:
+        - words:
+          - eat
+          - tea
+          - the
+          - teh
+          - hte
+          - abc
+          - edf
+          expected:
+          - - eat
+            - tea
+          - - the
+            - teh
+            - hte
+          - abc
+          - edf
+        is_passed: not_runned
+        params:
+          words: list
+          return: list
+  list_string_tasks:
+    title: Списки и строки
+    questions:
+      Поиск подстрок:
+        text: 'Написать функцию, которая принимает строку subs и строку long_string.
+
+          Функция вернет список индексов всех вхождений подстроки subs в строке long_string.
+
+          Номера позиций начинаются с нуля.
+
+          Например:
+
+          - подстрока "hello" встречается в строке "hello, world, all people hello"
+          два раза: на позиции 0 (начало строки) и 25.
+
+          - подстрока "xyz" встречается в строке "abc def xyz ghr" один раз на позиции
+          8.
+
+          Таким образом:
+
+          - solution("hello, world, all people hello") -> [0, 25]
+
+          - solution("xyz", "abc def xyz ghr") -> [8]
+
+          - solution("", "my string") -> [] (для пустой строки вернет пустой список)
+
+          - solution("hello", "ok, great!") -> [] (нет вхождений)'
+        code_template: "def solution(subs: str, long_string: str):\n    return []"
+        code: "def solution(subs: str, long_string: str):\n    return []"
+        test_cases:
+        - subs: abc
+          long_string: _abc_abc
+          expected:
+          - 1
+          - 5
+        - subs: hello
+          long_string: hello world hello
+          expected:
+          - 0
+          - 12
+        - subs: xyz
+          long_string: abc def xyz ghr
+          expected:
+          - 8
+        is_passed: not_runned
+        params:
+          subs: str
+          long_string: str
+          return: list
+      Нерадивый ученик:
+        text: 'Ученик написал на доске предложение:
+
+          ''привет, мир. какая хорошая погода. мне все нравится.''
+
+          Но он забыл, что предложения начинаются с большой буквы.
+
+          Напишите функцию, которая принимает строку с таким предложением и возвращает
+          новую строку, где все предложения начинаются с большой буквы.
+
+          Считаем, что предложение может заканчиваться только точкой.'
+        code_template: "def solution(sentence: str):\n    return ''"
+        code: "def solution(sentence: str):\n    return ''"
+        test_cases:
+        - sentence: ''
+          expected: ''
+        - sentence: привет.
+          expected: Привет.
+        - sentence: анализ данных - лучшая профессия.
+          expected: Анализ данных - лучшая профессия.
+        - sentence: привет, мир. какая хорошая погода. мне все нравится.
+          expected: Привет, мир. Какая хорошая погода. Мне все нравится.
+        is_passed: not_runned
+        params:
+          sentence: str
+          return: str
+      Аббревиатура:
+        text: 'Напишите функцию, которая принимает название учреждения и возвращает
+          аббревиатуру.
+
+          Например: - Министерство Иностранных Дел -> МИД - Российская Федерация ->
+          РФ
+
+          Нельзя привязываться к числу слов, их может быть бесконечное число. Буквы
+          в entity могут быть как большими, так и маленькими. Если в entity одно слово,
+          то вернуть его первую букву, например: ''учреждение'' -> ''У'''
+        code_template: "def solution(entity: str):\n    return ''"
+        code: "def solution(entity: str):\n    return ''"
+        test_cases:
+        - entity: ''
+          expected: ''
+        - entity: учреждение
+          expected: У
+        - entity: Российская Федерация
+          expected: РФ
+        - entity: министерство иностранных дел
+          expected: МИД
+        - entity: союз   советских   социалистических  республик
+          expected: СССР
+        is_passed: not_runned
+        params:
+          entity: str
+          return: str
+      Локальные максимумы:
+        text: 'Напишите функцию, которая принимает список и возвращает список локальных
+          максимумов. Крайние элементы списка максимумами не являются.
+
+          Локальный максимум - это элемент, который:
+
+          - больше предыдущего
+
+          - больше следующего
+
+          Например:
+
+          - [1,2,5,3,4,7,8,3,2,0] -> [5, 8]
+
+          - [3,2,1] -> [] пустой список, не лок. максимумов.'
+        code_template: "def solution(lst: list):\n    return []"
+        code: "def solution(lst: list):\n    return []"
+        test_cases:
+        - lst:
+          - 8
+          - 7
+          - 6
+          - 5
+          - 4
+          expected: []
+        - lst:
+          - 8
+          - 10
+          - 6
+          - 5
+          - 4
+          expected:
+          - 10
+        - lst:
+          - 1
+          - 4
+          - 2
+          - 5
+          - 10
+          - 3
+          - 2
+          expected:
+          - 4
+          - 10
+        - lst:
+          - 1
+          - 2
+          - 5
+          - 3
+          - 4
+          - 7
+          - 8
+          - 3
+          - 2
+          - 0
+          expected:
+          - 5
+          - 8
+        is_passed: not_runned
+        params:
+          lst: list
+          return: list
+      Сумма положительных:
+        text: 'Написать функцию, которая принимает список чисел и вернет сумму только
+          положительных элементов.
+
+          Для пустого списка вернуть 0. Аналогично, вернуть 0 если нет ни одного положительного
+          элемента.
+
+          Например:
+
+          - solution([]) -> 0
+
+          - solution([1, 2, -3]) -> 3
+
+          - solution([3, 4, -2, 7, -10, 12]) -> 26'
+        code_template: "def solution(lst: list):\n    return 0"
+        code: "def solution(lst: list):\n    return 0"
+        test_cases:
+        - lst: []
+          expected: 0
+        - lst:
+          - 14
+          expected: 14
+        - lst:
+          - 2
+          - 5
+          - 8
+          expected: 15
+        - lst:
+          - 3
+          - -2
+          - -2
+          - -15
+          - -10
+          - 12
+          expected: 15
+        - lst:
+          - 1
+          - 2
+          - -3
+          expected: 3
+        - lst:
+          - 3
+          - 4
+          - -2
+          - 7
+          - -10
+          - 12
+          expected: 26
+        - lst:
+          - -3
+          - -4
+          - -2
+          - -7
+          - -10
+          - -12
+          expected: 0
+        is_passed: not_runned
+        params:
+          lst: list
+          return: int
+      Простое число:
+        text: 'Напишите функцию, которая возращает true, если число является простым.
+
+          Число является простым, если нацело делится только на 1 и само себя.
+
+          Например:
+
+          - 7 - простое, т.к. делится нацело только на себя и 1.
+
+          - 8, к примеру, простым не является, потому что без остатка делится еще
+          и на 2, и 4.
+
+          Подсказка: пройдетесь по всем числам, меньше заданного и проверьте делимость'
+        code_template: "def solution(n: int):\n    return True"
+        code: "def solution(n: int):\n    return True"
+        test_cases:
+        - n: 1
+          expected: true
+        - n: 2
+          expected: true
+        - n: 3
+          expected: true
+        - n: 4
+          expected: false
+        - n: 5
+          expected: true
+        - n: 6
+          expected: false
+        - n: 8
+          expected: false
+        - n: 11
+          expected: true
+        - n: 13
+          expected: true
+        - n: 14
+          expected: false
+        is_passed: not_runned
+        params:
+          n: int
+          return: bool

matthew_ide/features/app_folder/__init__.py

@@ -0,0 +1,44 @@
+import uuid
+from pathlib import Path
+from platformdirs import user_data_dir
+
+from matthew_ide import APP_FOLDER_NAME
+
+
+def init_app_working_folder() -> None:
+    _create_app_folder()
+    write_user_id()
+
+
+class NoUserIdException(Exception):
+    def __init__(self, user_id_file_path: str) -> None:
+        super().__init__(*user_id_file_path)
+        self.user_id_file_path = user_id_file_path
+
+
+def read_user_id() -> str:
+    app_folder = _get_app_folder()
+    user_id_file = app_folder / "user_id.txt"
+    if not user_id_file.exists():
+        raise FileExistsError()
+    user_id = user_id_file.read_text()
+    if user_id == "":
+        raise NoUserIdException(str(user_id_file))
+    return user_id
+
+
+def write_user_id() -> None:
+    app_folder = _get_app_folder()
+    user_id_file = app_folder / "user_id.txt"
+    user_id = str(uuid.uuid4())
+    user_id_file.write_text(user_id)
+
+
+def _get_app_folder() -> Path:
+    return Path(user_data_dir()) / APP_FOLDER_NAME
+
+
+def _create_app_folder() -> None:
+    app_folder = _get_app_folder()
+    if not app_folder.exists():
+        app_folder.mkdir()

matthew_ide/features/events/__init__.py

@@ -0,0 +1,5 @@
+from .hook import send_event
+
+__all__ = [
+    "send_event"
+]

matthew_ide/features/events/hook.py

@@ -0,0 +1,51 @@
+from typing import Any, Literal
+
+from textual import log
+from textual.app import App
+
+from matthew_ide import EVENT_DESTINATION
+
+from .sender.event_sender import BaseEventSender
+from .sender.api_sender import ApiEventSender
+from .sender.no_sender import NoEventSender
+
+
+def _create_sender(
+        sender_type: Literal["local_db", "remote_db", "no_events"]
+) -> BaseEventSender:
+    if sender_type == "local_db":
+        return ApiEventSender(
+            api_url="https://localhost:7150/api/NeonApi/PostEvent")
+    if sender_type == "remote_db":
+        return ApiEventSender(
+            api_url="https://www.xn----7sbbaat6aaehdfdhwgj7f.xn--p1ai/api/NeonApi/PostEvent")
+    if sender_type == "no_events":
+        return NoEventSender()
+    raise ValueError(f"Event sender <{sender_type}> supported")
+
+
+def _wrapper():
+
+    _sender = _create_sender(EVENT_DESTINATION)
+
+    def _send_event(
+            app: App[Any],
+            event_name: str,
+            event_location: str,
+            event_json: dict[str, str | int | bool] | None = None) -> None:
+
+        async def _send_async(event_name: str,
+                              event_location: str) -> None:
+            try:
+                await _sender.send_event(event_name=event_name,
+                                         event_location=event_location,
+                                         event_json=event_json)
+            except Exception as ex:  # pylint: disable=broad-exception-caught
+                log(f"Ошибка отправки события {event_name}/{event_location}: {str(ex)}")
+
+        app.run_worker(_send_async(event_name, event_location), thread=True)
+
+    return _send_event
+
+
+send_event = _wrapper()