quotely 1.0.0

Professional Python library providing 500+ curated motivational quotes from influential thinkers, leaders, and artists

🎯 quotely

A minimalist Python library delivering 500+ curated motivational quotes from history's most influential minds.

---

Overview

quotely provides instant access to hundreds of verified, high-quality motivational quotes—perfect for command-line tools, chatbots, dashboards, and educational apps.
Built with modern Python best practices, it's dependency-free, type-hinted, and lightweight.

---

Installation

pip install quotely

For local development with linting and testing tools:

pip install quotely[dev]

Requirements: Python 3.8 or higher

---

Quick Start

from quotely import random, quote

# Get a random quote
print(random(quote))

# Get quote with author
print(random.name(quote))

Example Output:

"The only way to do great work is to love what you do." - Steve Jobs

---

API Reference

random(quote)

Returns a random quote (text only).

text = random(quote)

---

random.name(quote)

Returns a random quote with author attribution.

full = random.name(quote)
# → "Success is not final, failure is not fatal..." - Winston Churchill

---

get_random_quote()

Returns a structured Quote object for detailed access.

from quotely import get_random_quote

q = get_random_quote()
print(str(q))   # Quote text
print(q.name)   # Author
print(repr(q))  # "Quote" - Author

---

Example Use Cases

Command-Line Tools

import argparse
from quotely import random, quote

parser = argparse.ArgumentParser()
parser.add_argument("--inspire", action="store_true")
args = parser.parse_args()

if args.inspire:
    print(f"\n✨ {random.name(quote)}\n")

Daily Motivation

from quotely import random, quote

print("═" * 40)
print("💡 Your Daily Motivation")
print("═" * 40)
print(random.name(quote))

Chatbot Integration

from quotely import get_random_quote

def get_motivation():
    q = get_random_quote()
    return {
        "text": str(q),
        "author": q.name,
        "full": repr(q)
    }

---

Technical Details

Feature	Description
Dependencies	None
Memory Optimization	Uses __slots__ (~40% less overhead)
Thread Safety	Random selection is concurrency-safe
Type Hints	Fully typed for IDE autocomplete
Tests	100% coverage via pytest

---

Development

# Run tests
pytest

# Format with Black
black quotely

# Type check
mypy quotely

---

License

Licensed under the MIT License.
See LICENSE for full text.

---

Credits

Quotes are sourced from verified public domain and attributed works for educational and inspirational use.

Author: MJ Dev
Contact: [e-mail]
Project Page: PyPI: quotely

---

"The only way to do great work is to love what you do." — Steve Jobs