path_to_string.py

"""Helper function file"""

from urllib.parse import urlparse
from pathlib import PurePath


def path_to_string(path):
    """Converts an obj that represents a path into a string"""
    if isinstance(path, str):
        try:
            parsed_url = urlparse(path)
            if parsed_url and parsed_url.scheme == "file":
                return parsed_url.path
        except Exception:
            return None
        return path

    if isinstance(path, bytes):
        # Use errors="replace" so invalid bytes (e.g. \xff, surrogate sequences)
        # don't silently suppress path traversal detection — the replacement char
        # preserves the traversal components that follow.
        return path.decode("utf-8", errors="replace")
    if isinstance(path, PurePath):
        # Stringify PurePath. This can still allow path traversal but in extremely
        # limited cases so it's safe to just stringify for now.
        return str(path)
    return None