174 lines
4.7 KiB
Python
174 lines
4.7 KiB
Python
"""输入验证模块
|
|
|
|
提供 YouTube URL 格式验证和文件路径验证功能。
|
|
"""
|
|
|
|
import re
|
|
from pathlib import Path
|
|
from typing import Tuple
|
|
|
|
|
|
# YouTube URL 正则表达式模式
|
|
YOUTUBE_PATTERNS = [
|
|
# 标准视频 URL: https://www.youtube.com/watch?v=VIDEO_ID
|
|
r"(?:https?://)?(?:www\.)?youtube\.com/watch\?v=([a-zA-Z0-9_-]{11})",
|
|
# 短链接: https://youtu.be/VIDEO_ID
|
|
r"(?:https?://)?youtu\.be/([a-zA-Z0-9_-]{11})",
|
|
# 嵌入: https://www.youtube.com/embed/VIDEO_ID
|
|
r"(?:https?://)?(?:www\.)?youtube\.com/embed/([a-zA-Z0-9_-]{11})",
|
|
# Shorts: https://www.youtube.com/shorts/VIDEO_ID
|
|
r"(?:https?://)?(?:www\.)?youtube\.com/shorts/([a-zA-Z0-9_-]{11})",
|
|
# 移动版: https://m.youtube.com/watch?v=VIDEO_ID
|
|
r"(?:https?://)?m\.youtube\.com/watch\?v=([a-zA-Z0-9_-]{11})",
|
|
]
|
|
|
|
# 播放列表 URL 模式
|
|
PLAYLIST_PATTERNS = [
|
|
# 标准播放列表: https://www.youtube.com/playlist?list=PLAYLIST_ID
|
|
r"(?:https?://)?(?:www\.)?youtube\.com/playlist\?list=([a-zA-Z0-9_-]+)",
|
|
# 带视频的播放列表: https://www.youtube.com/watch?v=X&list=Y
|
|
r"(?:https?://)?(?:www\.)?youtube\.com/watch\?.*list=([a-zA-Z0-9_-]+)",
|
|
]
|
|
|
|
|
|
def validate_youtube_url(url: str) -> Tuple[bool, str, bool]:
|
|
"""验证 YouTube URL 是否有效
|
|
|
|
Args:
|
|
url: 待验证的 URL
|
|
|
|
Returns:
|
|
(是否有效, 视频/播放列表ID, 是否为播放列表) 元组
|
|
无效时返回 (False, "", False)
|
|
"""
|
|
if not url or not url.strip():
|
|
return False, "", False
|
|
|
|
url = url.strip()
|
|
|
|
# 检查是否为播放列表
|
|
for pattern in PLAYLIST_PATTERNS:
|
|
match = re.search(pattern, url)
|
|
if match:
|
|
return True, match.group(1), True
|
|
|
|
# 检查是否为视频
|
|
for pattern in YOUTUBE_PATTERNS:
|
|
match = re.search(pattern, url)
|
|
if match:
|
|
return True, match.group(1), False
|
|
|
|
return False, "", False
|
|
|
|
|
|
def is_valid_video_url(url: str) -> bool:
|
|
"""检查是否为有效的 YouTube 视频 URL
|
|
|
|
Args:
|
|
url: 待检查的 URL
|
|
|
|
Returns:
|
|
是否有效
|
|
"""
|
|
valid, _, is_playlist = validate_youtube_url(url)
|
|
return valid and not is_playlist
|
|
|
|
|
|
def is_valid_playlist_url(url: str) -> bool:
|
|
"""检查是否为有效的 YouTube 播放列表 URL
|
|
|
|
Args:
|
|
url: 待检查的 URL
|
|
|
|
Returns:
|
|
是否有效
|
|
"""
|
|
valid, _, is_playlist = validate_youtube_url(url)
|
|
return valid and is_playlist
|
|
|
|
|
|
def validate_directory(path: str) -> Tuple[bool, str]:
|
|
"""验证目录路径是否可用
|
|
|
|
Args:
|
|
path: 目录路径
|
|
|
|
Returns:
|
|
(是否有效, 错误信息) 元组
|
|
"""
|
|
if not path:
|
|
return False, "目录路径不能为空"
|
|
|
|
try:
|
|
dir_path = Path(path)
|
|
if dir_path.exists() and not dir_path.is_dir():
|
|
return False, f"路径已存在但不是目录: {path}"
|
|
return True, ""
|
|
except (OSError, ValueError) as e:
|
|
return False, f"路径无效: {str(e)}"
|
|
|
|
|
|
def clean_video_url(url: str) -> str:
|
|
"""清理视频 URL,移除播放列表和多余参数
|
|
|
|
将带 ?list= 或 &list= 的视频 URL 净化,
|
|
同时移除 &t= (时间戳) 和 &feature= 等无关参数,
|
|
保留核心的 ?v= 部分。
|
|
|
|
Args:
|
|
url: 原始 YouTube URL
|
|
|
|
Returns:
|
|
清理后的 URL
|
|
"""
|
|
import re
|
|
|
|
# 对于 youtu.be 短链接:移除 ?list=... 及之后的所有参数
|
|
# https://youtu.be/VIDEO_ID?list=...&t=... → https://youtu.be/VIDEO_ID
|
|
short_match = re.match(
|
|
r"(https?://youtu\.be/[a-zA-Z0-9_-]{11})", url
|
|
)
|
|
if short_match:
|
|
return short_match.group(1)
|
|
|
|
# 对于标准 youtube.com/watch?v= 链接:保留 v= 参数,移除 list/t/feature 等
|
|
watch_match = re.match(
|
|
r"(https?://(?:www\.)?youtube\.com/watch\?v=[a-zA-Z0-9_-]{11})", url
|
|
)
|
|
if watch_match:
|
|
return watch_match.group(1)
|
|
|
|
# 其他格式(embed, shorts 等):原样返回
|
|
return url
|
|
|
|
|
|
def sanitize_filename(filename: str) -> str:
|
|
"""清理文件名,移除非法字符
|
|
|
|
Args:
|
|
filename: 原始文件名
|
|
|
|
Returns:
|
|
清理后的文件名
|
|
"""
|
|
# Windows 和跨平台非法字符
|
|
illegal_chars = r'[<>:"/\\|?*\x00-\x1f]'
|
|
sanitized = re.sub(illegal_chars, "_", filename)
|
|
|
|
# 移除开头和结尾的空格及点
|
|
sanitized = sanitized.strip(". ")
|
|
|
|
# 限制文件名长度 (保留扩展名)
|
|
if len(sanitized) > 200:
|
|
# 尝试保留扩展名
|
|
stem = Path(sanitized).stem
|
|
suffix = Path(sanitized).suffix
|
|
max_stem = 200 - len(suffix)
|
|
sanitized = stem[:max_stem] + suffix
|
|
|
|
# 空文件名使用默认值
|
|
if not sanitized:
|
|
sanitized = "video"
|
|
|
|
return sanitized
|