Source code for ccu.fancyplots.gui.utils

"""GUI utility functions.

Specifically, this module provides :func:`ccu.fancyplots.gui.utils.open_image`,
which opens a Tkinter-compatible version of an image shipped with
:mod:`ccu.`, and :func:`ccu.fancyplots.gui.utils.print_decal`, which prints an
Easter egg.
"""

import importlib

from PIL import Image
from PIL import ImageTk

from ccu import __version__




def open_image(name: str, width: int, height: int) -> ImageTk.PhotoImage:
    """Open Tkinter-compatible version of a ``ccu`` image.

    Args:
        name: The name of the image to open.
        width: The width of the image when opened.
        height: The height of the image when opened.

    Returns:
        A Tkinter-compatible version of the opened image.

    """
    images_ = importlib.resources.files("ccu.fancyplots.images")
    image = Image.open(images_.joinpath(name))
    resized_image = image.resize((width, height), Image.LANCZOS)
    tk_image = ImageTk.PhotoImage(resized_image)
    return tk_image





def print_easter_egg() -> None:
    """Print an Easter egg."""
    print("\n \n \n")
    print(
        "#######################################################################################################"
    )
    print(
        "#                                                                                                     #"
    )
    print(
        "#                                                                                                     #"
    )
    print(
        "#    *****    *****   ***    **   ****  **     **     ******   **       ***    **********  *******    #"
    )
    print(
        "#    **      **  **   **  *  **  *****   **  **       **   **  **      ** **   **********  **         #"
    )
    print(
        "#    ****   *** ***   **   ****  **        **         ** **    **     **   **      **      *******    #"
    )
    print(
        "#    **    **    **   **    ***  *****     **         **       ******  ** **       **           **    #"
    )
    print(
        "#    **   **     **   **     **   ****     **         **       ******   ***        **      *******    #"
    )
    print(
        "#                                                                                                     #"
    )
    print(
        f"#    Version {__version__}                                           Contact info:                              #"
    )
    print(
        "#                                                            -tiagojoaog@gmail.com                    #"
    )
    print(
        "#######################################################################################################"
    )
    print("\n \n \n")