https://github.com/peterdsp/greek-salary-calculator-cli
A Python CLI tool to calculate net-gross salary in Greece. Includes employer and employee insurance contributions, income tax, and tax credits based on number of children. Get detailed monthly and annual breakdowns effortlessly!
https://github.com/peterdsp/greek-salary-calculator-cli
Last synced: 19 days ago
JSON representation
A Python CLI tool to calculate net-gross salary in Greece. Includes employer and employee insurance contributions, income tax, and tax credits based on number of children. Get detailed monthly and annual breakdowns effortlessly!
- Host: GitHub
- URL: https://github.com/peterdsp/greek-salary-calculator-cli
- Owner: peterdsp
- License: mit
- Created: 2024-08-02T11:09:11.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-02T12:06:17.000Z (almost 2 years ago)
- Last Synced: 2024-08-03T13:20:53.877Z (almost 2 years ago)
- Language: Python
- Homepage:
- Size: 10.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🇬🇷 Greek Salary Calculator CLI 🇬🇷
### Calculate your net salary in Greece for 2023 effortlessly!
---
## 🚀 Introduction
Welcome to the **Greek Salary Calculator CLI**! This Python tool helps you calculate your net monthly and annual salary in Greece for the tax year 2023. It takes into account:
- Employer and employee insurance contributions
- Income tax
- Tax credits based on the number of children
You can use it as a CLI tool or through a REST API.
---
## 🛠️ Features
- **Employer Contributions**: Automatically calculated based on the gross salary.
- **Employee Insurance Contributions**: Deducted before calculating the taxable income.
- **Income Tax**: Applied on a graduated basis according to Greek tax law.
- **Tax Credits**: Adjusted based on the number of children.
- **Detailed Salary Breakdown**: Outputs gross and net monthly and annual salaries.
---
## 💻 How to Run the CLI
1. **Clone the repository**:
```sh
git clone https://github.com/peterdsp/greek-salary-calculator-cli.git
```
2. **Navigate to the project directory**:
```sh
cd greek-salary-calculator-cli
```
3. **Install the dependencies**:
```sh
pip install -r requirements.txt
```
4. **Run the application**:
```sh
python ng_salary_calculator.py
```
---
## 🌐 How to Use the REST API
1. **Navigate to the project directory**:
```sh
cd greek-salary-calculator-cli
```
2. **Install the dependencies**:
```sh
pip install -r requirements.txt
```
3. **Run the Flask application**:
```sh
python ng_salary_calculator_api.py
```
4. **Send a POST request to the API**:
- URL: `http://127.0.0.1:5000/calculate_net_salary`
- Body:
```json
{
"gross_monthly_salary": 2000,
"num_children": 2
}
```
### Example CURL Command
```sh
curl -X POST http://127.0.0.1:5000/calculate_net_salary -H "Content-Type: application/json" -d '{"gross_monthly_salary": 2000, "num_children": 2}'
```
### Example Response
```json
{
"gross_monthly_salary": 2000.0,
"gross_annual_salary": 28000.0,
"net_monthly_salary": 1457.29,
"net_annual_salary": 20401.08
}
```
---
## Explanation of the Calculation
1. **Gross Monthly Salary**: The starting salary provided by the user.
2. **Annual Gross Salary**: Calculated as `gross_monthly_salary * 14` since there are 14 monthly payments in the year. 3. **Employee's Insurance Contribution**: Calculated based on whether the gross salary exceeds the insurable earnings ceiling. 4. **Annual Insurance Contribution**: The monthly insurance contribution multiplied by 14. 5. **Annual Taxable Income**: The gross annual salary minus the annual insurance contribution. 6. **Total Tax**: Calculated based on the taxable income using the given tax brackets and rates. 7. **Tax Credit**: Based on the number of children and reduced by income above €12,000. 8. **Final Tax**: The total tax reduced by the tax credit. 9. **Net Annual Income**: The gross annual salary minus the insurance contributions and final tax. 10. **Net Monthly Income**: The net annual income divided by 14.
***
## 🤝 Contributing
Contributions are welcome! Feel free to open an issue or submit a pull request.
---
## 📜 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
## 🌟 Acknowledgements
Special thanks to the developers and contributors who have made this project possible.
---
## 📧 Contact
For any questions, please contact us at [info@peterdsp.dev](mailto:info@peterdsp.dev).