leave-utils 1.0.0

A Python library for leave management calculations, balance tracking and policy enforcement.

leave-utils

A Python library for leave management applications. Provides business day calculations, leave balance management and policy enforcement.

Installation

````pip install leave-utils```

Classes

LeaveCalculator

Calculates the number of working days between two dates, excluding weekends and Irish public holidays.

LeaveBalanceManager

Manages and validates employee leave balances and entitlements for different leave types including annual, sick, maternity, paternity and unpaid leave.

LeavePolicyEngine

Enforces organisational leave policies including minimum notice periods, maximum consecutive days and documentation requirements.

Usage

from leave_utils import LeaveCalculator, LeaveBalanceManager, LeavePolicyEngine
from datetime import date

# Calculate working days
calc = LeaveCalculator()
days = calc.count_working_days(date(2025, 1, 6), date(2025, 1, 10))
print(days)  # 5

# Check balance
manager = LeaveBalanceManager()
remaining = manager.calculate_remaining('annual', days_used=5)
print(remaining)  # 15

# Validate policy
policy = LeavePolicyEngine(min_notice_days=3)
result = policy.validate_request(date(2025, 2, 10), date(2025, 2, 14), 'annual', 5)
print(result)  # {'valid': True, 'errors': []}

License

MIT