Vacation Tracker

A command-line tool to track and manage vacation periods with support for holidays and date ranges. This tool helps you manage your vacation days, taking into account:

Vacation day entitlements per month
Public holidays based on country/region
Weekend exclusions
Year transitions and expiration dates
Detailed summaries and reporting

Prerequisites

Python 3.10 or later

Installation

Install using pip:

pip install vacation-tracker

Configuration

First, create a new tracking configuration:

vacation-tracker new --days 2.5 --first-year 2023 --first-month 1 \
                     --last-year 2024 --last-month 12 \
                     --special-days 12-31 --special-days 01-02

This creates a vacation-periods.toml file with your vacation tracking settings. The configuration includes:

Days earned per month
Tracking period (start/end dates)
Country/region for holiday calculations
List of vacation periods

Example configuration:

days-per-month = 2.5
first-year = "2023-01" # Start tracking from January 2023
last-year = "2024-12"  # Track until December 2024
country = ["DE", "BY"]  # Germany, Bavaria region
categories = ["public", "catholic"]  # Holiday categories to consider
special-days = ["12-31"] # Special days to exclude from vacation calculation

Usage

Adding Vacation Periods

Add single day vacations:

vacation-tracker add "Doctor Appointment" --first 2023-05-15

Add multi-day periods:

vacation-tracker add "Summer Holiday" --first 2023-08-01 --last 2023-08-15

Viewing Vacation Summary

Basic summary:

vacation-tracker show

This displays a table with:

Yearly entitlements
Utilized days
Remaining days
Expired allocations

Detailed view with individual periods:

vacation-tracker show --detailed

Example output:

 Year  Months  Entitlement  Real Util  Adj Util  Remaining
 2023  12      30           25         25        5 (expired)
 ├─ 01.08-15.08 (11): Summer Holiday
 └─ 15.05 (1): Doctor Appointment
 2024  12      30           0          0         30

Features

Automatically handles:
- Weekend exclusions
- Public holidays based on country/region
- Vacation day expiration
- Year transitions
- Period overlaps prevention
- Cross-year vacation splits
Configurable holiday categories
Support for partial day accumulation (e.g., 2.5 days/month)
Detailed vacation period tracking and reporting

License

MIT, see LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vacation_tracker-0.1.5.tar.gz (12.4 kB view details)

Uploaded Aug 25, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

vacation_tracker-0.1.5-py3-none-any.whl (8.9 kB view details)

Uploaded Aug 25, 2026 Python 3

File details

Details for the file vacation_tracker-0.1.5.tar.gz.

File metadata

Download URL: vacation_tracker-0.1.5.tar.gz
Upload date: Aug 25, 2026
Size: 12.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vacation_tracker-0.1.5.tar.gz
Algorithm	Hash digest
SHA256	`ade2a2ee2a7b62d8c8c10586b59c4e47a648dd0cef1d6175df8a4c04d9282690`
MD5	`07853bec626daa21dddeda857554c401`
BLAKE2b-256	`9ed12b7f4b948c5079780f6b4bd1dc0b15dc68af31e76d77fce05b57b8119a9a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for vacation_tracker-0.1.5.tar.gz:

Publisher: release.yml on audivir/vacation-tracker

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: vacation_tracker-0.1.5.tar.gz
- Subject digest: ade2a2ee2a7b62d8c8c10586b59c4e47a648dd0cef1d6175df8a4c04d9282690
- Sigstore transparency entry: 2590654014
- Sigstore integration time: Aug 25, 2026
Source repository:
- Permalink: audivir/vacation-tracker@3070120dd0211496135bce8268dfeb2c6c7f34fb
- Branch / Tag: refs/tags/v0.1.5
- Owner: https://github.com/audivir
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@3070120dd0211496135bce8268dfeb2c6c7f34fb
- Trigger Event: release