Configuration

Annotated Sample Configuration

See the annotated sample project configuration file for a commented example of available settings.

Project File

• Project File Basics

  ---

  YAML conventions, project file structure, and special Ceedling-specific YAML handling.

• Configuration Reference

  ---

  Exhaustive documentation for all project configuration options — organized by section.

• How to Load a Project Configuration

  ---

  Load your base configuration via command line flag, environment variable, or default file. Add Mixins to merge additional configuration for different build scenarios.

Advanced Topics

• Parallel Builds

  ---

  Configure Ceedling to take advantage of multiple CPU cores for faster build steps and test suite execution.

• Which Ceedling?

  ---

  Sometimes you may need to point to a different Ceedling to run.

• Global Collections

  ---

  Globally available Ruby lists of paths, files, and more — useful for advanced project customization and plugin development.