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

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