Metadata-Version: 2.4
Name: birth-teller
Version: 0.1.0
Summary: A Python library and CLI to calculate birthdays and age information.
Author-email: Emran Hossain Sagor <imrans4gor@gmail.com>
License: GPL V3
Requires-Python: >=3
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Birth Teller

[![PyPI version](https://img.shields.io/pypi/v/birth-teller.svg)](https://pypi.org/project/birth-teller/)
[![License](https://img.shields.io/pypi/l/birth-teller.svg)](https://github.com/exeebit/birth-teller/blob/main/LICENSE)

**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

```bash
pip install birth-teller
```

## Library Usage (Python / Django / Scripts)

```bash
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
```bash
# 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)
```bash
birth-teller --name "Emran" --day 8 --month feb --year 1999
```
### Example Output (CLI)

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