{"id":22242814,"url":"https://github.com/theluqmn/tax-calculator","last_synced_at":"2026-02-01T05:30:58.520Z","repository":{"id":220258061,"uuid":"751168771","full_name":"theluqmn/Tax-Calculator","owner":"theluqmn","description":"Progressive Tax Calculator","archived":false,"fork":false,"pushed_at":"2024-04-26T03:18:05.000Z","size":20,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-13T13:54:00.677Z","etag":null,"topics":["calculator","json","python","tax"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theluqmn.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"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}},"created_at":"2024-02-01T04:06:13.000Z","updated_at":"2024-05-10T03:00:54.000Z","dependencies_parsed_at":"2024-02-01T05:25:06.454Z","dependency_job_id":"168fe28e-743d-408d-85f0-5dd1e7f96eb7","html_url":"https://github.com/theluqmn/Tax-Calculator","commit_stats":null,"previous_names":["luqmanity/taxed","luqmanually/tax-calculator","luq-mn/tax-calculator","theluqmn/tax-calculator"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/theluqmn/Tax-Calculator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theluqmn%2FTax-Calculator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theluqmn%2FTax-Calculator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theluqmn%2FTax-Calculator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theluqmn%2FTax-Calculator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theluqmn","download_url":"https://codeload.github.com/theluqmn/Tax-Calculator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theluqmn%2FTax-Calculator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28969972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T04:44:20.970Z","status":"ssl_error","status_checked_at":"2026-02-01T04:44:19.994Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["calculator","json","python","tax"],"created_at":"2024-12-03T04:17:43.486Z","updated_at":"2026-02-01T05:30:58.486Z","avatar_url":"https://github.com/theluqmn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tax Calculator\n\nThis is a basic tax calculator designed for countries with progressive taxation (aka, taxes with brackets).\n\nThe USA bracket and several copies (for testing) is included by default, in the `/tax_brackets` folder.\n\n## How it works\n\nFirst, this script lists down all available tax brackets. You will enter an ID for the tax bracket you would\nlike to use for the calculation (eg: USA.json).\n\nSecond, you will be instructed to input your **yearly** salary.\n\nLastly, it will begin to calculate your tax. It loops through the different tax brackets until\nit locates the bracket that is within range of your salary. Once it successfully locates your bracket,\nit will output your total tax and what tier you belong in, and will mention the tier's salary range.\n\nDo note that this script is designed to have robust error-catching, whenever needed - such as checking\nfor missing files/folders. This project is part of Project ChainLink, as an exercise for robust, scalable\nand redundant software solutions. This is also the first actual working project I made this year, ever\nsince my absence - which lasted roughly four months.\n\n**Code written 100% by Luqman (MY)**.\nSpecial thanks to **Hannah (US) for helping out with this project idea :D\n\n## Tax Bracket JSON Format\n\nCurrently, this code follows the version 1 format. It consists of a version, name, country and updated year key, followed\nby a list containing the tiers (each tier is a dictionary of its own).\n\nEach different bracket follows a JSON format that can be read by this code, and it is as follow:\n\n```json\n\n{\n    \"format_version\":1,\n    \"name\": \"US tax bracket (single-filers)\",\n    \"country\": \"USA\",\n    \"updated\": 2021,\n    \"tiers\": [\n        {\n            \"tier\":1,\n            \"rate\":10,\n            \"min\":0,\n            \"max\":9875\n        },\n        {\n            \"tier\":2,\n            \"rate\":12,\n            \"min\":9876,\n            \"max\":40125\n        },\n    ]\n}\n```\n\nYou can add as much tiers as needed, according to your local tax laws. Each bracket is identified in the system through\nthe file name (eg: USA.json) as the ID.\n\nDo note that the rate is in percentages (eg: 22 is 0.22x).\n\n## Error Catching\n\n`/tax_brackets` and `/scripts`, including all of its contents, is required for this tool to function.\n`/tax_brackets` folder can be empty, and is checked for so when loading brackets. This will end up\nin the tool informing you of so and exiting. Other error catching is just basic things, hence not worth\nmentioning.\n\nThis script also checks if each of the individual tax brackets contains required keys, and follows the format that this code\nis able to read. Refer to **Tax Bracket JSON Format** above for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheluqmn%2Ftax-calculator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheluqmn%2Ftax-calculator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheluqmn%2Ftax-calculator/lists"}