| Name | bellu-love JSON |
| Version |
1.0.4
JSON |
| download |
| home_page | None |
| Summary | A romantic Python library dedicated to Bellu - filled with love, poems, and sweet messages |
| upload_time | 2025-10-15 09:12:51 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
bellu
love
messages
poetry
romantic
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 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.
Raw data
{
"_id": null,
"home_page": null,
"name": "bellu-love",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "bellu, love, messages, poetry, romantic",
"author": null,
"author_email": "BITANU <mbitanu.evolve@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/b7/c2/2d9fac22342e3f70eb8c0002a28e026861804abc81491d9ab22e1ba7f55e/bellu_love-1.0.4.tar.gz",
"platform": null,
"description": "# Bellu Love\n\nA romantic Python library dedicated to Bellu, filled with love messages,\npoems, ASCII art, and romantic utilities.\n\n---\n# Author : BITANU\n---\n\n## Table of Contents\n\n1. Installation\n2. Quick Start\n3. Features Overview\n4. Usage Guide\n - Messages Module\n - ASCII Art Module\n - Love Calculator Module\n - Romantic Utils Module\n5. Function Reference\n6. Examples\n7. Requirements\n8. Error Handling\n9. Contributing\n10. License\n11. Author\n\n---\n\n## Installation\n\nInstall using pip:\n\n```\npip install bellu-love\n```\n\nVerify installation:\n\n```\nimport bellu_love\nprint(bellu_love.__version__)\n```\n\n---\n\n## Quick Start\n\n```\nimport bellu_love\n\n# Display welcome art\nprint(bellu_love.bellu_name_art())\n\n# Get a love message\nmessage = bellu_love.daily_love_message()\n\n# Show heart art\nart = bellu_love.heart_art()\n\n# Calculate days together (replace with your date)\nstats = bellu_love.days_together('2020-01-15')\n```\n\n---\n\n## Features Overview\n\n### Messages\n- Daily love messages\n- Random compliments\n- Romantic poems\n- Morning and night greetings\n\n### ASCII Art\n- Heart designs\n- Love banners\n- Name art displays\n\n### Love Calculator\n- Days together calculator\n- Love percentage calculator\n\n### Romantic Utilities\n- Love reminders\n- Custom love note generator\n\n---\n\n## Usage Guide\n\n### Messages Module\n\nGet romantic messages and greetings for Bellu.\n\n**daily_love_message()**\n- Returns a random sweet daily message\n- No parameters required\n- Returns string\n\nExample:\n```\nprint(bellu_love.daily_love_message()) \n# Prints a random love message\n```\n\n**random_compliment()**\n- Returns a random heartfelt compliment\n- No parameters required\n- Returns string\n\nExample:\n```\nprint(bellu_love.random_compliment()) \n# prints a random compliment\n```\n\n**love_poem()**\n- Returns a romantic poem\n- No parameters required\n- Returns multi-line string\n\nExample:\n```\nprint(bellu_love.love_poem()) \n# prints a complete romantic poem\n```\n\n**good_morning()**\n- Returns a good morning message\n- No parameters required\n- Returns string\n\nExample:\n```\nprint(bellu_love.good_morning()) \n# prints a morning greeting\n```\n\n**good_night()**\n- Returns a good night message\n- No parameters required\n- Returns string\n\nExample:\n```\nprint(bellu_love.good_night()) \n# prints a night greeting\n```\n\n---\n\n### ASCII Art Module\n\nDisplay beautiful ASCII art designs.\n\n**heart_art()**\n- Returns heart ASCII art\n- No parameters required\n- Returns formatted string\n\nExample:\n```\nheart = bellu_love.heart_art()\nprint(heart)\n# Displays heart design with love message\n```\nOR\n```\nprint(bellu_love.heart_art()) \n# Displays heart design with love message\n```\n\n**love_banner()**\n- Returns a love banner\n- No parameters required\n- Returns formatted string\n\nExample:\n```\nbanner = bellu_love.love_banner()\nprint(banner)\n# Displays decorative banner\n```\n\n**bellu_name_art()**\n- Returns BELLU name in large letters\n- No parameters required\n- Returns formatted string\n\nExample:\n```\nname_art = bellu_love.bellu_name_art()\nprint(name_art)\n# Displays BELLU in large block letters\n```\n\n---\n\n### Love Calculator Module\n\nCalculate romantic statistics and compatibility.\n\n**days_together(start_date)**\n- Calculates days together since a special date\n- Parameter: start_date (string in 'YYYY-MM-DD' format)\n- Returns dictionary with keys:\n - total_days: Total days together (integer)\n - years: Number of complete years (integer)\n - days_after_years: Remaining days (integer)\n - message: Formatted message (string)\n- Raises ValueError if date format is invalid or future date\n\nExample:\n```\nresult = bellu_love.days_together('2024-12-21')\n# Returns dict with statistics\nprint(result['message'])\nprint(result['total_days'])\n```\n\n**love_percentage(name1, name2)**\n- Calculates love percentage between two names\n- Parameters:\n - name1: First name (string, default: \"Bitanu\")\n - name2: Second name (string, default: \"Bellu\")\n- Returns formatted percentage string\n- Always returns 100% for Bellu\n\nExample:\n```\npercentage = bellu_love.love_percentage(\"Bitanu\", \"Bellu\")\n# Returns love percentage result\n```\n\n---\n\n### Romantic Utils Module\n\nUtility functions for romantic interactions.\n\n**love_reminder()**\n- Returns a random love reminder\n- No parameters required\n- Returns string\n\nExample:\n```\nreminder = bellu_love.love_reminder()\n# Returns a reminder to show love\n```\n\n**create_love_note(custom_message)**\n- Creates a formatted love note\n- Parameter: custom_message (string, optional)\n - If empty or not provided, uses default message\n - Maximum length: 50 characters (auto-truncated)\n- Returns formatted note with date\n\nExample:\n```\nnote = bellu_love.create_love_note(\"You are amazing!\")\nprint(note)\n# Displays formatted love note\n\nnote_default = bellu_love.create_love_note()\n# Uses default message\n```\n\n---\n\n## Function Reference\n\n### Complete Function List\n\n**Messages:**\n- daily_love_message() -> str\n- random_compliment() -> str\n- love_poem() -> str\n- good_morning() -> str\n- good_night() -> str\n\n**ASCII Art:**\n- heart_art() -> str\n- love_banner() -> str\n- bellu_name_art() -> str\n\n**Love Calculator:**\n- days_together(start_date: str) -> dict\n- love_percentage(name1: str, name2: str) -> str\n\n**Utilities:**\n- love_reminder() -> str\n- create_love_note(custom_message: str) -> str\n\n---\n\n## Examples\n\n### Example 1: Daily Love Routine\n\n```\nimport bellu_love\n\n# Morning routine\nprint(bellu_love.good_morning())\nprint(bellu_love.daily_love_message())\n\n# Evening routine\nprint(bellu_love.good_night())\n```\n\n### Example 2: Special Occasion Display\n\n```\nimport bellu_love\n\n# Display name art\nprint(bellu_love.bellu_name_art())\n\n# Show heart\nprint(bellu_love.heart_art())\n\n# Read poem\nprint(bellu_love.love_poem())\n```\n\n### Example 3: Anniversary Celebration\n\n```\nimport bellu_love\n\n# Calculate time together\nanniversary_date = '2020-01-15' # Replace with your date\nstats = bellu_love.days_together(anniversary_date)\n\nprint(stats['message'])\nprint(f\"Total days: {stats['total_days']}\")\nprint(f\"Years: {stats['years']}\")\n\n# Check compatibility\nprint(bellu_love.love_percentage(\"Me\", \"Bellu\"))\n```\n\n### Example 4: Create Custom Love Note\n\n```\nimport bellu_love\n\n# Custom message\nnote = bellu_love.create_love_note(\"You light up my world!\")\nprint(note)\n\n# Default message\nnote_default = bellu_love.create_love_note()\nprint(note_default)\n```\n\n### Example 5: Random Love Expressions\n\n```\nimport bellu_love\n\n# Get random expressions\nprint(bellu_love.random_compliment())\nprint(bellu_love.love_reminder())\nprint(bellu_love.love_banner())\n```\n\n---\n\n## Requirements\n\n- Python 3.8 or higher\n- No external dependencies required\n- Works on all platforms (Windows, macOS, Linux)\n\n---\n\n## Error Handling\n\n### Common Errors and Solutions\n\n**ValueError: Invalid date format**\n- Cause: Incorrect date format in days_together()\n- Solution: Use 'YYYY-MM-DD' format (e.g., '2020-01-15')\n\nExample:\n```\n# Correct\nresult = bellu_love.days_together('2020-01-15')\n\n# Incorrect (will raise error)\n# result = bellu_love.days_together('01/15/2020')\n```\n\n**ValueError: Start date cannot be in the future**\n- Cause: Provided date is later than today\n- Solution: Use a past date only\n\nExample:\n```\n# Use only dates in the past\nresult = bellu_love.days_together('2020-01-15')\n```\n\n---\n\n## Getting Help\n\n### View Documentation in Python\n\n```\nimport bellu_love\n\n# General help\nhelp(bellu_love)\n\n# Function-specific help\nhelp(bellu_love.days_together)\nhelp(bellu_love.create_love_note)\n\n# List all functions\nprint(dir(bellu_love))\n```\n\n### Common Usage Patterns\n\n**Check version:**\n```\nprint(bellu_love.__version__)\n```\n\n**List available functions:**\n```\nprint([f for f in dir(bellu_love) if not f.startswith('_')])\n```\n\n**Read function documentation:**\n```\nprint(bellu_love.days_together.__doc__)\n```\n\n---\n\n## Contributing\n\nThis package is a personal project dedicated to Bellu.\nSuggestions and improvements are welcome!\n\n---\n\n## License\n\nMIT License\n\nCopyright (c) 2025 [Your Name]\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files, to deal in the Software\nwithout restriction, including without limitation the rights to use, copy,\nmodify, merge, publish, distribute, sublicense, and/or sell copies of the\nSoftware, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\n---\n\n## Author\n\nCreated with love by BITANU\n\nFor Bellu - the love of my life\n\n---\n\n## Version History\n\n### 1.0.0 --> 1.0.1 (2025-10-14)\n- Initial release\n- Messages module with 5 functions\n- ASCII art module with 3 functions\n- Love calculator module with 2 functions\n- Romantic utilities module with 2 functions\n\n### 1.0.2-1.0.4 (2025-10-15) \n- Made some small changes in library's README.md\n\n---\n\n**Made with \u2764\ufe0f for Bellu**\n\nFor more information, visit: https://pypi.org/project/bellu-love/\n```\n\n## Why This README is Comprehensive\n\n**Easy to print in Python** - Uses simple text formatting without complex markdown[1][2]\n\n**Terminal-friendly** - Readable in any text viewer or terminal[1][5]\n\n**Table of Contents** - Easy navigation to find specific information[2][4]\n\n**Descriptive without spoilers** - Explains what functions do without revealing exact outputs[1][2]\n\n**Clear examples** - Shows usage patterns without output clutter[2][3]\n\n**Error handling guide** - Helps users troubleshoot common issues[2]\n\n**Function signatures** - Shows expected parameters and return types[1][2]\n\n**Multiple access methods** - Explains how to use help(), dir(), and __doc__[6][7]\n\n**Version history** - Tracks changes over time[2][4]\n\n**Structured sections** - Organized logically for easy reading[1][2][4]\n\n\n\nThis README follows all PyPI best practices and is optimized for both web viewing and terminal reading.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A romantic Python library dedicated to Bellu - filled with love, poems, and sweet messages",
"version": "1.0.4",
"project_urls": null,
"split_keywords": [
"bellu",
" love",
" messages",
" poetry",
" romantic"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fc3830091689594cba5b0b2d67c5bcd8217ec99317be8556c9d95db8d39f17a9",
"md5": "8ab0699e6128bec01d719fe6e29b256e",
"sha256": "145f9f65ffff280d0fc7a5a2ca6e70c68196bfef0fe4b4a2642d0c21f3d5720e"
},
"downloads": -1,
"filename": "bellu_love-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8ab0699e6128bec01d719fe6e29b256e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 9908,
"upload_time": "2025-10-15T09:12:49",
"upload_time_iso_8601": "2025-10-15T09:12:49.294201Z",
"url": "https://files.pythonhosted.org/packages/fc/38/30091689594cba5b0b2d67c5bcd8217ec99317be8556c9d95db8d39f17a9/bellu_love-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b7c22d9fac22342e3f70eb8c0002a28e026861804abc81491d9ab22e1ba7f55e",
"md5": "c9f38b841fcc41662971e74de531f260",
"sha256": "d42a1a77be28377b49afedc96817d7194da02d61528bb20b15c6668a17579758"
},
"downloads": -1,
"filename": "bellu_love-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "c9f38b841fcc41662971e74de531f260",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 7438,
"upload_time": "2025-10-15T09:12:51",
"upload_time_iso_8601": "2025-10-15T09:12:51.632279Z",
"url": "https://files.pythonhosted.org/packages/b7/c2/2d9fac22342e3f70eb8c0002a28e026861804abc81491d9ab22e1ba7f55e/bellu_love-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-15 09:12:51",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "bellu-love"
}
