py-mortgagekit
Build Status
Description
Python library for mortgage calculations.
Installation
Requirements
- Python 3.6++
Instructions
pip instll py-mortgagekitUsage
Development
Here is an example of using the using the library in your code.
from mortgagekit.constants import *
from mortgagekit.calculator import *
# Define our variables.
total_amount = Money(amount=250000.00, currency="USD")
down_payment = Money(amount=50000.00, currency="USD")
amortization_year = 25
annual_interest_rate = Decimal(0.04)
payment_frequency = MORTGAGEKIT_MONTH # see calculator.py for more options.
compounding_period = MORTGAGEKIT_SEMI_ANNUAL
first_payment_date = '2008-01-01'
# Feel free to use an alternate currency type by first checking to see if your
# your currency is supported here:
# https://github.com/limist/py-moneyed/blob/master/moneyed/localization.py#L348
currency='USD'
# Load up our calculator.
calc = MortgageCalculator(total_amount, down_payment, amortization_year,
annual_interest_rate, payment_frequency, compounding_period,
first_payment_date, currency)
# Perform computations.
payment_schedule = calc.mortgage_payment_schedule()
# You can now inspect the results and use it for your purposes.
print(payment_schedule)Quality Assurance
Unit Tests
If you want to run the unit tests, you can run the following.
Here is how you run the unit tests.
python setup.py testCode Coverage
Here is how you run code coverage. The first command runs the code coverage
and the second command provides a report. If you would like to know more about coverage then click to here to read.
coverage run --source=mortgagekit setup.py test
coverage report -mLicense
This library is licensed under the BSD license. See LICENSE.md for more information.
