Inspirational

Inspire

The Inspire class is a lightweight service built into Orionis that provides random inspirational quotes. Its purpose is to deliver motivational messages that can be used in command-line interfaces, welcome screens, startup logs, or other points in the framework where a personal touch is desired.

The service includes a curated collection of over 360 quotes from historical figures, technology leaders, artists, and thinkers. It also allows injecting custom collections, making it a flexible and extensible component.

Import

from orionis.services.inspirational.inspire import Inspire

Initialization

The Inspire class accepts an optional quotes parameter with a custom list of quotes. If not provided or if an empty list is passed, the service automatically uses the default INSPIRATIONAL_QUOTES collection.

from orionis.services.inspirational.inspire import Inspire

# Use the default collection (360+ quotes)
inspire = Inspire()

# Use custom quotes
custom_quotes = [
    {"quote": "Clean code always looks like it was written by someone who cares.", "author": "Robert C. Martin"},
    {"quote": "Simplicity is the ultimate sophistication.", "author": "Leonardo da Vinci"},
]
inspire = Inspire(quotes=custom_quotes)

Custom Quotes Validation

When a custom list is provided, each element is strictly validated:

Must be a dictionary (dict)
Must contain exactly the keys quote and author

If any element does not meet these conditions, an exception will be raised:

# TypeError: element is not a dictionary
Inspire(quotes=["not a dict"])

# ValueError: missing required keys
Inspire(quotes=[{"quote": "No author"}])

# ValueError: missing required keys
Inspire(quotes=[{"author": "No quote"}])

Contract

The Inspire class implements the IInspire contract, which defines the public interface of the service:

from orionis.services.inspirational.contracts.inspire import IInspire

The contract declares a single abstract method random(), ensuring that any alternative implementation of the service maintains consistent behavior.

Getting a Random Quote

random

Returns a random inspirational quote selected from the available collection. The selection uses secrets.randbelow() to generate a cryptographically secure index.

inspire = Inspire()
result = inspire.random()
# {"quote": "Logic will get you from A to B. Imagination will take you everywhere.", "author": "Albert Einstein"}

The result is always a dictionary with two keys:

Key	Type	Description
`quote`	`str`	Text of the inspirational quote
`author`	`str`	Name of the quote’s author

Fallback Mechanism

If for any reason the internal quote list is empty at the time of the call, the service automatically returns a default fallback quote instead of raising an exception:

{
    "quote": "Greatness is not measured by what you build, but by what you inspire others to create.",
    "author": "Raul M. Uñate"
}

This mechanism ensures that random() always returns a valid result, regardless of the service’s internal state.

Default Collection

The default collection is defined in the quotes module and contains over 360 carefully selected quotes:

from orionis.services.inspirational.quotes import INSPIRATIONAL_QUOTES

Each entry in the collection follows the same {"quote": str, "author": str} structure and includes quotes from personalities such as:

Science & Technology: Albert Einstein, Steve Wozniak, Galileo Galilei
Leadership: Eleanor Roosevelt, Napoleon Bonaparte, Sun Tzu
Art & Culture: Maya Angelou, David Bowie, Roald Dahl
Sports: Simone Biles, Lionel Messi, Diego Maradona
Philosophy: Confucius, Euripides, Archimedes

The collection contains no duplicate quotes and every entry is validated with the required keys.

Complete Example

from orionis.services.inspirational.inspire import Inspire

# Instantiate with the default collection
inspire = Inspire()

# Get a random quote
quote = inspire.random()
print(f'"{quote["quote"]}" — {quote["author"]}')

# Use custom quotes for a specific project
project_quotes = [
    {"quote": "First, solve the problem. Then, write the code.", "author": "John Johnson"},
    {"quote": "Experience is simply the name we give our mistakes.", "author": "Oscar Wilde"},
    {"quote": "The best time to plant a tree was 20 years ago. The second best time is now.", "author": "Chinese Proverb"},
]

inspire = Inspire(quotes=project_quotes)
quote = inspire.random()
print(f'"{quote["quote"]}" — {quote["author"]}')