You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

test_models.py 18KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451
  1. from datetime import timedelta, datetime
  2. from decimal import Decimal as D
  3. from unittest import mock
  4. from django.core.exceptions import ImproperlyConfigured
  5. from django.test import TestCase, override_settings
  6. from django.utils import timezone
  7. from django.utils.translation import gettext_lazy as _
  8. from oscar.apps.order.exceptions import (
  9. InvalidOrderStatus, InvalidLineStatus, InvalidShippingEvent)
  10. from oscar.apps.order.models import (
  11. Order, Line, ShippingEvent, ShippingEventType, ShippingEventQuantity,
  12. OrderNote, OrderDiscount)
  13. from oscar.apps.order.signals import order_line_status_changed, order_status_changed
  14. from oscar.test.basket import add_product
  15. from oscar.test.contextmanagers import mock_signal_receiver
  16. from oscar.test.factories import (
  17. create_order, create_offer, create_voucher, create_basket,
  18. OrderFactory, OrderLineFactory, ShippingAddressFactory,
  19. ShippingEventFactory)
  20. ORDER_PLACED = 'order_placed'
  21. class ShippingAddressTest(TestCase):
  22. def test_titleless_salutation_is_stripped(self):
  23. a = ShippingAddressFactory(
  24. first_name='', last_name='Barrington', line1="75 Smith Road",
  25. postcode="N4 8TY")
  26. self.assertEqual("Barrington", a.salutation)
  27. class OrderStatusPipelineTests(TestCase):
  28. def setUp(self):
  29. Order.pipeline = {'PENDING': ('SHIPPED', 'CANCELLED'),
  30. 'SHIPPED': ('COMPLETE',)}
  31. Order.cascade = {'SHIPPED': 'SHIPPED'}
  32. def tearDown(self):
  33. Order.pipeline = {}
  34. Order.cascade = {}
  35. def test_available_statuses_for_pending(self):
  36. self.order = create_order(status='PENDING')
  37. self.assertEqual(('SHIPPED', 'CANCELLED'),
  38. self.order.available_statuses())
  39. def test_available_statuses_for_shipped_order(self):
  40. self.order = create_order(status='SHIPPED')
  41. self.assertEqual(('COMPLETE',), self.order.available_statuses())
  42. def test_no_statuses_available_for_no_status(self):
  43. self.order = create_order()
  44. self.assertEqual((), self.order.available_statuses())
  45. def test_set_status_respects_pipeline(self):
  46. self.order = create_order(status='SHIPPED')
  47. with self.assertRaises(InvalidOrderStatus):
  48. self.order.set_status('PENDING')
  49. def test_set_status_does_nothing_for_same_status(self):
  50. self.order = create_order(status='PENDING')
  51. self.order.set_status('PENDING')
  52. self.assertEqual('PENDING', self.order.status)
  53. def test_set_status_works(self):
  54. self.order = create_order(status='PENDING')
  55. self.order.set_status('SHIPPED')
  56. self.assertEqual('SHIPPED', self.order.status)
  57. def test_cascading_status_change(self):
  58. self.order = create_order(status='PENDING')
  59. self.order.set_status('SHIPPED')
  60. for line in self.order.lines.all():
  61. self.assertEqual('SHIPPED', line.status)
  62. def test_set_status_sends_a_signal(self):
  63. self.order = create_order(status='PENDING')
  64. with mock_signal_receiver(order_status_changed) as receiver:
  65. self.order.set_status('SHIPPED')
  66. self.assertEqual(receiver.call_count, 1)
  67. def test_set_status_signal_creates_a_order_status_change_object(self):
  68. self.order = create_order(status='PENDING')
  69. self.order.set_status('SHIPPED')
  70. order_status_change = self.order.status_changes.first()
  71. self.assertEqual(self.order.status_changes.count(), 1)
  72. self.assertEqual(order_status_change.old_status, 'PENDING')
  73. self.assertEqual(order_status_change.new_status, 'SHIPPED')
  74. class OrderNoteTests(TestCase):
  75. def setUp(self):
  76. self.order = create_order()
  77. def test_system_notes_are_not_editable(self):
  78. note = self.order.notes.create(note_type=OrderNote.SYSTEM, message='test')
  79. self.assertFalse(note.is_editable())
  80. def test_non_system_notes_are_editable(self):
  81. note = self.order.notes.create(message='test')
  82. self.assertTrue(note.is_editable())
  83. def test_notes_are_not_editable_after_timeout(self):
  84. OrderNote.editable_lifetime = 1
  85. note = self.order.notes.create(message='test')
  86. self.assertTrue(note.is_editable())
  87. now = timezone.now()
  88. with mock.patch.object(timezone, 'now') as mock_timezone:
  89. mock_timezone.return_value = now + timedelta(seconds=30)
  90. self.assertFalse(note.is_editable())
  91. class LineTests(TestCase):
  92. def setUp(self):
  93. basket = create_basket(empty=True)
  94. add_product(basket, D('10.00'), 4)
  95. self.order = create_order(number='100002', basket=basket)
  96. self.line = self.order.lines.all()[0]
  97. self.order_placed, __ = ShippingEventType.objects.get_or_create(
  98. code='order_placed', name='Order placed')
  99. self.dispatched, __ = ShippingEventType.objects.get_or_create(
  100. code='dispatched', name='Dispatched')
  101. def tearDown(self):
  102. ShippingEventType.objects.all().delete()
  103. def event(self, type, quantity=None):
  104. """
  105. Creates a shipping event for the test line
  106. """
  107. event = ShippingEvent.objects.create(order=self.order, event_type=type)
  108. if quantity is None:
  109. quantity = self.line.quantity
  110. ShippingEventQuantity.objects.create(
  111. event=event, line=self.line, quantity=quantity)
  112. def test_shipping_event_history(self):
  113. self.event(self.order_placed, 3)
  114. self.event(self.dispatched, 1)
  115. history = self.line.shipping_event_breakdown
  116. self.assertEqual(3, history['Order placed']['quantity'])
  117. self.assertEqual(1, history['Dispatched']['quantity'])
  118. def test_shipping_status_is_empty_to_start_with(self):
  119. self.assertEqual('', self.line.shipping_status)
  120. def test_shipping_status_after_full_line_event(self):
  121. self.event(self.order_placed)
  122. self.assertEqual(self.order_placed.name, self.line.shipping_status)
  123. def test_shipping_status_after_two_full_line_events(self):
  124. type1 = self.order_placed
  125. self.event(type1)
  126. type2 = self.dispatched
  127. self.event(type2)
  128. self.assertEqual(type2.name, self.line.shipping_status)
  129. def test_shipping_status_after_partial_line_event(self):
  130. type = self.order_placed
  131. self.event(type, 3)
  132. expected = "%s (%d/%d items)" % (type.name, 3, self.line.quantity)
  133. self.assertEqual(expected, self.line.shipping_status)
  134. def test_has_passed_shipping_status_after_full_line_event(self):
  135. type = self.order_placed
  136. self.event(type)
  137. self.assertTrue(self.line.has_shipping_event_occurred(type))
  138. def test_has_passed_shipping_status_after_partial_line_event(self):
  139. type = self.order_placed
  140. self.event(type, self.line.quantity - 1)
  141. self.assertFalse(self.line.has_shipping_event_occurred(type), 1)
  142. def test_has_passed_shipping_status_after_multiple_line_event(self):
  143. event_types = [ShippingEventType.objects.get(code='order_placed'),
  144. ShippingEventType.objects.get(code='dispatched')]
  145. for type in event_types:
  146. self.event(type)
  147. for type in event_types:
  148. self.assertTrue(self.line.has_shipping_event_occurred(type))
  149. def test_inconsistent_shipping_status_setting(self):
  150. type = self.order_placed
  151. self.event(type, self.line.quantity - 1)
  152. with self.assertRaises(InvalidShippingEvent):
  153. self.event(type, self.line.quantity)
  154. def test_inconsistent_shipping_quantities(self):
  155. type = ShippingEventType.objects.get(code='order_placed')
  156. self.event(type, self.line.quantity - 1)
  157. with self.assertRaises(InvalidShippingEvent):
  158. # Total quantity is too high
  159. self.event(type, 2)
  160. def test_handles_product_deletion_gracefully(self):
  161. product = self.line.product
  162. product.delete()
  163. line = Line.objects.get(pk=self.line.pk)
  164. self.assertIsNone(line.product)
  165. self.assertIsNone(line.stockrecord)
  166. self.assertEqual(product.title, line.title)
  167. self.assertEqual(product.upc, line.upc)
  168. class LineStatusTests(TestCase):
  169. def setUp(self):
  170. Line.pipeline = {'A': ('B', 'C'),
  171. 'B': ('C',)}
  172. self.order = create_order()
  173. self.line = self.order.lines.all()[0]
  174. self.line.status = 'A'
  175. self.line.save()
  176. def test_all_statuses_class_method(self):
  177. self.assertEqual(['A', 'B'], sorted(Line.all_statuses()))
  178. def test_invalid_status_set_raises_exception(self):
  179. with self.assertRaises(InvalidLineStatus):
  180. self.line.set_status('D')
  181. def test_set_status_changes_status(self):
  182. self.line.set_status('C')
  183. self.assertEqual('C', self.line.status)
  184. def test_setting_same_status_does_nothing(self):
  185. self.line.set_status('A')
  186. def test_set_status_sends_a_signal(self):
  187. with mock_signal_receiver(order_line_status_changed) as receiver:
  188. self.line.set_status('C')
  189. self.assertEqual(receiver.call_count, 1)
  190. class ShippingEventTypeTests(TestCase):
  191. def tearDown(self):
  192. ShippingEventType.objects.all().delete()
  193. def test_code_is_set_automatically(self):
  194. etype = ShippingEventType.objects.create(name='Returned')
  195. self.assertEqual('returned', etype.code)
  196. class ShippingEventQuantityTests(TestCase):
  197. def setUp(self):
  198. basket = create_basket(empty=True)
  199. add_product(basket, D('10.00'), 4)
  200. self.order = create_order(number='100002', basket=basket)
  201. self.line = self.order.lines.all()[0]
  202. self.shipped, __ = ShippingEventType.objects.get_or_create(
  203. name='Shipped')
  204. self.returned, __ = ShippingEventType.objects.get_or_create(
  205. name='Returned')
  206. def tearDown(self):
  207. ShippingEventType.objects.all().delete()
  208. def test_quantity_defaults_to_all(self):
  209. event = self.order.shipping_events.create(event_type=self.shipped)
  210. event_quantity = ShippingEventQuantity.objects.create(event=event, line=self.line)
  211. self.assertEqual(self.line.quantity, event_quantity.quantity)
  212. def test_event_is_created_ok_when_prerequisites_are_met(self):
  213. shipped_event = self.order.shipping_events.create(event_type=self.shipped)
  214. ShippingEventQuantity.objects.create(event=shipped_event,
  215. line=self.line)
  216. event = self.order.shipping_events.create(event_type=self.returned)
  217. ShippingEventQuantity.objects.create(event=event,
  218. line=self.line,
  219. quantity=1)
  220. class TestOrderDiscount(TestCase):
  221. def test_can_be_created_without_offer_or_voucher(self):
  222. order = create_order(number='100002')
  223. discount = OrderDiscount.objects.create(order=order, amount=D('10.00'))
  224. self.assertTrue(discount.voucher is None)
  225. self.assertTrue(discount.offer is None)
  226. self.assertEqual(discount.description(), '')
  227. def test_can_be_created_with_an_offer(self):
  228. offer = create_offer()
  229. order = create_order(number='100002')
  230. discount = OrderDiscount.objects.create(order=order, amount=D('10.00'),
  231. offer_id=offer.id)
  232. self.assertEqual(offer.id, discount.offer.id)
  233. self.assertEqual(offer.name, discount.offer_name)
  234. def test_can_be_created_with_an_offer_and_specified_offer_name(self):
  235. offer = create_offer(name="My offer")
  236. order = create_order(number='100002')
  237. discount = OrderDiscount.objects.create(order=order, amount=D('10.00'),
  238. offer_id=offer.id,
  239. offer_name="Your offer")
  240. self.assertEqual(offer.id, discount.offer.id)
  241. self.assertEqual("Your offer", discount.offer_name)
  242. def test_can_be_created_with_a_voucher(self):
  243. voucher = create_voucher()
  244. order = create_order(number='100002')
  245. discount = OrderDiscount.objects.create(order=order, amount=D('10.00'),
  246. voucher_id=voucher.id)
  247. self.assertEqual(voucher.id, discount.voucher.id)
  248. self.assertEqual(voucher.code, discount.voucher_code)
  249. def test_can_be_created_with_a_voucher_and_specidied_voucher_code(self):
  250. voucher = create_voucher()
  251. order = create_order(number='100002')
  252. discount = OrderDiscount.objects.create(order=order, amount=D('10.00'),
  253. voucher_id=voucher.id,
  254. voucher_code="anothercode")
  255. self.assertEqual(voucher.id, discount.voucher.id)
  256. self.assertEqual('anothercode', discount.voucher_code)
  257. def test_contains_offer_details_after_offer_is_deleted(self):
  258. offer = create_offer(name="Get 200% off")
  259. order = create_order(number='100002')
  260. discount = OrderDiscount.objects.create(order=order, amount=D('10.00'),
  261. offer_id=offer.id)
  262. offer.delete()
  263. self.assertTrue(discount.voucher is None)
  264. self.assertTrue(discount.offer is None)
  265. self.assertEqual(discount.description(), 'Get 200% off')
  266. def test_contains_voucher_details_after_voucher_is_deleted(self):
  267. voucher = create_voucher()
  268. order = create_order(number='100002')
  269. discount = OrderDiscount.objects.create(order=order, amount=D('10.00'),
  270. voucher_id=voucher.id)
  271. voucher.delete()
  272. self.assertTrue(discount.voucher is None)
  273. self.assertTrue(discount.offer is None)
  274. self.assertEqual(discount.description(), voucher.code)
  275. class OrderTests(TestCase):
  276. @mock.patch('oscar.apps.order.abstract_models.now')
  277. def test_sets_date_placed_to_now_by_default(self, mock_now):
  278. tzinfo = timezone.get_current_timezone()
  279. mock_now.return_value = datetime(2017, 6, 23, 16, 14, tzinfo=tzinfo)
  280. order = create_order(number='100003')
  281. self.assertEqual(order.date_placed, datetime(2017, 6, 23, 16, 14, tzinfo=tzinfo))
  282. def test_allows_date_placed_to_be_changed_and_set_explicitly(self):
  283. order = create_order(number='100003')
  284. tzinfo = timezone.get_current_timezone()
  285. order.date_placed = datetime(2012, 8, 11, 16, 14, tzinfo=tzinfo)
  286. order.save()
  287. self.assertEqual(order.date_placed, datetime(2012, 8, 11, 16, 14, tzinfo=tzinfo))
  288. def test_shipping_status(self):
  289. order = OrderFactory()
  290. line_1 = OrderLineFactory(
  291. order=order, partner_sku='SKU1234', quantity=2)
  292. line_2 = OrderLineFactory(
  293. order=order, partner_sku='SKU5678', quantity=1)
  294. self.assertEqual(order.shipping_status, '')
  295. event_1 = ShippingEventFactory(order=order, event_type__name='Shipped')
  296. event_2 = ShippingEventFactory(order=order, event_type__name='Returned')
  297. # Default status
  298. self.assertEqual(order.shipping_status, _('In progress'))
  299. # Set first line to shipped
  300. event_1.line_quantities.create(line=line_1, quantity=2)
  301. self.assertEqual(order.shipping_status, _('In progress'))
  302. # Set first line to returned
  303. event_2.line_quantities.create(line=line_1, quantity=2)
  304. self.assertEqual(order.shipping_status, _('In progress'))
  305. # Set second line to shipped
  306. event_1.line_quantities.create(line=line_2, quantity=1)
  307. self.assertEqual(order.shipping_status, _('Shipped'))
  308. # Set second line to returned
  309. event_2.line_quantities.create(line=line_2, quantity=1)
  310. self.assertEqual(order.shipping_status, _('Returned'))
  311. @override_settings(SECRET_KEY='order_hash_secret')
  312. def test_verification_hash_generation(self):
  313. order = OrderFactory(number='111000')
  314. self.assertEqual(order.verification_hash(), '111000:UJrZWNPLsq7zf1r17c3v1Q6DUmE')
  315. @override_settings(SECRET_KEY='order_hash_secret')
  316. def test_check_verification_hash_valid(self):
  317. order = OrderFactory(number='111000')
  318. self.assertTrue(order.check_verification_hash('111000:UJrZWNPLsq7zf1r17c3v1Q6DUmE'))
  319. @override_settings(SECRET_KEY='order_hash_secret')
  320. def test_check_verification_hash_invalid_signature(self):
  321. order = OrderFactory(number='111000')
  322. self.assertFalse(order.check_verification_hash('111000:HKDZWNPLsq7589517c3v1Q6DHKD'))
  323. @override_settings(SECRET_KEY='order_hash_secret')
  324. def test_check_verification_hash_valid_signature_but_wrong_number(self):
  325. order = OrderFactory(number='111000')
  326. # Hash is valid, but it is for a different order number
  327. self.assertFalse(order.check_verification_hash('222000:knvoMB1KAiJu8meWtGce00Y88j4'))
  328. @override_settings(OSCAR_DEPRECATED_ORDER_VERIFY_KEY='deprecated_order_hash_secret')
  329. def test_check_deprecated_hash_verification(self):
  330. order = OrderFactory(number='100001')
  331. # Check that check_deprecated_verification_hash validates the hash
  332. self.assertTrue(
  333. order.check_deprecated_verification_hash('3efd0339e8c789447469f37851cbaaaf')
  334. )
  335. # Check that check_verification_hash calls it correctly
  336. self.assertTrue(order.check_verification_hash('3efd0339e8c789447469f37851cbaaaf'))
  337. def test_check_deprecated_hash_verification_without_old_key(self):
  338. order = OrderFactory(number='100001')
  339. # Check that check_deprecated_verification_hash validates the hash
  340. self.assertFalse(
  341. order.check_deprecated_verification_hash('3efd0339e8c789447469f37851cbaaaf')
  342. )
  343. @override_settings(
  344. OSCAR_DEPRECATED_ORDER_VERIFY_KEY='deprecated_order_hash_secret',
  345. SECRET_KEY='deprecated_order_hash_secret')
  346. def test_check_deprecated_hash_verification_old_key_matches_new(self):
  347. order = OrderFactory(number='100001')
  348. # OSCAR_DEPRECATED_ORDER_VERIFY_KEY must not be equal to SECRET_KEY.
  349. with self.assertRaises(ImproperlyConfigured):
  350. order.check_deprecated_verification_hash('3efd0339e8c789447469f37851cbaaaf')