mdbq 4.0.23__py3-none-any.whl → 4.0.25__py3-none-any.whl

mdbq/myconf/myconf.py

@@ -21,21 +21,16 @@ logger = mylogger.MyLogger(
 T = TypeVar('T')  # 类型变量
 
 
-class ConfigError(Exception):
-    """配置相关的基础异常类
-    
-    Attributes:
-        message: 错误消息
-        file_path: 配置文件路径
-        section: 配置节名称
-        key: 配置键名称
-    """
+class ConfigException(Exception):
+    """配置异常基类"""
     def __init__(self, message: str, file_path: Optional[Union[str, Path]] = None, 
-                 section: Optional[str] = None, key: Optional[str] = None):
+                 section: Optional[str] = None, key: Optional[str] = None,
+                 original_error: Optional[Exception] = None):
         self.message = message
         self.file_path = str(file_path) if file_path else None
         self.section = section
         self.key = key
+        self.original_error = original_error
         super().__init__(self._format_message())
 
     def _format_message(self) -> str:
@@ -47,70 +42,69 @@ class ConfigError(Exception):
             parts.append(f"节: [{self.section}]")
         if self.key:
             parts.append(f"键: {self.key}")
+        if self.original_error:
+            parts.append(f"原始错误: {str(self.original_error)}")
         return " | ".join(parts)
 
+    @classmethod
+    def file_not_found(cls, file_path: Union[str, Path]) -> 'ConfigException':
+        """配置文件不存在异常"""
+        return cls("配置文件不存在", file_path=file_path)
 
-class ConfigFileNotFoundError(ConfigError):
-    """当指定的配置文件不存在时抛出的异常"""
-    def __init__(self, file_path: Union[str, Path]):
-        super().__init__("配置文件不存在", file_path=file_path)
+    @classmethod
+    def read_error(cls, file_path: Union[str, Path], error: Exception) -> 'ConfigException':
+        """读取配置文件失败异常"""
+        return cls("读取配置文件失败", file_path=file_path, original_error=error)
 
+    @classmethod
+    def write_error(cls, file_path: Union[str, Path], error: Exception) -> 'ConfigException':
+        """写入配置文件失败异常"""
+        return cls("写入配置文件失败", file_path=file_path, original_error=error)
 
-class ConfigReadError(ConfigError):
-    """当读取配置文件失败时抛出的异常
-    
-    Attributes:
-        original_error: 原始错误对象
-    """
-    def __init__(self, file_path: Union[str, Path], original_error: Exception):
-        super().__init__(
-            f"读取配置文件失败: {str(original_error)}",
-            file_path=file_path
-        )
-        self.original_error = original_error
+    @classmethod
+    def value_error(cls, message: str, file_path: Union[str, Path], 
+                   section: Optional[str] = None, key: Optional[str] = None) -> 'ConfigException':
+        """配置值无效异常"""
+        return cls(message, file_path=file_path, section=section, key=key)
 
+    @classmethod
+    def section_not_found(cls, file_path: Union[str, Path], section: str) -> 'ConfigException':
+        """配置节不存在异常"""
+        return cls("配置节不存在", file_path=file_path, section=section)
 
-class ConfigWriteError(ConfigError):
-    """当写入配置文件失败时抛出的异常
-    
-    Attributes:
-        original_error: 原始错误对象
-    """
-    def __init__(self, file_path: Union[str, Path], original_error: Exception):
-        super().__init__(
-            f"写入配置文件失败: {str(original_error)}",
-            file_path=file_path
-        )
-        self.original_error = original_error
-
-
-class ConfigValueError(ConfigError):
-    """当配置值无效时抛出的异常"""
-    def __init__(self, message: str, file_path: Union[str, Path], 
-                 section: Optional[str] = None, key: Optional[str] = None):
-        super().__init__(message, file_path=file_path, section=section, key=key)
+    @classmethod
+    def key_not_found(cls, file_path: Union[str, Path], section: str, key: str) -> 'ConfigException':
+        """配置键不存在异常"""
+        return cls("配置键不存在", file_path=file_path, section=section, key=key)
 
+    @classmethod
+    def validation_error(cls, message: str, file_path: Union[str, Path],
+                        section: Optional[str] = None, key: Optional[str] = None) -> 'ConfigException':
+        """配置验证失败异常"""
+        return cls(f"配置验证失败: {message}", file_path=file_path, section=section, key=key)
 
-class ConfigSectionNotFoundError(ConfigError):
-    """当指定的配置节不存在时抛出的异常"""
-    def __init__(self, file_path: Union[str, Path], section: str):
-        super().__init__(
-            f"配置节不存在",
-            file_path=file_path,
-            section=section
-        )
-
-
-class ConfigKeyNotFoundError(ConfigError):
-    """当指定的配置键不存在时抛出的异常"""
-    def __init__(self, file_path: Union[str, Path], section: str, key: str):
-        super().__init__(
-            f"配置键不存在",
+    @classmethod
+    def conversion_error(cls, value: Any, target_type: Type, file_path: Union[str, Path],
+                        section: Optional[str] = None, key: Optional[str] = None) -> 'ConfigException':
+        """类型转换失败异常"""
+        return cls(
+            f"无法将值 '{value}' 转换为类型 {target_type.__name__}",
             file_path=file_path,
             section=section,
             key=key
         )
 
+    @classmethod
+    def invalid_key_error(cls, key: str, file_path: Union[str, Path],
+                         section: Optional[str] = None) -> 'ConfigException':
+        """无效的键名异常"""
+        return cls(f"无效的键名: {key}", file_path=file_path, section=section, key=key)
+
+    @classmethod
+    def invalid_section_error(cls, section: str, file_path: Union[str, Path]) -> 'ConfigException':
+        """无效的节名异常"""
+        return cls(f"无效的节名: {section}", file_path=file_path, section=section)
+
 
 class CommentStyle(Enum):
     """配置文件支持的注释风格"""
@@ -121,21 +115,7 @@ class CommentStyle(Enum):
 
 @dataclass
 class ConfigOptions:
-    """配置解析器的选项类
-    
-    Attributes:
-        comment_styles: 支持的注释风格列表
-        encoding: 文件编码
-        auto_create: 是否自动创建不存在的配置文件
-        strip_values: 是否去除配置值的首尾空白
-        preserve_comments: 是否保留注释
-        default_section: 默认配置节名称
-        separators: 支持的分隔符列表
-        cache_ttl: 缓存过期时间（秒）
-        validate_keys: 是否验证键名
-        key_pattern: 键名正则表达式模式
-        case_sensitive: 是否区分大小写
-    """
+    """配置解析器选项"""
     comment_styles: List[CommentStyle] = field(default_factory=lambda: [CommentStyle.HASH, CommentStyle.DOUBLE_SLASH])
     encoding: str = 'utf-8'
     auto_create: bool = False
@@ -150,83 +130,44 @@ class ConfigOptions:
 
 
 class ConfigParser:
-    """配置文件解析器，用于读取和写入配置文件
-    
-    Attributes:
-        options: 解析器配置选项
-        _config_cache: 配置缓存，用于存储已读取的配置
-        _cache_timestamps: 缓存时间戳，用于管理缓存过期
-        _comments_cache: 注释缓存，用于存储每个配置节的注释
-        _section_map: 用于存储大小写映射
-        _current_file: 当前正在处理的文件路径
-    """
+    """配置文件解析器"""
     
     def __init__(self, options: Optional[ConfigOptions] = None):
         self.options = options or ConfigOptions()
         self._config_cache: Dict[str, Dict[str, Any]] = {}
         self._cache_timestamps: Dict[str, float] = {}
         self._comments_cache: Dict[str, Dict[str, List[str]]] = {}
-        self._section_map: Dict[str, Dict[str, str]] = {}  # 用于存储大小写映射
-        self._current_file: Optional[Path] = None  # 当前正在处理的文件路径
+        self._section_map: Dict[str, Dict[str, str]] = {}
+        self._current_file: Optional[Path] = None
     
     def __enter__(self) -> 'ConfigParser':
-        """进入上下文管理器
-        
-        Returns:
-            ConfigParser: 返回当前实例
-        """
         return self
 
     def __exit__(self, exc_type: Optional[Type[BaseException]], 
                  exc_val: Optional[BaseException], 
                  exc_tb: Optional[Any]) -> None:
-        """退出上下文管理器
-        
-        Args:
-            exc_type: 异常类型
-            exc_val: 异常值
-            exc_tb: 异常追踪信息
-        """
         self._current_file = None
 
     def open(self, file_path: Union[str, Path]) -> 'ConfigParser':
-        """打开配置文件
-        
-        Args:
-            file_path: 配置文件路径
-            
-        Returns:
-            ConfigParser: 返回当前实例，支持链式调用
-            
-        Raises:
-            ConfigFileNotFoundError: 当配置文件不存在且未启用自动创建时
-        """
+        """打开配置文件"""
         file_path = Path(file_path)
         if not file_path.exists() and not self.options.auto_create:
-            raise ConfigFileNotFoundError(file_path)
+            raise ConfigException.file_not_found(file_path)
         self._current_file = file_path
         return self
 
     def _ensure_file_open(self) -> None:
-        """确保文件已打开
-        
-        Raises:
-            ConfigError: 当文件未打开时
-        """
+        """确保文件已打开"""
         if self._current_file is None:
-            raise ConfigError("未打开任何配置文件，请先调用 open() 方法")
+            raise ConfigException("未打开任何配置文件，请先调用 open() 方法")
 
     def _is_comment_line(self, line: str) -> bool:
-        """判断一行是否为注释行"""
+        """判断是否为注释行"""
         stripped = line.strip()
         return any(stripped.startswith(style.value) for style in self.options.comment_styles)
     
     def _extract_comment(self, line: str) -> Tuple[str, str]:
-        """从行中提取注释
-        
-        Returns:
-            Tuple[str, str]: (去除注释后的行内容, 注释内容)
-        """
+        """从行中提取注释"""
         for style in self.options.comment_styles:
             comment_match = re.search(fr'\s+{re.escape(style.value)}.*$', line)
             if comment_match:
@@ -234,14 +175,7 @@ class ConfigParser:
         return line.strip(), ''
     
     def _split_key_value(self, line: str) -> Optional[Tuple[str, str]]:
-        """分割配置行为键值对
-        
-        Args:
-            line: 要分割的配置行
-            
-        Returns:
-            Optional[Tuple[str, str]]: 键值对元组，如果无法分割则返回None
-        """
+        """分割配置行为键值对"""
         for sep in self.options.separators:
             if sep in line:
                 key_part, value_part = line.split(sep, 1)
@@ -263,11 +197,8 @@ class ConfigParser:
         return bool(re.match(self.options.key_pattern, key))
     
     def _get_cached_config(self, file_path: str) -> Optional[Dict[str, Any]]:
-        """获取缓存的配置，如果过期则返回None"""
-        if file_path not in self._config_cache:
-            return None
-        
-        if file_path not in self._cache_timestamps:
+        """获取缓存的配置"""
+        if file_path not in self._config_cache or file_path not in self._cache_timestamps:
             return None
         
         if time.time() - self._cache_timestamps[file_path] > self.options.cache_ttl:
@@ -281,10 +212,8 @@ class ConfigParser:
         self._cache_timestamps[file_path] = time.time()
     
     def _normalize_section(self, section: str) -> str:
-        """标准化节名称（处理大小写）"""
-        if self.options.case_sensitive:
-            return section
-        return section.lower()
+        """标准化节名称"""
+        return section.replace(' ', '').lower()
     
     def _get_original_section(self, file_path: str, normalized_section: str) -> Optional[str]:
         """获取原始节名称"""
@@ -313,73 +242,50 @@ class ConfigParser:
             self._comments_cache.clear()
             self._section_map.clear()
     
-    def _convert_value(self, value: str, target_type: Type[T]) -> T:
-        """转换配置值到指定类型
-        
-        Args:
-            value: 要转换的值
-            target_type: 目标类型
-            
-        Returns:
-            T: 转换后的值
-            
-        Raises:
-            ConfigValueError: 当值无法转换为指定类型时
-        """
+    def _convert_value(self, value: str, target_type: Type[T], file_path: Optional[Union[str, Path]] = None, key: Optional[str] = None) -> T:
+        """转换配置值到指定类型"""
         try:
             if target_type == bool:
                 return bool(value.lower() in ('true', 'yes', '1', 'on'))
             elif target_type == list:
-                # 支持多种分隔符的列表
                 if not value.strip():
                     return []
-                # 尝试不同的分隔符
                 for sep in [',', ';', '|', ' ']:
                     if sep in value:
                         return [item.strip() for item in value.split(sep) if item.strip()]
-                # 如果没有分隔符，则作为单个元素返回
                 return [value.strip()]
             elif target_type == tuple:
-                # 支持元组类型
                 if not value.strip():
                     return ()
-                # 尝试不同的分隔符
                 for sep in [',', ';', '|', ' ']:
                     if sep in value:
                         return tuple(item.strip() for item in value.split(sep) if item.strip())
-                # 如果没有分隔符，则作为单个元素返回
                 return (value.strip(),)
-            elif target_type == set:
-                # 支持集合类型
+            elif target_type == set or target_type == frozenset:
                 if not value.strip():
-                    return set()
-                # 尝试不同的分隔符
+                    return set() if target_type == set else frozenset()
                 for sep in [',', ';', '|', ' ']:
                     if sep in value:
-                        return {item.strip() for item in value.split(sep) if item.strip()}
-                # 如果没有分隔符，则作为单个元素返回
-                return {value.strip()}
+                        items = [item.strip() for item in value.split(sep) if item.strip()]
+                        return set(items) if target_type == set else frozenset(items)
+                return set([value.strip()]) if target_type == set else frozenset([value.strip()])
             elif target_type == dict:
-                # 支持字典类型，格式：key1=value1,key2=value2
                 if not value.strip():
                     return {}
                 result = {}
-                # 尝试不同的分隔符
                 for sep in [',', ';', '|']:
                     if sep in value:
                         pairs = [pair.strip() for pair in value.split(sep) if pair.strip()]
                         for pair in pairs:
                             if '=' in pair:
-                                key, val = pair.split('=', 1)
-                                result[key.strip()] = val.strip()
+                                key_, val = pair.split('=', 1)
+                                result[key_.strip()] = val.strip()
                         return result
-                # 如果没有分隔符，尝试单个键值对
                 if '=' in value:
-                    key, val = value.split('=', 1)
-                    return {key.strip(): val.strip()}
+                    key_, val = value.split('=', 1)
+                    return {key_.strip(): val.strip()}
                 return {}
             elif target_type == int:
-                # 支持十六进制、八进制、二进制
                 value = value.strip().lower()
                 if value.startswith('0x'):
                     return int(value, 16)
@@ -396,12 +302,7 @@ class ConfigParser:
                 return value.encode('utf-8')
             elif target_type == bytearray:
                 return bytearray(value.encode('utf-8'))
-            elif target_type == set:
-                return set(value.split(','))
-            elif target_type == frozenset:
-                return frozenset(value.split(','))
             elif target_type == range:
-                # 支持 range 类型，格式：start:stop:step 或 start:stop
                 parts = value.split(':')
                 if len(parts) == 2:
                     return range(int(parts[0]), int(parts[1]))
@@ -410,81 +311,39 @@ class ConfigParser:
                 raise ValueError("Invalid range format")
             return target_type(value)
         except (ValueError, TypeError) as e:
-            raise ConfigValueError(
-                f"无法将值 '{value}' 转换为类型 {target_type.__name__}",
-                file_path=None,
-                key=None
-            )
+            raise ConfigException.conversion_error(value, target_type, file_path, key=key)
     
-    def get_value(self, file_path: Optional[Union[str, Path]] = None, key: str = None, 
-                 section: Optional[str] = None, default: Any = None,
-                 value_type: Optional[Type[T]] = None) -> T:
-        """获取指定配置项的值
-        
-        Args:
-            file_path: 配置文件路径，如果为None则使用当前打开的文件
-            key: 配置键
-            section: 配置节名称，如果为None则使用默认节
-            default: 当配置项不存在时返回的默认值
-            value_type: 期望的值的类型
-            
-        Returns:
-            T: 配置值
-            
-        Raises:
-            ConfigSectionNotFoundError: 当指定的节不存在且未提供默认值时
-            ConfigKeyNotFoundError: 当指定的键不存在且未提供默认值时
-            ConfigValueError: 当值无法转换为指定类型时
-        """
+    def get_value(self, section: Optional[str] = None, key: str = None,
+                 default: Any = None, value_type: Optional[Type[T]] = None,
+                 file_path: Optional[Union[str, Path]] = None) -> T:
+        """获取指定配置项的值"""
         if file_path is None:
             self._ensure_file_open()
             file_path = self._current_file
         if not self._validate_key(key):
-            raise ConfigValueError(f"无效的键名: {key}", file_path=file_path, key=key)
-            
+            raise ConfigException.invalid_key_error(key, file_path, section)
         config = self.read(file_path)
         section = section or self.options.default_section
         normalized_section = self._normalize_section(section)
-        
-        # 获取原始节名称
         original_section = self._get_original_section(str(file_path), normalized_section)
         if original_section is None:
             if default is not None:
                 return default
-            raise ConfigSectionNotFoundError(file_path, section)
-            
+            raise ConfigException.section_not_found(file_path, section)
         if key not in config[original_section]:
             if default is not None:
                 return default
-            raise ConfigKeyNotFoundError(file_path, original_section, key)
-            
+            raise ConfigException.key_not_found(file_path, original_section, key)
         value = config[original_section][key]
-        
         if value_type is not None:
-            return self._convert_value(value, value_type)
-            
+            return self._convert_value(value, value_type, file_path=file_path, key=key)
         return value
     
-    def get_values(self, keys: List[Tuple[str, str]], 
-                  file_path: Optional[Union[str, Path]] = None,
+    def get_values(self, section: Optional[str] = None, keys: List[Tuple[str, str]] = None,
                   defaults: Optional[Dict[str, Any]] = None,
-                  value_types: Optional[Dict[str, Type]] = None) -> Dict[str, Any]:
-        """批量获取多个配置项的值
-        
-        Args:
-            keys: 配置项列表，每个元素为 (section, key) 元组
-            file_path: 配置文件路径，如果为None则使用当前打开的文件
-            defaults: 默认值字典，格式为 {key: default_value}
-            value_types: 值类型字典，格式为 {key: type}
-            
-        Returns:
-            Dict[str, Any]: 配置值字典，格式为 {key: value}
-            
-        Raises:
-            ConfigSectionNotFoundError: 当指定的节不存在且未提供默认值时
-            ConfigKeyNotFoundError: 当指定的键不存在且未提供默认值时
-            ConfigValueError: 当值无法转换为指定类型时
-        """
+                  value_types: Optional[Dict[str, Type]] = None,
+                  file_path: Optional[Union[str, Path]] = None) -> Dict[str, Any]:
+        """批量获取多个配置项的值"""
         if file_path is None:
             self._ensure_file_open()
             file_path = self._current_file
@@ -495,14 +354,15 @@ class ConfigParser:
         for section, key in keys:
             try:
                 value = self.get_value(
-                    file_path=file_path,
-                    key=key,
                     section=section,
+                    key=key,
                     default=defaults.get(key),
-                    value_type=value_types.get(key)
+                    value_type=value_types.get(key),
+                    file_path=file_path
                 )
                 result[key] = value
-            except (ConfigSectionNotFoundError, ConfigKeyNotFoundError) as e:
+            except ConfigException as e:
+                logger.error(f"读取配置项失败: section={section}, key={key}, error={e}")
                 if key in defaults:
                     result[key] = defaults[key]
                 else:
@@ -510,28 +370,11 @@ class ConfigParser:
                     
         return result
 
-    def get_section_values(self, keys: List[str],
-                          section: Optional[str] = None,
-                          file_path: Optional[Union[str, Path]] = None,
+    def get_section_values(self, section: Optional[str] = None, keys: List[str] = None,
                           defaults: Optional[Dict[str, Any]] = None,
-                          value_types: Optional[Dict[str, Type]] = None) -> Tuple[Any, ...]:
-        """获取指定节点下多个键的值元组
-        
-        Args:
-            keys: 要获取的键列表
-            section: 配置节名称，默认为 DEFAULT
-            file_path: 配置文件路径，如果为None则使用当前打开的文件
-            defaults: 默认值字典，格式为 {key: default_value}
-            value_types: 值类型字典，格式为 {key: type}
-            
-        Returns:
-            Tuple[Any, ...]: 按键列表顺序返回的值元组
-            
-        Raises:
-            ConfigSectionNotFoundError: 当指定的节不存在且未提供默认值时
-            ConfigKeyNotFoundError: 当指定的键不存在且未提供默认值时
-            ConfigValueError: 当值无法转换为指定类型时
-        """
+                          value_types: Optional[Dict[str, Type]] = None,
+                          file_path: Optional[Union[str, Path]] = None) -> Tuple[Any, ...]:
+        """获取指定节点下多个键的值元组"""
         if file_path is None:
             self._ensure_file_open()
             file_path = self._current_file
@@ -542,14 +385,15 @@ class ConfigParser:
         for key in keys:
             try:
                 value = self.get_value(
-                    file_path=file_path,
-                    key=key,
                     section=section,
+                    key=key,
                     default=defaults.get(key),
-                    value_type=value_types.get(key)
+                    value_type=value_types.get(key),
+                    file_path=file_path
                 )
                 result.append(value)
-            except (ConfigSectionNotFoundError, ConfigKeyNotFoundError) as e:
+            except ConfigException as e:
+                logger.error(f"读取配置项失败: section={section}, key={key}, error={e}")
                 if key in defaults:
                     result.append(defaults[key])
                 else:
@@ -557,41 +401,23 @@ class ConfigParser:
                     
         return tuple(result)
     
-    def set_value(self, key: str, value: Any,
-                 section: Optional[str] = None,
-                 file_path: Optional[Union[str, Path]] = None,
-                 value_type: Optional[Type] = None) -> None:
-        """设置指定配置项的值，保持原始文件的格式和注释
-        
-        Args:
-            key: 配置键
-            value: 要设置的值
-            section: 配置节名称，如果为None则使用默认节
-            file_path: 配置文件路径，如果为None则使用当前打开的文件
-            value_type: 值的类型，用于验证和转换
-            
-        Raises:
-            ConfigValueError: 当值无法转换为指定类型时
-            ConfigError: 当其他配置错误发生时
-        """
+    def set_value(self, section: Optional[str] = None, key: str = None, value: Any = None,
+                 value_type: Optional[Type] = None,
+                 file_path: Optional[Union[str, Path]] = None) -> None:
+        """设置指定配置项的值"""
         if file_path is None:
             self._ensure_file_open()
             file_path = self._current_file
         if not self._validate_key(key):
-            raise ConfigValueError(f"无效的键名: {key}", file_path=file_path, key=key)
-            
-        # 读取原始文件內容
+            raise ConfigException.invalid_key_error(key, file_path, section)
+        section = section or self.options.default_section
         original_lines = []
         if file_path.exists():
             with open(file_path, 'r', encoding=self.options.encoding) as file:
                 original_lines = file.readlines()
-        
-        # 读取当前配置
         config = self.read(file_path)
-        
         if section not in config:
             config[section] = {}
-            
         if value_type is not None:
             try:
                 if value_type == bool:
@@ -602,109 +428,106 @@ class ConfigParser:
                 else:
                     value = value_type(value)
             except (ValueError, TypeError) as e:
-                raise ConfigValueError(
-                    f"无法将值 '{value}' 转换为类型 {value_type.__name__}",
-                    file_path=file_path,
-                    section=section,
-                    key=key
-                )
-        
+                raise ConfigException.conversion_error(value, value_type, file_path, section=section, key=key)
         if isinstance(value, bool):
             value = str(value).lower()
         else:
             value = str(value)
-            
-        # 更新配置
         config[section][key] = value
-        
-        # 写入文件，保持原始格式
         try:
             file_path.parent.mkdir(parents=True, exist_ok=True)
-            
             with open(file_path, 'w', encoding=self.options.encoding) as file:
                 current_section = self.options.default_section
-                section_separators = {}  # 用于存储每个section使用的分隔符
-                
-                # 解析原始文件，提取格式信息
+                section_separators = {}
                 for line in original_lines:
                     stripped_line = line.strip()
-                    
                     if not stripped_line:
-                        file.write(line)  # 保持空行
+                        file.write(line)
                         continue
-                        
                     if stripped_line.startswith('[') and stripped_line.endswith(']'):
                         current_section = stripped_line[1:-1]
-                        file.write(line)  # 保持节标记的原始格式
+                        file.write(line)
                         continue
-                        
                     if self._is_comment_line(stripped_line):
-                        file.write(line)  # 保持注释的原始格式
+                        file.write(line)
                         continue
-                        
                     key_value = self._split_key_value(stripped_line)
                     if key_value:
                         orig_key, orig_value = key_value
-                        # 检测使用的分隔符
                         for sep in self.options.separators:
                             if sep in line:
                                 section_separators.setdefault(current_section, {})[orig_key] = sep
                                 break
-                        
-                        # 如果是当前要修改的键，则写入新值
                         if current_section == section and orig_key == key:
                             separator = section_separators.get(current_section, {}).get(orig_key, self.options.separators[0])
-                            # 提取行尾注释
                             comment = ''
                             for style in self.options.comment_styles:
                                 comment_match = re.search(fr'\s+{re.escape(style.value)}.*$', line)
                                 if comment_match:
                                     comment = comment_match.group(0)
                                     break
-                            # 写入新值并保留注释
                             file.write(f'{key}{separator}{value}{comment}\n')
                         else:
-                            file.write(line)  # 保持其他行的原始格式
+                            file.write(line)
                     else:
-                        file.write(line)  # 保持无法解析的行的原始格式
-                
-                # 如果section不存在，则添加新的section
+                        file.write(line)
                 if section not in [line.strip()[1:-1] for line in original_lines if line.strip().startswith('[') and line.strip().endswith(']')]:
                     file.write(f'\n[{section}]\n')
                     file.write(f'{key}={value}\n')
-            
             self._clear_cache(str(file_path))
-            
         except Exception as e:
-            raise ConfigWriteError(file_path, e)
+            raise ConfigException.write_error(file_path, e)
+
+    def set_values(self, section: Optional[str] = None, values: Dict[str, Any] = None,
+                  value_types: Optional[Dict[str, Type]] = None,
+                  file_path: Optional[Union[str, Path]] = None) -> None:
+        """批量设置多个配置项的值"""
+        for key, value in values.items():
+            value_type = value_types.get(key) if value_types else None
+            self.set_value(section, key, value, value_type, file_path)
+
+    def validate_config(self, section: Optional[str] = None, schema: Dict[str, Type] = None,
+                       file_path: Optional[Union[str, Path]] = None) -> bool:
+        """验证配置是否符合指定的模式"""
+        config = self.read(file_path)
+        if section:
+            if section not in config:
+                return False
+            for key, expected_type in schema.items():
+                if key not in config[section]:
+                    return False
+                try:
+                    self._convert_value(config[section][key], expected_type)
+                except ConfigException:
+                    return False
+        else:
+            for section, keys in schema.items():
+                if section not in config:
+                    return False
+                for key, expected_type in keys.items():
+                    if key not in config[section]:
+                        return False
+                    try:
+                        self._convert_value(config[section][key], expected_type)
+                    except ConfigException:
+                        return False
+        return True
     
     def read(self, file_path: Optional[Union[str, Path]] = None) -> Dict[str, Any]:
-        """读取配置文件内容
-        
-        Args:
-            file_path: 配置文件路径，如果为None则使用当前打开的文件
-            
-        Returns:
-            Dict[str, Any]: 配置字典，格式为 {section: {key: value}}
-            
-        Raises:
-            ConfigFileNotFoundError: 当配置文件不存在且未启用自动创建时
-            ConfigReadError: 当读取配置文件失败时
-        """
+        """读取配置文件内容"""
         if file_path is None:
             self._ensure_file_open()
             file_path = self._current_file
         else:
-            file_path = Path(file_path)  # 确保 file_path 是 Path 对象
+            file_path = Path(file_path)
         
-        # 检查缓存
         cached_config = self._get_cached_config(str(file_path))
         if cached_config is not None:
             return cached_config
         
         if not file_path.exists():
             if not self.options.auto_create:
-                raise ConfigFileNotFoundError(file_path)
+                raise ConfigException.file_not_found(file_path)
             logger.info(f'配置文件不存在，将创建: {file_path}')
             file_path.parent.mkdir(parents=True, exist_ok=True)
             file_path.touch()
@@ -727,11 +550,7 @@ class ConfigParser:
                     if stripped_line.startswith('[') and stripped_line.endswith(']'):
                         current_section = stripped_line[1:-1]
                         if not self._validate_key(current_section):
-                            raise ConfigValueError(
-                                f"无效的节名: {current_section}",
-                                file_path=file_path,
-                                section=current_section
-                            )
+                            raise ConfigException.invalid_section_error(current_section, file_path)
                         self._update_section_map(str(file_path), current_section)
                         if current_section not in config:
                             config[current_section] = {}
@@ -744,12 +563,7 @@ class ConfigParser:
                     if key_value:
                         key, value = key_value
                         if not self._validate_key(key):
-                            raise ConfigValueError(
-                                f"无效的键名: {key}",
-                                file_path=file_path,
-                                section=current_section,
-                                key=key
-                            )
+                            raise ConfigException.invalid_key_error(key, file_path, current_section)
                         value, comment = self._extract_comment(value)
                         
                         if self.options.strip_values:
@@ -766,51 +580,141 @@ class ConfigParser:
                 return config
                 
         except Exception as e:
-            raise ConfigReadError(file_path, e)
-    
+            raise ConfigException.read_error(file_path, e)
+
 
 def main() -> None:
-    # 使用示例
-    config_file = Path('/Users/xigua/spd.txt')
-    
+    """示例用法"""
+    config_file = Path('/Users/xigua/spd_副本.txt')
+
+    # 创建配置解析器实例
+    parser = ConfigParser()
+    # 设置配置选项
+    options = ConfigOptions(
+        comment_styles=[CommentStyle.HASH, CommentStyle.DOUBLE_SLASH],
+        encoding='utf-8',
+        auto_create=True,
+        strip_values=True,
+        preserve_comments=True,
+        default_section='DEFAULT',
+        separators=['=', ':', '：'],
+        cache_ttl=300,
+        validate_keys=True,
+        key_pattern=r'^[a-zA-Z0-9_\-\.]+$',
+        case_sensitive=False
+    )
+    parser = ConfigParser(options)
+
     # 方式1：使用上下文管理器
     with ConfigParser() as parser:
         parser.open(config_file)
+        # 读取配置 - 最常用的参数放在前面
         host, port, username, password = parser.get_section_values(
-            keys=['host', 'port', 'username', 'password'],
-            section='mysql'
+            section='mysql',  # 最常用的section参数放在前面
+            keys=['host', 'port', 'username', 'password']
         )
-        print("方式1结果:", host, port, username, password)
-        
+        print("2.1 使用上下文管理器 读取结果:", host, port, username, password)
         # 修改配置
-        parser.set_value('host', 'localhost', section='mysql')
-        parser.set_value('port', 3306, section='mysql')
-        
-        # # 读取整个配置
-        # config = parser.read()
-        # print("\n当前配置:")
-        # for section, items in config.items():
-        #     print(f"\n[{section}]")
-        #     for key, value in items.items():
-        #         print(f"{key} = {value}")
-    
+        parser.set_value(
+            section='mysql',
+            key='username',
+            value='root'
+        )
+        parser.set_value(
+            section='mysql',
+            key='port',
+            value=3306,
+            value_type=int
+        )
+
     # 方式2：链式调用
     parser = ConfigParser()
     host, port, username, password = parser.open(config_file).get_section_values(
-        keys=['host', 'port', 'username', 'password'],
-        section='mysql'
+        section='mysql',
+        keys=['host', 'port', 'username', 'password']
     )
-    print("\n方式2结果:", host, port, username, password)
-    
+    print("2.2 链式调用 读取结果:", host, port, username, password)
+
     # 方式3：传统方式
     parser = ConfigParser()
     host, port, username, password = parser.get_section_values(
-        file_path=config_file,
         section='mysql',
-        keys=['host', 'port', 'username', 'password']
+        keys=['host', 'port', 'username', 'password'],
+        file_path=config_file  # 文件路径参数放在最后
+    )
+    print("2.3 传统方式 读取结果:", host, port, username, password)
+
+    # 3.1 读取单个值 - 最常用的参数放在前面
+    value = parser.get_value(
+        section='mysql',
+        key='host',
+        default='localhost',  # 默认值参数放在中间
+        value_type=str,
+        file_path=config_file
+    )
+    print("3.1 单个值读取结果:", value)
+
+    # 3.2 批量读取多个值 - 最常用的参数放在前面
+    values = parser.get_values(
+        section='mysql',
+        keys=[('host', 'host'), ('host', 'port')],
+        defaults={'host': 'localhost', 'port': 3306},
+        value_types={'port': int},
+        file_path=config_file
+    )
+    print("3.2 批量读取多个值结果:", values)
+
+    # 3.3 读取整个配置
+    config = parser.read(config_file)
+    print("3.3 读取完整配置:", config)
+
+    # 4.1 写入单个值 - 最常用的参数放在前面
+    parser.set_value(
+        section='mysql',
+        key='host',
+        value='127.0.0.1',
+        value_type=str,
+        file_path=config_file
+    )
+    print("4.1 写入单个值结果:", config_file)
+
+    # 4.2 写入不同类型的数据 - 最常用的参数放在前面
+    parser.open(config_file)
+    parser.set_value(
+        section='mysql',
+        key='port',
+        value=3306,
+        value_type=int
+    )
+    parser.set_value(
+        section='mysql',
+        key='debug',
+        value=True,
+        value_type=bool
     )
-    print("\n方式3结果:", host, port, username, password)
+    parser.set_value(
+        section='mysql',
+        key='servers',
+        value=['server1', 'server2'],
+        value_type=list
+    )
+    print("4.2 写入不同类型的数据")
+
+    try:
+        # 尝试读取不存在的配置项 - 最常用的参数放在前面
+        parser.get_value(
+            section='mysql',
+            key='nonexistent'
+        )
+    except ConfigException as e:
+        if "配置键不存在" in str(e):
+            print("5.1 错误处理 配置键不存在错误:", e)
+        elif "配置节不存在" in str(e):
+            print("5.2 错误处理 配置节不存在错误:", e)
+        else:
+            print("5.3 错误处理 配置错误:", e)
 
 
 if __name__ == '__main__':
     main()
+