DevBox/quotes_loader.py at main · GoodieHART/DevBox · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
"""
Quotes Management Module for DevBox Launcher

This module handles loading and managing programming quotes from JSON data file.
Provides error handling and fallback quotes for robust operation.

Author: GoodieHART
"""

import json
import random
import os
from typing import Dict, List, Optional


def load_quotes(quotes_file: str = "quotes.json") -> List[Dict[str, str]]:
    """
    Load programming quotes from JSON file with error handling and fallback.

    Args:
        quotes_file: Path to the quotes JSON file (default: "quotes.json")

    Returns:
        List of quote dictionaries with 'text' and 'author' keys
    """
    fallback_quotes = [
        {"text": "Code is like humor. When you have to explain it, it's bad.", "author": "Cory House"},
        {"text": "First, solve the problem. Then, write the code.", "author": "John Johnson"},
        {"text": "Make it work, make it right, make it fast.", "author": "Kent Beck"}
    ]

    script_dir = os.path.dirname(os.path.abspath(__file__))

    # Try multiple paths to find quotes.json (module dir, /etc/, CWD)
    search_paths = [
        os.path.join(script_dir, quotes_file),
        os.path.join("/etc", quotes_file),
        quotes_file,
    ]

    for path in search_paths:
        try:
            if not os.path.exists(path):
                continue
            with open(path, 'r', encoding='utf-8') as f:
                quotes = json.load(f)
            if not isinstance(quotes, list) or not quotes:
                continue
            for quote in quotes:
                if not isinstance(quote, dict) or 'text' not in quote or 'author' not in quote:
                    break
            else:
                return quotes
        except (FileNotFoundError, json.JSONDecodeError, KeyError, TypeError, ValueError):
            continue

    return fallback_quotes


def get_random_quote(quotes_file: str = "quotes.json") -> Dict[str, str]:
    """
    Get a random programming quote from the loaded quotes.

    Args:
        quotes_file: Path to the quotes JSON file (default: "quotes.json")

    Returns:
        A random quote dictionary with 'text' and 'author' keys
    """
    quotes = load_quotes(quotes_file)
    return random.choice(quotes)


def format_quote(quote: Dict[str, str]) -> str:
    """
    Format a quote dictionary into a displayable string.

    Args:
        quote: Quote dictionary with 'text' and 'author' keys

    Returns:
        Formatted quote string ready for display
    """
    return f'"{quote["text"]}"\n\n— {quote["author"]}'