vladefr97 / async_api_sprint_2 Goto Github PK

Покрыть функциональными тестами endpoint /films

Оценка: 8

Покрыть функциональными тестами endpoint /genres , /genre

ok

Покрыть функциональными тестами endpoint /person
Оценка: 5

Приветствую! Хорошая работа, но еще есть что улучшить.

1. [исправить] При инъекции внешнего сервиса лучше использовать абстрактный класс. Тоже самое касается и redis. Проблемы могут возникнуть, когда будет принято решение заменить redis на memcached, а es на что-то другое.
   Как это может быть реализовано, например для redis:

   from abc import ABC
   
   class AsyncCacheStorage(ABC):
       @abstractmethod
       async def get(self, key: str, **kwargs):
           pass
   
       @abstractmethod
       async def set(self, key: str, value: str, expire: int, **kwargs):
           pass
   

   В итоге запись redis: Redis = Depends(get_redis) можно заменить на cache: AsyncCacheStorage = Depends(get_redis), а es=Depends(get_elastic) заменится на text_search: FullTextSearch = Depends(get_elastic). Здесь главное, чтобы используемый класс кэширования/полнотекстового поиска реализовал методы абстрактного класса. В итоге, если необходимо будет заменить redis на memcached, то надо будет только изменить cache: AsyncCacheStorage = Depends(get_memcached).
2. [исправить] Этот параметр лучше убрать в конфиг. Во-первых, так все настройки будут лежать в одном месте. Во-вторых, другим программистам, которые будут развивать и поддерживать сервис, не надо будет искать настраиваемые параметры по всему проекту.
3. [можно лучше] page и size можно поместить в отдельный класс и потом везде использовать в качестве dependency:

   class Paginator(BaseModel):
       page_number: int = Query(default=0, alias='page[number]')
       page_size: int = Query(default=10, alias='page[size]')
   

   @router.get('/')
   async def get_items(paginator: Paginator = Depends()):
       ...
   

   Профит в том, что его можно переиспользовать и тем самым мы избавляемся от дублирования кода.
   Кстати, с остальными параметрами функции вы можете сделать тоже самое. Это по сути ответ на вопрос в todo.
4. [исправить] Этот маркер можно указать один раз и не дублировать его для всех тестов https://github.com/pytest-dev/pytest-asyncio#pytestmarkasyncio
5. [можно лучше] Рекомендую для всех тестов придерживаться подхода ААА. Т.е., делать перенос строки после каждой логической единицы, выполняемой в тесте, если тело теста превышает 3 строки. Под логическими единицами подразумевается: подготовка, вызов тестируемого объекта и сравнение результата теста (assert). Если в тесте меньше трех строк, то можно не делать переносы.

Покрыть функциональными тестами endpoint /persons

Реализовать работу с внешними сервисами через exponential backoff

Оценка: 8

Покрыть функциональными тестами endpoint /genre
Оценка: 5

Разработать инфраструктуру для запуска функциональных тестов. Тесты изолированно запускаются в docker-compose[

Подготовить документацию для клиентов сервиса, используя OpenAPI

Оценка: 5

Покрыть функциональными тестами endpoint /film

Оценка: 5