Commit (https://github.com/SENATOROVAI/intro-cs/issues/5)

python/commits.ipynb

@@ -0,0 +1,74 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c7922e3c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\"\"\"[TASK] Commits.\"\"\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1de37ed3",
+   "metadata": {},
+   "source": [
+    "1. Типы коммитов:\n",
+    "    - feat — добавил новую фичу/функциональность\n",
+    "    - fix — исправил баг\n",
+    "    - docs — изменил только документацию (README, комментарии и т.д.)\n",
+    "    - style — поправил форматирование, отступы, пробелы — логика не менялась\n",
+    "    - refactor — переписал код, но поведение не изменилось (не фича и не баг)\n",
+    "    - test — добавил или поправил тесты\n",
+    "    - build — изменения в системе сборки или зависимостях\n",
+    "    - ci — изменения в CI/CD конфигах\n",
+    "    - perf — оптимизация производительности\n",
+    "    - chore — рутинные задачи, которые не попадают в остальные категории (обновление .gitignore, конфиги линтера и т.д.)\n",
+    "\n",
+    "2. Исправление бага округления:\n",
+    "\n",
+    "    fix: исправлено некорректное округление чисел в функции round()\n",
+    "\n",
+    "    Функция round() округляла числа по усечению вместо математического\n",
+    "    округления.\n",
+    "\n",
+    "3. Новая функциональность\n",
+    "   \n",
+    "    feat: добавлена функция generateReport для формирования отчётов\n",
+    "\n",
+    "    Реализована функция generateReport, принимающая параметры периода\n",
+    "    и формата вывода (PDF/Excel). Возвращает байтовый поток файла.\n",
+    "    \n",
+    "4. Форматирование кода\n",
+    "   \n",
+    "    style: исправлены отступы и форматирование по всему проекту\n",
+    "\n",
+    "    Приведено форматирование к единому стилю согласно .editorconfig.\n",
+    "    Логика кода не изменялась.\n",
+    "\n",
+    "5. Документация и \n",
+    "   \n",
+    "    docs: добавлена документация для функции generateReport\n",
+    "\n",
+    "    Описаны входные параметры, возвращаемые значения и примеры\n",
+    "    использования функции generateReport в README и XML-комментариях.\n",
+    "\n",
+    "6. Тесты\n",
+    "   \n",
+    "    test: добавлены unit-тесты для функции generateReport\n",
+    "\n",
+    "    Покрыты сценарии: генерация PDF, генерация Excel, невалидный период,\n",
+    "    пустой результат выборки."
+   ]
+  }
+ ],
+ "metadata": {
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

python/commits.py

@@ -0,0 +1,48 @@
+"""[TASK] Commits."""
+
+# 1. Типы коммитов:
+#     - feat — добавил новую фичу/функциональность
+#     - fix — исправил баг
+#     - docs — изменил только документацию (README, комментарии и т.д.)
+#     - style — поправил форматирование, отступы, пробелы — логика не менялась
+#     - refactor — переписал код, но поведение не изменилось (не фича и не баг)
+#     - test — добавил или поправил тесты
+#     - build — изменения в системе сборки или зависимостях
+#     - ci — изменения в CI/CD конфигах
+#     - perf — оптимизация производительности
+#     - chore — рутинные задачи, которые не попадают в остальные категории (обновление .gitignore, конфиги линтера и т.д.)
+#
+# 2. Исправление бага округления:
+#
+#     fix: исправлено некорректное округление чисел в функции round()
+#
+#     Функция round() округляла числа по усечению вместо математического
+#     округления.
+#
+# 3. Новая функциональность
+#
+#     feat: добавлена функция generateReport для формирования отчётов
+#
+#     Реализована функция generateReport, принимающая параметры периода
+#     и формата вывода (PDF/Excel). Возвращает байтовый поток файла.
+#
+# 4. Форматирование кода
+#
+#     style: исправлены отступы и форматирование по всему проекту
+#
+#     Приведено форматирование к единому стилю согласно .editorconfig.
+#     Логика кода не изменялась.
+#
+# 5. Документация и
+#
+#     docs: добавлена документация для функции generateReport
+#
+#     Описаны входные параметры, возвращаемые значения и примеры
+#     использования функции generateReport в README и XML-комментариях.
+#
+# 6. Тесты
+#
+#     test: добавлены unit-тесты для функции generateReport
+#
+#     Покрыты сценарии: генерация PDF, генерация Excel, невалидный период,
+#     пустой результат выборки.