"""Shared utility helpers."""


# Define function escape_like
def escape_like(value: str) -> str:
    """Escape SQL LIKE wildcard characters (``%`` and ``_``).

    Prevents user-supplied search terms from being interpreted as LIKE
    pattern metacharacters when used with SQLAlchemy's ``ilike``/``like``
    methods.

    Usage::

        from app.utils import escape_like
        query.filter(Model.name.ilike(f"%{escape_like(term)}%"))
    """
    # Return (
    return (
        value
        # Chain .replace() call
        .replace("\\", "\\\\")
        # Chain .replace() call
        .replace("%", "\\%")
        # Chain .replace() call
        .replace("_", "\\_")
    )
