{"id":21293349,"url":"https://github.com/ejw-data/sim-financials","last_synced_at":"2025-09-12T18:14:45.250Z","repository":{"id":65751829,"uuid":"568547903","full_name":"ejw-data/sim-financials","owner":"ejw-data","description":"Financial Calculator of Personal Finances using Object Oriented Programming","archived":false,"fork":false,"pushed_at":"2023-02-08T07:29:15.000Z","size":192,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-22T06:47:16.294Z","etag":null,"topics":["python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ejw-data.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2022-11-20T21:29:48.000Z","updated_at":"2023-08-08T20:48:38.000Z","dependencies_parsed_at":"2023-05-15T14:00:33.710Z","dependency_job_id":null,"html_url":"https://github.com/ejw-data/sim-financials","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ejw-data%2Fsim-financials","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ejw-data%2Fsim-financials/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ejw-data%2Fsim-financials/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ejw-data%2Fsim-financials/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ejw-data","download_url":"https://codeload.github.com/ejw-data/sim-financials/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243762236,"owners_count":20343976,"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":["python"],"created_at":"2024-11-21T13:54:25.623Z","updated_at":"2025-03-15T16:44:33.060Z","avatar_url":"https://github.com/ejw-data.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sim-financials\n\nCalculator that can do the following:\n* Car calculator \n    - inputs:  selling price, down payment, interest rate, book value, insurance cost, taxes, maintenance cost, repair cost, ?replacement cost, fuel cost, registration fees, \n    - outputs: current expense, annual cash flow, future savings\n* House calculator:\n    - inputs: selling price, offer price, down payment, interest rate, surrounding house value, maintenance cost, repair cost, insurance cost, heating/cooling cost, electric cost, sewer costs, internet/cable costs, roof replacement, furnace replacement, siding replacement, insulation replacement, remodelling, property taxes, selling tax, realator fees, yard expenses, \n    - outputs:\n\n* Rent calculator:\n    - inputs: rent cost, internet cost, gym cost, insurance, electricity expense\n    - outputs:  current expense, annual cash flow\n\n* Retirement calculator:\n    - Bond calc:\n    - Stock calc:\n    - Investment property calc:\n    - Expenses\n\n\nOther considerations:\n* Compare rent versus buying scenario - is there are savings?\n    - The goal is to reduce total cash flow to balance all savings; for example, housing cost directly effects retirement savings and general spending and purchase initiatives.  \n    - Scenario:  Buy house then have direct and indirect expenses, but could rent.  The comparision is interest expenses, maintenance expenses, taxes, utility costs, internet/cable that are recurring for ownership and rent and required expenses.  \n    - Excellent analysis could be:  1) Calc annual cash flows and equity for house and apartment.  2) Next calc the savings if the rent savings was used as down payment.  \n\nDesigned with OOP so that the processes can be repeated and results stored to get a broad range of aggregated results.\n\nDev Notes:\nCalculated assets by updating savings periodically because savings depends on previous year's savings then adding the current year income and subtracing the current year's expenses.\n\nData Structure: \n```\n    setup={ id: sim_id\n            meta: {start_year: #, end_year: #, sim_length: #, retirement_year: # }\n            balance_sheet:{\n                2015: \n                    {income:[\n                        {amount: #, source:xxx},\n                        {amount: #, source:xxx}\n                        ],\n                    expenses:[],\n                    assets:[\n                        {savings:#}\n                        ], \n                    liabilities[]\n                    }\n                \n            }\n          }\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fejw-data%2Fsim-financials","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fejw-data%2Fsim-financials","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fejw-data%2Fsim-financials/lists"}