B `B+@sddlmZddlmZddlmZmZddlmZddl m Z ddl m Z ddlmZddlmZdd lmZGd d d ejZGd d d ejZGdddejZdS))Decimal) exceptions)models transaction)Sum)timezone) gettext_lazy)get_unused_code)AUTH_USER_MODEL) get_modelc seZdZdZejedddZejeddZ ej eddd Z ej ed dZ ejd d d Zeed ZeedZejddedddiejd d dZGdddZddZddZddZd(ddZfd d!Zed"d#Zed$d%Zed&d'ZZS))AbstractVoucherSetaCA collection of vouchers (potentially auto-generated) a VoucherSet is a group of voucher that are generated automatically. - count: the minimum number of vouchers in the set. If this is kept at zero, vouchers are created when and as needed. - code_length: the length of the voucher code. Codes are by default created with groups of 4 characters: XXXX-XXXX-XXXX. The dashes (-) do not count for the code_length. - :py:attr:`.start_datetime` and :py:attr:`.end_datetime` together define the validity range for all vouchers in the set. Named) verbose_name max_lengthzNumber of vouchers)rzLength of Code )rdefault DescriptionT) auto_now_adddb_indexzStart datetimez End datetimezoffer.ConditionalOffer voucher_setZOffer offer_typeVoucher) related_namerlimit_choices_to on_deletenullblankc@s.eZdZdZdZdZdgZedZedZ dS)zAbstractVoucherSet.MetaTvoucher date_createdz -date_createdZ VoucherSetZ VoucherSetsN) __name__ __module__ __qualname__abstract app_label get_latest_byordering_rverbose_name_pluralr)r)Q/home/dcms/DCMS/lib/python3.7/site-packages/oscar/apps/voucher/abstract_models.pyMeta-s r+cCs|jS)N)name)selfr)r)r*__str__5szAbstractVoucherSet.__str__cCs,|j}xt||jD] }|qWdS)zGenerate vouchers for this setN)voucherscountrangeadd_new)r-Z current_countir)r)r*generate_vouchers8s z$AbstractVoucherSet.generate_voucherscCsNtdd}t|jd}|jj|j|||j|j|jd}|j rJ|j |j |S)zAdd a new voucher to this setrr)length)r,coderusagestart_datetime end_datetime) r r code_lengthZobjectscreater, SINGLE_USEr8r9offeroffersadd)r-rr6rr)r)r*r2>s   zAbstractVoucherSet.add_newNcCs(|p t}|j|ko"|jkSS)z3Test whether this voucher set is currently active. )rnowr8r9)r- test_datetimer)r)r* is_activeOs zAbstractVoucherSet.is_activec sVt|j|j|_t0tj||||jj|j |j dWdQRXdS)N)r8r9) maxr0r/rZatomicsupersaver4updater8r9)r-argskwargs) __class__r)r*rETs zAbstractVoucherSet.savecCs|jjtdd}|dS)Nnum_basket_additions)resultrK)r/ aggregater)r-valuer)r)r*rJ^sz'AbstractVoucherSet.num_basket_additionscCs|jjtdd}|dS)N num_orders)rKrK)r/rLr)r-rMr)r)r*rNcszAbstractVoucherSet.num_orderscCs|jjtdd}|dS)Ntotal_discount)rKrK)r/rLr)r-rMr)r)r*rOhsz!AbstractVoucherSet.total_discount)N) r r!r"__doc__r CharFieldr'r,PositiveIntegerFieldr0Z IntegerFieldr:Z TextField description DateTimeFieldrr8r9Z OneToOneFieldCASCADEr=r+r.r4r2rBrEpropertyrJrNrO __classcell__r)r))rIr*r s,    r cseZdZdZejeddeddZejeddddedd Zej d d ed d didZ d\Z Z Z e edfe edfe edffZejeddee dZejedddZejedddZejedddZejedddZejeddded d!Zejd"ddd ejd#Zejddd$ZGd%d&d&Zd'd(Zd)d*Zfd+d,Z dAbstractVouchera. A voucher. This is simply a link to a collection of offers. Note that there are three possible "usage" modes: (a) Single use (b) Multi-use (c) Once per customer Oscar enforces those modes by creating VoucherApplication instances when a voucher is used for an order. r zIThis will be shown in the checkout and basket once the voucher is entered)r help_textZCodeTz$Case insensitive / No spaces allowed)rruniquerZzoffer.ConditionalOfferr/ZOffersrr)rrr)z Single usez Multi-usezOnce per customerz Can be used once by one customerz0Can be used multiple times by multiple customersz"Can only be used once per customerUsage)rchoicesrzStart datetime)rz End datetimezTimes added to basketr)rzTimes on orderszTotal discountrz0.00)Zdecimal_placesZ max_digitsrzvoucher.VoucherSet)rrrr)rrc@s.eZdZdZdZdgZdZedZedZ dS)zAbstractVoucher.MetaTrz -date_createdrrZVouchersN) r r!r"r#r$r&r%r'rr(r)r)r)r*r+s r+cCs|jS)N)r,)r-r)r)r*r.szAbstractVoucher.__str__cCs,t|j|j|j|jkgr(ttddS)Nz(End date should be later than start date)allr8r9rZValidationErrorr')r-r)r)r*cleans zAbstractVoucher.cleancs|j|_tj||dS)N)r6upperrDrE)r-rGrH)rIr)r*rEs zAbstractVoucher.saveNcCs(|p t}|j|ko"|jkSS)z@ Test whether this voucher is currently active. )rr@r8r9)r-rAr)r)r*rBs zAbstractVoucher.is_activecCst}|j|kS)zJ Test whether this voucher has passed its expiration date )rr@r9)r-r@r)r)r* is_expiredszAbstractVoucher.is_expiredcCsd\}}|j|jkr.|j }|std}nT|j|jkr@d}nB|j|jkr|js`d}td}n"|jj||d }|std}||fS)z Test whether this voucher is available to the passed user. Returns a tuple of a boolean for whether it is successful, and a availability message. )Fz"This voucher has already been usedTFz1This voucher is only available to signed in users)ruserz6You have already used this voucher in a previous order) r7r< applicationsexistsr' MULTI_USEONCE_PER_CUSTOMERis_authenticatedfilter)r-rd is_availablemessager)r)r*is_available_to_users"     z$AbstractVoucher.is_available_to_usercCs^|j|jd\}}|sd|fSdtd}}x(|jD]}|j|dr8d}d}Pq8W||fS)z Tests whether this voucher is available to the passed basket. Returns a tuple of a boolean for whether it is successful, and a availability message. )rdFz-This voucher is not available for this basket)basketTrc)rmownerr'r>r_Zis_condition_satisfied)r-rnrkrlr=r)r)r*is_available_for_baskets z'AbstractVoucher.is_available_for_basketcCsD|jr|jj|||dn|jj||d|jd7_|dS)z> Records a usage of this voucher in an order. )rorderrd)rrqN)rirer;rNrE)r-rqrdr)r)r* record_usages zAbstractVoucher.record_usagecCs|j|d7_|dS)z= Record a discount that this offer has given discountN)rOrE)r-rtr)r)r*record_discountszAbstractVoucher.record_discountcCs |jjS)z Returns the first offer's benefit instance. A voucher is commonly only linked to one offer. In that case, this helper can be used for convenience. )r>firstbenefit)r-r)r)r*rwszAbstractVoucher.benefit)N)N)+r r!r"rPrrQr'r,r6ZManyToManyFieldr>r<rgrhZ USAGE_CHOICESr7rTr8r9rRrJrNZ DecimalFieldrrO ForeignKeyrUrrr+r.r`rErBrbrmrprsZ alters_datarurVrwrWr)r))rIr*rXnsN               rXc@s|eZdZdZejdejdeddZeje ddejeddZ ejd ejed d Z ej ddd Z Gd ddZddZdS)AbstractVoucherApplicationz For tracking how often a voucher has been used in an order. This is used to enforce the voucher usage mode in Voucher.is_available_to_user, and created in Voucher.record_usage. zvoucher.Voucherrer)rrrTZUser)rrrrz order.OrderZOrder)rr)rrc@s*eZdZdZdZdgZedZedZdS)zAbstractVoucherApplication.MetaTrz -date_createdzVoucher ApplicationzVoucher ApplicationsN) r r!r"r#r$r&r'rr(r)r)r)r*r+,s r+cCstd|j|jdS)Nz '%(voucher)s' used by '%(user)s')rrd)r'rrd)r-r)r)r*r.3sz"AbstractVoucherApplication.__str__N)r r!r"rPrrxrUr'rr rdrqrTrr+r.r)r)r)r*rys&   ryN)decimalrZ django.corerZ django.dbrrZdjango.db.modelsrZ django.utilsrZdjango.utils.translationrr'Zoscar.apps.voucher.utilsr Zoscar.core.compatr Zoscar.core.loadingr ZModelr rXryr)r)r)r*s        `$