https://github.com/npodlozhniy/portugal-taxes
Portugal tax console calculator for 2023
https://github.com/npodlozhniy/portugal-taxes
docker numpy portugal taxes
Last synced: 2 months ago
JSON representation
Portugal tax console calculator for 2023
- Host: GitHub
- URL: https://github.com/npodlozhniy/portugal-taxes
- Owner: NPodlozhniy
- License: mit
- Created: 2023-01-31T01:29:22.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-08-22T16:23:01.000Z (2 months ago)
- Last Synced: 2025-08-22T18:52:52.684Z (2 months ago)
- Topics: docker, numpy, portugal, taxes
- Language: Python
- Homepage:
- Size: 18.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# portugal-taxes
Portugal tax console calculator valid for 2023-2025 fiscal years
## :zap: Getting started
The app support interaction via two approaches either a standard console or a docker container
### Installation
You can just copy the repo without installing any additional packages
```
$ git clone https://github.com/NPodlozhniy/portugal-taxes.git
$ cd portugal-taxes
```
### Usage
#### :black_large_square: Terminal
This way is suitable for users who already have Python installed
First of all you should install the dependencies as following
```
$ pip install --no-cache-dir -r requirements.txt
```
That's it, app is ready to use! By default calculator return Portugal taxes for an employee who lives on mainland Portugal
```
$ python main.py -a
```
If you want to specify a different residence option, you can view the help
```
$ python main.py --help
```
#### :whale: Docker
If you don't have Python installed this option is designed especially for you
Instead of using Python, build the container with the name `calculator`
```
docker build -t calculator .
```
And then you are all set! You can do all the things as described in the first part using `docker run --rm calculator` instead of `python main.py`
```
docker run --rm calculator -a
```
### :beers: Examples
```
$ python main.py -a -nr 15000
$ python main.py -ar Madeira 50000
$ python main.py 49506.00 --year 2024 -nhr Mainland -b 04/23 -e 344.16
$ python main.py 82813.28 --year 2024 -nhr Azores -b 01/24 -e 2223.16
```
### WebApp [in-progress]
You can also use the web version of the calculator (it;s not deployed yet though) the commands for local run are and then go to localhost on http://127.0.0.1:5000
```
$ rm instance/taxes.db
$ python -c "from app import db, app; app.app_context().push(); db.create_all()"
$ python app.py
```