egekit-study 1.2.0__tar.gz → 1.2.1__tar.gz

{egekit_study-1.2.0 → egekit_study-1.2.1}/GUIDE.html

@@ -4,13 +4,14 @@
 :root{color-scheme:light;--ink:#172a3a;--blue:#075c80;--line:#dbe5ea;--pale:#edf5f8}
 *{box-sizing:border-box}body{margin:0;background:#f5f7f9;color:var(--ink);font:16px/1.65 system-ui,sans-serif}header{background:#122d40;color:white;padding:48px max(24px,calc((100vw - 1100px)/2))}header p{max-width:870px;color:#d4e7ef}h1{font-size:clamp(30px,5vw,48px);line-height:1.15;margin:8px 0 24px}h2{font-size:26px;margin:44px 0 18px}h3{margin:0;color:var(--blue);font-size:21px;overflow-wrap:anywhere}.eyebrow{letter-spacing:2px;font-size:12px;text-transform:uppercase}.wrap{max-width:1150px;margin:auto;padding:0 24px 64px}a{color:var(--blue)}header a{color:#bfe5f8}.intro,article{background:white;border:1px solid var(--line);padding:24px;border-radius:12px;margin:14px 0}pre{white-space:pre-wrap;overflow-wrap:anywhere;background:#eef3f6;border-radius:8px;padding:16px;font-size:14px;line-height:1.6}code{font-family:ui-monospace,Consolas,monospace}table{width:100%;border-collapse:collapse;font-size:14px}th,td{text-align:left;border-bottom:1px solid var(--line);padding:12px;vertical-align:top}th{background:var(--pale)}.tablewrap{overflow-x:auto}td:first-child{font-weight:bold;min-width:40px}td code{overflow-wrap:anywhere}.controls{position:sticky;top:0;background:#f5f7f9f2;border-bottom:1px solid var(--line);padding:18px 0;z-index:1;display:flex;flex-wrap:wrap;gap:12px;align-items:end}.control{display:flex;flex-direction:column;font-size:13px;font-weight:600}.search{flex:1;min-width:220px}input,select{font:inherit;background:white;border:1px solid #9cb5c3;border-radius:6px;padding:10px;color:var(--ink);max-width:100%}input:focus,select:focus{outline:3px solid #a0d9ee}.tags{font-size:13px;color:#49687b;margin:6px 0 14px}.example{border-left:3px solid #1c8cad;padding-left:14px}li{margin:12px 0}.muted{color:#587081;font-size:14px}article[hidden]{display:none}.count{min-width:120px;font-size:13px;align-self:center}details{background:white;border:1px solid var(--line);padding:18px;border-radius:10px}summary{cursor:pointer;font-weight:600}@media print{.controls{display:none}body{background:white}header{padding:20px;color:#172a3a;background:white}header p{color:#172a3a}article{break-inside:avoid}details>*{display:block}}@media(max-width:600px){.wrap{padding:0 14px 40px}header{padding:30px 20px}article{padding:16px}td,th{padding:8px}}
 </style>
-<header><div class="eyebrow">Python 3.10+ · версия 1.2.0 · без зависимостей</div><h1>EGEKit<br>112 функций для подготовки к ЕГЭ</h1><p>Учебная библиотека Python 3.10+ без внешних зависимостей. 112 функций для тем всех 27 номеров. Это инструменты и шаблоны: условие, диапазон и критерий проверки переносите из конкретной задачи. Автоматического решения любой формулировки и гарантии всех будущих подтипов здесь нет. Все функции доступны под понятными русскими именами; английские варианты также работают.</p><a href="#catalog">Перейти к справочнику ↓</a></header>
+<header><div class="eyebrow">Python 3.10+ · версия 1.2.1 · без зависимостей</div><h1>EGEKit<br>112 функций для подготовки к ЕГЭ</h1><p>Учебная библиотека Python 3.10+ без внешних зависимостей. 112 функций для тем всех 27 номеров. Это инструменты и шаблоны: условие, диапазон и критерий проверки переносите из конкретной задачи. Автоматического решения любой формулировки и гарантии всех будущих подтипов здесь нет. Все функции доступны под понятными русскими именами; английские варианты также работают.</p><a href="#catalog">Перейти к справочнику ↓</a></header>
 <main class="wrap"><section class="intro"><h2 style="margin-top:0">Начало работы</h2><p>Положите <code>egekit.py</code> и <code>егэ.py</code> рядом со своим <code>solution.py</code> либо установите пакет egekit-study версии 1.2.0 и новее. Установка не нужна. Запустите <code>python solution.py</code> в терминале этой папки. Полная инструкция — в README.md.</p><pre><code>from егэ import *
 
 print(делители(120))
 print(перевести_в_систему(125, 3))
 man(делители)                 # Назначение, параметры и пример
 man(17)                       # Функции для задания 17
+man(по_заданиям=True)          # Сгруппировать по номерам
 man(поиск=&#x27;простые&#x27;)           # Поиск в справочнике
 </code></pre><p>Примеры по всем номерам: <code>python examples_ru.py</code>. Отдельный номер: <code>python examples_ru.py --year 2027 23</code>.</p></section>
 <h2>Номера и основные функции</h2><p>Базовая нумерация — 2026. В правом столбце тем указаны изменения проекта ФИПИ 2027.</p><div class="tablewrap"><table><thead><tr><th>№</th><th>Тема 2026</th><th>Проект 2027</th><th>С чего начать</th></tr></thead><tbody><tr><td>1</td><td>Графы и соответствие вершин</td><td>—</td><td><code>сопоставить_вершины_графов, кратчайшие_расстояния</code></td></tr><tr><td>2</td><td>Логика и таблицы истинности</td><td>—</td><td><code>таблица_истинности, определить_столбцы_таблицы, следование</code></td></tr><tr><td>3</td><td>Таблицы и базы данных</td><td>—</td><td><code>прочитать_xlsx, прочитать_ods, соединить_таблицы, сгруппировать_и_вычислить, запрос_к_базе</code></td></tr><tr><td>4</td><td>Коды и условие Фано</td><td>—</td><td><code>проверка_условия_Фано, допустимые_кодовые_слова, коды_Хаффмана, длина_кодированного_сообщения</code></td></tr><tr><td>5</td><td>Алгоритмы преобразования чисел</td><td>—</td><td><code>преобразовать_двоичную_запись, перевести_в_систему, найти_значения</code></td></tr><tr><td>6</td><td>Черепаха и геометрия</td><td>—</td><td><code>вершины_черепахи, внутренние_точки_по_Пику, целые_точки_в_фигурах</code></td></tr><tr><td>7</td><td>Изображения, звук и передача данных</td><td>—</td><td><code>объём_изображения_в_битах, объём_звука_в_битах, время_передачи</code></td></tr><tr><td>8</td><td>Комбинаторика и порядок слов</td><td>—</td><td><code>количество_слов, номер_слова, слово_по_номеру, различные_перестановки</code></td></tr><tr><td>9</td><td>Обработка строк таблицы</td><td>—</td><td><code>характеристики_строки, отобрать_строки</code></td></tr><tr><td>10</td><td>Поиск в текстовом документе</td><td>IPv4 и маски сетей</td><td><code>текст_из_docx, количество_вхождений</code></td></tr><tr><td>11</td><td>Объём хранения идентификаторов</td><td>—</td><td><code>бит_на_символ, объём_хранения_в_байтах</code></td></tr><tr><td>12</td><td>Редактор и машина Тьюринга</td><td>—</td><td><code>редактор_строк, машина_Тьюринга</code></td></tr><tr><td>13</td><td>IPv4 и маски сетей</td><td>Исполнители и количество программ</td><td><code>сведения_о_сети, количество_ip_по_условию, распределение_ip_по_единицам</code></td></tr><tr><td>14</td><td>Системы счисления</td><td>—</td><td><code>перевести_в_систему, перевести_из_системы, цифры_числа</code></td></tr><tr><td>15</td><td>Логические условия и параметры</td><td>—</td><td><code>следование, допустимые_параметры, принадлежит_интервалу</code></td></tr><tr><td>16</td><td>Рекурсия и рекуррентные формулы</td><td>—</td><td><code>вычислить_рекуррентную_функцию, рекурсивная_функция</code></td></tr><tr><td>17</td><td>Последовательности, пары и тройки</td><td>—</td><td><code>прочитать_числа, соседние_группы, статистика_соседних_групп</code></td></tr><tr><td>18</td><td>Робот и пути по таблице</td><td>—</td><td><code>суммы_путей_робота</code></td></tr><tr><td>19</td><td>Игры: первый ход</td><td>—</td><td><code>анализатор_игры</code></td></tr><tr><td>20</td><td>Игры: стратегия победы</td><td>—</td><td><code>анализатор_игры</code></td></tr><tr><td>21</td><td>Игры: неизбежное поражение</td><td>—</td><td><code>анализатор_игры</code></td></tr><tr><td>22</td><td>Параллельные процессы и зависимости</td><td>—</td><td><code>процессы_из_таблицы, расписание_процессов, активные_процессы, максимум_одновременных_интервалов</code></td></tr><tr><td>23</td><td>Исполнители и количество программ</td><td>Пути в ориентированном графе</td><td><code>количество_программ, количество_программ_через_точки</code></td></tr><tr><td>24</td><td>Строки, подстроки и выражения</td><td>—</td><td><code>подстрока_не_более, подстрока_ровно, подстрока_не_менее, найти_по_регулярному_выражению</code></td></tr><tr><td>25</td><td>Делители, простые числа и маски</td><td>—</td><td><code>делители, разложить_на_простые, решето_простых, кратные_по_маске</code></td></tr><tr><td>26</td><td>Сортировка, выбор и моделирование</td><td>—</td><td><code>выбрать_файлы_для_архива, выбрать_непересекающиеся_интервалы, вложенные_коробки, свободные_места, очередь_обслуживания, журнал_резервных_копий</code></td></tr><tr><td>27</td><td>Кластеризация и алгоритмы анализа данных</td><td>Анализ данных: точки, признаки и энергия частиц</td><td><code>кластеры_по_расстоянию, центр_по_сумме_расстояний, кластеры_по_размаху_признака, центр_по_медиане_признака; дополнительно — префиксы, остатки, динамика</code></td></tr></tbody></table></div>
@@ -403,19 +404,22 @@ man(поиск=&#x27;простые&#x27;)           # Поиск в справ
 <p class="example"><strong>Пример:</strong>  соседние_группы([1,2,3],2,lambda w:sum(w)&gt;3). В отличие от всех пар берёт только соседние элементы.</p></article>
 <article id="man" data-name="man" data-y26='[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27]' data-y27='[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27]'>
 <h3>справка</h3><p class="muted">Английское имя: <code>man</code></p><div class="tags" data-tags></div>
-<pre><code>справка(функция=None, *, задание=None, год=2026, поиск=None, листать=False)</code></pre><p>Справочник EGEKit в терминале: назначение, сигнатура, параметры, пример и номера заданий.
+<pre><code>справка(функция=None, *, задание=None, год=2026, поиск=None, листать=False, по_заданиям=False)</code></pre><p>Справочник EGEKit в терминале: назначение, сигнатура, параметры, пример и номера заданий.
 
 функция — объект функции либо её русское/английское имя строкой.
 Без функции выводится список с краткими описаниями. Целое число первым
 аргументом означает номер задания. задание и год фильтруют список;
-поиск ищет текст в именах и описаниях; листать=True открывает системный
+поиск ищет текст в именах и описаниях; по_заданиям=True группирует список
+по номерам 1–27 с названиями тем. Каждый пункт списка показывает номера
+заданий для выбранного года; листать=True открывает системный
 просмотрщик через pydoc.pager (выход обычно клавишей q).
 По умолчанию справка просто печатается, не требует действий и возвращает None.
 Ничего не выполняет из переданной строки: имена берутся только из каталога.
 
 </p>
 <p class="example"><strong>Пример:</strong> 
-    справка()                         # Все функции с описаниями
+    справка()                         # Все функции с описаниями и номерами
+    справка(по_заданиям=True)          # Группы по заданиям 1–27
     справка(делители)                 # Подробная справка о функции
     справка(&#x27;делители&#x27;)               # То же по строковому имени
     справка(&#x27;делители&#x27;)               # Английское имя тоже подходит
@@ -483,7 +487,7 @@ man(поиск=&#x27;простые&#x27;)           # Поиск в справ
 <h3>цифры_числа</h3><p class="muted">Английское имя: <code>base_digits</code></p><div class="tags" data-tags></div>
 <pre><code>цифры_числа(n, base)</code></pre><p>Цифры неотрицательного числа списком, от старшей к младшей; допускает основания больше 36. </p>
 <p class="example"><strong>Пример:</strong>  цифры_числа(10,3) == [1,0,1].</p></article></div><p id="empty" hidden>Функций с такими условиями не найдено. Попробуйте другое слово или номер.</p>
-<h2>Проверки и источники</h2><p>22 автоматических тестовых методов, в том числе сотни случайных сравнений с полным перебором. На файлах демоверсии 2027 совпали официальные ответы №22, №23, №24, №26 и №27. Это проверка конкретных алгоритмов и данных, а не доказательство универсальной применимости.</p><p>ФИПИ: <a href="https://fipi.ru/ege/demoversii-specifikacii-kodifikatory">демоверсии, спецификации, кодификаторы</a>. Проверено 18.10.2026. Изменения 2027 приведены по опубликованному проекту.</p><p class="muted">Исходный код — egekit.py · Полные примеры — examples_ru.py · Текстовая версия — GUIDE.md · Проверки — VALIDATION.md. Страница работает без интернета.</p></main>
+<h2>Проверки и источники</h2><p>24 автоматических тестовых метода, в том числе сотни случайных сравнений с полным перебором. На файлах демоверсии 2027 совпали официальные ответы №22, №23, №24, №26 и №27. Это проверка конкретных алгоритмов и данных, а не доказательство универсальной применимости.</p><p>ФИПИ: <a href="https://fipi.ru/ege/demoversii-specifikacii-kodifikatory">демоверсии, спецификации, кодификаторы</a>. Проверено 18.10.2026. Изменения 2027 приведены по опубликованному проекту.</p><p class="muted">Исходный код — egekit.py · Полные примеры — examples_ru.py · Текстовая версия — GUIDE.md · Проверки — VALIDATION.md. Страница работает без интернета.</p></main>
 <script>
 const cards=[...document.querySelectorAll('article')], search=document.querySelector('#search'), year=document.querySelector('#year'), task=document.querySelector('#task');
 function filter(){let shown=0;const q=search.value.trim().toLocaleLowerCase('ru');for(const card of cards){const tags=JSON.parse(card.dataset['y'+year.value]);card.querySelector('[data-tags]').textContent='Номера '+(year.value==='26'?'2026':'проекта 2027')+': '+(tags.length?tags.join(', '):'историческая функция');const visible=(!q||card.textContent.toLocaleLowerCase('ru').includes(q))&&(!task.value||tags.includes(Number(task.value)));card.hidden=!visible;if(visible)shown++;}document.querySelector('#count').textContent=shown+' из '+cards.length+' функций';document.querySelector('#empty').hidden=shown>0;}

{egekit_study-1.2.0 → egekit_study-1.2.1}/GUIDE.md

@@ -13,6 +13,7 @@ print(делители(120))
 print(перевести_в_систему(125, 3))
 man(делители)                 # Назначение, параметры и пример
 man(17)                       # Функции для задания 17
+man(по_заданиям=True)          # Сгруппировать по номерам
 man(поиск='простые')           # Поиск в справочнике
 
 ```
@@ -1224,7 +1225,7 @@ FCFS-очередь к одинаковым серверам. arrivals — (пр
 ### справка
 
 ```python
-справка(функция=None, *, задание=None, год=2026, поиск=None, листать=False)
+справка(функция=None, *, задание=None, год=2026, поиск=None, листать=False, по_заданиям=False)
 ```
 
 Английское имя: `man`.
@@ -1236,13 +1237,16 @@ FCFS-очередь к одинаковым серверам. arrivals — (пр
 функция — объект функции либо её русское/английское имя строкой.
 Без функции выводится список с краткими описаниями. Целое число первым
 аргументом означает номер задания. задание и год фильтруют список;
-поиск ищет текст в именах и описаниях; листать=True открывает системный
+поиск ищет текст в именах и описаниях; по_заданиям=True группирует список
+по номерам 1–27 с названиями тем. Каждый пункт списка показывает номера
+заданий для выбранного года; листать=True открывает системный
 просмотрщик через pydoc.pager (выход обычно клавишей q).
 По умолчанию справка просто печатается, не требует действий и возвращает None.
 Ничего не выполняет из переданной строки: имена берутся только из каталога.
 
 Пример:
-    справка()                         # Все функции с описаниями
+    справка()                         # Все функции с описаниями и номерами
+    справка(по_заданиям=True)          # Группы по заданиям 1–27
     справка(делители)                 # Подробная справка о функции
     справка('делители')               # То же по строковому имени
     справка('делители')               # Английское имя тоже подходит
@@ -1437,4 +1441,4 @@ FCFS-очередь к одинаковым серверам. arrivals — (пр
 
 Архив проекта 2027: https://doc.fipi.ru/ege/demoversii-specifikacii-kodifikatory/2027/inf_11_2027.zip
 
-22 автоматических тестовых методов; сотни случайных сравнений с полным перебором. Совпадение официальных ответов №22, 23, 24, 26 и 27 проекта 2027. Подробности в VALIDATION.md.
+24 автоматических тестовых метода; сотни случайных сравнений с полным перебором. Совпадение официальных ответов №22, 23, 24, 26 и 27 проекта 2027. Подробности в VALIDATION.md.

{egekit_study-1.2.0 → egekit_study-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: egekit-study
-Version: 1.2.0
+Version: 1.2.1
 Summary: Алгоритмические инструменты для подготовки к ЕГЭ по информатике
 License-Expression: MIT
 Requires-Python: >=3.10
@@ -10,7 +10,7 @@ Dynamic: license-file
 
 # EGEKit — библиотека для подготовки к ЕГЭ по информатике
 
-Версия 1.2.0 · Python 3.10+ · 112 функций · внешние зависимости не нужны.
+Версия 1.2.1 · Python 3.10+ · 112 функций · внешние зависимости не нужны.
 
 Библиотека охватывает темы всех 27 номеров: логика, базы данных, кодирование,
 исполнители, комбинаторика, геометрия, сети, рекурсия, игры, строки,
@@ -181,8 +181,27 @@ python -m unittest discover -s tests -v
 старых архивов. После публикации пользователи обновляют пакет через
 `python -m pip install --upgrade ИМЯ_ВАШЕГО_ПАКЕТА`.
 
-Готовые файлы для публикации версии 1.2.0 находятся в папке dist. После
+Готовые файлы для публикации версии 1.2.1 находятся в папке dist. После
 проверки `python -m twine check dist/*` их можно загрузить командой
 `python -m twine upload dist/*`. Если меняете код, пересоберите пакет.
 После публикации обновите установленный пакет:
 `python -m pip install --upgrade egekit-study`.
+
+## Номера заданий в справке: версия 1.2.1
+
+`man()` теперь подписывает у каждой функции номера заданий выбранного года.
+`man(по_заданиям=True)` выводит группы с заголовками «ЗАДАНИЕ №1», «ЗАДАНИЕ
+№2» и так далее. Общие инструменты вынесены в отдельный раздел. Функция,
+подходящая нескольким номерам, появляется в каждой соответствующей группе.
+
+```python
+from егэ import *
+man()                           # Алфавитный список с номерами
+man(по_заданиям=True)             # Группы по заданиям
+man(17)                          # Только функции для №17
+man(по_заданиям=True, год=2027)   # Нумерация проекта 2027
+```
+
+На установленной версии 1.2.0 эти новые параметры ещё не работают.
+Для установки без ожидания обновления индекса PyPI можно установить
+готовый файл dist/egekit_study-1.2.1-py3-none-any.whl из этого архива.

{egekit_study-1.2.0 → egekit_study-1.2.1}/README.md

@@ -1,6 +1,6 @@
 # EGEKit — библиотека для подготовки к ЕГЭ по информатике
 
-Версия 1.2.0 · Python 3.10+ · 112 функций · внешние зависимости не нужны.
+Версия 1.2.1 · Python 3.10+ · 112 функций · внешние зависимости не нужны.
 
 Библиотека охватывает темы всех 27 номеров: логика, базы данных, кодирование,
 исполнители, комбинаторика, геометрия, сети, рекурсия, игры, строки,
@@ -171,8 +171,27 @@ python -m unittest discover -s tests -v
 старых архивов. После публикации пользователи обновляют пакет через
 `python -m pip install --upgrade ИМЯ_ВАШЕГО_ПАКЕТА`.
 
-Готовые файлы для публикации версии 1.2.0 находятся в папке dist. После
+Готовые файлы для публикации версии 1.2.1 находятся в папке dist. После
 проверки `python -m twine check dist/*` их можно загрузить командой
 `python -m twine upload dist/*`. Если меняете код, пересоберите пакет.
 После публикации обновите установленный пакет:
 `python -m pip install --upgrade egekit-study`.
+
+## Номера заданий в справке: версия 1.2.1
+
+`man()` теперь подписывает у каждой функции номера заданий выбранного года.
+`man(по_заданиям=True)` выводит группы с заголовками «ЗАДАНИЕ №1», «ЗАДАНИЕ
+№2» и так далее. Общие инструменты вынесены в отдельный раздел. Функция,
+подходящая нескольким номерам, появляется в каждой соответствующей группе.
+
+```python
+from егэ import *
+man()                           # Алфавитный список с номерами
+man(по_заданиям=True)             # Группы по заданиям
+man(17)                          # Только функции для №17
+man(по_заданиям=True, год=2027)   # Нумерация проекта 2027
+```
+
+На установленной версии 1.2.0 эти новые параметры ещё не работают.
+Для установки без ожидания обновления индекса PyPI можно установить
+готовый файл dist/egekit_study-1.2.1-py3-none-any.whl из этого архива.

{egekit_study-1.2.0 → egekit_study-1.2.1}/RUSSIAN_NAMES.md

@@ -1,4 +1,4 @@
-# Русские названия функций EGEKit 1.2.0
+# Русские названия функций EGEKit 1.2.1
 
 112 функций: 111 прежних алгоритмов и встроенная справка man/справка.
 

{egekit_study-1.2.0 → egekit_study-1.2.1}/VALIDATION.md

@@ -1,11 +1,11 @@
-# Проверка EGEKit 1.2.0
+# Проверка EGEKit 1.2.1
 
 Дата: 18 октября 2026 года. Среда проверки: Python 3.12.14, Linux.
 Минимальная заявленная версия Python — 3.10 (отдельный запуск под 3.10 не выполнялся).
 
 ## Автоматические проверки
 
-22 тестовых метода unittest проходят. Внутри них:
+24 тестовых метода unittest проходят. Внутри них:
 
 - 300 случайных наборов: пары с остатком суммы, максимум суммы пары,
   кратность произведения, суммы и длины подмассивов, выбор из групп,
@@ -90,3 +90,9 @@ wheel установлен в отдельное чистое окружение
 Проверены `from егэ import *`, русские функции и man в установленном пакете.
 Автоматическая интерактивная проверка поведения системного pager в Windows
 не выполнялась; по умолчанию man печатает справку без pager.
+
+## Номера заданий в man, версия 1.2.1
+
+Два новых тестовых метода проверяют подписи у функций для обоих годов,
+все 27 групп, отдельный раздел общих инструментов, фильтрацию по номеру,
+поиск и пустую выдачу. Всего 24 тестовых метода проходят.

{egekit_study-1.2.0 → egekit_study-1.2.1}/build_docs.py

@@ -69,6 +69,7 @@ print(делители(120))
 print(перевести_в_систему(125, 3))
 man(делители)                 # Назначение, параметры и пример
 man(17)                       # Функции для задания 17
+man(по_заданиям=True)          # Сгруппировать по номерам
 man(поиск='простые')           # Поиск в справочнике
 """
 notes.insert(0, 'Новый модуль: from егэ import *. После импорта используйте функции без префикса. man() показывает список, man(делители) или man("делители") — подробную справку, man(17) — функции задания 17. Синоним man — справка. Для постраничного просмотра: man(листать=True), выход обычно q.')
@@ -105,7 +106,7 @@ for name in sorted(e.CATALOG, key=lambda n:e.РУССКИЕ_ИМЕНА[n]):
 <p class="example"><strong>Пример:</strong> {html.escape(example)}</p></article>''')
 md += ['## Источники и проверка','','ФИПИ: https://fipi.ru/ege/demoversii-specifikacii-kodifikatory','',
 'Архив проекта 2027: https://doc.fipi.ru/ege/demoversii-specifikacii-kodifikatory/2027/inf_11_2027.zip','',
-'22 автоматических тестовых методов; сотни случайных сравнений с полным перебором. Совпадение официальных ответов №22, 23, 24, 26 и 27 проекта 2027. Подробности в VALIDATION.md.']
+'24 автоматических тестовых метода; сотни случайных сравнений с полным перебором. Совпадение официальных ответов №22, 23, 24, 26 и 27 проекта 2027. Подробности в VALIDATION.md.']
 (root/'GUIDE.md').write_text('\n'.join(md)+'\n',encoding='utf-8')
 rows=''.join(f'<tr><td>{n}</td><td>{html.escape(TOPICS[n])}</td><td>{html.escape(TOPICS27[n] if TOPICS27[n]!=TOPICS[n] else "—")}</td><td><code>{html.escape(ROUTES[n])}</code></td></tr>' for n in TOPICS)
 page='''<!doctype html><html lang="ru"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
@@ -114,14 +115,14 @@ page='''<!doctype html><html lang="ru"><meta charset="utf-8"><meta name="viewpor
 :root{color-scheme:light;--ink:#172a3a;--blue:#075c80;--line:#dbe5ea;--pale:#edf5f8}
 *{box-sizing:border-box}body{margin:0;background:#f5f7f9;color:var(--ink);font:16px/1.65 system-ui,sans-serif}header{background:#122d40;color:white;padding:48px max(24px,calc((100vw - 1100px)/2))}header p{max-width:870px;color:#d4e7ef}h1{font-size:clamp(30px,5vw,48px);line-height:1.15;margin:8px 0 24px}h2{font-size:26px;margin:44px 0 18px}h3{margin:0;color:var(--blue);font-size:21px;overflow-wrap:anywhere}.eyebrow{letter-spacing:2px;font-size:12px;text-transform:uppercase}.wrap{max-width:1150px;margin:auto;padding:0 24px 64px}a{color:var(--blue)}header a{color:#bfe5f8}.intro,article{background:white;border:1px solid var(--line);padding:24px;border-radius:12px;margin:14px 0}pre{white-space:pre-wrap;overflow-wrap:anywhere;background:#eef3f6;border-radius:8px;padding:16px;font-size:14px;line-height:1.6}code{font-family:ui-monospace,Consolas,monospace}table{width:100%;border-collapse:collapse;font-size:14px}th,td{text-align:left;border-bottom:1px solid var(--line);padding:12px;vertical-align:top}th{background:var(--pale)}.tablewrap{overflow-x:auto}td:first-child{font-weight:bold;min-width:40px}td code{overflow-wrap:anywhere}.controls{position:sticky;top:0;background:#f5f7f9f2;border-bottom:1px solid var(--line);padding:18px 0;z-index:1;display:flex;flex-wrap:wrap;gap:12px;align-items:end}.control{display:flex;flex-direction:column;font-size:13px;font-weight:600}.search{flex:1;min-width:220px}input,select{font:inherit;background:white;border:1px solid #9cb5c3;border-radius:6px;padding:10px;color:var(--ink);max-width:100%}input:focus,select:focus{outline:3px solid #a0d9ee}.tags{font-size:13px;color:#49687b;margin:6px 0 14px}.example{border-left:3px solid #1c8cad;padding-left:14px}li{margin:12px 0}.muted{color:#587081;font-size:14px}article[hidden]{display:none}.count{min-width:120px;font-size:13px;align-self:center}details{background:white;border:1px solid var(--line);padding:18px;border-radius:10px}summary{cursor:pointer;font-weight:600}@media print{.controls{display:none}body{background:white}header{padding:20px;color:#172a3a;background:white}header p{color:#172a3a}article{break-inside:avoid}details>*{display:block}}@media(max-width:600px){.wrap{padding:0 14px 40px}header{padding:30px 20px}article{padding:16px}td,th{padding:8px}}
 </style>
-<header><div class="eyebrow">Python 3.10+ · версия 1.2.0 · без зависимостей</div><h1>EGEKit<br>112 функций для подготовки к ЕГЭ</h1><p>INTRO</p><a href="#catalog">Перейти к справочнику ↓</a></header>
+<header><div class="eyebrow">Python 3.10+ · версия 1.2.1 · без зависимостей</div><h1>EGEKit<br>112 функций для подготовки к ЕГЭ</h1><p>INTRO</p><a href="#catalog">Перейти к справочнику ↓</a></header>
 <main class="wrap"><section class="intro"><h2 style="margin-top:0">Начало работы</h2><p>Положите <code>egekit.py</code> и <code>егэ.py</code> рядом со своим <code>solution.py</code> либо установите пакет egekit-study версии 1.2.0 и новее. Установка не нужна. Запустите <code>python solution.py</code> в терминале этой папки. Полная инструкция — в README.md.</p><pre><code>QUICK</code></pre><p>Примеры по всем номерам: <code>python examples_ru.py</code>. Отдельный номер: <code>python examples_ru.py --year 2027 23</code>.</p></section>
 <h2>Номера и основные функции</h2><p>Базовая нумерация — 2026. В правом столбце тем указаны изменения проекта ФИПИ 2027.</p><div class="tablewrap"><table><thead><tr><th>№</th><th>Тема 2026</th><th>Проект 2027</th><th>С чего начать</th></tr></thead><tbody>ROWS</tbody></table></div>
 <h2>Как применять функции</h2><details><summary>Правила, ограничения и частые ошибки</summary><ul>NOTES</ul></details>
 <h2 id="catalog">Полный справочник</h2><p>У каждой функции: сигнатура, назначение, параметры, пример и ограничения. Фильтр ищет по имени и описанию. Номера показывают также смежные вспомогательные алгоритмы.</p>
 <div class="controls"><label class="control search">Поиск<input id="search" type="search" placeholder="например: делители, энергия, count_pairs"></label><label class="control">Год<select id="year"><option value="26">2026</option><option value="27">2027 — проект</option></select></label><label class="control">Номер<select id="task"><option value="">Все номера</option>OPTIONS</select></label><div id="count" class="count" aria-live="polite"></div></div>
 <div id="cards">CARDS</div><p id="empty" hidden>Функций с такими условиями не найдено. Попробуйте другое слово или номер.</p>
-<h2>Проверки и источники</h2><p>22 автоматических тестовых методов, в том числе сотни случайных сравнений с полным перебором. На файлах демоверсии 2027 совпали официальные ответы №22, №23, №24, №26 и №27. Это проверка конкретных алгоритмов и данных, а не доказательство универсальной применимости.</p><p>ФИПИ: <a href="https://fipi.ru/ege/demoversii-specifikacii-kodifikatory">демоверсии, спецификации, кодификаторы</a>. Проверено 18.10.2026. Изменения 2027 приведены по опубликованному проекту.</p><p class="muted">Исходный код — egekit.py · Полные примеры — examples_ru.py · Текстовая версия — GUIDE.md · Проверки — VALIDATION.md. Страница работает без интернета.</p></main>
+<h2>Проверки и источники</h2><p>24 автоматических тестовых метода, в том числе сотни случайных сравнений с полным перебором. На файлах демоверсии 2027 совпали официальные ответы №22, №23, №24, №26 и №27. Это проверка конкретных алгоритмов и данных, а не доказательство универсальной применимости.</p><p>ФИПИ: <a href="https://fipi.ru/ege/demoversii-specifikacii-kodifikatory">демоверсии, спецификации, кодификаторы</a>. Проверено 18.10.2026. Изменения 2027 приведены по опубликованному проекту.</p><p class="muted">Исходный код — egekit.py · Полные примеры — examples_ru.py · Текстовая версия — GUIDE.md · Проверки — VALIDATION.md. Страница работает без интернета.</p></main>
 <script>
 const cards=[...document.querySelectorAll('article')], search=document.querySelector('#search'), year=document.querySelector('#year'), task=document.querySelector('#task');
 function filter(){let shown=0;const q=search.value.trim().toLocaleLowerCase('ru');for(const card of cards){const tags=JSON.parse(card.dataset['y'+year.value]);card.querySelector('[data-tags]').textContent='Номера '+(year.value==='26'?'2026':'проекта 2027')+': '+(tags.length?tags.join(', '):'историческая функция');const visible=(!q||card.textContent.toLocaleLowerCase('ru').includes(q))&&(!task.value||tags.includes(Number(task.value)));card.hidden=!visible;if(visible)shown++;}document.querySelector('#count').textContent=shown+' из '+cards.length+' функций';document.querySelector('#empty').hidden=shown>0;}

{egekit_study-1.2.0 → egekit_study-1.2.1}/egekit.py

@@ -17,7 +17,7 @@ import sqlite3
 import zipfile
 import xml.etree.ElementTree as ET
 
-__version__ = '1.2.0'
+__version__ = '1.2.1'
 CATALOG = {}
 
 def _task(*numbers):
@@ -1291,19 +1291,22 @@ __all__ = ['CATALOG', 'CATALOG_2027', 'РУССКИЕ_ИМЕНА', '__version__'
 
 
 @_task(*range(1, 28))
-def man(функция=None, *, задание=None, год=2026, поиск=None, листать=False):
+def man(функция=None, *, задание=None, год=2026, поиск=None, листать=False, по_заданиям=False):
     """Справочник EGEKit в терминале: назначение, сигнатура, параметры, пример и номера заданий.
 
     функция — объект функции либо её русское/английское имя строкой.
     Без функции выводится список с краткими описаниями. Целое число первым
     аргументом означает номер задания. задание и год фильтруют список;
-    поиск ищет текст в именах и описаниях; листать=True открывает системный
+    поиск ищет текст в именах и описаниях; по_заданиям=True группирует список
+    по номерам 1–27 с названиями тем. Каждый пункт списка показывает номера
+    заданий для выбранного года; листать=True открывает системный
     просмотрщик через pydoc.pager (выход обычно клавишей q).
     По умолчанию справка просто печатается, не требует действий и возвращает None.
     Ничего не выполняет из переданной строки: имена берутся только из каталога.
 
     Пример:
-        man()                         # Все функции с описаниями
+        man()                         # Все функции с описаниями и номерами
+        man(по_заданиям=True)          # Группы по заданиям 1–27
         man(делители)                 # Подробная справка о функции
         man('делители')               # То же по строковому имени
         man('divisors')               # Английское имя тоже подходит
@@ -1381,15 +1384,65 @@ def man(функция=None, *, задание=None, год=2026, поиск=Non
             query = поиск.casefold()
             candidates = [name for name in candidates if query in
                           (name + ' ' + РУССКИЕ_ИМЕНА[name] + ' ' + documentation(name)).casefold()]
-        lines.append('СПИСОК ФУНКЦИЙ' + (f' — задание {задание}, {год}' if задание else ''))
-        lines.append(f'Найдено: {len(candidates)}')
-        for name in sorted(candidates, key=lambda n: РУССКИЕ_ИМЕНА[n]):
+        lines.append('СПИСОК ФУНКЦИЙ' + (f' — задание {задание}' if задание else ''))
+        lines.append(f'Нумерация: {год}' + (' (проект)' if год == 2027 else ''))
+        lines.append(f'Найдено функций: {len(candidates)}')
+
+        def add_entry(name):
+            numbers = catalog[name]
+            if tuple(numbers) == tuple(range(1, 28)):
+                label = '№1–27'
+            elif numbers:
+                label = '№' + ', '.join(map(str, numbers))
+            else:
+                label = 'историческая/вспомогательная'
             description = documentation(name).split('Пример:')[0].split('. ')[0].split('\n')[0]
-            lines.extend([f'  {РУССКИЕ_ИМЕНА[name]}  [{name}]',
+            lines.extend([f'  {РУССКИЕ_ИМЕНА[name]}  [{name}] — {label}',
                           textwrap.fill(description, width=96, initial_indent='    ', subsequent_indent='    ')])
+
+        if по_заданиям:
+            topics = {
+                1: 'Графы и соответствие вершин', 2: 'Логика и таблицы истинности',
+                3: 'Таблицы и базы данных', 4: 'Коды и условие Фано',
+                5: 'Преобразование чисел', 6: 'Черепаха и геометрия',
+                7: 'Изображения, звук и передача данных', 8: 'Комбинаторика и слова',
+                9: 'Строки таблицы', 10: 'Поиск в текстовом документе',
+                11: 'Объём хранения', 12: 'Редактор и машина Тьюринга',
+                13: 'IPv4 и маски сетей', 14: 'Системы счисления',
+                15: 'Логические условия и параметры', 16: 'Рекурсия',
+                17: 'Последовательности: пары и тройки', 18: 'Робот и пути по таблице',
+                19: 'Игры: первый ход', 20: 'Игры: стратегия победы',
+                21: 'Игры: неизбежное поражение', 22: 'Параллельные процессы',
+                23: 'Исполнители и количество программ', 24: 'Строки и подстроки',
+                25: 'Делители, простые числа и маски', 26: 'Сортировка и моделирование',
+                27: 'Кластеризация и анализ данных'}
+            if год == 2027:
+                topics.update({10: 'IPv4 и маски сетей',
+                               13: 'Исполнители и количество программ',
+                               23: 'Пути в ориентированном графе',
+                               27: 'Анализ данных: точки, признаки и энергия частиц'})
+            common = [name for name in candidates if tuple(catalog[name]) == tuple(range(1, 28))]
+            for number in ([задание] if задание is not None else range(1, 28)):
+                group = [name for name in candidates if number in catalog[name] and name not in common]
+                if group:
+                    lines.extend(['', f'ЗАДАНИЕ №{number} — {topics[number]}'])
+                    for name in sorted(group, key=lambda n: РУССКИЕ_ИМЕНА[n]):
+                        add_entry(name)
+            historical = [name for name in candidates if not catalog[name]]
+            if historical:
+                lines.extend(['', 'ИСТОРИЧЕСКИЕ И ВСПОМОГАТЕЛЬНЫЕ ФУНКЦИИ'])
+                for name in sorted(historical, key=lambda n: РУССКИЕ_ИМЕНА[n]): add_entry(name)
+            if common:
+                lines.extend(['', 'ОБЩИЕ ИНСТРУМЕНТЫ ДЛЯ ВСЕХ ЗАДАНИЙ'])
+                for name in sorted(common, key=lambda n: РУССКИЕ_ИМЕНА[n]): add_entry(name)
+        else:
+            for name in sorted(candidates, key=lambda n: РУССКИЕ_ИМЕНА[n]):
+                add_entry(name)
         lines.extend(['', 'Подробнее: man(делители) или man("делители")',
                       'Поиск: man(поиск="строк") | По заданию: man(17)',
-                      'Постраничный просмотр: man(листать=True)'])
+                      'Группы по номерам: man(по_заданиям=True)',
+                      'Постраничный просмотр: man(листать=True)',
+                      'Номера включают смежные и вспомогательные инструменты, а не только готовые решения.'])
     text = '\n'.join(lines)
     if листать:
         import pydoc

{egekit_study-1.2.0 → egekit_study-1.2.1}/egekit_study.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: egekit-study
-Version: 1.2.0
+Version: 1.2.1
 Summary: Алгоритмические инструменты для подготовки к ЕГЭ по информатике
 License-Expression: MIT
 Requires-Python: >=3.10
@@ -10,7 +10,7 @@ Dynamic: license-file
 
 # EGEKit — библиотека для подготовки к ЕГЭ по информатике
 
-Версия 1.2.0 · Python 3.10+ · 112 функций · внешние зависимости не нужны.
+Версия 1.2.1 · Python 3.10+ · 112 функций · внешние зависимости не нужны.
 
 Библиотека охватывает темы всех 27 номеров: логика, базы данных, кодирование,
 исполнители, комбинаторика, геометрия, сети, рекурсия, игры, строки,
@@ -181,8 +181,27 @@ python -m unittest discover -s tests -v
 старых архивов. После публикации пользователи обновляют пакет через
 `python -m pip install --upgrade ИМЯ_ВАШЕГО_ПАКЕТА`.
 
-Готовые файлы для публикации версии 1.2.0 находятся в папке dist. После
+Готовые файлы для публикации версии 1.2.1 находятся в папке dist. После
 проверки `python -m twine check dist/*` их можно загрузить командой
 `python -m twine upload dist/*`. Если меняете код, пересоберите пакет.
 После публикации обновите установленный пакет:
 `python -m pip install --upgrade egekit-study`.
+
+## Номера заданий в справке: версия 1.2.1
+
+`man()` теперь подписывает у каждой функции номера заданий выбранного года.
+`man(по_заданиям=True)` выводит группы с заголовками «ЗАДАНИЕ №1», «ЗАДАНИЕ
+№2» и так далее. Общие инструменты вынесены в отдельный раздел. Функция,
+подходящая нескольким номерам, появляется в каждой соответствующей группе.
+
+```python
+from егэ import *
+man()                           # Алфавитный список с номерами
+man(по_заданиям=True)             # Группы по заданиям
+man(17)                          # Только функции для №17
+man(по_заданиям=True, год=2027)   # Нумерация проекта 2027
+```
+
+На установленной версии 1.2.0 эти новые параметры ещё не работают.
+Для установки без ожидания обновления индекса PyPI можно установить
+готовый файл dist/egekit_study-1.2.1-py3-none-any.whl из этого архива.

{egekit_study-1.2.0 → egekit_study-1.2.1}/examples_man.py

@@ -6,3 +6,5 @@ print("Число 125 в троичной системе:", перевести_
 man(делители)
 man(17)
 man(поиск="простые")
+
+man(по_заданиям=True)

{egekit_study-1.2.0 → egekit_study-1.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "egekit-study"
-version = "1.2.0"
+version = "1.2.1"
 description = "Алгоритмические инструменты для подготовки к ЕГЭ по информатике"
 readme = "README.md"
 requires-python = ">=3.10"

{egekit_study-1.2.0 → egekit_study-1.2.1}/tests/test_manual.py

@@ -29,7 +29,7 @@ class ManualTests(unittest.TestCase):
         self.assertEqual(self.output(17),self.output(задание=17))
         self.assertIn('сведения_о_сети',self.output(задание=10,год=2027))
         self.assertIn('простое_число',self.output(поиск='is_prime'))
-        self.assertIn('Найдено: 0',self.output(поиск='несуществующее_слово_8472'))
+        self.assertIn('Найдено функций: 0',self.output(поиск='несуществующее_слово_8472'))
         self.assertIn('Функция не найдена',self.output('делител'))
         self.assertIn('делители',self.output('делител'))
         self.assertIn('Функция не найдена',self.output('__import__("os")'))
@@ -43,6 +43,24 @@ class ManualTests(unittest.TestCase):
             self.assertIn('делители',pager.call_args.args[0])
             pager.assert_called_once()
 
+    def test_numbers_are_shown_beside_every_function(self):
+        text=self.output()
+        self.assertIn('делители  [divisors] — №25',text)
+        self.assertIn('сведения_о_сети  [network_info] — №13',text)
+        self.assertIn('сведения_о_сети  [network_info] — №10',self.output(год=2027))
+        self.assertIn('Нумерация: 2027 (проект)',self.output(год=2027))
+
+    def test_grouped_catalog_and_filters(self):
+        text=self.output(по_заданиям=True)
+        for n in range(1,28): self.assertIn(f'ЗАДАНИЕ №{n} —',text)
+        self.assertEqual(text.count('справка  [man]'),1)
+        selected=self.output(17,по_заданиям=True)
+        self.assertIn('ЗАДАНИЕ №17 —',selected)
+        self.assertNotIn('ЗАДАНИЕ №25 —',selected)
+        self.assertIn('ЗАДАНИЕ №10 — IPv4',self.output(год=2027,по_заданиям=True))
+        self.assertIn('ЗАДАНИЕ №25 —',self.output(поиск='is_prime',по_заданиям=True))
+        self.assertIn('Найдено функций: 0',self.output(поиск='not_a_function_8482',по_заданиям=True))
+
     def test_cyrillic_star_import(self):
         ns={}
         exec('from егэ import *\nрезультат = делители(12)\nчисло = перевести_в_систему(125, 3)',ns)
@@ -50,7 +68,7 @@ class ManualTests(unittest.TestCase):
         self.assertEqual(ns['число'],'11122')
         self.assertIs(ns['man'],e.man)
         self.assertIs(ns['справка'],e.man)
-        self.assertEqual(егэ.__version__,'1.2.0')
+        self.assertEqual(егэ.__version__,'1.2.1')
         for name in e.__all__: self.assertIs(getattr(егэ,name),getattr(e,name))
 
 if __name__=='__main__': unittest.main()