Based on SARS's tax pocket guide for 2022/23

---

Use this income tax calculator to work out your monthly take-home pay
View Source Code »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. How to use the Tax Calculator
4. Roadmap
5. Contributing
6. License
7. Acknowledgments

About The Project

Ignorance could cost you a fine or two, or even jail time. Ensure that your taxes are paid. No more, nor less than is absolutely necessary.

This Tax Calculator will do that for you. Annualy, monthly and even the percentage of your gross income you lose to income tax.

Features

1. Calculate Income

• Annual
• Monthly

2. Calculate Income Tax

• Annual
• Monthly

3. Calculate Net Income

• Annual
• Monthly

4. Display Taxed Percentile
5. Display Tax Bracket

Disclaimer: Results do not cater for all scenarios and should be used as an indicator only. For more information visit https://www.sars.gov.za/ or consult a professional.

(back to top)

Built With

• Python 3.10.4

(back to top)

Getting Started

Setting up Tax Calculator on your local machine is as simple as 1, 2, 3. Just follow the steps; 1, 2 and 3.

Prerequisites

You'll need Python 3.8 or higher. Don't worry, it doesn't bite ... often.

How to download the lastest version of Python:

• Click here to navigate to python's official page.
• Click on the big, flashy "Download Python [version]" button.
• Save the executable file.
• Open the .exe file within the downloaded location, and follow the installation instructions.

Installation

1. Open the terminal / command prompt:

• On PC: Open Command prompt by pressing start, then typing "cmd" then hit ENTER.
• On Mac OS: Click the Launchpad icon in the Dock, type Terminal in the search field, then click Terminal.

2. Navigate to the directory you would like to install Unit Converter:

cd [DirectoryPathHere]

3. Clone the repository by entering the following command into your shell:

   git clone https://github.com/John-JonSteyn/taxCalculatorZA.git

It's that simple! You can run Unit converter with following command:

python taxCalculatorZA.py

(back to top)

How to use the Tax Calculator

When you run the script, this message will be displayed. From here we just follow the instructions:

• Enter your age.
• Enter 'A' if you receive an Annual Salary
• Enter 'M' if you reveive a Monthly Salary
• Enter the amount you earn before tax.

Voila!

(back to top)

Roadmap

• Remove Case-Sensitivity
• Implement Fault-Tolerance with Time Frame
• Display Tax Percentile
• Display Tax Bracket
• Read Brackets and Rates from File
• Display Message if program is out of date
• Multi-langual Support
  • Afrikaans
  • Sotho
  • Xhosa
  • Zulu

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Acknowledgments

I'd also like to thank the Braided-Viqueen for all her guidance and support. Explaining tax, brackets and rebates into the wee hours of the morning.

• Braided-Viqueen

I'd also like to acknowledge Karan and his project list, which greatly inspired not only this project - but many projects to come.

• Karan Projects

(back to top)