Гексагональная архитектура в приложениях Django

Как не превратить свой проект в груду урлов? Как не потерять расширяемость с ростом кодовой базы? Как писать поддерживаемый код? Об этих проблемах и их возможных решениях на примере Django расскажет и покажет Малышев Артем.

Moscow Python Meetup №30

Transcript

1. HEXAGONAL DJANGO @PROOFIT404
2. ПОГОВОРИМ О КОДЕ
3. ПЛОХОЙ КОД
4. ПЛОХОЙ КОД БОЛЬНО БЬЕТ ПО ПРОДАКШЕНУ :(
5. КОМУ-ТО БЫЛО ЛЕНЬ ПИСАТЬ CUSTOM MANAGER def make_report(request, pk): request.GET = request.GET.copy() request.GET['foo'] = 'bar' response = another_report(request, pk) return render(request, 'report.html', context=response.context_data)
6. А ЕЩЁ ПОЛОЖИЛ ЛОГИКУ В ШАБЛОНЫ, ЧТО ЕЙ ТАМ БУДЕТ... {% for i, j, k in rows %} <tr> <td>{{ i }}</td> <td>{{ j }}</td> <td>{{ i|add:j }}</td> </tr> {% endfor %}
7. И ВСЕ ВРОДЕ БЫ РАБОТАЕТ Customer Orders number In total Jane 2 120$ Ted 7 3053$
8. ДО ПЕРВОГО ИЗМЕНЕНИЯ В ANOTHER_REPORT Customer Orders number In total Jane 2 -2453261524615246.0$ Ted 7 -7502737247324375.0$
9. Проект ломается в местах, несвязанных с вносимыми изменениями ХРУПКОСТЬ
10. Необходимо вносить большое количество правок в различные части проекта даже для тривиальных задач ЖЕСТКОСТЬ
11. .
12. .
13. НЕ ВСЕ ТАК ПРОСТО В зависимости от контекста код решает проблему сам становится проблемой
14. КОД ПЛОХОЙ, ЕСЛИ ПРИ РАБОТЕ НАД НИМ ЧУВСТВУЕШЬ СЕБЯ ВОТ ТАК
15. .
16. КОД ХОРОШИЙ, ЕСЛИ КАЖДЫЙ ТИКЕТ ВЫГЛЯДИТ ВОТ ТАК
19. . TOM CHRISTIE As codebases grow it becomes difficult to make any cast-iron guarantees that you really are enforcing application-level data integrity. DJANGO MODELS, ENCAPSULATION AND DATA INTEGRITY
20. АРХИТЕКТУРНЫЕ СТИЛИ
21. PIPELINE ARCHITECTURE
22. LAYERED ARCHITECTURE
23. MVC ФРЕЙМВОРКИ ХОРОШО ПОДХОДЯТ ДЛЯ CRUD ПРИЛОЖЕНИЙ class PublisherList(ListView): model = Publisher context_object_name = 'publishers' class PublisherDetail(DetailView): queryset = Publisher.objects.all() context_object_name = 'publisher'
24. ГЕКСАГОНАЛЬНАЯ АРХИТЕКТУРА Позволяет взаимодействовать с приложением как пользователю, так и программам, автоматическим тестам, скриптам пакетной обработки. Также позволяет приложению быть разработанным и оттестированным без каких- либо дополнительных устройств или баз данных.
25. .
26. ПРИЧЁМ ТУТ DJANGO?
27. ENTITY class Order: def calculate_price(self): return sum(product.price for product in self.bucket)
28. USE CASE class Purchase(UseCase): @boundary_method def start(user_name, product_name): user = self.get_user(user_name) product = self.get_product(product_name) if product.allowed_for(user): self.success.ask_for_confirmation() else: self.failure.impossible_purchase()
29. USE CASE def get_product(self, product_name): try: product = self.products.by_name(product_name) except NotAvailable: self.failure.product_not_available() else: return product
30. ENTITY GATEWAY class ProductGateway(Gateway): @entity(Product) def by_name(product_name): raise NotImplementedError def not_available_error(): raise NotAvailable
31. IMPLEMENTATION class Products(ProductGateway): def by_name(product_name): product_row = ProductModel.objects.get(name=product_name) if product_row.amount < 1: self.not_available_error() else: return {'price': product_row.price}
32. PRESENTERS class Failure(Presenter): def product_not_available(self): return render_to_response('products/not_available.html')
33. BOUNDARIES class PurchaseBoundary(Boundary): use_case = Purchase() products = Products() failure = Failure()
34. CONTROLLERS class PurchaseView(UseCaseView): boundary = PurchaseBoundary()
35. .
36. PROS: Сохраняется связь с доменной областью Изоляция зависимостей Очень быстрые тесты
37. CONS: Сложнее чем MVC для понимания Придется подумать, как использовать существующие инструменты
38. КАК НАЧАТЬ В УЖЕ СУЩЕСТВУЮЩЕМ ПРОЕКТЕ?
39. REUSABLE APPS ➙ REUSABLE HEXAGONS app/ templates/ templatetags/ tests/ entities.py persistence.py presenters.py use_cases.py views.py
40. HEXAGONAL LAYOUT business/ entities/ product .py use_cases/ purchase.py persistence/ web/ templates/ templatetags/ api/
41. READING Robert Martin. Architecture: The lost years Chris Fidao. Hexagonal Architecture Николай Рыжиков. Use Case Driven Development Кирилл Мокевнин. Ментальное программирование
42. LET THE HOLY WAR BEGIN!