{"id":23305736,"url":"https://github.com/mmsaki/timevalue","last_synced_at":"2025-06-15T13:05:58.430Z","repository":{"id":85110461,"uuid":"581655627","full_name":"mmsaki/timevalue","owner":"mmsaki","description":"A python package for time money value calculations, annuity and perpetuity","archived":false,"fork":false,"pushed_at":"2025-06-13T06:24:32.000Z","size":392,"stargazers_count":3,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-13T07:28:54.119Z","etag":null,"topics":["annuity","perpetuity","python"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/timevalue/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mmsaki.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-12-23T21:15:08.000Z","updated_at":"2025-06-13T06:24:36.000Z","dependencies_parsed_at":"2024-02-15T00:31:17.193Z","dependency_job_id":"1e68151b-3712-4747-80bf-47b9ee92bad4","html_url":"https://github.com/mmsaki/timevalue","commit_stats":{"total_commits":98,"total_committers":3,"mean_commits":"32.666666666666664","dds":0.2755102040816326,"last_synced_commit":"e932da1f33fc47c1f6116a90df05adc4a79a22a5"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/mmsaki/timevalue","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmsaki%2Ftimevalue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmsaki%2Ftimevalue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmsaki%2Ftimevalue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmsaki%2Ftimevalue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mmsaki","download_url":"https://codeload.github.com/mmsaki/timevalue/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmsaki%2Ftimevalue/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259981467,"owners_count":22941148,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["annuity","perpetuity","python"],"created_at":"2024-12-20T12:14:09.746Z","updated_at":"2025-06-15T13:05:58.411Z","avatar_url":"https://github.com/mmsaki.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Timevalue\n\n![PyPI - Version](https://img.shields.io/pypi/v/timevalue)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/timevalue)\n![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/mmsaki/timevalue)\n![GitHub License](https://img.shields.io/github/license/mmsaki/timevalue)\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/mmsaki/timevalue)\n![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/msakiart)\n\nTimevalue is a simple Python package for finding the time value of money\n\n```bash\npip install timevalue\n```\n\n## Run Tests\n\nTo run tests:\n\n```bash\npytest --verbosity=1\n```\n\n## Future \u0026 Present Cli Commands\n\nFind future value of money for $1000$ at $0.03%$ interest for $2$ periods:\n\n```bash\nfuture 1000 .03 2 #returns 1060.90\n```\n\nFind present value of money for $1000$ at $0.03%$ interest for $2$ periods:\n\n```bash\npresent 1000 .03 2 #returns 942.60\n```\n\n## Annuity Cli Command\n\nAnnuities are payments are that are paid to you as a steady stream of income. Heres an example annuity.\n\nQ1. Find the future value of an annuity cash flow of $1000$ with and interest rate of $0.06$ for $3$ periods.\n\n```bash\nannuity --future_value --cash_flow 1000 --interest_rate 0.06 --time 3 # returns 2673.011949461636\n```\n\nSay we want calculate the annuity present value given the cash flow as the result from Q1, use the `--present_value` and `--pv` flag to get the cash flow value:\n\n```bash\nannuity --present_value --cash_flow 2673.011949461636 --interest_rate 0.06 --time 3 --pv\n```\n\nHeres an example of growing annuity due.\n\n```bash\nannuity --future_value --due --cash_flow 1000 --interest_rate 0.06 --time 3 --growth_rate .10\n```\n\nOutput:\n\n```bash\n3709.576\n```\n\nYou can access the help by using `annuity --help`.\n\n## Import timevalue package\n\n```python3\nIn [1]: from timevalue.investing import time_value_money\n\nIn [2]: initialize = time_value_money.TimeValueOfMoney()\n\nIn [3]: initialize.future_value_of_money(1000, .03, 2)\nOut[3]: 1060.9\n\nIn [4]: initialize.present_value_of_money(1000, .03, 2)\nOut[4]: 942.5959091337544\n```\n\nSee more [examples](https://github.com/mmsaki/timevalue/blob/main/src/timevalue/examples/annuities.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmsaki%2Ftimevalue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmmsaki%2Ftimevalue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmsaki%2Ftimevalue/lists"}