miet-schedule-api 0.1.0__tar.gz

miet_schedule_api-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deka
+
+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.

miet_schedule_api-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+include requirements.txt

miet_schedule_api-0.1.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: miet-schedule-api
+Version: 0.1.0
+Summary: Небольшая библиотека для получения расписания групп МИЭТ
+Home-page: https://github.com/TheDIMONDK/miet_schedule_api
+Author: Deka
+Author-email: Deka <dka@disroot.org>
+License: MIT
+Project-URL: Homepage, https://github.com/TheDIMONDK/miet_schedule_api
+Project-URL: Repository, https://github.com/TheDIMONDK/miet_schedule_api
+Project-URL: Issues, https://github.com/TheDIMONDK/miet_schedule_api/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# MIET Schedule API
+
+Небольшая библиотека для получения и структурирования расписания указанных групп МИЭТ.
+
+
+## Возможности
+- Получение расписания для любой группы из списка МИЭТ.
+- Проверка существования группы перед запросом, используя официальное API.
+- Получение расписания на одну дату или диапазон дат, формат: `ДД.ММ.ГГГГ` или `ДД.ММ.ГГГГ-ДД.ММ.ГГГГ`.
+- Получение расписания на текущую, следующую или предыдущую неделю.
+- Кэширование данных в едином файле `last_data.json`, чтобы не мучать API МИЭТ.
+- Принудительное обновление кэша через параметр `force=True`.
+- Пропуск дней, состоящих только из военной подготовки, управляется флагом `SKIP_MILITARY`.
+- Автоматическое определение года начала семестра: если текущий месяц >= сентября, используется текущий год, иначе - предыдущий.
+- Возможность явно установить дату начала семестра через функцию `set_semester_start()`.
+- Возврат результата с мета-информацией: `isFromCache` источник данных, `data` само расписание и `meta` - метаинформация о неделях для каждой даты.
+- Возврат в виде словаря или отформатированной строки JSON, это управляется параметрами `return_json` и `pretty`.
+
+> Важно: библиотека пока не учитывает каникулы и праздничные дни.
+
+
+## Структура вывода
+```jsonc
+{
+  "isFromCache": true, // Вывод был закэширован, или было прямое обращение к API?
+  "data": {
+    "01.09.2026": { // День
+      "1": {
+        "time": ["09:00", "10:20"],
+        "title": "Название",
+        "type": "Лекция",
+        "full_name": "Фамилия Имя Отчество",
+        "room": "1201"
+      },
+      ...
+    },
+    "02.09.2026": {...},
+    ...
+  },
+  "meta": {
+    "weeks": {
+      "01.09.2026": {
+        "number": 1, // Номер недели по счёту в этом дне
+        "type": 0, // Тип недели, 1-й/2-й числитель/знаменатель в виде простого ID
+        "typeString": "Числитель - 1" // Тоже самое, но уже приведённое к читаемому виду
+      },
+      "02.09.2026": {...},
+      ...
+    },
+    "total_weeks": 20 // Общее количество недель
+  }
+}
+```
+
+
+## Установка
+### Локальная установка / для разработки
+```sh
+pip install -e .
+```
+
+### Установка из PyPI
+```sh
+pip install miet_schedule_api
+```
+
+### Установка из GitHub
+```sh
+pip install git+https://github.com/TheDIMONDK/miet_schedule_api.git
+```
+
+## Использование
+```py
+from miet_schedule_api import *
+
+# Получить список всех существующих групп
+groups = get_groups_list()
+print(groups)
+
+# Расписание на один день, смотрим на само расписание без метаданных
+schedule = get_schedule(group="ИТД-11", date_str="01.09.2026")
+print(schedule["data"])
+
+# Диапазон дат, вдобавок возвращаем и красивую JSON-строку
+schedule_json = get_schedule_range(
+    group="ИТД-11",
+    start_date_str="01.09.2026",
+    end_date_str="05.09.2026",
+    return_json=True,
+    pretty=True
+)
+print(schedule_json)
+
+# Расписание+метаданные текущей недели с понедельника по воскресенье
+current_week = get_current_week(group="ИТД-11", return_json=True, pretty=True)
+print(current_week)
+
+# Расписание+метаданные следующей недели относительно сегодня
+next_week = get_next_week(group="ИТД-11", return_json=True, pretty=True)
+print(next_week)
+
+# Расписание+метаданные предыдущей недели относительно заданной даты
+prev_week = get_previous_week(group="ИТД-11", date_str="15.09.2026", return_json=True, pretty=True)
+print(prev_week)
+```
+
+
+## Параметры функций
+- `group` (str, обязательный) - код группы.
+- `return_json` (bool, default=False) - если True, возвращает строку JSON вместо словаря.
+- `pretty` (bool, default=False) - если True и `return_json=True`, JSON выводится с отступами.
+- `force` (bool, default=False) - принудительно запрашивает данные с сервера, игнорируя кэш.
+- `date_str` (str) - дата в формате `ДД.ММ.ГГГГ`, для функций недели опциональна.
+- `start_date_str`, `end_date_str` (str) - начальная и конечная даты диапазона.
+
+
+## Разработка
+### Сборка пакета
+```sh
+pip install build
+python -m build
+```
+
+## Конфигурация
+Базовые настройки по умолчанию находятся в `miet_schedule_api/consts.py`:
+
+- `API_URL` - URL для запроса расписания.
+- `GROUPS_URL` - URL для получения списка групп.
+- `TOTAL_WEEKS` - общее количество недель в семестре, по умолчанию 20.
+- `SKIP_MILITARY` - пропускать ли дни с военной подготовкой.
+- `SEMESTER_START` - автоматически вычисляется, но можно переопределить, если нужно.
+
+## Лицензия
+MIT

miet_schedule_api-0.1.0/README.md

@@ -0,0 +1,134 @@
+# MIET Schedule API
+
+Небольшая библиотека для получения и структурирования расписания указанных групп МИЭТ.
+
+
+## Возможности
+- Получение расписания для любой группы из списка МИЭТ.
+- Проверка существования группы перед запросом, используя официальное API.
+- Получение расписания на одну дату или диапазон дат, формат: `ДД.ММ.ГГГГ` или `ДД.ММ.ГГГГ-ДД.ММ.ГГГГ`.
+- Получение расписания на текущую, следующую или предыдущую неделю.
+- Кэширование данных в едином файле `last_data.json`, чтобы не мучать API МИЭТ.
+- Принудительное обновление кэша через параметр `force=True`.
+- Пропуск дней, состоящих только из военной подготовки, управляется флагом `SKIP_MILITARY`.
+- Автоматическое определение года начала семестра: если текущий месяц >= сентября, используется текущий год, иначе - предыдущий.
+- Возможность явно установить дату начала семестра через функцию `set_semester_start()`.
+- Возврат результата с мета-информацией: `isFromCache` источник данных, `data` само расписание и `meta` - метаинформация о неделях для каждой даты.
+- Возврат в виде словаря или отформатированной строки JSON, это управляется параметрами `return_json` и `pretty`.
+
+> Важно: библиотека пока не учитывает каникулы и праздничные дни.
+
+
+## Структура вывода
+```jsonc
+{
+  "isFromCache": true, // Вывод был закэширован, или было прямое обращение к API?
+  "data": {
+    "01.09.2026": { // День
+      "1": {
+        "time": ["09:00", "10:20"],
+        "title": "Название",
+        "type": "Лекция",
+        "full_name": "Фамилия Имя Отчество",
+        "room": "1201"
+      },
+      ...
+    },
+    "02.09.2026": {...},
+    ...
+  },
+  "meta": {
+    "weeks": {
+      "01.09.2026": {
+        "number": 1, // Номер недели по счёту в этом дне
+        "type": 0, // Тип недели, 1-й/2-й числитель/знаменатель в виде простого ID
+        "typeString": "Числитель - 1" // Тоже самое, но уже приведённое к читаемому виду
+      },
+      "02.09.2026": {...},
+      ...
+    },
+    "total_weeks": 20 // Общее количество недель
+  }
+}
+```
+
+
+## Установка
+### Локальная установка / для разработки
+```sh
+pip install -e .
+```
+
+### Установка из PyPI
+```sh
+pip install miet_schedule_api
+```
+
+### Установка из GitHub
+```sh
+pip install git+https://github.com/TheDIMONDK/miet_schedule_api.git
+```
+
+## Использование
+```py
+from miet_schedule_api import *
+
+# Получить список всех существующих групп
+groups = get_groups_list()
+print(groups)
+
+# Расписание на один день, смотрим на само расписание без метаданных
+schedule = get_schedule(group="ИТД-11", date_str="01.09.2026")
+print(schedule["data"])
+
+# Диапазон дат, вдобавок возвращаем и красивую JSON-строку
+schedule_json = get_schedule_range(
+    group="ИТД-11",
+    start_date_str="01.09.2026",
+    end_date_str="05.09.2026",
+    return_json=True,
+    pretty=True
+)
+print(schedule_json)
+
+# Расписание+метаданные текущей недели с понедельника по воскресенье
+current_week = get_current_week(group="ИТД-11", return_json=True, pretty=True)
+print(current_week)
+
+# Расписание+метаданные следующей недели относительно сегодня
+next_week = get_next_week(group="ИТД-11", return_json=True, pretty=True)
+print(next_week)
+
+# Расписание+метаданные предыдущей недели относительно заданной даты
+prev_week = get_previous_week(group="ИТД-11", date_str="15.09.2026", return_json=True, pretty=True)
+print(prev_week)
+```
+
+
+## Параметры функций
+- `group` (str, обязательный) - код группы.
+- `return_json` (bool, default=False) - если True, возвращает строку JSON вместо словаря.
+- `pretty` (bool, default=False) - если True и `return_json=True`, JSON выводится с отступами.
+- `force` (bool, default=False) - принудительно запрашивает данные с сервера, игнорируя кэш.
+- `date_str` (str) - дата в формате `ДД.ММ.ГГГГ`, для функций недели опциональна.
+- `start_date_str`, `end_date_str` (str) - начальная и конечная даты диапазона.
+
+
+## Разработка
+### Сборка пакета
+```sh
+pip install build
+python -m build
+```
+
+## Конфигурация
+Базовые настройки по умолчанию находятся в `miet_schedule_api/consts.py`:
+
+- `API_URL` - URL для запроса расписания.
+- `GROUPS_URL` - URL для получения списка групп.
+- `TOTAL_WEEKS` - общее количество недель в семестре, по умолчанию 20.
+- `SKIP_MILITARY` - пропускать ли дни с военной подготовкой.
+- `SEMESTER_START` - автоматически вычисляется, но можно переопределить, если нужно.
+
+## Лицензия
+MIT

miet_schedule_api-0.1.0/miet_schedule_api/__init__.py

@@ -0,0 +1,34 @@
+"""
+Небольшая библиотека для получения расписания групп МИЭТ.
+"""
+
+from .core import (
+    get_schedule,
+    get_schedule_range,
+    get_current_week,
+    get_next_week,
+    get_previous_week,
+    fetch_schedule,
+    get_groups_list,
+    validate_group,
+    load_cached_data,
+    save_cached_data,
+    set_semester_start,
+    set_skip_military,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "get_schedule",
+    "get_schedule_range",
+    "get_current_week",
+    "get_next_week",
+    "get_previous_week",
+    "fetch_schedule",
+    "get_groups_list",
+    "validate_group",
+    "load_cached_data",
+    "save_cached_data",
+    "set_semester_start",
+    "set_skip_military",
+]

miet_schedule_api-0.1.0/miet_schedule_api/consts.py

@@ -0,0 +1,56 @@
+"""
+Константы для скрипта расписания.
+"""
+
+from datetime import datetime
+
+
+# URL API расписания МИЭТ
+API_URL = "https://miet.ru/schedule/data"
+
+# URL API списка групп
+GROUPS_URL = "https://miet.ru/schedule/groups"
+
+# Общее количество недель в семестре
+TOTAL_WEEKS = 20
+
+# Если истина, дни, состоящие только из занятий "Военная подготовка",
+# будут считаться свободными и возвращаться как {}
+SKIP_MILITARY = True
+
+# Внутренняя переменная для хранения даты начала семестра
+_SEMESTER_START = None
+
+
+def get_semester_start() -> str:
+    """
+    Функция для возврата даты начала семестра в формате ДД.ММ.ГГГГ.
+    Если дата не была установлена явно через сеттер,
+    она вычисляется автоматически на основе текущей даты:
+    - если текущий месяц >= 9 (сентябрь), то год текущий,
+    - иначе год предыдущий.
+    """
+    
+    global _SEMESTER_START
+    if _SEMESTER_START is None:
+        _CURRENT_YEAR = datetime.now().year
+        _CURRENT_MONTH = datetime.now().month
+        if _CURRENT_MONTH >= 9:
+            _SEMESTER_START = f"01.09.{_CURRENT_YEAR}"
+        
+        else:
+            _SEMESTER_START = f"01.09.{_CURRENT_YEAR - 1}"
+    
+    return _SEMESTER_START
+
+
+def set_semester_start(new_start: str):
+    """
+    Явно устанавливает дату начала семестра в формате ДД.ММ.ГГГГ.
+    """
+    global _SEMESTER_START
+    _SEMESTER_START = new_start
+
+
+# Для обратной совместимости сохраняем константу, но она теперь вычисляется при первом обращении
+SEMESTER_START = get_semester_start()

miet_schedule_api-0.1.0/miet_schedule_api/core.py

@@ -0,0 +1,303 @@
+"""
+Основной модуль библиотеки для получения расписания.
+Предоставляет функции для загрузки, кэширования и парсинга расписания.
+"""
+
+import json
+import os
+import requests
+from datetime import datetime, timedelta
+from .consts import API_URL, GROUPS_URL, TOTAL_WEEKS, SKIP_MILITARY, get_semester_start, set_semester_start
+from .parser import build_schedule_for_date, get_week_info
+
+def get_groups_list() -> list:
+    """
+    Функция для получения списка всех доступных групп из API.
+    """
+    try:
+        response = requests.get(GROUPS_URL)
+        response.raise_for_status()
+        
+        return response.json()
+    
+    except requests.exceptions.RequestException as e:
+        raise RuntimeError(f"Ошибка при получении списка групп: {e}")
+
+
+def validate_group(group: str) -> bool:
+    """
+    Функция для проверки, существует ли указанная группа.
+    """
+    groups = get_groups_list()
+    return group in groups
+
+
+def fetch_schedule(group: str) -> dict:
+    """
+    Функция для выполнения POST-запроса к API расписания и получения самого расписания в виде JSON-ответа.
+    """
+    try:
+        response = requests.post(API_URL, data={"group": group})
+        response.raise_for_status()
+        return response.json()
+
+    except requests.exceptions.RequestException as e:
+        raise RuntimeError(f"Ошибка при запросе расписания для группы {group}: {e}")
+
+
+def load_cached_data(group: str) -> dict | None:
+    """
+    Функция для загрузки данных для указанной группы из единого файла кэша.
+    Возвращает словарь с данными расписания или None, если группа не найдена.
+    """
+    cache_path = "last_data.json"
+    if not os.path.exists(cache_path):
+        return None
+    
+    try:
+        with open(cache_path, "r", encoding="utf-8") as f:
+            all_data = json.load(f)
+        return all_data.get(group)
+    
+    except (json.JSONDecodeError, IOError):
+        return None
+
+
+def save_cached_data(group: str, data: dict):
+    """
+    Функция для сохранения данных для указанной группы в единый файл кэша.
+    Если файл существует, обновляет запись для группы, иначе, создаёт новый.
+    """
+    cache_path = "last_data.json"
+    all_data = {}
+    if os.path.exists(cache_path):
+        try:
+            with open(cache_path, "r", encoding="utf-8") as f:
+                all_data = json.load(f)
+        
+        except (json.JSONDecodeError, IOError):
+            all_data = {}
+    
+    all_data[group] = data
+    
+    with open(cache_path, "w", encoding="utf-8") as f:
+        json.dump(all_data, f, ensure_ascii=False, indent=2)
+
+
+def get_schedule(group: str, date_str: str, force: bool = False, return_json: bool = False, pretty: bool = False):
+    """
+    Функция для получения структурированного расписания для указанной группы и даты.
+
+    Аргументы:
+        group: код группы / обязательный параметр
+        date_str: дата в формате ДД.ММ.ГГГГ
+        force: если True, принудительно запрашивает данные с сервера
+        return_json: если True, возвращает строку JSON, иначе словарь
+        pretty: если True, форматирует JSON с отступами; работает только при return_json=True
+
+    Возвращает словарь или строку JSON.
+    """
+    if not validate_group(group):
+        raise ValueError(f"Группа '{group}' не найдена в списке доступных групп.")
+
+    is_from_cache = False
+    schedule_data = None
+
+    if not force:
+        cached = load_cached_data(group)
+        if cached is not None:
+            schedule_data = cached
+            is_from_cache = True
+        
+        else:
+            schedule_data = fetch_schedule(group)
+            save_cached_data(group, schedule_data)
+    
+    else:
+        schedule_data = fetch_schedule(group)
+        save_cached_data(group, schedule_data)
+
+    if schedule_data is None:
+        raise RuntimeError(f"Не удалось получить данные расписания для группы {group}.")
+
+    result_data = build_schedule_for_date(schedule_data, date_str)
+
+    week_info = get_week_info(date_str)
+    meta = {
+        "weeks": {date_str: week_info},
+        "total_weeks": TOTAL_WEEKS
+    }
+
+    result = {
+        "isFromCache": is_from_cache,
+        "data": result_data,
+        "meta": meta
+    }
+
+    if return_json:
+        indent = 2 if pretty else None
+        return json.dumps(result, ensure_ascii=False, indent=indent)
+    
+    return result
+
+
+def get_schedule_range(group: str, start_date_str: str, end_date_str: str, force: bool = False, return_json: bool = False, pretty: bool = False):
+    """
+    Функция для получения структурированного расписания для указанной группы и диапазона дат.
+
+    Аргументы:
+        group: код группы / обязательный параметр
+        start_date_str: начальная дата в формате ДД.ММ.ГГГГ
+        end_date_str: конечная дата в формате ДД.ММ.ГГГГ
+        force: если True, принудительно запрашивает данные с сервера
+        return_json: если True, возвращает строку JSON, иначе словарь
+        pretty: если True, форматирует JSON с отступами; работает только при return_json=True
+
+    Возвращает словарь или строку JSON.
+    """
+    if not validate_group(group):
+        raise ValueError(f"Группа '{group}' не найдена в списке доступных групп.")
+
+    start = datetime.strptime(start_date_str, "%d.%m.%Y")
+    end = datetime.strptime(end_date_str, "%d.%m.%Y")
+    if start > end:
+        start, end = end, start
+
+    is_from_cache = False
+    schedule_data = None
+
+    if not force:
+        cached = load_cached_data(group)
+        if cached is not None:
+            schedule_data = cached
+            is_from_cache = True
+        
+        else:
+            schedule_data = fetch_schedule(group)
+            save_cached_data(group, schedule_data)
+    
+    else:
+        schedule_data = fetch_schedule(group)
+        save_cached_data(group, schedule_data)
+
+    if schedule_data is None:
+        raise RuntimeError(f"Не удалось получить данные расписания для группы {group}.")
+
+    result_data = {}
+    weeks_info = {}
+    current = start
+    delta = timedelta(days=1)
+    while current <= end:
+        date_str = current.strftime("%d.%m.%Y")
+        day_result = build_schedule_for_date(schedule_data, date_str)
+        result_data.update(day_result)
+        weeks_info[date_str] = get_week_info(date_str)
+        current += delta
+
+    meta = {
+        "weeks": weeks_info,
+        "total_weeks": TOTAL_WEEKS
+    }
+
+    result = {
+        "isFromCache": is_from_cache,
+        "data": result_data,
+        "meta": meta
+    }
+
+    if return_json:
+        indent = 2 if pretty else None
+        return json.dumps(result, ensure_ascii=False, indent=indent)
+    
+    return result
+
+
+def get_current_week(group: str, date_str: str = None, force: bool = False, return_json: bool = False, pretty: bool = False):
+    """
+    Функция для получения расписания на текущую неделю / с понедельника по воскресенье,
+    относительно заданной даты или текущей даты, если date_str не указан.
+
+    Аргументы:
+        group: код группы / обязательный параметр
+        date_str: опционально, дата в формате ДД.ММ.ГГГГ, от которой вычисляется неделя; если не указана, используется сегодняшняя дата
+        force: если True, принудительно запрашивает данные с сервера
+        return_json: если True, возвращает строку JSON, иначе словарь
+        pretty: если True, форматирует JSON с отступами
+
+    Возвращает словарь или строку JSON с расписанием на неделю.
+    """
+    if date_str is None:
+        date_str = datetime.now().strftime("%d.%m.%Y")
+    dt = datetime.strptime(date_str, "%d.%m.%Y")
+    start_of_week = dt - timedelta(days=dt.weekday())  # понедельник
+    end_of_week = start_of_week + timedelta(days=6)
+    start_str = start_of_week.strftime("%d.%m.%Y")
+    end_str = end_of_week.strftime("%d.%m.%Y")
+    return get_schedule_range(group, start_str, end_str, force, return_json, pretty)
+
+
+def get_next_week(group: str, date_str: str = None, force: bool = False, return_json: bool = False, pretty: bool = False):
+    """
+    Функция для получения расписания на следующую неделю / с понедельника по воскресенье
+    относительно заданной даты или текущей даты, если date_str не указан.
+
+    Аргументы:
+        group: код группы / обязательный параметр
+        date_str: опционально, дата в формате ДД.ММ.ГГГГ, от которой вычисляется неделя; если не указана, используется сегодняшняя дата
+        force: если True, принудительно запрашивает данные с сервера
+        return_json: если True, возвращает строку JSON, иначе словарь
+        pretty: если True, форматирует JSON с отступами
+
+    Возвращает словарь или строку JSON с расписанием на неделю.
+    """
+    if date_str is None:
+        date_str = datetime.now().strftime("%d.%m.%Y")
+    dt = datetime.strptime(date_str, "%d.%m.%Y")
+    start_of_week = dt - timedelta(days=dt.weekday()) + timedelta(days=7)
+    end_of_week = start_of_week + timedelta(days=6)
+    start_str = start_of_week.strftime("%d.%m.%Y")
+    end_str = end_of_week.strftime("%d.%m.%Y")
+    return get_schedule_range(group, start_str, end_str, force, return_json, pretty)
+
+def get_previous_week(group: str, date_str: str = None, force: bool = False, return_json: bool = False, pretty: bool = False):
+    """
+    Метод для получения расписания на предыдущую неделю / с понедельника по воскресенье
+    относительно заданной даты или текущей даты, если date_str не указан.
+
+    Аргументы:
+        group: код группы / обязательный параметр
+        date_str: опционально, дата в формате ДД.ММ.ГГГГ, от которой вычисляется неделя; если не указана, используется сегодняшняя дата
+        force: если True, принудительно запрашивает данные с сервера
+        return_json: если True, возвращает строку JSON, иначе словарь
+        pretty: если True, форматирует JSON с отступами
+
+    Возвращает словарь или строку JSON с расписанием на неделю.
+    """
+    if date_str is None:
+        date_str = datetime.now().strftime("%d.%m.%Y")
+    
+    dt = datetime.strptime(date_str, "%d.%m.%Y")
+    start_of_week = dt - timedelta(days=dt.weekday()) - timedelta(days=7)
+    end_of_week = start_of_week + timedelta(days=6)
+    start_str = start_of_week.strftime("%d.%m.%Y")
+    end_str = end_of_week.strftime("%d.%m.%Y")
+    
+    return get_schedule_range(group, start_str, end_str, force, return_json, pretty)
+
+
+def get_semester_start():
+    """Возвращает дату начала семестра."""
+    from .consts import get_semester_start as _get
+    return _get()
+
+
+def set_semester_start(new_start: str):
+    """Устанавливает дату начала семестра."""
+    from .consts import set_semester_start as _set
+    _set(new_start)
+
+
+def set_skip_military(value: bool):
+    """Включает или выключает пропуск дней военной подготовки."""
+    global SKIP_MILITARY
+    SKIP_MILITARY = value

miet_schedule_api-0.1.0/miet_schedule_api/parser.py

@@ -0,0 +1,150 @@
+"""
+Модуль парсинга расписания МИЭТ.
+"""
+
+import re
+from datetime import datetime
+from .consts import get_semester_start, SKIP_MILITARY
+
+
+def compute_week_type(date_str: str) -> int:
+    """
+    Функция для вычисления типа недели 0-3 на основе даты и начала семестра.
+    Формула: разница в днях % 28 // 7.
+    Дата и начало семестра ожидаются в формате ДД.ММ.ГГГГ.
+    """
+    date = datetime.strptime(date_str, "%d.%m.%Y").date()
+    semester_start = datetime.strptime(get_semester_start(), "%d.%m.%Y").date()
+    delta = (date - semester_start).days
+    if delta < 0:
+        return 0
+    return (delta % 28) // 7
+
+
+def compute_week_number(date_str: str) -> int:
+    """
+    Функция для вычисления абсолютного номера недели, начиная с 1, на основе даты.
+    """
+    date = datetime.strptime(date_str, "%d.%m.%Y").date()
+    semester_start = datetime.strptime(get_semester_start(), "%d.%m.%Y").date()
+   
+    delta = (date - semester_start).days
+    if delta < 0:
+        return 0
+    
+    return delta // 7 + 1
+
+
+def get_week_type_string(week_type: int) -> str:
+    """
+    Функция для преобразования числового типа недели (0-3) в строку.
+    """
+    mapping = {
+        0: "Числитель - 1",
+        1: "Знаменатель - 1",
+        2: "Числитель - 2",
+        3: "Знаменатель - 2",
+    }
+    return mapping.get(week_type, "Неизвестно")
+
+
+def get_week_info(date_str: str) -> dict:
+    """
+    Функция для получения информации о неделе для заданной даты:
+    {
+        "number": номер недели, начиная с 1,
+        "type": числовой тип 0-3,
+        "typeString": строковое представление
+    }
+    """
+    week_type = compute_week_type(date_str)
+    week_number = compute_week_number(date_str)
+    type_string = get_week_type_string(week_type)
+    return {
+        "number": week_number,
+        "type": week_type,
+        "typeString": type_string
+    }
+
+
+def extract_lesson_type(name: str) -> tuple:
+    """
+    Функция для извлечения типа занятия из строки названия и получения очищенного названия и типа.
+    Пример: "Ноксология [Лек]" -> ("Ноксология", "Лекция")
+    Типы: Лек -> Лекция, Пр -> Практика, Сем -> Семинар, Лаб -> Лабораторная.
+    Если тип не распознан, возвращается "Неизвестно".
+    """
+    match = re.search(r'\[(.*?)\]$', name)
+    if not match:
+        return name.strip(), "Неизвестно"
+
+    type_code = match.group(1).strip()
+    clean_name = re.sub(r'\s*\[.*?\]$', '', name).strip()
+
+    type_map = {
+        "Лек": "Лекция",
+        "Пр": "Практика",
+        "Сем": "Семинар",
+        "Лаб": "Лабораторная",
+    }
+    lesson_type = type_map.get(type_code, "Неизвестно")
+
+    return clean_name, lesson_type
+
+
+def parse_time(time_str: str) -> str:
+    """
+    Функция для преобразования строки времени вида "0001-01-01T09:00:00" в формат "ЧЧ:ММ".
+    """
+    time_part = time_str.split('T')[1]
+    return time_part[:-3]
+
+
+def build_schedule_for_date(schedule_data: dict, target_date_str: str) -> dict:
+    """
+    Функция для преобразования сырых данных расписания в словарь из JSON
+    в формате ДД.ММ.ГГГГ ведущие нули необязательны.
+    Возвращает структурированный сортированный словарь.
+
+    Если включён флаг SKIP_MILITARY и все занятия на эту дату являются
+    "Военная подготовка", возвращается {дата: {}}, как бы "выходной".
+    """
+    target_date_obj = datetime.strptime(target_date_str, "%d.%m.%Y").date()
+    formatted_date = target_date_obj.strftime("%d.%m.%Y")
+
+    day_of_week = target_date_obj.isoweekday()
+    week_type = compute_week_type(formatted_date)
+
+    lessons = []
+    for item in schedule_data.get("Data", []):
+        if item.get("Day") == day_of_week and item.get("DayNumber") == week_type:
+            lessons.append(item)
+
+    if SKIP_MILITARY and lessons:
+        all_military = all("Военная подготовка" in item["Class"]["Name"] for item in lessons)
+        if all_military:
+            return {formatted_date: {}}
+
+    lessons.sort(key=lambda x: x["Time"]["Code"])
+
+    result = {formatted_date: {}}
+    for lesson in lessons:
+        time_info = lesson["Time"]
+        class_info = lesson["Class"]
+        room_info = lesson["Room"]
+
+        pair_number = time_info["Code"]
+        time_from = parse_time(time_info["TimeFrom"])
+        time_to = parse_time(time_info["TimeTo"])
+
+        clean_title, lesson_type = extract_lesson_type(class_info["Name"])
+
+        result[formatted_date][pair_number] = {
+            "time": [time_from, time_to],
+            "title": clean_title,
+            "type": lesson_type,
+            "full_name": class_info["TeacherFull"],
+            "room": room_info["Name"]
+        }
+
+    return result

miet_schedule_api-0.1.0/miet_schedule_api.egg-info/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: miet-schedule-api
+Version: 0.1.0
+Summary: Небольшая библиотека для получения расписания групп МИЭТ
+Home-page: https://github.com/TheDIMONDK/miet_schedule_api
+Author: Deka
+Author-email: Deka <dka@disroot.org>
+License: MIT
+Project-URL: Homepage, https://github.com/TheDIMONDK/miet_schedule_api
+Project-URL: Repository, https://github.com/TheDIMONDK/miet_schedule_api
+Project-URL: Issues, https://github.com/TheDIMONDK/miet_schedule_api/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# MIET Schedule API
+
+Небольшая библиотека для получения и структурирования расписания указанных групп МИЭТ.
+
+
+## Возможности
+- Получение расписания для любой группы из списка МИЭТ.
+- Проверка существования группы перед запросом, используя официальное API.
+- Получение расписания на одну дату или диапазон дат, формат: `ДД.ММ.ГГГГ` или `ДД.ММ.ГГГГ-ДД.ММ.ГГГГ`.
+- Получение расписания на текущую, следующую или предыдущую неделю.
+- Кэширование данных в едином файле `last_data.json`, чтобы не мучать API МИЭТ.
+- Принудительное обновление кэша через параметр `force=True`.
+- Пропуск дней, состоящих только из военной подготовки, управляется флагом `SKIP_MILITARY`.
+- Автоматическое определение года начала семестра: если текущий месяц >= сентября, используется текущий год, иначе - предыдущий.
+- Возможность явно установить дату начала семестра через функцию `set_semester_start()`.
+- Возврат результата с мета-информацией: `isFromCache` источник данных, `data` само расписание и `meta` - метаинформация о неделях для каждой даты.
+- Возврат в виде словаря или отформатированной строки JSON, это управляется параметрами `return_json` и `pretty`.
+
+> Важно: библиотека пока не учитывает каникулы и праздничные дни.
+
+
+## Структура вывода
+```jsonc
+{
+  "isFromCache": true, // Вывод был закэширован, или было прямое обращение к API?
+  "data": {
+    "01.09.2026": { // День
+      "1": {
+        "time": ["09:00", "10:20"],
+        "title": "Название",
+        "type": "Лекция",
+        "full_name": "Фамилия Имя Отчество",
+        "room": "1201"
+      },
+      ...
+    },
+    "02.09.2026": {...},
+    ...
+  },
+  "meta": {
+    "weeks": {
+      "01.09.2026": {
+        "number": 1, // Номер недели по счёту в этом дне
+        "type": 0, // Тип недели, 1-й/2-й числитель/знаменатель в виде простого ID
+        "typeString": "Числитель - 1" // Тоже самое, но уже приведённое к читаемому виду
+      },
+      "02.09.2026": {...},
+      ...
+    },
+    "total_weeks": 20 // Общее количество недель
+  }
+}
+```
+
+
+## Установка
+### Локальная установка / для разработки
+```sh
+pip install -e .
+```
+
+### Установка из PyPI
+```sh
+pip install miet_schedule_api
+```
+
+### Установка из GitHub
+```sh
+pip install git+https://github.com/TheDIMONDK/miet_schedule_api.git
+```
+
+## Использование
+```py
+from miet_schedule_api import *
+
+# Получить список всех существующих групп
+groups = get_groups_list()
+print(groups)
+
+# Расписание на один день, смотрим на само расписание без метаданных
+schedule = get_schedule(group="ИТД-11", date_str="01.09.2026")
+print(schedule["data"])
+
+# Диапазон дат, вдобавок возвращаем и красивую JSON-строку
+schedule_json = get_schedule_range(
+    group="ИТД-11",
+    start_date_str="01.09.2026",
+    end_date_str="05.09.2026",
+    return_json=True,
+    pretty=True
+)
+print(schedule_json)
+
+# Расписание+метаданные текущей недели с понедельника по воскресенье
+current_week = get_current_week(group="ИТД-11", return_json=True, pretty=True)
+print(current_week)
+
+# Расписание+метаданные следующей недели относительно сегодня
+next_week = get_next_week(group="ИТД-11", return_json=True, pretty=True)
+print(next_week)
+
+# Расписание+метаданные предыдущей недели относительно заданной даты
+prev_week = get_previous_week(group="ИТД-11", date_str="15.09.2026", return_json=True, pretty=True)
+print(prev_week)
+```
+
+
+## Параметры функций
+- `group` (str, обязательный) - код группы.
+- `return_json` (bool, default=False) - если True, возвращает строку JSON вместо словаря.
+- `pretty` (bool, default=False) - если True и `return_json=True`, JSON выводится с отступами.
+- `force` (bool, default=False) - принудительно запрашивает данные с сервера, игнорируя кэш.
+- `date_str` (str) - дата в формате `ДД.ММ.ГГГГ`, для функций недели опциональна.
+- `start_date_str`, `end_date_str` (str) - начальная и конечная даты диапазона.
+
+
+## Разработка
+### Сборка пакета
+```sh
+pip install build
+python -m build
+```
+
+## Конфигурация
+Базовые настройки по умолчанию находятся в `miet_schedule_api/consts.py`:
+
+- `API_URL` - URL для запроса расписания.
+- `GROUPS_URL` - URL для получения списка групп.
+- `TOTAL_WEEKS` - общее количество недель в семестре, по умолчанию 20.
+- `SKIP_MILITARY` - пропускать ли дни с военной подготовкой.
+- `SEMESTER_START` - автоматически вычисляется, но можно переопределить, если нужно.
+
+## Лицензия
+MIT

miet_schedule_api-0.1.0/miet_schedule_api.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+requirements.txt
+setup.py
+miet_schedule_api/__init__.py
+miet_schedule_api/consts.py
+miet_schedule_api/core.py
+miet_schedule_api/parser.py
+miet_schedule_api.egg-info/PKG-INFO
+miet_schedule_api.egg-info/SOURCES.txt
+miet_schedule_api.egg-info/dependency_links.txt
+miet_schedule_api.egg-info/requires.txt
+miet_schedule_api.egg-info/top_level.txt

miet_schedule_api-0.1.0/miet_schedule_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

miet_schedule_api-0.1.0/miet_schedule_api.egg-info/requires.txt

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

miet_schedule_api-0.1.0/miet_schedule_api.egg-info/top_level.txt

@@ -0,0 +1 @@
+miet_schedule_api

miet_schedule_api-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "miet-schedule-api"
+version = "0.1.0"
+description = "Небольшая библиотека для получения расписания групп МИЭТ"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Deka", email = "dka@disroot.org"}
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.6"
+dependencies = [
+    "requests>=2.25.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/TheDIMONDK/miet_schedule_api"
+Repository = "https://github.com/TheDIMONDK/miet_schedule_api"
+Issues = "https://github.com/TheDIMONDK/miet_schedule_api/issues"

miet_schedule_api-0.1.0/requirements.txt

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

miet_schedule_api-0.1.0/setup.cfg

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

miet_schedule_api-0.1.0/setup.py

@@ -0,0 +1,27 @@
+#!/usr/bin/env python3
+
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="miet-schedule-api",
+    version="0.1.0",
+    author="Deka",
+    author_email="dka@disroot.org",
+    description="Небольшая библиотека для получения расписания групп МИЭТ",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/TheDIMONDK/miet_schedule_api",
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.6",
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+)