bellu-love 1.0.4
A romantic Python library dedicated to Bellu - filled with love, poems, and sweet messages
License: MIT
Requires Python: >=3.8
Keywords: bellu, love, messages, poetry, romantic

# Bellu Love

A romantic Python library dedicated to Bellu, filled with love messages,
poems, ASCII art, and romantic utilities.

---
# Author : BITANU
---

## Table of Contents

1. Installation
2. Quick Start
3. Features Overview
4. Usage Guide
   - Messages Module
   - ASCII Art Module
   - Love Calculator Module
   - Romantic Utils Module
5. Function Reference
6. Examples
7. Requirements
8. Error Handling
9. Contributing
10. License
11. Author

---

## Installation

Install using pip:

```
pip install bellu-love
```

Verify installation:

```
import bellu_love
print(bellu_love.__version__)
```

---

## Quick Start

```
import bellu_love

# Display welcome art
print(bellu_love.bellu_name_art())

# Get a love message
message = bellu_love.daily_love_message()

# Show heart art
art = bellu_love.heart_art()

# Calculate days together (replace with your date)
stats = bellu_love.days_together('2020-01-15')
```

---

## Features Overview

### Messages
- Daily love messages
- Random compliments
- Romantic poems
- Morning and night greetings

### ASCII Art
- Heart designs
- Love banners
- Name art displays

### Love Calculator
- Days together calculator
- Love percentage calculator

### Romantic Utilities
- Love reminders
- Custom love note generator

---

## Usage Guide

### Messages Module

Get romantic messages and greetings for Bellu.

**daily_love_message()**
- Returns a random sweet daily message
- No parameters required
- Returns string

Example:
```
print(bellu_love.daily_love_message()) 
# Prints a random love message
```

**random_compliment()**
- Returns a random heartfelt compliment
- No parameters required
- Returns string

Example:
```
print(bellu_love.random_compliment()) 
# prints a random compliment
```

**love_poem()**
- Returns a romantic poem
- No parameters required
- Returns multi-line string

Example:
```
print(bellu_love.love_poem()) 
# prints a complete romantic poem
```

**good_morning()**
- Returns a good morning message
- No parameters required
- Returns string

Example:
```
print(bellu_love.good_morning()) 
# prints a morning greeting
```

**good_night()**
- Returns a good night message
- No parameters required
- Returns string

Example:
```
print(bellu_love.good_night()) 
# prints a night greeting
```

---

### ASCII Art Module

Display beautiful ASCII art designs.

**heart_art()**
- Returns heart ASCII art
- No parameters required
- Returns formatted string

Example:
```
heart = bellu_love.heart_art()
print(heart)
# Displays heart design with love message
```
OR
```
print(bellu_love.heart_art()) 
# Displays heart design with love message
```

**love_banner()**
- Returns a love banner
- No parameters required
- Returns formatted string

Example:
```
banner = bellu_love.love_banner()
print(banner)
# Displays decorative banner
```

**bellu_name_art()**
- Returns BELLU name in large letters
- No parameters required
- Returns formatted string

Example:
```
name_art = bellu_love.bellu_name_art()
print(name_art)
# Displays BELLU in large block letters
```

---

### Love Calculator Module

Calculate romantic statistics and compatibility.

**days_together(start_date)**
- Calculates days together since a special date
- Parameter: start_date (string in 'YYYY-MM-DD' format)
- Returns dictionary with keys:
  - total_days: Total days together (integer)
  - years: Number of complete years (integer)
  - days_after_years: Remaining days (integer)
  - message: Formatted message (string)
- Raises ValueError if date format is invalid or future date

Example:
```
result = bellu_love.days_together('2024-12-21')
# Returns dict with statistics
print(result['message'])
print(result['total_days'])
```

**love_percentage(name1, name2)**
- Calculates love percentage between two names
- Parameters:
  - name1: First name (string, default: "Bitanu")
  - name2: Second name (string, default: "Bellu")
- Returns formatted percentage string
- Always returns 100% for Bellu

Example:
```
percentage = bellu_love.love_percentage("Bitanu", "Bellu")
# Returns love percentage result
```

---

### Romantic Utils Module

Utility functions for romantic interactions.

**love_reminder()**
- Returns a random love reminder
- No parameters required
- Returns string

Example:
```
reminder = bellu_love.love_reminder()
# Returns a reminder to show love
```

**create_love_note(custom_message)**
- Creates a formatted love note
- Parameter: custom_message (string, optional)
  - If empty or not provided, uses default message
  - Maximum length: 50 characters (auto-truncated)
- Returns formatted note with date

Example:
```
note = bellu_love.create_love_note("You are amazing!")
print(note)
# Displays formatted love note

note_default = bellu_love.create_love_note()
# Uses default message
```

---

## Function Reference

### Complete Function List

**Messages:**
- daily_love_message() -> str
- random_compliment() -> str
- love_poem() -> str
- good_morning() -> str
- good_night() -> str

**ASCII Art:**
- heart_art() -> str
- love_banner() -> str
- bellu_name_art() -> str

**Love Calculator:**
- days_together(start_date: str) -> dict
- love_percentage(name1: str, name2: str) -> str

**Utilities:**
- love_reminder() -> str
- create_love_note(custom_message: str) -> str

---

## Examples

### Example 1: Daily Love Routine

```
import bellu_love

# Morning routine
print(bellu_love.good_morning())
print(bellu_love.daily_love_message())

# Evening routine
print(bellu_love.good_night())
```

### Example 2: Special Occasion Display

```
import bellu_love

# Display name art
print(bellu_love.bellu_name_art())

# Show heart
print(bellu_love.heart_art())

# Read poem
print(bellu_love.love_poem())
```

### Example 3: Anniversary Celebration

```
import bellu_love

# Calculate time together
anniversary_date = '2020-01-15'  # Replace with your date
stats = bellu_love.days_together(anniversary_date)

print(stats['message'])
print(f"Total days: {stats['total_days']}")
print(f"Years: {stats['years']}")

# Check compatibility
print(bellu_love.love_percentage("Me", "Bellu"))
```

### Example 4: Create Custom Love Note

```
import bellu_love

# Custom message
note = bellu_love.create_love_note("You light up my world!")
print(note)

# Default message
note_default = bellu_love.create_love_note()
print(note_default)
```

### Example 5: Random Love Expressions

```
import bellu_love

# Get random expressions
print(bellu_love.random_compliment())
print(bellu_love.love_reminder())
print(bellu_love.love_banner())
```

---

## Requirements

- Python 3.8 or higher
- No external dependencies required
- Works on all platforms (Windows, macOS, Linux)

---

## Error Handling

### Common Errors and Solutions

**ValueError: Invalid date format**
- Cause: Incorrect date format in days_together()
- Solution: Use 'YYYY-MM-DD' format (e.g., '2020-01-15')

Example:
```
# Correct
result = bellu_love.days_together('2020-01-15')

# Incorrect (will raise error)
# result = bellu_love.days_together('01/15/2020')
```

**ValueError: Start date cannot be in the future**
- Cause: Provided date is later than today
- Solution: Use a past date only

Example:
```
# Use only dates in the past
result = bellu_love.days_together('2020-01-15')
```

---

## Getting Help

### View Documentation in Python

```
import bellu_love

# General help
help(bellu_love)

# Function-specific help
help(bellu_love.days_together)
help(bellu_love.create_love_note)

# List all functions
print(dir(bellu_love))
```

### Common Usage Patterns

**Check version:**
```
print(bellu_love.__version__)
```

**List available functions:**
```
print([f for f in dir(bellu_love) if not f.startswith('_')])
```

**Read function documentation:**
```
print(bellu_love.days_together.__doc__)
```

---

## Contributing

This package is a personal project dedicated to Bellu.
Suggestions and improvements are welcome!

---

## License

MIT License

Copyright (c) 2025 [Your Name]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files, to deal in the Software
without restriction, including without limitation the rights to use, copy,
modify, merge, publish, distribute, sublicense, and/or sell copies of the
Software, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

---

## Author

Created with love by BITANU

For Bellu - the love of my life

---

## Version History

### 1.0.0 --> 1.0.1 (2025-10-14)
- Initial release
- Messages module with 5 functions
- ASCII art module with 3 functions
- Love calculator module with 2 functions
- Romantic utilities module with 2 functions

### 1.0.2-1.0.4 (2025-10-15) 
- Made some small changes in library's README.md

---

**Made with ❤️ for Bellu**

For more information, visit: https://pypi.org/project/bellu-love/
```

## Why This README is Comprehensive

**Easy to print in Python** - Uses simple text formatting without complex markdown[1][2]

**Terminal-friendly** - Readable in any text viewer or terminal[1][5]

**Table of Contents** - Easy navigation to find specific information[2][4]

**Descriptive without spoilers** - Explains what functions do without revealing exact outputs[1][2]

**Clear examples** - Shows usage patterns without output clutter[2][3]

**Error handling guide** - Helps users troubleshoot common issues[2]

**Function signatures** - Shows expected parameters and return types[1][2]

**Multiple access methods** - Explains how to use help(), dir(), and __doc__[6][7]

**Version history** - Tracks changes over time[2][4]

**Structured sections** - Organized logically for easy reading[1][2][4]



This README follows all PyPI best practices and is optimized for both web viewing and terminal reading.