Data Extraction

METADATA_MAP: dict
"""Mapping of metadata field names between different packaging systems.

Maps standard setuptools/wheel metadata field names to their pyroma equivalents.
Used internally to normalize metadata from different sources like setup.cfg, 
pyproject.toml, and wheel metadata.

Example mappings:
- 'summary' -> 'description'
- 'classifier' -> 'classifiers'  
- 'home_page' -> 'url'
- 'requires_python' -> 'python_requires'
"""

def get_data(path):
    """Extract package metadata from a project directory.
    
    Args:
        path: Absolute path to project directory
        
    Returns:
        dict: Package metadata including name, version, description,
              classifiers, dependencies, and build system information
              
    Raises:
        build.BuildException: If project cannot be built or analyzed
    """

def build_metadata(path, isolated=None):
    """Build wheel metadata using the project's build system.
    
    Args:
        path: Project directory path
        isolated: Whether to use build isolation (None for auto-detection)
        
    Returns:
        Metadata object containing package information
        
    Raises:
        build.BuildBackendException: If build system fails
    """

def map_metadata_keys(metadata) -> dict:
    """Convert metadata object to standardized dictionary format.
    
    Args:
        metadata: Metadata object from build system
        
    Returns:
        dict: Normalized metadata with standardized key names
    """

def get_build_data(path, isolated=None):
    """Extract package data using modern build system.
    
    Args:
        path: Project directory path  
        isolated: Whether to use build isolation
        
    Returns:
        dict: Package metadata with build system information
    """

def get_setupcfg_data(path):
    """Extract metadata from setup.cfg configuration file.
    
    Args:
        path: Project directory path
        
    Returns:
        dict: Metadata from setup.cfg file
        
    Raises:
        Exception: If setup.cfg cannot be parsed
    """

def get_setuppy_data(path):
    """Extract metadata by executing setup.py (fallback method).
    
    Args:
        path: Absolute path to project directory
        
    Returns:
        dict: Package metadata from setup.py execution
        
    Note:
        This is a fallback method for legacy projects and
        adds '_stoneage_setuppy' flag to indicate usage
    """

def get_data(path):
    """Extract metadata from a distribution file.
    
    Args:
        path: Path to distribution file (.tar.gz, .zip, .egg, etc.)
        
    Returns:
        dict: Package metadata extracted from distribution
        
    Raises:
        ValueError: If file type is not supported
        tarfile.TarError: If tar file is corrupted
        zipfile.BadZipFile: If zip file is corrupted
    """

def get_data(project):
    """Extract metadata from a PyPI package.
    
    Args:
        project: PyPI package name
        
    Returns:
        dict: Complete package metadata including PyPI-specific information
        
    Raises:
        ValueError: If package not found on PyPI or HTTP error occurs
        requests.RequestException: If network request fails
    """

# Analyze local project
from pyroma.projectdata import get_data
data = get_data('/path/to/project')

# Analyze distribution file  
from pyroma.distributiondata import get_data
data = get_data('package-1.0.tar.gz')

# Analyze PyPI package
from pyroma.pypidata import get_data  
data = get_data('requests')

class FakeContext:
    """Context manager for temporarily changing working directory and sys.path.
    
    Used internally for safe execution of setup.py files without
    affecting the global Python environment.
    """
    
    def __init__(self, path): ...
    def __enter__(self): ...
    def __exit__(self, exc_type, exc_val, exc_tb): ...

class SetupMonkey:
    """Context manager that monkey-patches setup() calls to capture metadata.
    
    Intercepts calls to distutils.core.setup() and setuptools.setup()
    to extract package metadata without executing setup commands.
    """
    
    def __enter__(self): ...
    def __exit__(self, exc_type, exc_val, exc_tb): ...
    def get_data(self): ...