Skip to content
Ruby/Rake-based build and test system for C projects
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets commmon -> common Dec 22, 2018
bin examples are still set up to be full installs (should I change this?) Apr 14, 2019
docs Add documentation on how to integrate Ceedling after installing it Dec 22, 2018
examples commmon -> common Dec 22, 2018
lib Refactoring command line options to switch defaults and clean up inte… Apr 13, 2019
spec examples are still set up to be full installs (should I change this?) Apr 14, 2019
vendor Update to latest cmock and unity in order to put together a release c… Aug 8, 2018
.gitmodules Added the fake function framework plugin. May 23, 2016
.travis.yml Add ruby-2.6 to travis and raise minimum ruby to 2.3 Jan 26, 2019
Gemfile Update minimum rake version based on issue #214 Dec 22, 2018
Gemfile.lock Update minimum rake version based on issue #214 Dec 22, 2018
license.txt Update version to prepare for gem release Jun 25, 2017

Ceedling - Build/Test System for C Based on Ruby/Rake

Ceedling Build Status

Ceedling is a build system for C projects that is something of an extension around Ruby’s Rake (make-ish) build system. Ceedling also makes TDD (Test-Driven Development) in C a breeze by integrating CMock, Unity, and CException -- three other awesome open-source projects you can’t live without if you're creating awesomeness in the C language. Ceedling is also extensible with a handy plugin mechanism.

Usage Documentation

Documentation and license info exists in the repo in docs/

Getting Started

First make sure Ruby is installed on your system (if it's not already). Then, from a command prompt:

> gem install ceedling

(Alternate Installation for Those Planning to Be Ceedling Developers)

> git clone --recursive
> cd ceedling
> bundle install # Ensures you have all RubyGems needed
> bundle exec rake # Run all CMock library tests

If bundler isn't installed on your system or you run into problems, you might have to install it:

> sudo gem install bundler

Creating A Project

Creating a project with Ceedling is easy. Simply tell ceedling the name of the project, and it will create a subdirectory called that name and fill it with a default directory structure and configuration.

ceedling new YourNewProjectName

You can add files to your src and test directories and they will instantly become part of your test build. Need a different structure? You can start to tweak the project.yml file immediately with your new path or tool requirements.

You can upgrade to the latest version of Ceedling at any time, automatically gaining access to the packaged Unity and CMock that come with it.

gem update ceedling


Are you just getting started with Ceedling? Maybe you'd like your project to be installed with some of its handy documentation? No problem! You can do this when you create a new project.

ceedling new --docs MyAwesomeProject

Bonding Your Tools And Project

Ceedling can deploy all of its guts into the project as well. This allows it to be used without having to worry about external dependencies. You don't have to worry about Ceedling changing for this particular project just because you updated your gems... no need to worry about changes in Unity or CMock breaking your build in the future. If you'd like to use Ceedling this way, tell it you want a local copy when you create your project:

ceedling new --local YourNewProjectName

This will install all of Unity, CMock, and Ceedling into a new folder named vendor inside your project YourNewProjectName. It will still create the simple directory structure for you with src and test folders.


If you want to force a locally installed version of Ceedling to upgrade to match your latest gem later, it's easy! Just issue the following command:

ceedling upgrade --local YourNewProjectName

Just like the new command, it's called from the parent directory of your project.

Are you afraid of losing all your local changes when this happens? You can keep Ceedling from updating your project file by issuing no_configs.

ceedling upgrade --local --no_configs TheProject

Git Integration

Are you using Git? You might want to automatically have Ceedling create a gitignore file for you by adding --gitignore to your new call.


You can’t perform that action at this time.