From Allegro Wiki

Cbuild

Introduction

A multiplatform build system using (mostly) standard ANSI C aimed at organizing and creating projects with ease.

add more information

Usage

CBuild comes with a single source file cbuild.c and it's default script file default.cbd. The file cbuild.c is self-compiling under Linux and theoretically should be under Windows with a BASH shell (such as MSys).

So issuing:

myshell $ ./cbuild.c

will get it started and read in the default.cbd file and do whatever it is instructed to do within that file.

Example

Lets take a look at the provided default.cbd and explan it's usage:

incomplete

Here's another, even simpler, example: CBUILD_Example2

Advanced

Syntax

To read variables, use the syntax ${VARIABLE}. Using ${'VARIABLE'} will encapsulate the given variable's value within 'hard quotes'. To set a variable, use VARIABLE = value.

The commands below are provided for your use.

do command

else

done

if "foo"="bar" command

ifnot "foo"="bar" command

ifret NUMBER command

ifnret NUMBER command

ifplat PLATFORM command

ifnplat PLATFORM command

ifopt OPTION command

ifnopt OPTION command

ifexist FILE command

ifnexist FILE command

ifwrite FILE command

ifnwrite FILE command

call command

fixpath VARNAME

reinvoke args

invoke file

define NAME COMMAND

compile file_list

compileadd file_list

linkexec file

linklib file

loadlist LIST

execlist command

echo TEXT

put TEXT

read VARNAME

setinput FILE

writefile FILE TEXT

appendfile FILE TEXT

goto LABEL

src_paths DIRLIST

rmexec LIST

rmlib LIST

rmobj LIST

rm LIST

mkdir DIR

verbose NUM

uninvoke NUM

copy file1 file2

copylib name1 name2

copyexec name1 name2

popfront VARNAME

associate ext command

exit NUM

Using a compiler's pre-defined macro set, CBuild can currently detect the following platforms: aix, amigaos, beos, unicos, dgux, dynix, freebsd, gnuhurd, hpux, irix, linux, macosx, mpeix, msdos, netbsd, openbsd, os2, pyramiddc, qnx4, qnx6, reliantunix, scoopensever, solaris, sunos, solaris, symbian, osf1 (aka tru64), ultrix, unixware, vms, and win32. As well, it detects the following general environments: bsd, svr4, unix, uwin, and windu. As well as the architectures: i386, ia64, powerpc, and sparc.

Note that these are detected when CBuild is compiled, so if you want run-time detection you'll need to do some of your own checking in a script.

When defining your own commands, be aware that there are internal commands not listed here which may take precedance. These commands are prefixed with at least one underscore (_). As well, defining a command that begins with atexit_ will cause that command to be executed when the script exits, in the opposite order in which they were defined. If another exit is triggered, the script will immediately abort.

When used, the following sub-commands will be replaced with the described text. They use the syntax $(command options). Some sub-commands have strict formatting rules regarding the , character and may abort the script if this isn't met. Prefixing the command name with * will cause the returned value to be encapsulated in 'hard quotes' (important when dealing with user input).

$(getoptval variable)

$(word n,list-of-words)

$(libname name)

$(findsrc list-of-files)

$(ifeq A,B,YES,NO)

$(add A,B)

$(sub A,B)

$(mult A,B)

$(div A,B)

$(lsa list-of-files)

$(ls list-of-files)

$(tolower string)

$(toupper string)

$(which program)

$(suffix list-of-files)

$(basename list-of-files)

$(addprefix pre,list-of-words)

$(addsuffix suf,list-of-words)

$(dir list-of-files)

$(notdir list-of-files)

Note: lsa, ls, suffix, basename, addprefix, addsuffix, join, dir, and notdir will only leave one space between returned words.

Bash Autocompletion Code:

Add this to your ~/.bashrc and see a miracle ;)

alias cbuild="./cbuild.c"
 
_cbuild_opts ()
{
   FILES=( default.cbd )
   COMPREPLY=()
 
   k=${#FILES[@]}
   for (( i=0; i < $k; i++ )); do
      for j in `grep -s -E 'invoke .*.cbd' ${FILES[i]} | cut -d' ' -f2`; do
         FILES[$k]="$j";
         let k+=1
      done
   done
 
   rm -fr tmp
   touch tmp
 
   k=0
   for i in ${FILES[@]} ; do
      echo $i >> tmp
   done
 
   tmp=`sort -u tmp`
   rm -fr tmp
   touch tmp
   for i in $tmp; do
      if [ -f $i ] ; then
         for j in `cat $i | sed -n -e 's/.*ifn\?opt\s\+\([^ \t]\+\).*/\1/p' -e 's/\$(getoptval\s\+\(\[^)]+\))/\1/p'`; do
            echo $j >> tmp
         done
      fi
   done
 
   k=0
   for i in `sort -u tmp`; do
      COMPREPLY[$k]=$i
      let k+=1
   done
   rm -fr tmp
 
}
complete -F _cbuild_opts ./cbuild cbuild

Credits

Files: Latest Cbuild

Written by KittyCat

• File:Cbuild.xml: Kate syntax file
  • Place into ~/.kde/share/apps/katepart/syntax/ and kate will highlight cbuild files

Requests

• $(backticks program) or
• capture VAR program
  • $VAR now contains the output of "program"