Рецензия на книгу

• 

  pyuscherbakov

  7 ноября 2024

  В друзья

  Краткий пересказ документации FastAPI с ошибками в примерах и ссылками на другие источники

  В книге автор пытается обучить разработке сервиса на основе FastAPI, но ключевое слово– "Пытается". Данные по FastAPI весьма поверхностные. Книга подойдет для тех, кто вообще не знаком с данным фреймворком. Помимо FastAPI есть краткое введение в аннотацию типов, Pydantic и асинхронные функции. Затронуто множество тем, помимо фреймворка, но все они очень краткие и содержат скорее краткое описание технологии/библиотеки с предложением изучить подробнее уже самостоятельно и ссылкой на офф.документацию. В прочем, книжка маленькая, читается легко, не стоит ожидать от неё многого.

  Плюсы:
  

  • Обширное кол-во тем, хоть они и не раскрыты особо, но подойдет для того, что бы просто узнать об их существовании и изучить подробнее.
  • Легко читается, ко всем темам есть "подступы". Например, изучили аннотации типов, изучили Pydantic, изучаем FastAPI, на основе которого используется тот самый Pydantic с аннотациями.
  • Затрагивается тема тестирования кода– уважаю

    Минусы:

  • Поверхностная информация о FastAPI
  • Ошибки в примерах. Встречались неправильные импорты, ошибки в названии переменных, отсутствие аннотаций типов в каких-то местах.
  • Неочевидные действия в примерах. Например, разрабатывается тестовый API сервис, изначально на захардкоженных данных. После этого прикручиваем SQLite3, но как меняем всё остальное под базу данных– не описано.
  • Ошибки в верстке. Есть момент, где показывается иерархия директорий проекта, так вот– она совсем не информативна ввиду того, что верстка поплыла. Пришлось искать оригинал и смотреть там.
  • Местами странный перевод. В теме тестирования кода, на вершине пирамиды тестирования откуда-то взялись, "Полные тесты" (дословно). Видимо к лету не успели скинуть вес. Вообще, там должны быть End-to-end.

    Вывод: если вы ничего не знаете о FastAPI и хотите быстро с ним ознакомиться– читать можно. Официальная дока FastAPI сильно информативнее данной книги.

  1 понравилось

  0

  101