Skip to main content
Jump to: navigation, search

Difference between revisions of "Non Java projects Proposal"

m (Example)
Line 67: Line 67:
==== Syntax ====
==== Syntax ====
This syntax integrates into [[Buckminster component meta-data language 1.0 (Reference)#Public.2FPrivate_Actions|Buckminster's CSpec Actions]]
This syntax integrates into [[Buckminster component meta-data language 1.0 (Reference)#Public.2FPrivate_Actions|Buckminster's CSpec Actions]].
<source lang="text">
TODO : provide specifications

Revision as of 09:51, 19 July 2008

< To: Buckminster Project
< To: Helping_Out_(Buckminster)

Note this document is under construction --Guillaume CHATELET


While trying to use Buckminster for both my Java and C++ projects, I realized that Java projects within Eclipse were pretty straightforward but C/C++ projects were much more difficult to manage.

Why is it so hard ?

Component materialization is much harder in non Java environments because :

  • there are no standard way to describe C/C++ projects so you have to write the CSpec file anyway ( contrary to Eclipse Java projects which provides a way to auto generate the CSpec )
  • compiling, testing, your code requires to execute programs from outside ( shell scripts, compiler, unit tests and so forth ).
  • some of the resources you need to materialize are libraries that are only available as zipped url resources.
    • which implies you have to download and unzip them : Buckminster cannot do that for the moment despites its exactly what you expect it to do. So to overcome this issue you have to write ant tasks.

Work flow currently used

The toolchain I created to manage C/C++ projects dependencies is as follows :

  • Create Spec components to describe dependencies
  • Specify actions like build / clean / rebuild
    • those actions have prerequisites pointing to other components (eg: the path to the libTiff include folder)
  • Write ant scripts called from buckminster to
    • retrieve libraries from urls or retrieve files from archives pointed by url
    • execute commands with specific environment variables (eg. calling the compiler with paths to libraries)
  • Create the script to compile the code ( Makefile or Boost Jamfile or SCons file )


This page is a proposal to extends Buckminster in order to bring users from the non Java world a better experience.

Executor Actor

This actor would add the possibility to execute programs directly from the CSpec without writing Ant Scripts.


  • Executes programs
  • Sets arguments
    • arguments can refer to prerequisites
  • Sets environment variables for the execution
    • environments variables are key/value pairs
    • environments variables values can refer to prerequisites


<cs:public name="build" actor="executor">
      <cs:exec executable="${gcc}" dir="${buckmintser.home}" />
      <cs:env key="DEBUG" value="1" />
      <cs:env key="LIB_TIFF_INCLUDE" value="${tiff.include}" />
      <cs:env key="LIB_TIFF_LIB" value="${tiff.lib}" />
      <cs:arg value="-j2" />
      <cs:arg value="-I${tiff.include}" />
      <cs:arg value="-L${tiff.lib}" />
      <cs:attribute component="tiff-3.6.1" name="include" alias="tiff.include" />
      <cs:attribute component="tiff-3.6.1" name="lib" alias="tiff.lib" />
      <cs:attribute component="mingw-5.1.4" name="gcc" alias="gcc" />

Note that the actorProperties section will not allow the exec / var / env elements for the moment.


This syntax integrates into Buckminster's CSpec Actions.

TODO : provide specifications

Back to the top