Resolve merge conflicts and format code with ruff

Author: Rulet63

README.md

@@ -15,8 +15,9 @@ git clone [email protected]:gardiys/fastapi-backend-course.git
 - [ ] [Урок 3: Настройка окружения](./setting_environment/)
 - [ ] [Урок 4: Использование хранилищ](./using_storage/)
 - [ ] [Урок 5: Архитектура проекта](./project_architecture/)
-- [ ] [Урок 6: Общение сервисов](./services_communication/)
-- [ ] [Урок 7: Тестирование](./testing/)
-- [ ] [Урок 8: Деплой сервисов](./services_deploy/)
-- [ ] [Урок 9: Отказоустойчивость](./fault_tolerance/)
-- [ ] [Урок 10: Мониторинг](./monitoring/)
+- [ ] [Урок 6: Фоновые задачи](./async_tasks/)
+- [ ] [Урок 7: Общение сервисов](./services_communication/)
+- [ ] [Урок 8: Тестирование](./testing/)
+- [ ] [Урок 9: Деплой сервисов](./services_deploy/)
+- [ ] [Урок 10: Отказоустойчивость](./fault_tolerance/)
+- [ ] [Урок 11: Мониторинг](./monitoring/)

async_tasks/README.md

@@ -5,12 +5,13 @@
 3. Создать новую ветку с названием задачи "pull-request-task" и переключиться на неё
 4. В проекте создать два новых файла main.py и config.py
 5. Закоммитить изменения и запушить ветку в репозиторий
-6. Затем создать пулл-реквест
+6. Затем создать пулл-реквест с ветки pull-request-task на ветку main
 
 ## Задание 2: разрешение конфликтов
 В пулл-реквесте по [ссылке](https://github.com/gardiys/fastapi-backend-course/pull/1) есть конфликт. Нужно:
 1. Форкнуть к себе репозиторий
 2. Разрешить конфликт в этой ветке, чтобы ветку можно было вмержить в мастер без потери логики
+3. Проверить папку git/src с помощью линтера ruff на ошибки и несоответствия стандартам разработки на Python
 
 ## Задание 3: простой CI
 Нужно добавить конфигурацию CI с помощью GitHub Actions в свой репозиторий. 

git/README.md

@@ -1,26 +1,29 @@
 import json
 import os
 
-def load_books(filename='library.json'):
+
+def load_books(filename="library.json"):
     """
     Загрузка списка книг из JSON-файла.
     Возвращает список книг (каждая книга - это словарь).
     """
     if not os.path.isfile(filename):
         return []
-    with open(filename, 'r', encoding='utf-8') as file:
+    with open(filename, "r", encoding="utf-8") as file:
         try:
             return json.load(file)
         except json.JSONDecodeError:
             return []
 
-def saving_books(books, filename='library.json'):
+
+def save_books(books, filename="library.json"):
     """
     Сохранение списка книг в JSON-файл.
     """
-    with open(filename, 'w', encoding='utf-8') as file:
+    with open(filename, "w", encoding="utf-8") as file:
         json.dump(books, file, ensure_ascii=False, indent=4)
 
+
 def list_books(books):
     """
     Возвращает строку со списком всех книг.
@@ -29,29 +32,30 @@ def list_books(books):
         return "Библиотека пуста."
     result_lines = []
     for idx, book in enumerate(books, start=1):
-        result_lines.append(f"{idx}. {book['title']} | {book['author']} | {book['year']}")
+        result_lines.append(
+            f"{idx}. {book['title']} | {book['author']} | {book['year']}"
+        )
     return "\n".join(result_lines)
 
+
 def add_book(books, title, author, year):
     """
     Принимает текущий список книг и данные о новой книге.
     Возвращает новый список, в котором добавлена новая книга.
     """
-    new_book = {
-        'title': title,
-        'author': author,
-        'year': year
-    }
+    new_book = {"title": title, "author": author, "year": year}
     # Создаём НОВЫЙ список, добавляя new_book
     return books + [new_book]
 
+
 def remove_book(books, title):
     """
     Принимает текущий список книг и название книги для удаления.
     Возвращает новый список без книги, у которой совпадает название.
     """
     # Фильтруем список: оставляем только те книги, у которых название не совпадает с переданным
-    return [book for book in books if book['title'].lower() != title.lower()]
+    return [book for book in books if book["title"].lower() != title.lower()]
+
 
 def search_books(books, keyword):
     """
@@ -60,13 +64,16 @@ def search_books(books, keyword):
     """
     keyword_lower = keyword.lower()
     return [
-        book for book in books
-        if keyword_lower in book['title'].lower() or keyword_lower in book['author'].lower()
+        book
+        for book in books
+        if keyword_lower in book["title"].lower()
+        or keyword_lower in book["author"].lower()
     ]
 
+
 def main():
     """
-    Точка входа в программу: здесь мы загружаем книги, 
+    Точка входа в программу: здесь мы загружаем книги,
     показываем меню и обрабатываем ввод пользователя.
     """
     books = load_books()  # Загрузили список книг из JSON
@@ -81,11 +88,11 @@ def main():
 
         choice = input("Выберите действие (1-5): ").strip()
 
-        if choice == '1':
+        if choice == "1":
             print("\nСписок книг:")
             print(list_books(books))
 
-        elif choice == '2':
+        elif choice == "2":
             print("\nДобавление новой книги:")
             title = input("Введите название: ").strip()
             author = input("Введите автора: ").strip()
@@ -94,42 +101,42 @@ def main():
             # Получаем новый список с добавленной книгой
             new_books = add_book(books, title, author, year)
             books = new_books  # Обновляем переменную, чтобы сохранить изменения
-            saving_books(books)  # Сразу сохраняем в файл
+            save_books(books)  # Сразу сохраняем в файл
             print("Книга добавлена!")
 
-        elif choice == '3':
+        elif choice == "3":
             print("\nУдаление книги:")
-            title_to_remove = input("Введите название книги, которую хотите удалить: ").strip()
+            title_to_remove = input(
+                "Введите название книги, которую хотите удалить: "
+            ).strip()
 
             new_books = remove_book(books, title_to_remove)
-            if len(new_books) > len(books):
+            if len(new_books) < len(books):
                 books = new_books
-                saving_books(books)
+                save_books(books)
                 print("Книга удалена!")
             else:
                 print("Книга с таким названием не найдена.")
 
-        elif choice == '4':
+        elif choice == "4":
             print("\nПоиск книг:")
-            keyword = input("Введите ключевое слово для поиска (в названии или авторе): ").strip()
+            keyword = input(
+                "Введите ключевое слово для поиска (в названии или авторе): "
+            ).strip()
             found_books = search_books(books, keyword)
             if found_books:
                 print("\nНайденные книги:")
                 print(list_books(found_books))
             else:
                 print("Ничего не найдено.")
 
-        elif choice == '6':
+        elif choice == "5":
             print("Выход из программы.")
             break
 
         else:
             print("Некорректный ввод. Попробуйте ещё раз.")
 
 
-
-
-
-
 if __name__ == "__main__":
-    main()
+    main()

git/src/main.py

@@ -1,10 +1,30 @@
-Задание 1
-настройка Poetry
-Задание 2
-Создание docker образа
-Задание 3
-создание docker compose файла
-Задание 4
-линтеры и pre-commit хуки
-задание 5 
-конфигурация проектов
+# Задачи
+
+## Задание 1
+Переведите проект, полученный в разделе [Простой backend](/simple_backend/README.md) на Poetry.
+
+## Задание 2 
+Установите в dev группу poetry линтер ruff. Настройте pre-commit хуки для ruff check и ruff format.
+При каждом коммите у вас должны запускаться проверки с помощью линтеров.
+
+## Задание 3
+Заверните проект в Docker-образ. Критерии:
+- Должен быть slim
+- Внутри должны устанавливаться poetry зависимости
+- Образ должен собираться
+- С помощью образа можно запустить приложение на FastAPI
+
+## Задание 4
+Создайте docker-compose.yaml файл. Критерии:
+- Должен быть сервис приложения
+- Внутри должна быть команда запуска приложения
+
+## Задание 5
+Создайте makefile с основными командами для работы с вашим проектом. Критерии:
+- Должны быть команды для запуска, перезагрузки, остановки проекта с помощью docker compose
+- Должны быть команды для запуска pre-commit check
+
+## Задание 6
+Создайте файлы конфигурации `.env` и `.env.example`. `.env` должен быть в gitignore, а `.env.example` должен содержать структуру `.env` файла.
+Подключите  `.env` в docker compose с помощью `env_file:`.
+Вынесите все свои токены из проекта в `.env`

setting_environment/README.md

@@ -1,3 +1,46 @@
-Задание 1
-- создайте приложение main.py на fastapi
-- проверьте его на тестах
+# Задачи
+**Во всех заданиях обязательно создание pull-request по аналогии из задачи блока git!**
+
+**Ваш код обязательно должен запускаться и проверяться на работоспособность**
+## Задание 1
+Нужно локально запустить backend приложение. Пройдитесь по шагам:
+1. Если еще не склонирован этот репозиторий, то склонируйте
+2. Создайте в папке `simple_backend/src/task_tracker` виртуальное окружение
+3. Активируйте `venv`
+4. Установите записимости из `requirements.txt`
+5. Запустите сервер с помощью команды `uvicorn main:app`
+6. Перейдите по ссылке http://127.0.0.1:8000/docs и проверьте, что бэк работает
+## Задание 2
+Вам нужно оживить бекенд из первой задачи и создать простой API для управления списком задач. Данные нужно хранить в оперативной памяти (например в списке Python).
+В каждой из функций нужно прописать логику:
+- get_tasks должен возвращать список всех задач
+- create_task должен создавать новую задачу
+- update_task должен обновлять информацию о задаче
+- delete_task должен удалять задачу
+
+У задачи должны быть параметры: id, название, статус задачи.
+
+### Подзадачи
+- Прочитайте, что такое "Хранение состояния", создайте в task_tracker readme.md файл и напишите в чём минусы подхода с хранением задач в оперативной памяти (списке python)
+- Исправьте ситуацию и переделайте хранение информации о задачах в файле проекта. Информацию можно хранить например в формате json.
+- Напишите в readme.md:
+    - что улучшилось после того, как список из оперативной памяти изменился на файл проекта?
+    - избавились ли мы таким способом от хранения состояния или нет?
+    - где еще можно хранить задачи и какие есть преимущества и недостатки этих подходов?
+- Напишите класс для работы с файлом хранения задач в task_tracker и измените код проекта так, чтобы он работал с объектом этого класса.
+- Сделайте свой backend - stateless с помощью интеграции с облачным сервисом (jsonbin.io, mockapi.io, github gist). Организуйте хранение и обновление json файла во внешнем сервисе.
+- Прочитайте что такое "состояние гонки" и напишите в readme файле о том, какие проблемы остались в бекенде на данном этапе проекта. Есть ли у вас какое-то решение этой проблемы?
+
+
+## Задание 3
+Давайте прокачаем наш таск-треккер. Хочется, чтобы текст задачи заливался в LLM модель и она выдавала способы решения задачи и добавляла к её тексту.
+Для того, чтобы это сделать:
+- Настройте интеграцию с сервисом [Cloudflare](https://developers.cloudflare.com/workers-ai/get-started/rest-api/) через REST API. Для этого создайте новый класс для работы с этой API.
+- При создании новой задачи отправляйте запрос с её текстом в LLM и просьбой объяснить как решать задачу
+- Добавляйте полученный ответ в текст задачи
+
+## Задание 4
+Заметили, что в коде для работы с файлами и в коде для работы с LLM API есть похожие участки? Давайте избавимся от дублирования через наследование.
+- Сделайте базовый класс BaseHTTPClient и вынесите в него общие функции и методы из двух классов
+- Сделайте наследование от базового класса в клиентах
+- С помощью абстрактных классов реализуйте абстрактные методы, которые должны быть в классах наследниках

simple_backend/README.md

@@ -0,0 +1,104 @@
+
+class Order:
+    TAX_RATE = 0.08  # 8% налог
+    SERVICE_CHARGE = 0.05  # 5% сервисный сбор
+
+    def __init__(self, customer):
+        self.customer = customer
+        self.dishes = []
+    
+    def add_dish(self, dish):
+        if isinstance(dish, Dish):
+            self.dishes.append(dish)
+        else:
+            raise ValueError("Можно добавлять только объекты класса Dish.")
+    
+    def remove_dish(self, dish):
+        if dish in self.dishes:
+            self.dishes.remove(dish)
+        else:
+            raise ValueError("Такого блюда нет в заказе.")
+
+    def calculate_total(self):
+        return sum(dish.price for dish in self.dishes)
+
+
+    def final_total(self):
+        total_after_discount = self.apply_discount()
+        total_with_tax = total_after_discount * (1 + Order.TAX_RATE)
+        final_total = total_with_tax * (1 + Order.SERVICE_CHARGE)
+        return final_total
+
+    def apply_discount(self):
+        discount_rate = self.customer.get_discount() / 100
+        return self.calculate_total() * (1 - discount_rate)
+
+    def __str__(self):
+        dish_list = "\n".join([str(dish) for dish in self.dishes])
+        return f"Order for {self.customer.name}:\n{dish_list}\nTotal: ${self.final_total():.2f}"
+
+
+class GroupOrder(Order):
+    def __init__(self, customers):
+        super().__init__(customer=None)  # Групповой заказ не привязан к одному клиенту
+        self.customers = customers
+
+    def split_bill(self):
+        if not self.customers:
+            raise ValueError("Нет клиентов для разделения счета.")
+        total = self.final_total()
+        return total / len(self.customers)
+
+    def __str__(self):
+        customer_list = ", ".join([customer.name for customer in self.customers])
+        dish_list = "\n".join([str(dish) for dish in self.dishes])
+        return f"Group Order for {customer_list}:\n{dish_list}\nTotal: ${self.final_total():.2f}"
+  
+class Dish:
+    def __init__(self, name, price, category):
+        self.name = name
+        self.price = price
+        self.category = category
+
+    def __str__(self):
+        return f"Dish: {self.name}, Category: {self.category}, Price: ${self.price:.2f}"
+
+class Customer:
+    def __init__(self, name, membership="Regular"):
+        self.name = name
+        self.membership = membership
+
+    def get_discount(self):
+        if self.membership == "VIP":
+            return 10  # VIP клиенты получают 10% скидки
+        return 0  # Обычные клиенты не получают скидки
+
+    def __str__(self):
+        return f"Customer: {self.name}, Membership: {self.membership}"
+# Пример использования
+
+# Создаем блюда
+pizza = Dish("Pizza", 12, "Main Course")
+ice_cream = Dish("Ice Cream", 5, "Dessert")
+coffee = Dish("Coffee", 3, "Drink")
+
+# Создаем клиентов
+regular_customer = Customer("Alice", "Regular")
+vip_customer = Customer("Bob", "VIP")
+
+# Индивидуальный заказ
+order1 = Order(regular_customer)
+order1.add_dish(pizza)
+order1.add_dish(ice_cream)
+
+print(order1)  # Вывод информации о заказе
+print(f"Final Total: ${order1.final_total():.2f}")  # Итоговая стоимость
+
+# Групповой заказ
+group_order = GroupOrder([regular_customer, vip_customer])
+group_order.add_dish(pizza)
+group_order.add_dish(ice_cream)
+group_order.add_dish(coffee)
+
+print(group_order)  # Вывод информации о групповом заказе
+print(f"Split Bill: ${group_order.split_bill():.2f} per person")  # Стоимость на каждого