Slides from my talk at KhmelnitskyPy community meetup #1 about REST and validation

1. Flask, REST, validation
Yehor Nazarkin
twitter.com/nimnull
github.com/nimnull

2. Требования
• Что в основе?
• Что хотим получить?
• Как будем расширять?
• Где храним данные?

3. REST
• хорошо подходит для web сервисов
• ресурсо-ориентированный
• отсутствие состояния (в декларации)

4. Потребности
• представление:
players/ — GET (read many), POST (create one)
players/1 — GET (read one), PUT (update one), DELETE (delete one)

5. Потребности
• фильтрация/сортировки данных:
players/?filter=joined_at__gte%3D1429821631
players/?
order_fields=nickname,joined_at&order_dir=asc

6. Потребности
• валидация клиентского ввода
• поддержка нескольких хранилищ
• сущности по агрегированным данным
• аутентификация (cookies, basic http, token-based)
• авторизация (группы, пользователи)
• доступ групп клиентов к разным наборам атрибутов

7. Варианты решения
• Пишем своё
• Берем готовое решение и допиливаем

8. Django?
• django-tastypie
• django-rest-framework
• django-pyston
• etc

9. Django?
• Известные проблемы
расширяемости
• Not Invented Here
• Эволюция проекта часто влечет
отказ от поставляемых решений

10. Flask?
• микро-фреймворк
• основан на werkzeug & jinja2
• большое количество расширений
• На почитать — http://flask.pocoo.org

11. Flask?
• гибкость
• простота (относительная)
• расширяемость

12. Что уже есть?
• eve
• flask-restful
• flask-restless
• potion

13. Если пилим сами
• MethodView FTW!
• flask.ext….anything

14. Если пилим сами

15. Как проверять?
• Imperative
• Declarative
• Mixed?

16. Где проверять
• Данные от пользователей
• Отправка/обработка результатов
внешних сервисов
• Схема данных хранилища

17. Note:
ORM и подобные предлагают
собственные решения

18. Как проверять?

19. Как проверять?
формы (Django/WTF/etc)

20. Как проверять?
• Gladiator (py3)
• Cerberus (py3)
• Schemer
• kanone
• trafaret

21. Как проверять?

22. Как проверять?

23. Как проверять?

24. Другие проблемы?

25. Вопросы?

26. Links:
• Nested resources — https://github.com/alanjds/drf-nested-routers
• Gladiator — https://github.com/alanjds/drf-nested-routers
• Schemer — https://github.com/gamechanger/schemer
• Trafaret — https://github.com/deepwalker/trafaret