def test_save_read_file():
"""
verify save donors and read donors
we create a donors object, save it, read it, then
examine the contents which indirectly tests both save and read
"""
test_donor_a = Donor(full_name="Joe Smith", donation=100)
test_donor_a.add_donation(150)
test_donor_b = Donor(full_name="Mary Jo Kline, III", donation=1000)
test_donors = Donors(test_donor_a)
test_donors.add_donor(test_donor_b)
test_donor_file = "test_donor_file"
save_donor_file(test_donors, donor_file=test_donor_file)
return_donors = load_donor_file(donor_file=test_donor_file)
name_matches = [x[0] for x in return_donors.full_name_index]
print(name_matches)
assert "Joe Smith" in name_matches
assert "Mary Jo Kline, III" in name_matches
assert "Joe Jo Williams" not in name_matches
os.remove(test_donor_file)
def test_match_donor():
""" verify the match_donor search functions """
test_donor_a = Donor(full_name="Joe Smith", donation=100)
test_donor_a.add_donation(150)
test_donor_b = Donor(full_name="Mary Jo Kline, III", donation=1000)
test_donors = Donors(test_donor_a)
test_donors.add_donor(test_donor_b)
matches = test_donors.match_donor("Joe Smith")
name_matches = [x[0] for x in matches]
print(matches)
assert "Joe Smith" in name_matches
assert "Mary Jo Kline, III" not in name_matches
def test_thank_all_donors():
""" verify the print_thank_you() function """
test_donor_a = Donor(full_name="Joe Smith", donation=100)
test_donor_a.add_donation(150)
test_donor_b = Donor(full_name="Mary Jo Kline, III", donation=1000)
test_donors = Donors(test_donor_a)
test_donors.add_donor(test_donor_b)
out = io.StringIO()
thank_all_donors(test_donors, dest_override=out)
output = out.getvalue()
out.close()
assert "Dearest Mary Jo Kline, III," in output
assert "Dearest Joe Smith," in output
def test_donor_iter():
""" verify the Donors object is iterable """
test_donor_a = Donor(full_name="Joe Smith", donation=100)
test_donor_b = Donor(full_name="Mary Jo Kline, III", donation=1000)
test_donor_c = Donor(full_name="Adam Frank")
test_donors = Donors(test_donor_a)
test_donors.add_donor(test_donor_b)
test_donors.add_donor(test_donor_c)
counter = 0
for full_name, did, last_name, first_name in test_donors:
print(full_name, did, last_name, first_name)
counter += 1
assert counter == 3
def test_audit_entry():
""" baseline test to verify ability to create Donor() object """
security.user = "******"
donor = Donor(first_name="joe")
print(donor.audit)
assert donor.audit[0]["user"] == "Jeff Jones"
assert donor.audit[0]["action"] == "first_name"
assert donor.audit[0]["args"] == ('Joe', )
def test_list_donors():
""" verify the list_donors() function """
test_donor_a = Donor(full_name="Joe Smith", donation=100)
test_donor_a.add_donation(150)
test_donor_b = Donor(full_name="Mary Jo Kline, III", donation=1000)
test_donors = Donors(test_donor_a)
test_donors.add_donor(test_donor_b)
out = io.StringIO()
list_donors(test_donors, dest=out)
output = out.getvalue()
out.close()
print(output)
assert "Donor Name | Total Given | Num Gifts | Average Gift" in output
assert "Joe Smith $ 250.00 2 $ 125.00" in output
assert "Mary Jo Kline, III $ 1,000.00 1 $ 1,000.00" in output
def test_print_thank_you():
""" verify the print_thank_you() function """
a_donor = Donor(full_name='Mary Jo Smith, IV')
out = io.StringIO()
print_thank_you(a_donor, "testfull", out)
output = out.getvalue()
out.close()
assert "Dearest Mary Jo Smith, IV," in output
def test_donor_entry_error():
"""
test donation error
we enter invalid data (string) and then are re-prompted
"""
amount = get_donation_amount(Donor(full_name="Test Donor5"))
assert amount == 999
def test_access_restriction():
""" we expect object creation to fail without a user context """
with pytest.raises(PermissionError) as err:
security.user = None
donor = repr(Donor())
print(donor)
assert donor.find("did=")
assert donor.find("created=")
assert err.value.args[0] == "You must be logged in to make changes."
def test_full_name():
""" test ability to create a Donor from a full_name """
donor = Donor(full_name="susan j adams")
first_name = donor.first_name
middle_name = donor.middle_name
last_name = donor.last_name
suffix = donor.suffix
assert first_name == "Susan"
assert middle_name == "J"
assert last_name == "Adams"
assert suffix == ""
def test_sub_names():
"""
verify we can create a donor from sub-name parts
indirectly tests case conversion and full name attribute
"""
donor = Donor(first_name="joe",
last_name="smith",
middle_name="q",
suffix="iii")
full_name = donor.full_name
assert full_name == "Joe Q Smith, III"
def test_bulk_donation():
""" test we can add bulk donations on create """
test_donor = Donor(full_name="maggie smith",
donations=[{
'amount': 99.0,
'date': '2017-12-12Z'
}, {
'amount': 100.0,
'date': '2017-12-12Z'
}])
assert test_donor.average_donations == 99.5
def test_donors_str():
""" test repr values represent donors object """
in_donors = Donors(
Donor(did='902a4e3e-deff-11e7-bee5-0800274b0a84',
first_name='Maggie',
last_name='Smith',
donations=[{
'amount': 99.0,
'date': '2017-12-12Z'
}],
created='2017-12-12T05:44:47.480878Z'))
repr_str = repr(in_donors)
out_donors = eval(repr_str)
assert repr(in_donors) == repr(out_donors)
def test_donor_repr():
""" test repr values represent donor object """
in_donor = Donor(did='f7f9a32c-defd-11e7-bee5-0800274b0a84',
first_name='John',
middle_name='Q',
last_name='Smith',
suffix='III',
donations=[{
'amount': 100.0,
'date': '2017-12-12Z'
}],
created='2017-12-12T05:33:22.651546Z')
repr_str = repr(in_donor)
out_donor = eval(repr_str)
assert repr(in_donor) == repr(out_donor)
def test_donor_str():
""" test str values represent donor object """
in_donor = Donor(did='f7f9a32c-defd-11e7-bee5-0800274b0a84',
first_name='John',
middle_name='Q',
last_name='Smith',
suffix='III',
donations=[{
'amount': 100.0,
'date': '2017-12-12Z'
}],
created='2017-12-12T05:33:22.651546Z')
str_str = str(in_donor)
assert "did='f7f9a32c-defd-11e7-bee5-0800274b0a84'" in str_str
assert "average_donations=100" in str_str
assert "informal_name='John Q Smith'" in str_str
assert "full_name='John Q Smith, III'" in str_str
def test_add_donations():
"""
test add_donations
we test that we can add a donation as part of the constructor as well
as via add_donation. we also test that the donation attributes
(number_donations, total_donations and average_donations) work
correctly.
"""
test_donor = Donor(full_name="Joe Smith", donation=100)
test_donor.add_donation(150)
test_donor.add_donation(777.77)
assert test_donor.number_donations == 3
assert test_donor.total_donations == 1027.77
assert test_donor.average_donations == 342.59
def test_create_donors():
"""
verify create_donors
verifies donor objects can be added via the constructor as
well as via add_donor()
"""
test_donor_a = Donor(full_name="Joe Smith", donation=100)
test_donor_a.add_donation(150)
test_donor_b = Donor(full_name="Mary Jo Kline, III", donation=1000)
test_donor_c = Donor(full_name="Adam Frank")
test_donors = Donors(test_donor_a)
test_donors.add_donor(test_donor_b)
test_donors.add_donor(test_donor_c)
name_matches = [x[0] for x in test_donors.full_name_index]
assert test_donors.number_donors == 3
assert "Adam Frank" in name_matches
def test_get_donation_normal():
""" test the donation input routine """
amount = get_donation_amount(Donor(full_name="Test Donor4"))
assert amount == 101
def test_get_donation_quit():
""" test the donation input routine """
amount = get_donation_amount(Donor(full_name="Test Donor5"))
assert amount is None
def data_entry(donors):
""" Enter new donation and send thank you. """
menu = "\n"
menu += "DONATION ENTRY (Donor Name)\n"
menu += "---------------------------\n"
menu += "\n"
menu += "Enter the full name (first last) of the donor\n"
menu += "for whom you would like to enter a donation,\n"
menu += "(l)ist to see a list of the existing donors, or\n"
menu += "(q)uit to return to the previous menu.\n"
menu += "\n"
while True:
print_lines()
print(menu)
selection = safe_input("Donor Name, (l)ist or (q)uit: ")
# check for a quit directive
if selection.lower() in ["q", "quit"]:
return
# check for a list directive
if selection.lower() in ["l", "list"]:
list_donors(donors)
continue
# protect against no entry
if not selection:
continue
# reject blatantly bad input
if len(selection.split()) < 2:
print("You must enter both a first and last name.")
continue
# find any records that match the input
matches = donors.match_donor(selection)
if not matches:
# if there are no matches, go ahead and create a donor record
donor = Donor(full_name=selection)
donors.add_donor(donor)
hint = "new"
if len(matches) == 1:
# if there is an exact match, let's use that one
donor = donors.get_donor(matches[0][1])
hint = "existing"
# TODO: Add confirmation logic and allow them to ignore a current
# record and add a new record anyway.
# prompt for new donation, cancel if None returned
new_donation = get_donation_amount(donor)
if new_donation is None:
print_lines()
print("Donation cancelled!")
return
# update the donor with the new donation
donor.add_donation(new_donation)
# thank the donor for the new donation
print_thank_you(donor, hint)
def test_create_donor():
""" baseline test to verify ability to create Donor() object """
donor = repr(Donor())
print(donor)
assert donor.find("did=")
assert donor.find("created=")