Metadata-Version: 2.1
Name: student-task-deadline-planner-sm
Version: 1.0.3
Summary: A Python library for task prioritisation, reminder scheduling, and deadline conflict detection
Home-page: UNKNOWN
Author: Shanthala M
Author-email: shanthalarahul98@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# student-task-deadline-planner-sm

A Python library for student task management applications. Provides task prioritisation, reminder scheduling, and deadline conflict detection to help users organise and manage their tasks efficiently.

## Installation
pip install student-task-deadline-planner-sm

## Functions

### calculate_priority_score
Calculates a priority score for a task based on its importance and time remaining until the deadline.

### rank_tasks
Ranks a list of tasks based on urgency and priority score, ensuring the most critical tasks are handled first.

### build_reminder_schedule
Generates reminder schedules for tasks (e.g., 24 hours and 1 hour before deadline) to help users stay on track.

### get_overload_summary
Identifies overloaded days or weeks where multiple tasks are due, helping users avoid deadline conflicts.

## Usage
from deadline_planner import rank_tasks, build_reminder_schedule, get_overload_summary
from datetime import datetime, timedelta

# Sample task data
tasks = [
    {"title": "Assignment", "priority": "High", "due": datetime.now() + timedelta(hours=5)},
    {"title": "Project", "priority": "Medium", "due": datetime.now() + timedelta(days=2)}
]

# Rank tasks
ranked = rank_tasks(tasks, datetime.now())
print(ranked)

# Generate reminder schedule
schedule = build_reminder_schedule(tasks[0])
print(schedule)

# Detect overload
summary = get_overload_summary(tasks)
print(summary)

