Skip to main content
function Arguments.claim
def Arguments.claim(
name: str,
/
) -> typing.Any
Take responsibility for the arg name and return its value, or [] when the task declares no such arg. This is how a task reads an args.passthrough() bucket. Claiming says “these flags are mine to act on”: after the task returns, the runtime fails the invocation if any bucket that received routed flags was never claimed, so an unrecognized flag can never be quietly dropped. Reading the bucket as a plain attribute (ctx.args.<name>) does not claim it — inspecting is not the same as forwarding, and a task is free to look before deciding. Claiming an arg that is not a passthrough is harmless and does nothing. function Arguments.is_explicit
def Arguments.is_explicit(
name: str,
/
) -> bool
Return True iff the user passed --<name>=... (or its short form) on the CLI for the current invocation. Returns False for args that were resolved from the task’s default, an alias’s overridden default, or a config.axl override — anything that wasn’t typed at the command line. Used by repro / fix command builders to skip echoing flags whose values would just reproduce the task’s default. The developer copying the rendered repro gets back exactly what they (or CI) typed.