mirror of
https://github.com/jxxghp/MoviePilot.git
synced 2026-08-29 03:56:43 +08:00
83 lines
2.6 KiB
Python
83 lines
2.6 KiB
Python
from typing import Dict, List, Set, TypeVar, Any, Union
|
|
|
|
K = TypeVar("K")
|
|
V = TypeVar("V")
|
|
|
|
|
|
class DictUtils:
|
|
"""提供字典键集合相关的基础操作。"""
|
|
|
|
@staticmethod
|
|
def filter_keys_to_subset(source: Dict[K, V], reference: Dict[K, V]) -> Dict[K, V]:
|
|
"""
|
|
过滤 source 字典，使其键成为 reference 字典键的子集
|
|
|
|
:param source: 要被过滤的字典
|
|
:param reference: 参考字典，定义允许的键
|
|
:return: 过滤后的字典，只包含在 reference 中存在的键
|
|
"""
|
|
if not isinstance(source, dict) or not isinstance(reference, dict):
|
|
return {}
|
|
|
|
return {key: value for key, value in source.items() if key in reference}
|
|
|
|
@staticmethod
|
|
def is_keys_subset(source: Dict[K, V], reference: Dict[K, V]) -> bool:
|
|
"""
|
|
判断 source 字典的键是否为 reference 字典键的子集
|
|
|
|
:param source: 要检查的字典
|
|
:param reference: 参考字典
|
|
:return: 如果 source 的键是 reference 的键子集，则返回 True，否则返回 False
|
|
"""
|
|
if not isinstance(source, dict) or not isinstance(reference, dict):
|
|
return False
|
|
|
|
return all(key in reference for key in source)
|
|
|
|
|
|
class ListUtils:
|
|
"""提供列表结构的基础转换能力。"""
|
|
|
|
@staticmethod
|
|
def flatten(nested_list: Union[List[List[Any]], List[Any]]) -> List[Any]:
|
|
"""
|
|
将嵌套的列表展平成单个列表
|
|
|
|
:param nested_list: 嵌套的列表
|
|
:return: 展平后的列表
|
|
"""
|
|
if not isinstance(nested_list, list):
|
|
return []
|
|
|
|
# 检查是否嵌套，若不嵌套直接返回
|
|
if not any(isinstance(sublist, list) for sublist in nested_list):
|
|
return nested_list
|
|
|
|
return [
|
|
item
|
|
for sublist in nested_list
|
|
for item in (sublist if isinstance(sublist, list) else [sublist])
|
|
]
|
|
|
|
|
|
class SetUtils:
|
|
"""提供集合结构的基础转换能力。"""
|
|
|
|
@staticmethod
|
|
def flatten(nested_sets: Union[Set[Set[Any]], Set[Any]]) -> Set[Any]:
|
|
"""
|
|
将嵌套的集合展开为单个集合
|
|
|
|
:param nested_sets: 嵌套的集合
|
|
:return: 展开的集合
|
|
"""
|
|
if not isinstance(nested_sets, set):
|
|
return set()
|
|
|
|
# 检查是否嵌套，若不嵌套直接返回
|
|
if not any(isinstance(subset, set) for subset in nested_sets):
|
|
return nested_sets
|
|
|
|
return {item for subset in nested_sets if isinstance(subset, set) for item in subset}
|