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

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