New to unittest and Python in general, came across example in a tutorial introduction to unit testing wherein a with statement is used to catch a ValueError.
The script being tested (invoice_calculator.py) is:
def divide_pay(amount, staff_hours):
"""
Divide an invoice evenly amongst staff depending on how many hours they
worked on a project
"""
total_hours = 0
for person in staff_hours:
total_hours += staff_hours[person]
if total_hours == 0:
raise ValueError("No hours entered")
per_hour = amount / total_hours
staff_pay = {}
for person in staff_hours:
pay = staff_hours[person] * per_hour
staff_pay[person] = pay
return staff_pay
The unit test includes this function in order to catch an edge case wherein staff_hours = None
:
import unittest
from invoice_calculator import divide_pay
class InvoiceCalculatorTests(unittest.TestCase):
def test_equality(self):
pay = divide_pay(300.0, {"Alice": 3.0, "Bob": 6.0, "Carol": 0.0})
self.assertEqual(pay, {'Bob': 75.0, 'Alice': 75.0, 'Carol': 150.0})
def test_zero_hours_total(self):
with self.assertRaises(ValueError):
pay = divide_pay(360.0, {"Alice": 0.0, "Bob": 0.0, "Carol": 0.0})
if __name__ == "__main__":
unittest.main()
Regarding the use of the with
statement in test_zero_hours_total(self)
, what is actually happening here in terms of how this statement works/is being executed?
Is the test_zero_hours_total()
function basically working as follows (layman's description): the expected error should be ValueError
(which we're doing by passing ValueError
to the function assertRaises()
) when 360.0, {"Alice": 0.0, "Bob": 0.0, "Carol": 0.0}
(which would raise a ValueError
in divide_pay()
) is passed as arguments to the divide_pay()
function?