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 17KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472
  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 event(self, event_type, quantity=None):
  138. """
  139. Creates a shipping event for the test line
  140. """
  141. event = ShippingEvent.objects.create(order=self.order, event_type=event_type)
  142. if quantity is None:
  143. quantity = self.line.quantity
  144. ShippingEventQuantity.objects.create(
  145. event=event, line=self.line, quantity=quantity
  146. )
  147. def test_shipping_event_history(self):
  148. self.event(self.order_placed, 3)
  149. self.event(self.dispatched, 1)
  150. history = self.line.shipping_event_breakdown
  151. self.assertEqual(3, history["Order placed"]["quantity"])
  152. self.assertEqual(1, history["Dispatched"]["quantity"])
  153. def test_shipping_status_is_empty_to_start_with(self):
  154. self.assertEqual("", self.line.shipping_status)
  155. def test_shipping_status_after_full_line_event(self):
  156. self.event(self.order_placed)
  157. self.assertEqual(self.order_placed.name, self.line.shipping_status)
  158. def test_shipping_status_after_two_full_line_events(self):
  159. type1 = self.order_placed
  160. self.event(type1)
  161. type2 = self.dispatched
  162. self.event(type2)
  163. self.assertEqual(type2.name, self.line.shipping_status)
  164. def test_shipping_status_after_partial_line_event(self):
  165. event_type = self.order_placed
  166. self.event(event_type, 3)
  167. expected = "%s (%d/%d items)" % (event_type.name, 3, self.line.quantity)
  168. self.assertEqual(expected, self.line.shipping_status)
  169. def test_has_passed_shipping_status_after_full_line_event(self):
  170. event_type = self.order_placed
  171. self.event(event_type)
  172. self.assertTrue(self.line.has_shipping_event_occurred(event_type))
  173. def test_has_passed_shipping_status_after_partial_line_event(self):
  174. event_type = self.order_placed
  175. self.event(event_type, self.line.quantity - 1)
  176. self.assertFalse(self.line.has_shipping_event_occurred(event_type), 1)
  177. def test_has_passed_shipping_status_after_multiple_line_event(self):
  178. event_types = [
  179. ShippingEventType.objects.get(code="order_placed"),
  180. ShippingEventType.objects.get(code="dispatched"),
  181. ]
  182. for event_type in event_types:
  183. self.event(event_type)
  184. for event_type in event_types:
  185. self.assertTrue(self.line.has_shipping_event_occurred(event_type))
  186. def test_inconsistent_shipping_status_setting(self):
  187. event_type = self.order_placed
  188. self.event(event_type, self.line.quantity - 1)
  189. with self.assertRaises(InvalidShippingEvent):
  190. self.event(event_type, self.line.quantity)
  191. def test_inconsistent_shipping_quantities(self):
  192. event_type = ShippingEventType.objects.get(code="order_placed")
  193. self.event(event_type, self.line.quantity - 1)
  194. with self.assertRaises(InvalidShippingEvent):
  195. # Total quantity is too high
  196. self.event(event_type, 2)
  197. def test_handles_product_deletion_gracefully(self):
  198. product = self.line.product
  199. product.delete()
  200. line = Line.objects.get(pk=self.line.pk)
  201. self.assertIsNone(line.product)
  202. self.assertIsNone(line.stockrecord)
  203. self.assertEqual(product.title, line.title)
  204. self.assertEqual(product.upc, line.upc)
  205. class LineStatusTests(TestCase):
  206. def setUp(self):
  207. Line.pipeline = {"A": ("B", "C"), "B": ("C",), "C": ()}
  208. self.order = create_order()
  209. self.line = self.order.lines.all()[0]
  210. self.line.status = "A"
  211. self.line.save()
  212. def test_all_statuses_class_method(self):
  213. self.assertEqual(["A", "B", "C"], sorted(Line.all_statuses()))
  214. def test_invalid_status_set_raises_exception(self):
  215. with self.assertRaises(InvalidLineStatus):
  216. self.line.set_status("D")
  217. def test_set_status_changes_status(self):
  218. self.line.set_status("C")
  219. self.assertEqual("C", self.line.status)
  220. def test_setting_same_status_does_nothing(self):
  221. self.line.set_status("A")
  222. def test_set_status_sends_a_signal(self):
  223. with mock_signal_receiver(order_line_status_changed) as receiver:
  224. self.line.set_status("C")
  225. self.assertEqual(receiver.call_count, 1)
  226. class ShippingEventTypeTests(TestCase):
  227. def tearDown(self):
  228. ShippingEventType.objects.all().delete()
  229. def test_code_is_set_automatically(self):
  230. etype = ShippingEventType.objects.create(name="Returned")
  231. self.assertEqual("returned", etype.code)
  232. class ShippingEventQuantityTests(TestCase):
  233. def setUp(self):
  234. basket = create_basket(empty=True)
  235. add_product(basket, D("10.00"), 4)
  236. self.order = create_order(number="100002", basket=basket)
  237. self.line = self.order.lines.all()[0]
  238. self.shipped, __ = ShippingEventType.objects.get_or_create(name="Shipped")
  239. self.returned, __ = ShippingEventType.objects.get_or_create(name="Returned")
  240. def tearDown(self):
  241. ShippingEventType.objects.all().delete()
  242. def test_quantity_defaults_to_all(self):
  243. event = self.order.shipping_events.create(event_type=self.shipped)
  244. event_quantity = ShippingEventQuantity.objects.create(
  245. event=event, line=self.line
  246. )
  247. self.assertEqual(self.line.quantity, event_quantity.quantity)
  248. def test_event_is_created_ok_when_prerequisites_are_met(self):
  249. shipped_event = self.order.shipping_events.create(event_type=self.shipped)
  250. ShippingEventQuantity.objects.create(event=shipped_event, line=self.line)
  251. event = self.order.shipping_events.create(event_type=self.returned)
  252. ShippingEventQuantity.objects.create(event=event, line=self.line, quantity=1)
  253. class TestOrderDiscount(TestCase):
  254. def test_can_be_created_without_offer_or_voucher(self):
  255. order = create_order(number="100002")
  256. discount = OrderDiscount.objects.create(order=order, amount=D("10.00"))
  257. self.assertTrue(discount.voucher is None)
  258. self.assertTrue(discount.offer is None)
  259. self.assertEqual(discount.description(), "")
  260. def test_can_be_created_with_an_offer(self):
  261. offer = create_offer()
  262. order = create_order(number="100002")
  263. discount = OrderDiscount.objects.create(
  264. order=order, amount=D("10.00"), offer_id=offer.id
  265. )
  266. self.assertEqual(offer.id, discount.offer.id)
  267. self.assertEqual(offer.name, discount.offer_name)
  268. def test_can_be_created_with_an_offer_and_specified_offer_name(self):
  269. offer = create_offer(name="My offer")
  270. order = create_order(number="100002")
  271. discount = OrderDiscount.objects.create(
  272. order=order, amount=D("10.00"), offer_id=offer.id, offer_name="Your offer"
  273. )
  274. self.assertEqual(offer.id, discount.offer.id)
  275. self.assertEqual("Your offer", discount.offer_name)
  276. def test_can_be_created_with_a_voucher(self):
  277. voucher = create_voucher()
  278. order = create_order(number="100002")
  279. discount = OrderDiscount.objects.create(
  280. order=order, amount=D("10.00"), voucher_id=voucher.id
  281. )
  282. self.assertEqual(voucher.id, discount.voucher.id)
  283. self.assertEqual(voucher.code, discount.voucher_code)
  284. def test_can_be_created_with_a_voucher_and_specidied_voucher_code(self):
  285. voucher = create_voucher()
  286. order = create_order(number="100002")
  287. discount = OrderDiscount.objects.create(
  288. order=order,
  289. amount=D("10.00"),
  290. voucher_id=voucher.id,
  291. voucher_code="anothercode",
  292. )
  293. self.assertEqual(voucher.id, discount.voucher.id)
  294. self.assertEqual("anothercode", discount.voucher_code)
  295. def test_contains_offer_details_after_offer_is_deleted(self):
  296. offer = create_offer(name="Get 200% off")
  297. order = create_order(number="100002")
  298. discount = OrderDiscount.objects.create(
  299. order=order, amount=D("10.00"), offer_id=offer.id
  300. )
  301. offer.delete()
  302. self.assertTrue(discount.voucher is None)
  303. self.assertTrue(discount.offer is None)
  304. self.assertEqual(discount.description(), "Get 200% off")
  305. def test_contains_voucher_details_after_voucher_is_deleted(self):
  306. voucher = create_voucher()
  307. order = create_order(number="100002")
  308. discount = OrderDiscount.objects.create(
  309. order=order, amount=D("10.00"), voucher_id=voucher.id
  310. )
  311. voucher.delete()
  312. self.assertTrue(discount.voucher is None)
  313. self.assertTrue(discount.offer is None)
  314. self.assertEqual(discount.description(), voucher.code)
  315. class OrderTests(TestCase):
  316. @mock.patch("oscar.apps.order.abstract_models.now")
  317. def test_sets_date_placed_to_now_by_default(self, mock_now):
  318. tzinfo = timezone.get_current_timezone()
  319. mock_now.return_value = datetime(2017, 6, 23, 16, 14, tzinfo=tzinfo)
  320. order = create_order(number="100003")
  321. self.assertEqual(
  322. order.date_placed, datetime(2017, 6, 23, 16, 14, tzinfo=tzinfo)
  323. )
  324. def test_allows_date_placed_to_be_changed_and_set_explicitly(self):
  325. order = create_order(number="100003")
  326. tzinfo = timezone.get_current_timezone()
  327. order.date_placed = datetime(2012, 8, 11, 16, 14, tzinfo=tzinfo)
  328. order.save()
  329. self.assertEqual(
  330. order.date_placed, datetime(2012, 8, 11, 16, 14, tzinfo=tzinfo)
  331. )
  332. def test_shipping_status(self):
  333. order = OrderFactory()
  334. line_1 = OrderLineFactory(order=order, partner_sku="SKU1234", quantity=2)
  335. line_2 = OrderLineFactory(order=order, partner_sku="SKU5678", quantity=1)
  336. self.assertEqual(order.shipping_status, "")
  337. event_1 = ShippingEventFactory(order=order, event_type__name="Shipped")
  338. event_2 = ShippingEventFactory(order=order, event_type__name="Returned")
  339. # Default status
  340. self.assertEqual(order.shipping_status, _("In progress"))
  341. # Set first line to shipped
  342. event_1.line_quantities.create(line=line_1, quantity=2)
  343. self.assertEqual(order.shipping_status, _("In progress"))
  344. # Set first line to returned
  345. event_2.line_quantities.create(line=line_1, quantity=2)
  346. self.assertEqual(order.shipping_status, _("In progress"))
  347. # Set second line to shipped
  348. event_1.line_quantities.create(line=line_2, quantity=1)
  349. self.assertEqual(order.shipping_status, _("Shipped"))
  350. # Set second line to returned
  351. event_2.line_quantities.create(line=line_2, quantity=1)
  352. self.assertEqual(order.shipping_status, _("Returned"))
  353. @override_settings(SECRET_KEY="order_hash_secret")
  354. def test_verification_hash_generation(self):
  355. order = OrderFactory(number="111000")
  356. self.assertEqual(
  357. order.verification_hash(),
  358. "111000:Ra7jPGqhkcTm6VXKWEdKtFjA0wBIRVqdxED4bp313os",
  359. )
  360. @override_settings(SECRET_KEY="order_hash_secret")
  361. def test_check_verification_hash_valid(self):
  362. order = OrderFactory(number="111000")
  363. self.assertTrue(
  364. order.check_verification_hash(
  365. "111000:Ra7jPGqhkcTm6VXKWEdKtFjA0wBIRVqdxED4bp313os"
  366. )
  367. )
  368. @override_settings(SECRET_KEY="order_hash_secret")
  369. def test_check_verification_hash_invalid_signature(self):
  370. order = OrderFactory(number="111000")
  371. self.assertFalse(
  372. order.check_verification_hash("111000:HKDZWNPLsq7589517c3v1Q6DHKD")
  373. )
  374. @override_settings(SECRET_KEY="order_hash_secret")
  375. def test_check_verification_hash_valid_signature_but_wrong_number(self):
  376. order = OrderFactory(number="111000")
  377. # Hash is valid, but it is for a different order number
  378. self.assertFalse(
  379. order.check_verification_hash("222000:knvoMB1KAiJu8meWtGce00Y88j4")
  380. )