def collect_video_paths(
    data_path: str | Path | list[str | Path],
    extensions: str | list[str] | None = None,
    shuffle: bool = False,
    exclude_patterns: list[str] | None = None,
) -> list[Path]:
    """
    Collects video paths from a given set of data paths: directories, files or mix of both.
    Optionally filters paths by extension and excludes patterns. Files and directories are treated differently:
    - Files are not filtered by extension by default. Set ``extensions`` if needed, to filter also supplied files.
    - Directory contents are filtered by ``SUPPORTED_VIDEOS`` by default. Specify custom ``extensions`` if needed.
    - exclude patterns are ALWAYS applied for directory contents and supplied files. Set to `[]` to exclude no patterns.

    Args:
        data_path: Path or list of paths to folders containing videos, or individual
            video files. Can be a mix of directories and files.
        extensions: The types of videos to filter for (e.g., ".mp4", ".avi", etc.).
            - If set: filter all videos with the given extensions. Both for directory contents and supplied files.
            - If ``None``, provided files are not filtered, but directory contents are filtered by ``SUPPORTED_VIDEOS``.
        shuffle: Whether to shuffle the order of videos. If False, videos are returned
            in sorted order for deterministic behavior.
        exclude_patterns: Patterns to exclude from the collection. Defaults to ["*_labeled.*", "*_full.*"].
            Set to [] to exclude no patterns.

    Returns:
        The paths of videos to analyze. Duplicate paths are removed.

    Raises:
        FileNotFoundError: If any path in data_path does not exist.
    """
 ...
    return unique_videos

@deprecated(replacement="deeplabcut.collect_video_paths", since="3.0.0")
def get_list_of_videos(
   videos: list[str] | str,
   videotype: list[str] | str = "",
   in_random_order: bool = True,
) -> list[str]:
   return collect_video_paths(
       data_path=videos,
       extensions=videotype,
       shuffle=in_random_order,
   )

def deprecated(
   replacement: str | None = None,
   since: str | None = None,
   removed_in: str | None = None,
) -> Callable:
   """Mark a function as deprecated.

   Args:
       replacement: Fully-qualified name of the replacement callable, e.g.
           ``"deeplabcut.utils.auxfun_videos.list_videos_in_folder"``.
       since: Version in which the function was deprecated.
       removed_in: Version in which the function will be removed.
   """
   ...
   return decorator