Source code for oscar.apps.partner.strategy

from collections import namedtuple
from decimal import Decimal as D

from . import availability, prices


# A container for policies
PurchaseInfo = namedtuple(
    'PurchaseInfo', ['price', 'availability', 'stockrecord'])


[docs]class Selector(object): """ Responsible for returning the appropriate strategy class for a given user/session. This can be called in three ways: #) Passing a request and user. This is for determining prices/availability for a normal user browsing the site. #) Passing just the user. This is for offline processes that don't have a request instance but do know which user to determine prices for. #) Passing nothing. This is for offline processes that don't correspond to a specific user. Eg, determining a price to store in a search index. """
[docs] def strategy(self, request=None, user=None, **kwargs): """ Return an instanticated strategy instance """ # Default to the backwards-compatible strategy of picking the first # stockrecord but charging zero tax. return Default(request)
[docs]class Base(object): """ The base strategy class Given a product, strategies are responsible for returning a ``PurchaseInfo`` instance which contains: - The appropriate stockrecord for this customer - A pricing policy instance - An availability policy instance """ def __init__(self, request=None): self.request = request self.user = None if request and request.user.is_authenticated(): self.user = request.user
[docs] def fetch_for_product(self, product, stockrecord=None): """ Given a product, return a ``PurchaseInfo`` instance. The ``PurchaseInfo`` class is a named tuple with attributes: - ``price``: a pricing policy object. - ``availability``: an availability policy object. - ``stockrecord``: the stockrecord that is being used If a stockrecord is passed, return the appropriate ``PurchaseInfo`` instance for that product and stockrecord is returned. """ raise NotImplementedError( "A strategy class must define a fetch_for_product method " "for returning the availability and pricing " "information." )
[docs] def fetch_for_group(self, product): """ Given a group product, fetch a ``StockInfo`` instance """ raise NotImplementedError( "A strategy class must define a fetch_for_group method " "for returning the availability and pricing " "information." )
[docs] def fetch_for_line(self, line, stockrecord=None): """ Given a basket line instance, fetch a ``PurchaseInfo`` instance. This method is provided to allow purchase info to be determined using a basket line's attributes. For instance, "bundle" products often use basket line attributes to store SKUs of contained products. For such products, we need to look at the availability of each contained product to determine overall availability. """ # Default to ignoring any basket line options as we don't know what to # do with them within Oscar - that's up to your project to implement. return self.fetch_for_product(line.product)
[docs]class Structured(Base): """ A strategy class which provides separate, overridable methods for determining the 3 things that a ``PurchaseInfo`` instance requires: #) A stockrecord #) A pricing policy #) An availability policy """
[docs] def fetch_for_product(self, product, stockrecord=None): """ Return the appropriate ``PurchaseInfo`` instance. This method is not intended to be overridden. """ if stockrecord is None: stockrecord = self.select_stockrecord(product) return PurchaseInfo( price=self.pricing_policy(product, stockrecord), availability=self.availability_policy(product, stockrecord), stockrecord=stockrecord)
def fetch_for_group(self, product): # Select variants and associated stockrecords variant_stock = self.select_variant_stockrecords(product) return PurchaseInfo( price=self.group_pricing_policy(product, variant_stock), availability=self.group_availability_policy( product, variant_stock), stockrecord=None)
[docs] def select_stockrecord(self, product): """ Select the appropriate stockrecord """ raise NotImplementedError( "A structured strategy class must define a " "'select_stockrecord' method")
[docs] def select_variant_stockrecords(self, product): """ Select appropriate stock record for all variants of a product """ records = [] for variant in product.variants.all(): records.append((variant, self.select_stockrecord(variant))) return records
[docs] def pricing_policy(self, product, stockrecord): """ Return the appropriate pricing policy """ raise NotImplementedError( "A structured strategy class must define a " "'pricing_policy' method")
[docs] def availability_policy(self, product, stockrecord): """ Return the appropriate availability policy """ raise NotImplementedError( "A structured strategy class must define a " "'availability_policy' method") # Mixins - these can be used to construct the appropriate strategy class
[docs]class UseFirstStockRecord(object): """ Stockrecord selection mixin for use with the ``Structured`` base strategy. This mixin picks the first (normally only) stockrecord to fulfil a product. This is backwards compatible with Oscar<0.6 where only one stockrecord per product was permitted. """ def select_stockrecord(self, product): try: return product.stockrecords.all()[0] except IndexError: return None
[docs]class StockRequired(object): """ Availability policy mixin for use with the ``Structured`` base strategy. This mixin ensures that a product can only be bought if it has stock available (if stock is being tracked). """ def availability_policy(self, product, stockrecord): if not stockrecord: return availability.Unavailable() if not product.get_product_class().track_stock: return availability.Available() else: return availability.StockRequired( stockrecord.net_stock_level) def group_availability_policy(self, product, variant_stock): # A parent product is available if one of its variants is for variant, stockrecord in variant_stock: policy = self.availability_policy(product, stockrecord) if policy.is_available_to_buy: return availability.Available() return availability.Unavailable()
[docs]class NoTax(object): """ Pricing policy mixin for use with the ``Structured`` base strategy. This mixin specifies zero tax and uses the ``price_excl_tax`` from the stockrecord. """ def pricing_policy(self, product, stockrecord): if not stockrecord: return prices.Unavailable() return prices.FixedPrice( currency=stockrecord.price_currency, excl_tax=stockrecord.price_excl_tax, tax=D('0.00')) def group_pricing_policy(self, product, variant_stock): stockrecords = [x[1] for x in variant_stock if x[1] is not None] if not stockrecords: return prices.Unavailable() # We take price from first record stockrecord = stockrecords[0] return prices.FixedPrice( currency=stockrecord.price_currency, excl_tax=stockrecord.price_excl_tax, tax=D('0.00'))
[docs]class FixedRateTax(object): """ Pricing policy mixin for use with the ``Structured`` base strategy. This mixin applies a fixed rate tax to the base price from the product's stockrecord. The price_incl_tax is quantized to two decimal places. Rounding behaviour is Decimal's default """ rate = D('0') # Subclass and specify the correct rate exponent = D('0.01') # Default to two decimal places def pricing_policy(self, product, stockrecord): if not stockrecord: return prices.Unavailable() tax = (stockrecord.price_excl_tax * self.rate).quantize(self.exponent) return prices.TaxInclusiveFixedPrice( currency=stockrecord.price_currency, excl_tax=stockrecord.price_excl_tax, tax=tax)
[docs]class DeferredTax(object): """ Pricing policy mixin for use with the ``Structured`` base strategy. This mixin does not specify the product tax and is suitable to territories where tax isn't known until late in the checkout process. """ def pricing_policy(self, product, stockrecord): if not stockrecord: return prices.Unavailable() return prices.FixedPrice( currency=stockrecord.price_currency, excl_tax=stockrecord.price_excl_tax) # Example strategy composed of above mixins. For real projects, it's likely # you'll want to use a different pricing mixin as you'll probably want to # charge tax!
[docs]class Default(UseFirstStockRecord, StockRequired, NoTax, Structured): """ Default stock/price strategy that uses the first found stockrecord for a product, ensures that stock is available (unless the product class indicates that we don't need to track stock) and charges zero tax. """
[docs]class UK(UseFirstStockRecord, StockRequired, FixedRateTax, Structured): """ Sample strategy for the UK that: - uses the first stockrecord for each product (effectively assuming there is only one). - requires that a product has stock available to be bought - applies a fixed rate of tax on all products This is just a sample strategy used for internal development. It is not recommended to be used in production, especially as the tax rate is hard-coded. """ # Use UK VAT rate (as of December 2013) rate = D('0.20')
[docs]class US(UseFirstStockRecord, StockRequired, DeferredTax, Structured): """ Sample strategy for the US. - uses the first stockrecord for each product (effectively assuming there is only one). - requires that a product has stock available to be bought - doesn't apply a tax to product prices (normally this will be done after the shipping address is entered). This is just a sample one used for internal development. It is not recommended to be used in production. """