Skip to content

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.

  • Loading a Project Configuration

    Load your base configuration via command line flag, environment variable, or default filename in your working directory.

  • Mixins

    Merge additional configuration into your project configuration on demand for build variants, local overrides, CI settings, toolchain differences, etc.

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.