Executor argumentsΒΆ

The executor is responsible for processing jobs in verbs which have more than one item of work. For each argument the name in brackets indicates which package contributes it.

--executor EXECUTOR [colcon-core]

The executor to process all jobs. The default is chosen based on the priorities of all available executor extensions. To see a complete list invoke colcon extensions colcon_core.executor --verbose.

  • sequential [colcon-core]

    Process one package at a time.

  • parallel [colcon-parallel-executor]

    Process multiple jobs in parallel.

--parallel-workers NUMBER [colcon-parallel-executor]
The maximum number of jobs to process in parallel. The default value is the number of logical CPU cores as reported by os.cpu_count(). This option only affects --executor parallel.