fix: add missing config-file option to the action (#883)

* fix: add missing config-file option to the action

* feat: empty config-file triggers default behavior

* Apply suggestions from code review

Co-authored-by: Joe Rickerby <joerick@mac.com>

Co-authored-by: Joe Rickerby <joerick@mac.com>

cibuildwheel/__main__.py

@@ -57,14 +57,15 @@ def main() -> None:
 
     parser.add_argument(
         "--output-dir",
-        help="Destination folder for the wheels.",
+        help="Destination folder for the wheels. Default: wheelhouse.",
     )
 
     parser.add_argument(
         "--config-file",
+        default="",
         help="""
-            TOML config file for cibuildwheel. Defaults to pyproject.toml, but
-            can be overridden with this option.
+            TOML config file. Default: "", meaning {package}/pyproject.toml,
+            if it exists.
         """,
     )
 

cibuildwheel/options.py

@@ -42,7 +42,7 @@ class CommandLineArguments:
     platform: Literal["auto", "linux", "macos", "windows"]
     archs: Optional[str]
     output_dir: Optional[str]
-    config_file: Optional[str]
+    config_file: str
     package_dir: str
     print_build_identifiers: bool
     allow_empty: bool
@@ -335,8 +335,9 @@ class Options:
     def config_file_path(self) -> Optional[Path]:
         args = self.command_line_arguments
 
-        if args.config_file is not None:
+        if args.config_file:
             return Path(args.config_file.format(package=args.package_dir))
+
         # return pyproject.toml, if it's available
         pyproject_toml_path = Path(args.package_dir) / "pyproject.toml"
         if pyproject_toml_path.exists():