birth-teller 0.1.0

A Python library and CLI to calculate birthdays and age information.

Birth Teller

Birth Teller is a lightweight Python library and optional CLI tool that calculates your age, birthday details, and the day of the week you were born. It supports full month names, 3-letter abbreviations, and numeric month input. Perfect for Python projects, scripts, or Django apps.

---

Features

• Compute age in years, months, weeks, days, hours, minutes, and seconds
• Determine the day of the week for any birthdate
• Supports full month names, 3-letter abbreviations, and numeric month input
• Optional CLI for quick terminal usage
• Fully importable as a Python library for projects like Django

---

Installation

pip install birth-teller

Library Usage (Python / Django / Scripts)

from birth_teller import BTM

# Create an instance
btm = BTM()

# Get birthday information
info = btm.information(8, "feb", 1999)

print(f"You were born on {info['weekDay']}")
print(f"Age in years: {info['years']}")
print(f"Age in days: {info['days']}")

Using different month formats

# Full month name
info = btm.information(15, "March", 1995)

# 3-letter abbreviation
info = btm.information(15, "mar", 1995)

# Numeric month
info = btm.information(15, 3, 1995)

[!NOTE] Works anywhere in Python, including Django views, scripts, or APIs.

CLI Usage (Optional)

birth-teller --name "Emran" --day 8 --month feb --year 1999

Example Output (CLI)

You were born on MONDAY
Years: 26
Days: 9689
Weeks: 1384
Hours: 232538
Minutes: 13952299
Seconds: 837137977