CLI_Orchestrator.md

graph LR
    CLI_Entry_Point_Facade["CLI Entry Point / Facade"]
    Build_Workflow_Manager["Build Workflow Manager"]
    Pre_Build_Information_Validation["Pre-Build Information & Validation"]
    Warning_Detector["Warning Detector"]
    Platform_Determiner["Platform Determiner"]
    CLI_Entry_Point_Facade -- "directly calls" --> Build_Workflow_Manager
    Build_Workflow_Manager -- "coordinates with" --> Pre_Build_Information_Validation
    Build_Workflow_Manager -- "coordinates with" --> Warning_Detector
    Build_Workflow_Manager -- "coordinates with" --> Platform_Determiner
    Pre_Build_Information_Validation -- "provides feedback to" --> Build_Workflow_Manager
    Warning_Detector -- "reports to" --> Build_Workflow_Manager
    Platform_Determiner -- "provides data to" --> Build_Workflow_Manager

Loading

Details

The CLI Orchestrator subsystem serves as the primary user interface and high-level workflow initiator for cibuildwheel. It is responsible for parsing command-line arguments and triggering the overall build process, acting as a Facade to the underlying complexities of the build system.

CLI Entry Point / Facade

This component serves as the primary user interface. Its core responsibility is to parse command-line arguments, initialize the application's environment (e.g., logging), and act as a Facade by initiating the high-level build process without exposing the underlying complexities to the user. It handles the initial setup and delegation.

Related Classes/Methods:

• cibuildwheel.__main__.main:59-73

Build Workflow Manager

This component orchestrates the core, high-level build process within the specified project directory. It manages the sequence of operations required for a successful build, including setting up the build environment, performing initial pre-build checks, determining the target platform, and coordinating with subsequent, more specialized build stages.

Related Classes/Methods:

• cibuildwheel.__main__.build_in_directory:322-390

Pre-Build Information & Validation

Responsible for gathering and printing essential pre-build information to the console, providing immediate feedback to the user about the build context and environment.

Related Classes/Methods:

• cibuildwheel.__main__.print_preamble:393-429

Warning Detector

Identifies and reports potential issues or non-critical warnings related to the build environment or configuration, ensuring the user is aware of any caveats without necessarily halting execution.

Related Classes/Methods:

• cibuildwheel.__main__.detect_warnings:453-503

Platform Determiner

Computes and returns the specific platform (e.g., operating system, architecture) on which cibuildwheel is currently executing, enabling platform-specific build logic and configuration.

Related Classes/Methods:

• cibuildwheel.__main__._compute_platform:300-319

FAQ