def __init__(self, number: str, contract: Contract) -> None:
""" Create a new PhoneLine with <number> and <contract>.
"""
self.number = number
self.contract = contract
self.callhistory = CallHistory()
self.bills = {}
class PhoneLine:
""" MewbileTech customer's phone line.
=== Public Attributes ===
number:
phone number
contract:
current contract for this phone, represented by a Contract instance
bills:
dictionary containing all the bills for this phoneline
each key is a (month, year) tuple and the corresponding value is
the Bill object for that month+year date.
callhistory:
call history for this phone line, represented as a CallHistory object
=== Representation Invariants ===
- the <bills> dictionary contains as keys only those month+year combinations
for dates that are encountered at least in one call from the input dataset.
"""
number: str
contract: Contract
bills: Dict[Tuple[int, int], Bill]
callhistory: CallHistory
def __init__(self, number: str, contract: Contract) -> None:
""" Create a new PhoneLine with <number> and <contract>.
"""
self.number = number
self.contract = contract
self.callhistory = CallHistory()
self.bills = {}
def new_month(self, month: int, year: int) -> None:
""" Advance to a new month (specified by <month> and <year>) in the
contract corresponding to this phone line.
If the new month+year does not already exist in the <bills> attribute,
create a new bill.
"""
self.bills[(month, year)] = Bill()
self.contract.new_month(month, year, self.bills[(month, year)])
def make_call(self, call: Call) -> None:
""" Add the <call> to this phone line's callhistory, and bill it
according to the contract for this phone line.
If there is no bill for the current monthly billing cycle, then a new
month must be <started> by advancing to the right month from <call>.
"""
self.callhistory.register_outgoing_call(call)
self.contract.bill_call(call)
def receive_call(self, call: Call) -> None:
""" Add the <call> to this phone line's callhistory.
Incoming calls are not billed under any contract.
However, if there is no bill for the current monthly billing cycle,
then a new month must be <started> by advancing to the right month from
<call>.
"""
self.callhistory.register_incoming_call(call)
def cancel_line(self) -> float:
""" Cancel this line's contract and return the outstanding bill amount
"""
return self.contract.cancel_contract()
# ----------------------------------------------------------
# NOTE: You do not need to understand the implementation of
# the following methods, to be able to solve this assignment
# but feel free to read them to get a sense of what these do.
# ----------------------------------------------------------
def get_number(self) -> str:
""" Return the phone number for this line
"""
return self.number
def get_call_history(self) -> CallHistory:
""" Return the CallHistory for this line
"""
return self.callhistory
def get_monthly_history(self, month: int = None, year: int = None) -> \
Tuple[List[Call], List[Call]]:
""" Return all calls this line has made during the <month> month of the
<year> year, formatted as a Tuple containing two lists, in this order:
outgoing calls, incoming calls
If month and year are both None, then return all calls from the
callhistory of this phone line.
Precondition:
- <month> and <year> are either both specified, or are both missing/None
- if <month> and <year> are specified (non-None), they are both valid
monthly cycles according to the input dataset
"""
return self.callhistory.get_monthly_history(month, year)
def get_bill(self, month: int, year: int) \
-> Optional[Dict[str, Union[float, int]]]:
""" Return a bill summary for the <month>+<year> billing cycle, as a
dictionary.
This dictionary will include the following string keys:
"number" - indicates the phone number
"type" - indicates the contract type
"fixed" - fixed cost for that month
"free_mins" - number of free minutes used in this monthly cycle
"billed_mins" - number of billed minutes used in this monthly cycle
"min_rate" - billing rate per minute
"total" - total cost for this monthly bill
The values corresponding to each key represent the respective amounts.
If no bill exists for this month+year, return None.
"""
if (month, year) not in self.bills:
return None
bill_summary = self.bills[(month, year)].get_summary()
bill_summary['number'] = self.number
return bill_summary
