5.3.1.4.1.1. cli.cmd_build.build_impl.run_top_level_waf

cli.cmd_build.build_impl.run_top_level_waf(args: list[str], stdout: int | None = -1, stderr: int | None = -1) SubprocessResult

Execute waf from the project top-level context.

This wrapper currently delegates directly to run_waf() and exists as a dedicated top-level call site for command handlers.

Parameters:
  • args – Command-line arguments passed to waf.

  • stdout – Optional stream configuration for standard output.

  • stderr – Optional stream configuration for standard error.

Returns:

A SubprocessResult containing command execution details.