ch08, 09, 10: example files

10-dp-1class-func/strategy.py

@@ -0,0 +1,103 @@
+# strategy.py
+# Strategy pattern -- function-based implementation
+
+"""
+# tag::STRATEGY_TESTS[]
+
+    >>> joe = Customer('John Doe', 0)  # <1>
+    >>> ann = Customer('Ann Smith', 1100)
+    >>> cart = [LineItem('banana', 4, .5),
+    ...         LineItem('apple', 10, 1.5),
+    ...         LineItem('watermellon', 5, 5.0)]
+    >>> Order(joe, cart, fidelity_promo)  # <2>
+    <Order total: 42.00 due: 42.00>
+    >>> Order(ann, cart, fidelity_promo)
+    <Order total: 42.00 due: 39.90>
+    >>> banana_cart = [LineItem('banana', 30, .5),
+    ...                LineItem('apple', 10, 1.5)]
+    >>> Order(joe, banana_cart, bulk_item_promo)  # <3>
+    <Order total: 30.00 due: 28.50>
+    >>> big_cart = [LineItem(str(item_code), 1, 1.0)
+    ...               for item_code in range(10)]
+    >>> Order(joe, big_cart, large_order_promo)
+    <Order total: 10.00 due: 9.30>
+    >>> Order(joe, cart, large_order_promo)
+    <Order total: 42.00 due: 42.00>
+
+# end::STRATEGY_TESTS[]
+"""
+# tag::STRATEGY[]
+
+import typing
+from typing import Sequence, Optional, Callable
+
+
+class Customer(typing.NamedTuple):
+    name: str
+    fidelity: int
+
+
+class LineItem:
+    def __init__(self, product: str, quantity: int, price: float):
+        self.product = product
+        self.quantity = quantity
+        self.price = price
+
+    def total(self):
+        return self.price * self.quantity
+
+
+class Order:  # the Context
+    def __init__(
+        self,
+        customer: Customer,
+        cart: Sequence[LineItem],
+        promotion: Optional[Callable[['Order'], float]] = None,
+    ) -> None:
+        self.customer = customer
+        self.cart = list(cart)
+        self.promotion = promotion
+
+    def total(self) -> float:
+        if not hasattr(self, '__total'):
+            self.__total = sum(item.total() for item in self.cart)
+        return self.__total
+
+    def due(self) -> float:
+        if self.promotion is None:
+            discount = 0.0
+        else:
+            discount = self.promotion(self)  # <1>
+        return self.total() - discount
+
+    def __repr__(self):
+        fmt = '<Order total: {:.2f} due: {:.2f}>'
+        return fmt.format(self.total(), self.due())
+
+
+# <2>
+
+
+def fidelity_promo(order: Order) -> float:  # <3>
+    """5% discount for customers with 1000 or more fidelity points"""
+    return order.total() * 0.05 if order.customer.fidelity >= 1000 else 0
+
+
+def bulk_item_promo(order: Order):
+    """10% discount for each LineItem with 20 or more units"""
+    discount = 0
+    for item in order.cart:
+        if item.quantity >= 20:
+            discount += item.total() * 0.1
+    return discount
+
+
+def large_order_promo(order: Order):
+    """7% discount for orders with 10 or more distinct items"""
+    distinct_items = {item.product for item in order.cart}
+    if len(distinct_items) >= 10:
+        return order.total() * 0.07
+    return 0
+
+
+# end::STRATEGY[]