Open Channel Foundation
Not Logged In |  | 
Open Channel Foundation

Quick Application Search:

Get this title!
Get Ruby-Cradle
Monitor new releases

Basic information

Foundation :: Systems Engineering :: Ruby-Cradle


Ruby Extension Library for Cradle System Engineering Tool

Steven Jenkins
Total downloads from Open Channel to date: 16
source code available SOURCE CODE AVAILABLE

Ruby-cradle is an extension to the Ruby programming language ( for accessing the C API of Cradle, a system engineering tool produced by 3SL (

The Cradle API was designed for static linking. It can work as a shared library, but has some quirks. For example, only one user on a given system can access the Cradle API at a given time. Others encounter an error. There is also a short refractory period (approximately 10 s) after shutting down a Cradle API application during which any attempt to start another causes a connection error. Within these constraints, it appears to work.

The Ruby extension is known to work on Linux with gcc. It has been built successfully and tested on Windows with the one-click installer and Microsoft's freely-downloadable compiler tools.

Build Instructions

  1. Type
       ./configure [cradle-home-dir]
    If your CRADLEHOME environment variable is set, you can omit the argument. You should see the message
       checking for main() in -lcradleapi... yes

  2. Type
       ruby setup.rb setup

    This step compiles the extension and builds the shared library. It also builds the Rdoc documentation, which can be found in the 'doc' subdirectory.

  3. Type
       ruby setup.rb install

    You will need administrative privilege for this step.


Unit tests for the low-level and high-level APIs can be found in the 'test' subdirectory. These tests expect to find a database called APIT on the Cradle CDS specified in the CRADLE_CDS_HOST environment variable. They log in with username 'manager' and password 'manager'. The database should be a copy of the DEMO database that comes with Cradle. The unit tests modify the database; do not apply them to real data.

Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Caltech/Jet Propulsion Laboratory
   More software from Jet Propulsion Laboratory

Open Channel Software runs entirely on Open Source Software. We return value to the Software community in the form of services and original software. Most of our content is currently available as source code, with the copyright owned by the original author, All Rights Reserved. Everything else is Copyright ©2000 - 2017 Open Channel Software.

View our privacy statement.
Contact webmaster at openchannelsoftware dot org with questions.