dataclass-args 1.4.0__tar.gz → 1.4.2__tar.gz

{dataclass_args-1.4.0 → dataclass_args-1.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataclass-args
-Version: 1.4.0
+Version: 1.4.2
 Summary: Zero-boilerplate CLI generation from Python dataclasses with advanced type support and file loading
 Author-email: Martin Bartlett <martin.j.bartlett@gmail.com>
 License: MIT

{dataclass_args-1.4.0 → dataclass_args-1.4.2}/dataclass_args/__init__.py

@@ -91,7 +91,7 @@ from .exceptions import ConfigBuilderError, ConfigurationError, FileLoadingError
 from .file_loading import is_file_loadable_value, load_file_content
 from .utils import load_structured_file
 
-__version__ = "1.4.0"
+__version__ = "1.4.2"
 
 __all__ = [
     # Main API

{dataclass_args-1.4.0 → dataclass_args-1.4.2}/dataclass_args/annotations.py

@@ -8,6 +8,47 @@ be excluded from CLI argument generation or have special behaviors.
 from dataclasses import field
 from typing import Any, Dict, List, Optional
 
+# ============================================================================
+# Unified Metadata Accessor
+# ============================================================================
+
+
+class _FieldMetadata:
+    """
+    Unified accessor for field metadata.
+
+    Internal class that eliminates duplication across all get_cli_* and is_cli_* functions.
+    All these functions share the same pattern: extract field_obj, check metadata, return value.
+    """
+
+    @staticmethod
+    def get(field_info: Dict[str, Any], key: str, default: Any = None) -> Any:
+        """
+        Get metadata value from field_info dict.
+
+        Args:
+            field_info: Field information dictionary from GenericConfigBuilder
+            key: Metadata key to retrieve
+            default: Default value if key not found
+
+        Returns:
+            Metadata value or default
+        """
+        field_obj = field_info.get("field_obj")
+        if field_obj and hasattr(field_obj, "metadata"):
+            return field_obj.metadata.get(key, default)
+        return default
+
+    @staticmethod
+    def get_bool(field_info: Dict[str, Any], key: str) -> bool:
+        """Get boolean metadata value (defaults to False)."""
+        return _FieldMetadata.get(field_info, key, False)
+
+
+# ============================================================================
+# CLI Annotation Decorators
+# ============================================================================
+
 
 def cli_exclude(**kwargs) -> Any:
     """
@@ -595,261 +636,92 @@ def cli_positional(
 
 
 def is_cli_excluded(field_info: Dict[str, Any]) -> bool:
-    """
-    Check if a field should be excluded from CLI arguments.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        True if field should be excluded from CLI
-    """
-    # Check for explicit CLI exclusion metadata
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_exclude", False)
-
-    return False
+    """Check if a field should be excluded from CLI arguments."""
+    return _FieldMetadata.get_bool(field_info, "cli_exclude")
 
 
 def is_cli_included(field_info: Dict[str, Any]) -> bool:
-    """
-    Check if a field is explicitly marked for CLI inclusion.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        True if field is explicitly marked for CLI inclusion
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_include", False)
-
-    return False
+    """Check if a field is explicitly marked for CLI inclusion."""
+    return _FieldMetadata.get_bool(field_info, "cli_include")
 
 
 def is_cli_nested(field_info: Dict[str, Any]) -> bool:
-    """
-    Check if a field is marked for nested dataclass flattening.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        True if field should be flattened as nested dataclass
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_nested", False)
-    return False
+    """Check if a field is marked for nested dataclass flattening."""
+    return _FieldMetadata.get_bool(field_info, "cli_nested")
 
 
 def get_cli_nested_prefix(field_info: Dict[str, Any]) -> Optional[str]:
     """
     Get prefix for nested dataclass CLI arguments.
 
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
     Returns:
-        Prefix string if specified:
         - "" (empty string): No prefix
         - "custom": Custom prefix
         - None: Auto-prefix with field name (default)
     """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_nested_prefix")
-    return None
+    return _FieldMetadata.get(field_info, "cli_nested_prefix")
 
 
 def is_cli_file_loadable(field_info: Dict[str, Any]) -> bool:
-    """
-    Check if a field is marked as file-loadable via '@' prefix.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        True if field supports file loading via '@' prefix
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_file_loadable", False)
-
-    return False
+    """Check if a field is marked as file-loadable via '@' prefix."""
+    return _FieldMetadata.get_bool(field_info, "cli_file_loadable")
 
 
 def is_cli_append(field_info: Dict[str, Any]) -> bool:
-    """
-    Check if a field uses append action for repeated options.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        True if field uses append action
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_append", False)
-    return False
+    """Check if a field uses append action for repeated options."""
+    return _FieldMetadata.get_bool(field_info, "cli_append")
 
 
 def is_cli_positional(field_info: Dict[str, Any]) -> bool:
-    """
-    Check if a field is marked as a positional CLI argument.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        True if field is a positional argument
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_positional", False)
-    return False
+    """Check if a field is marked as a positional CLI argument."""
+    return _FieldMetadata.get_bool(field_info, "cli_positional")
 
 
 def get_cli_short(field_info: Dict[str, Any]) -> Optional[str]:
-    """
-    Get short option character for a CLI argument.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        Short option character if available, otherwise None
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_short")
-    return None
+    """Get short option character for a CLI argument."""
+    return _FieldMetadata.get(field_info, "cli_short")
 
 
 def get_cli_choices(field_info: Dict[str, Any]) -> Optional[List[Any]]:
-    """
-    Get restricted choices for a CLI argument.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        List of valid choices if available, otherwise None
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_choices")
-    return None
+    """Get restricted choices for a CLI argument."""
+    return _FieldMetadata.get(field_info, "cli_choices")
 
 
 def get_cli_append_nargs(field_info: Dict[str, Any]) -> Optional[Any]:
-    """
-    Get nargs value for an append CLI argument.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        nargs value if specified, otherwise None (meaning exactly one per occurrence)
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_append_nargs")
-    return None
+    """Get nargs value for an append CLI argument."""
+    return _FieldMetadata.get(field_info, "cli_append_nargs")
 
 
 def get_cli_append_metavar(field_info: Dict[str, Any]) -> Optional[str]:
-    """
-    Get metavar for an append CLI argument.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        Metavar string if specified, otherwise None
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_append_metavar")
-    return None
+    """Get metavar for an append CLI argument."""
+    return _FieldMetadata.get(field_info, "cli_append_metavar")
 
 
 def get_cli_append_min_args(field_info: Dict[str, Any]) -> Optional[int]:
-    """
-    Get minimum arguments for an append CLI argument.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        Minimum argument count if specified, otherwise None
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_append_min_args")
-    return None
+    """Get minimum arguments for an append CLI argument."""
+    return _FieldMetadata.get(field_info, "cli_append_min_args")
 
 
 def get_cli_append_max_args(field_info: Dict[str, Any]) -> Optional[int]:
-    """
-    Get maximum arguments for an append CLI argument.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        Maximum argument count if specified, otherwise None
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_append_max_args")
-    return None
+    """Get maximum arguments for an append CLI argument."""
+    return _FieldMetadata.get(field_info, "cli_append_max_args")
 
 
 def get_cli_positional_nargs(field_info: Dict[str, Any]) -> Optional[Any]:
-    """
-    Get nargs value for a positional CLI argument.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        nargs value if specified, otherwise None (meaning exactly one)
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_positional_nargs")
-    return None
+    """Get nargs value for a positional CLI argument."""
+    return _FieldMetadata.get(field_info, "cli_positional_nargs")
 
 
 def get_cli_positional_metavar(field_info: Dict[str, Any]) -> Optional[str]:
-    """
-    Get metavar for a positional CLI argument.
-
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        Metavar string if specified, otherwise None
-    """
-    field_obj = field_info.get("field_obj")
-    if field_obj and hasattr(field_obj, "metadata"):
-        return field_obj.metadata.get("cli_positional_metavar")
-    return None
+    """Get metavar for a positional CLI argument."""
+    return _FieldMetadata.get(field_info, "cli_positional_metavar")
 
 
 def get_cli_help(field_info: Dict[str, Any]) -> str:
     """
     Get custom help text for a CLI argument.
 
-    Args:
-        field_info: Field information dictionary from GenericConfigBuilder
-
-    Returns:
-        Custom help text if available, otherwise empty string
+    Automatically adds file-loadable hint if applicable.
     """
     field_obj = field_info.get("field_obj")
     if field_obj and hasattr(field_obj, "metadata"):