lumache.py

"""
Lumache - Python library for cooks and food lovers.
"""

__version__ = "0.1.0"


class InvalidKindError(Exception):
    """Raised if the kind is invalid."""
    pass


def get_random_ingredients(kind=None):
    """
    Return a list of random ingredients as strings.

    :param kind: Optional "kind" of ingredients.
    :type kind: list[str] or None
    :raise lumache.InvalidKindError: If the kind is invalid.
    :return: The ingredients list.
    :rtype: list[str]
    """
    return ["shells", "gorgonzola", "parsley"]


def get_ingredient_by_kind(kind=None):
    """
    Return a list of random ingredients as strings.

    :param kind: Optional "kind" of ingredients.
    :type kind: str
    :raise lumache.InvalidKindError: If the kind is invalid.
    :return: The ingredients of the chosen "kind".
    :rtype: list[str]
    """

    if kind == "chesse":
        return ["mozzarela", "cheddar"]
    elif kind == "meat":
        return ["beef", "pork"]
    return ["shells", "gorgonzola", "parsley"]