[TASK] STASH (https://github.com/SENATOROVAI/intro-cs/issues/3)

git/stash.py

@@ -0,0 +1,79 @@
+# 1. Что делает команда git stash?
+#
+# Сохраняет незакоммиченные изменения (modified и staged файлы) во временное хранилище, возвращая рабочую директорию к состоянию последнего коммита.
+#
+# 2. Как просмотреть список всех сохранённых изменений (стэшей)?
+#
+# git stash list
+#
+# 3. Какая команда применяется для использования верхнего стэша?
+#
+# git stash pop
+#
+# 4. Как применить конкретный стэш по его номеру?
+#
+# git stash apply stash@{n}
+#
+# где n - номер стэша (например, stash@{2})
+#
+# 5. Чем отличается команда git stash apply от git stash pop?
+#
+# apply - применяет стэш, но сохраняет его в списке
+#
+# pop - применяет стэш и удаляет его из списка
+#
+# 6. Что делает команда git stash drop?
+#
+# Удаляет указанный стэш из списка. Без аргументов удаляет последний стэш
+#
+# 7. Как полностью очистить все сохранённые стэши?
+#
+# git stash clear
+#
+# 8. В каких случаях удобно использовать git stash?
+#
+# Когда нужно временно отложить текущие изменения для работы с другой веткой
+#
+# При смене контекста работы без коммита незавершённых изменений
+#
+# Перед выполнением операций, требующих чистого рабочего состояния
+#
+# 9. Что произойдёт, если выполнить git stash pop, но в проекте есть конфликтующие изменения?
+#
+# Git попытается применить изменения и создаст конфликт слияния, который нужно разрешить вручную. Стэш останется в списке до успешного применения.
+#
+# 10. Можно ли восстановить удалённый стэш после выполнения git stash drop?
+#
+# Да, если не прошло слишком много времени. Удалённые стэши временно хранятся в reflog:
+#
+# git reflog show refs/stash
+#
+# 11. Что делает команда git stash save "NAME_STASH"
+#
+# Создаёт стэш с указанным именем (удобно для идентификации)
+#
+# 12. Что делает команда git stash apply "NUMBER_STASH"
+#
+# Применяет конкретный стэш по его номеру, не удаляя его из списка
+#
+# 13. Что делает команда git stash pop "NUMBER_STASH"
+#
+# Применяет конкретный стэш по его номеру и удаляет его из списка
+#
+# 14. Сохраните текущие изменения в стэш под названием "SENATOROV ver1", вставьте скриншот из терминала
+#
+# ![stash SENATOROV ver1](./SENATOROV_ver1.png)
+#
+# 15. Внесите любые изменения в ваш репозиторий и сохраните второй стэш под именем "SENATOROV ver2"
+#
+# ![stash SENATOROV ver2](./SENATOROV_ver2.png)
+#
+# 16. Восстановите ваш стэш "SENATOROV ver1", вставьте скриншот из терминала
+#
+# ![stash apply](./stash_apply.png)
+#
+# 17. Удалите все стеши из истории, вставьте скриншот из терминала
+#
+# ![stash clear](./clear_stash.png)
+
+#

python/commits.py

@@ -0,0 +1,53 @@
+# 1. Опишите своими словами назначение каждого из этих типов коммитов:
+# feat, fix, docs, style, refactor, test, build, ci, perf, chore.
+#
+# feat - добавление новой функции
+#
+# fix - исправление бага в коде
+#
+# docs - обновление или изменение документации
+#
+# style - изменение стиля кода, не влияищее на функциональность
+#
+# refactor - изменение структуры кода, не изменяя функциональность(удаление дублирования кода, переименование переменных и т.д.)
+#
+# test - добавление, исправление или улучшение тестов
+#
+# build - изменения, связанные с системой сборки и внешними зависимостями(обновление зависимостей requirements.txt, изменение конфигурации сборки и т.д.)
+#
+# ci - изменение конфигурации CI/CD
+#
+# perf - улучшение производительности кода\программы(оптимизаци алгоритмов, оптимизация запросов к БД и т.д.)
+#
+# chore - рутинные задачи и изменения не связанные с изменением кода(обновление документации, обновление.
+#
+# gitignore, обновление README.md и т.д.)
+#
+# 2. Представьте, что вы исправили баг в функции, которая некорректно округляет числа. Сделайте фиктивный коммит и напишите для него сообщение в соответствии с Conventional Commits (используя тип fix).
+#
+# fix(round_nums): fix incorrect rounding of numbers
+#
+# The round_nums() function was incorrectly rounding numbers. Fixed rounding logic to work correctly.
+#
+# Fixes #123
+#
+# 3. Добавление новой функциональности:
+# Допустим, вы реализовали новую функцию generateReport в проекте. Сделайте фиктивный коммит с типом feat, отражающий добавление этой функциональности
+#
+# feat(reports): add generateReport function for data analysis
+#
+# 4. Модификация формата кода или стилей:
+# Представьте, что вы поправили отступы и форматирование во всём проекте, не меняя логики кода. Сделайте фиктивный коммит с типом style
+#
+# style: format code and fix indentation across project
+#
+# 5. Документация и тестирование:
+#
+# Сделайте фиктивный коммит с типом docs, добавляющий или улучшающий документацию для вашей новой функции.
+# Сделайте фиктивный коммит с типом test, добавляющий тесты для этой же функции.
+#
+# docs(reports): add comprehensive documentation for generateReport function
+#
+# test(reports): add comprehensive tests for genarateReports function
+
+#

python/test_commits.py

@@ -0,0 +1,7 @@
+"""Module provided a function to round nums."""
+
+
+def rounding_nums(num: float) -> None:
+    """Function to round nums."""
+    round(num, 1)
+    print(f"rounded num = {num}")