Metadata-Version: 2.4
Name: egekit-study
Version: 1.3.0
Summary: Алгоритмические инструменты для подготовки к ЕГЭ по информатике
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# EGEKit 1.3.0 — подготовка к ЕГЭ по информатике

Python 3.10+ · 114 функций · русские и английские имена · без внешних зависимостей.

Инструменты охватывают темы всех 27 номеров. Правила, ограничения и данные
конкретной задачи задаёт пользователь. Библиотека не разбирает русский текст
условия и не гарантирует решение всех возможных формулировок.

## Начало работы

После публикации версии 1.3.0 в PyPI:

```bash
python -m pip install --upgrade egekit-study==1.3.0
```

Без ожидания индекса PyPI можно установить готовый wheel из архива:

```bash
python -m pip install --upgrade dist/egekit_study-1.3.0-py3-none-any.whl
```

Команды запускайте в нужном виртуальном окружении. На Windows вместо
`python` при необходимости используется `py`. После обновления перезапустите
Python-консоль редактора.

```python
from егэ import *

print(делители(120))
print(перевести_в_систему(125, 3))
man(делители)
```

Прежнее `import egekit as e` и английские имена продолжают работать.
При использовании без установки положите **все три файла** `egekit.py`,
`егэ.py`, `egekit_support.py` рядом с вашим `solution.py`.
Не называйте свой скрипт именем одного из этих модулей.

## Справка, примеры и выбор алгоритма

```python
man()                          # Функции по заданиям №1–27
man(17)                        # Подсказки + список + учебный пример №17
man(делители)                  # Параметры, назначение, код примера и его вывод
man("divisors")                # Имя строкой, русское/английское
man(поиск="простые")           # Поиск в именах и описаниях
man(по_заданиям=False)          # Алфавитный список
man(задание=10, год=2027)       # Нумерация проекта 2027
man(листать=True)              # Системный просмотрщик, выход обычно q
справка(делители)              # Русское имя man
```

В подробной справке у каждой из 114 функций есть пример и ожидаемый вывод
(у самой man — выдержка). Для файловых функций также описано содержимое
входного файла: подготовьте такой файл для запуска приведённого примера.
Часть функций возвращает длину/число, часть — списки/словари; пример показывает
конкретный формат. Примеры в man хранятся как текст и **не исполняются**.
man сама печатает справку и возвращает None: `print(man())` добавит лишний None.

Подсказки объясняют различия между соседними и любыми парами, «ровно»/«не более»/
«не менее», медоидом и средним координат, кратностью суммы и произведения.
Ограничения сложности, диапазонов и модели указаны в описаниях.

## Шаблоны решений

```python
шаблон(17)                       # Напечатать самостоятельную заготовку
шаблон(23, год=2027)             # Графы по проекту 2027
текст = шаблон(17, текст=True)    # Получить Python-код строкой без печати
```

Шаблон содержит `from егэ import *`, небольшие данные, правило обработки
и вывод результата. Он не выполняется самой функцией и не меняет ваши файлы.
Скопируйте код в свой скрипт и замените данные, условия и диапазоны.
Ожидаемый результат находится в `man(номер, год=...)`.

В папке `templates/2026` и `templates/2027` лежат все **54 готовых .py файла**,
в конце каждого подписан ожидаемый вывод. Для запуска из этой папки установите
библиотеку в своё окружение. Это по одному учебному сценарию на номер и год,
а не все варианты заданий.

## Просмотр настоящего кода

```python
код(делители)                       # Реальная реализация функции
код("количество_программ")          # По имени
исходник = код(делители, текст=True) # Код строкой
man(делители, исходник=True)         # Справка, пример и реализация вместе
```

Исходник читается из установленного .py модуля и не исполняется.
Русские имена обычно ссылаются на английские реализации: в `def` может быть
английское имя. Код показывается без подмены, включая декораторы и зависимости.
Это средство изучения. Для самостоятельного запуска удобнее `шаблон(номер)`.

## Понятные ошибки

Ошибки значений и ограничения дополнены объяснениями и путями исправления.
Например, неверное основание подсказывает диапазон 2–36; неверное число в TXT
указывает строку/столбец и советует проверить skip/cast; отсутствующий файл
показывает рабочую папку; модуль 0 и отрицательные значения для метода двух
указателей объясняют, почему алгоритм применять нельзя.

Это не перехват всех исключений: ошибки пользовательской lambda и редкие
особенности форматов могут по-прежнему давать обычный traceback Python.
Имена параметров большинства алгоритмов остаются английскими, например
`делители(120, proper=True)`; man показывает сигнатуру и пример.

## Нумерация

| № | 2026 | Проект 2027 |
|---|---|---|
| 10 | Поиск в документе | IPv4 и маски |
| 13 | IPv4 и маски | Исполнители |
| 23 | Исполнители | Пути в ориентированном графе |
| 27 | Анализ данных, кластеризация | Анализ данных; демо — частицы и энергия |

По умолчанию выбран 2026 год. Перечень инструментов включает смежные,
вспомогательные и отдельные исторические алгоритмы, не является официальной
классификацией подтипов ФИПИ. Выбирайте модель строго по условию.

## Остальные файлы

- `GUIDE.html` — полный справочник с поиском, номерами, примерами и результатами.
- `GUIDE.md`, `RUSSIAN_NAMES.md` — текстовый справочник и таблица имён.
- `examples.py`, `examples_ru.py` — прежние 27 мини-примеров.
- `examples_man.py` — примеры новой справки, шаблонов и просмотра исходников.
- `verify_official.py` — проверка на скачанных файлах демоверсии ФИПИ 2027.
- `tests/`, `VALIDATION.md` — проверки и их ограничения.
- `dist/` — готовые wheel и sdist для версии 1.3.0.

Проверки:

```bash
python -m unittest discover -s tests -v
```

Все 30 тестовых методов проходят. Проверены все 114 примеров и 54 шаблона,
сохранены независимые сравнения быстрых алгоритмов с полным перебором.
Подробности и результаты исходной проверки на данных ФИПИ — VALIDATION.md.

## Публикация обновления

Откройте терминал в новой распакованной папке с `pyproject.toml`:

```bash
python -m twine check dist/*
python -m twine upload dist/*
```

В PyPI версия не публиковалась автоматически. Поле name осталось egekit-study,
версия повышена до 1.3.0. Не загружайте в dist старые версии файлов. Если вы
меняете код, пересоберите пакет перед публикацией: `python -m build`.

## Источники и лицензия

Материалы ФИПИ проверены 18.10.2026:
https://fipi.ru/ege/demoversii-specifikacii-kodifikatory

Архив проекта 2027:
https://doc.fipi.ru/ege/demoversii-specifikacii-kodifikatory/2027/inf_11_2027.zip

Официальные экзаменационные файлы в пакет не включены. Это независимая
учебная библиотека, не продукт ФИПИ. Лицензия MIT, текст — LICENSE.
