bee 0.1.0

data/doc/html/quickstart.html

@@ -0,0 +1,108 @@
+<!--
+Copyright 2006 Michel Casabianca <casa@sweetohm.net>
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<h2>Scripts</h2>
+
+<p>Let's start with traditional <i>Hello World!</i> example:</p>
+
+<pre class="code"><code>- target: hello
+  script:
+  - rb: "name = ENV['USER'].capitalize"
+  - "echo \"Hello #{name}!\""</code></pre>
+
+<p>A target script can be made of shell and/or Ruby scripts. Variables
+defined in Ruby scripts can be accessed in shell using Ruby syntax
+<code>#{variable}</code>. Each shell script is executed in its own
+context while Ruby variables all live in a global one that persist
+in the whole build. This script will output:</p>
+
+<pre class="code"><code>----------------------------------------------------------------------- hello --
+Hello Casa!
+OK</code></pre>
+
+<h2>Targets</h2>
+
+<p>You can set default target and dependencies as follows:</p>
+
+<pre class="code"><code>- build: hello
+  default: hello
+
+- target: name
+  script:
+  - rb: "name = ENV['USER'].capitalize"
+
+- target: hello
+  depends: name
+  script:
+  - "echo \"Hello #{name}!\""
+</code></pre>
+
+<p>When running without indicating any target, bee will run target
+<i>hello</i> (default one, as stated in <code>default</code> key).
+Nevertheless, this target depends on <i>name</i>, thus bee will first
+run target <i>name</i>, then <i>hello</i>. This will write on console:</p>
+
+<pre class="code"><code>------------------------------------------------------------------------ name --
+----------------------------------------------------------------------- hello --
+Hello Casa!
+OK</code></pre>
+
+<h2>Properties</h2>
+
+<p>You can define build properies as follows:</p>
+
+<pre class="code"><code>- properties:
+  - name: "casa"
+  - capitalized: "#{name.capitalize}"
+
+- target: hello
+  script:
+  - "echo \"Hello #{capitalized}!\""</code></pre>
+
+<p>First, we set property <i>name</i> to <i>casa</i>, a simple string.
+Then, we set <i>capitalized</i> to <i>Casa</i>, using a Ruby expression.
+Properties can use values defined in other properties. Furthermore, we
+can use these properties in shell or Ruby scripts.</p>
+
+<h2>Context</h2>
+
+<p>Ruby scripts run in a global context that persist for the whole build.
+This context is similar to the place you write your code in IRB. In
+this context, you can define variables, functions or classes. You can
+define your own context in a file loaded at startup. This file is the
+place to define utility functions you would use in your embedded Ruby
+scripts.</p>
+
+<p>For instance, loading script <i>hello.rb</i>:</p>
+
+<pre class="code"><code>def say_hello(who)
+  puts "Hello #{who}!"
+end</code></pre>
+
+<p>In following build file using <code>context</code> as  follows:</p>
+
+<pre class="code"><code>- build: hello
+  context: hello.rb
+
+- properties:
+  - me: "Casa"
+
+- target: hello
+  script:
+  - rb: "say_hello(me)"</code></pre>
+
+<p>After this quick introduction, you should know enough to start writing
+your first build file. Enjoy!</p>

data/doc/yml/#releases.yml#

@@ -0,0 +1,36 @@
+# Copyright 2006 Michel Casabianca <casa@sweetohm.net>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+- description: >
+  Here is the list of Bee release with new features and links to download.
+  download: http://rubyforge.org/frs/?group_id=2479
+
+- release: alpha
+  description: A simple night hack.
+
+- release: beta-1
+  description: First public release.
+  new:
+  - Run Ruby scripts.
+  - Load context on startup.
+  - Added checks on build files syntax.
+  - Documentation system.
+
+- release: 0.1.0
+  description: First Gem package.
+  new:
+  - Distribution as a Gem package.
+  - Template generation (-t option).
+  fixed:
+  - Directory in distribution archive postfixed with version.

data/doc/yml/menu.yml

@@ -0,0 +1,49 @@
+# Copyright 2006 Michel Casabianca <casa@sweetohm.net>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+- menu: bee
+
+- title: Quick Start
+  file: ../html/quickstart.html
+  dest: index.html
+  type: html
+
+- title: Downloads
+  dest: http://rubyforge.org/frs/?group_id=2479
+  type: link
+
+- title: Documentation
+  file: ../html/documentation.html
+  dest: documentation.html
+  type: html
+
+- title: Source API
+  dir: ../../build/api/
+  dest: api
+  type: dir
+
+- title: License
+  file: ../../LICENSE
+  dest: license.html
+  type: text
+
+- title: Syntax check
+  file: ../../build/syntax.txt
+  dest: syntax.html
+  type: text
+
+- title: Unit tests
+  file: ../../build/tests.txt
+  dest: tests.html
+  type: text

data/doc/yml/releases.yml

@@ -0,0 +1,36 @@
+# Copyright 2006 Michel Casabianca <casa@sweetohm.net>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+- description: >
+  Here is the list of Bee release with new features and links to download.
+  download: http://rubyforge.org/frs/?group_id=2479
+
+- release: alpha
+  description: A simple night hack.
+
+- release: beta-1
+  description: First public release.
+  new:
+  - Run Ruby scripts.
+  - Load context on startup.
+  - Added checks on build files syntax.
+  - Documentation system.
+
+- release: 0.1.0
+  description: Distribute bee as a gem.
+  new:
+  - Distribution as a Gem package.
+  - Template generation (-t option).
+  fixed:
+  - Directory in distribution archive postfixed with version.

data/doc/yml/todo.yml

@@ -0,0 +1,17 @@
+# Copyright 2006 Michel Casabianca <casa@sweetohm.net>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+- Write documentation in RDoc format.
+- Freeze and document extension mechanism.
+- Write extension tasks to build bee on any platform.

data/lib/bee.rb

@@ -0,0 +1,916 @@
+# Copyright 2006 Michel Casabianca <casa@sweetohm.net>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Module for Bee stuff.
+module Bee
+
+  require 'yaml'
+  require 'getoptlong'
+
+  # Copyright notice.
+  COPYRIGHT = 'Bee version 0.1.0 (C) Michel Casabianca - 2006'
+  # Command line help.
+  HELP = 'Usage: bee [options] [targets]
+-h        Print help about usage and exit.
+-b        Print help about build and exit.
+-t        Write template build file on disk.
+-v        Enable verbose mode.
+-s style  Define style for output (see documentation).
+-f file   Build file to run (defaults to "build.yml").
+targets   Targets to run (default target if omitted).'
+  # Name for default build file.
+  DEFAULT_BUILD_FILE = 'build.yml'
+  # Exit value on error parsing command line
+  EXIT_PARSING_CMDLINE = 1
+  # Exit value on build error
+  EXIT_BUILD_ERROR = 2
+  # Exit value on unknown error
+  EXIT_UNKNOWN_ERROR = 3
+
+  # Parse command line and return parsed arguments.
+  def self.parse_command_line
+    help = false
+    help_build = false
+    template = false
+    verbose = false
+    style = nil
+    file = DEFAULT_BUILD_FILE
+    targets = []
+    # read options in BEEOPT environment variable
+    options = ENV['BEEOPT']
+    options.split(' ').reverse.each { |option| ARGV.unshift(option) } if options
+    # parse command line arguments
+    opts = GetoptLong.new(['--help', '-h', GetoptLong::NO_ARGUMENT ],
+                          ['--help-build', '-b', GetoptLong::NO_ARGUMENT ],
+                          ['--template', '-t', GetoptLong::NO_ARGUMENT ],
+                          ['--verbose', '-v', GetoptLong::NO_ARGUMENT],
+                          ['--style', '-s', GetoptLong::REQUIRED_ARGUMENT],
+                          ['--file', '-f', GetoptLong::REQUIRED_ARGUMENT])
+    opts.each do |opt, arg|
+      case opt
+      when '--help'
+        help = true
+      when '--help-build'
+        help_build = true
+      when '--template'
+        template = true
+      when '--verbose'
+        verbose = true
+      when '--style'
+        style = arg
+      when '--file'
+        file = arg
+      end
+    end
+    targets = ARGV
+    return [help, help_build, template, verbose, style, file, targets]
+  end
+
+  # Start build from command line.
+  def self.start_command_line
+    STDOUT.sync = true
+    begin
+      help, help_build, template, verbose, style, file, targets = 
+        parse_command_line
+    rescue
+      puts "ERROR: parsing command line (type 'bee -h' for help)"
+      exit(EXIT_PARSING_CMDLINE)
+    end
+    formatter = ConsoleFormatter.new(style)
+    begin
+      if help
+        puts COPYRIGHT
+        puts HELP
+      elsif help_build
+        build = Build.new(file)
+        puts formatter.help_build(build)
+      elsif template
+        puts "Writing build template in file '#{file}'..."
+        raise BuildError.new("Build file '#{file}' already exists") if 
+          File.exists?(file)
+        File.open(file, 'w') { |file| file.write(BUILD_TEMPLATE) }
+        puts formatter.format_success("OK")
+      else
+        listener = ConsoleListener.new(formatter, verbose)
+        build = Build.new(file)
+        build.run(targets, listener)
+      end
+    rescue BuildError
+      puts "#{formatter.format_error('ERROR')}: #{$!}"
+      exit(EXIT_BUILD_ERROR)
+    rescue SystemExit
+      # do nothing, exit in code
+    rescue Exception => e
+      puts "#{formatter.format_error('ERROR')}: #{$!}"
+      puts e.backtrace.join("\n")
+      exit(EXIT_UNKNOWN_ERROR)
+    end
+  end
+
+  #########################################################################
+  #                             BUILD ERROR                               #
+  #########################################################################
+
+  class BuildError < RuntimeError; end
+
+  module BuildErrorMixin
+
+    # Convenient method to raise a BuildError.
+    # - message: error message.
+    def error(message)
+      raise BuildError.new(message)
+    end    
+
+  end
+
+  #########################################################################
+  #                       CONSOLE FORMATTER CLASS                         #
+  #########################################################################
+
+  # Class to format build output on console.
+  class ConsoleFormatter
+
+    include BuildErrorMixin
+
+    ###################### ANSI COLORS AND STYLES #########################
+
+    # List of colors.
+    COLORS = [:black, :red, :green, :yellow, :blue, :magenta, :cyan, :white]
+    # Foreground color codes.
+    FOREGROUND_COLOR_CODES = {
+      :black   => 30,
+      :red     => 31,
+      :green   => 32,
+      :yellow  => 33,
+      :blue    => 34,
+      :magenta => 35,
+      :cyan    => 36,
+      :white   => 37
+    }
+    # Background color codes.
+    BACKGROUND_COLOR_CODES = {
+      :black   => 40,
+      :red     => 41,
+      :green   => 42,
+      :yellow  => 43,
+      :blue    => 44,
+      :magenta => 45,
+      :cyan    => 46,
+      :white   => 47
+    }
+    # List of styles.
+    STYLES = [:reset, :bright, :dim, :underscore, :blink, :reverse, :hidden]
+    # Style codes.
+    STYLE_CODES = {
+      :reset      => 0,
+      :bright     => 1,
+      :dim        => 2,
+      :underscore => 4,
+      :blink      => 5,
+      :reverse    => 7,
+      :hidden     => 8
+    }
+
+    ############################ DEFAULT STYLE ############################
+
+    # Default style (supposed to work on any configuration).
+    DEFAULT_STYLE = {
+      :line_character => '-'
+    }
+    # Default line length.
+    DEFAULT_LINE_LENGTH = 80
+    # Short style keys for command line
+    SHORT_STYLE_KEYS = {
+      'lc' => 'line_character',
+      'll' => 'line_length',
+      'ts' => 'target_style',
+      'tf' => 'target_foreground',
+      'tb' => 'target_background',
+      'ks' => 'task_style',
+      'kf' => 'task_foreground',
+      'kb' => 'task_background',
+      'ss' => 'success_style',
+      'sf' => 'success_foreground',
+      'sb' => 'success_background',
+      'es' => 'error_style',
+      'ef' => 'error_foreground',
+      'eb' => 'error_background'      
+    }
+
+    ############################## METHODS ################################
+
+    # Constructor.
+    # - style: style as a Hash or a String.
+    def initialize(style)
+      # if style is a String, this is command line argument
+      style = parse_style_from_command_line(style) if style.kind_of?(String)
+      # if style is nil, set default style
+      @style = style || DEFAULT_STYLE
+      # set default values for keys if nil
+      for key in DEFAULT_STYLE.keys
+        @style[key] = @style[key] || DEFAULT_STYLE[key]
+      end
+    end
+
+    # Format a target.
+    # - target: target to format.
+    def format_target(target)
+      name = target.name
+      # generate title line
+      length = @style[:line_length] || line_length || DEFAULT_LINE_LENGTH
+      right = ' ' + @style[:line_character]*2
+      left = @style[:line_character]*(length - (name.length + 4)) + ' '
+      line = left + name + right
+      # apply style
+      formatted = style(line, 
+                        @style[:target_style], 
+                        @style[:target_foreground],
+                        @style[:target_background])
+      return formatted
+    end
+
+    # Format a task.
+    # - task: task to format.
+    def format_task(task)
+      if task.kind_of?(String)
+        source = task
+      elsif task.kind_of?(Hash)
+        if task.key?('rb')
+          source = task['rb']
+        else
+          source = YAML::dump(task)
+          source = source.sub(/---/, '')
+        end
+      end
+      formatted = '- ' + source.strip.gsub(/\n/, "\n. ")
+      styled = style(formatted,
+                     @style[:task_style], 
+                     @style[:task_foreground],
+                     @style[:task_background])
+      return styled
+    end
+
+    # Format a success string.
+    # - string: string to format.
+    def format_success(string)
+      string = style(string,
+                     @style[:success_style], 
+                     @style[:success_foreground],
+                     @style[:success_background])
+      return string
+    end
+
+    # Format an error string.
+    # - string: string to format.
+    def format_error(string)
+      string = style(string,
+                     @style[:error_style], 
+                     @style[:error_foreground],
+                     @style[:error_background])
+      return string
+    end
+
+    # Return help about build.
+    def help_build(build)
+      help = ''
+      if build.name
+        help << "- Build: #{build.name.inspect}\n"
+      end
+      if build.description
+        help << format_description('Description', build.description, 2, false)
+      end
+      if build.properties.keys.length > 0
+        help << "- Properties:\n"
+        for property in build.properties.keys.sort
+          help << "  - #{property}: #{build.properties[property].inspect}\n"
+        end
+      end
+      if build.targets.length > 0
+        help << "- Targets:\n"
+        for target in build.targets.values.sort { |a, b| a.name <=> b.name }
+          help << format_description(target.name, target.description, 2)
+        end
+      end
+      help << "- Default: #{build.default}"
+      return help.strip
+    end
+
+    private
+
+    # Apply style to a string:
+    # - string: the string to apply style to.
+    # - style: style to apply on string.
+    # - foreground: foreground color for string.
+    # - background: background color for string.
+    def style(string, style, foreground, background)
+      # check style, foreground and background colors
+      error "Unknown style '#{style}'" unless 
+        STYLES.member?(style) or not style
+      error "Unknown color '#{foreground}'" unless
+        COLORS.member?(foreground) or not foreground
+      error "Unknown color '#{background}'" unless
+        COLORS.member?(background) or not background
+      # if no style nor colors, return raw string
+      return string if not foreground and not background and not style
+      # insert style and colors in string
+      colorized = "\e["
+      colorized << "#{STYLE_CODES[style]};" if style
+      colorized << "#{FOREGROUND_COLOR_CODES[foreground]};" if foreground
+      colorized << "#{BACKGROUND_COLOR_CODES[background]};" if background
+      colorized = colorized[0..-2]
+      colorized << "m#{string}\e[#{STYLE_CODES[:reset]}m"
+      return colorized
+    end
+
+    # Get line length calling IOCTL. Return nil if call failed.
+    def line_length
+      begin
+        tiocgwinsz = 0x5413
+        string = [0, 0, 0, 0].pack('SSSS')
+        if $stdin.ioctl(tiocgwinsz, string) >= 0 then
+          rows, cols, xpixels, ypixels = string.unpack('SSSS')
+          return cols
+        end
+      rescue
+        return nil
+      end
+    end
+
+    # Parse style from command line. If error occurs parsing style, return
+    # nil (which means default style).
+    # - string: style to parse.
+    def parse_style_from_command_line(string)
+      return if not string
+      style = {}
+      begin
+        for pair in string.split(',')
+          key, value = pair.split(':')
+          key = SHORT_STYLE_KEYS[key] || key
+          key = key.to_sym
+          if key == :line_length
+            value = value.to_i
+          elsif key == :line_character
+            value = ' ' if not value or value.length == 0
+          else
+            value = value.to_sym
+            error "Unkown color or style '#{value}'" if 
+              not COLORS.member?(value) and not STYLES.member?(value)
+          end
+          style[key] = value
+        end
+        return style
+      rescue
+        # if parsing fails, return default style (nil)
+        return nil
+      end
+    end
+
+    # Format a description.
+    # - title: description title (project, property or target name).
+    # - text: description text.
+    # - indent: indentation width.
+    # - bullet: tells if we must put a bullet.
+    def format_description(title, text=nil, indent=0, bullet=true)
+      string = ' '*indent
+      string << '- ' if bullet
+      string << title
+      if text
+        string << ": "
+        if text.split("\n").length > 1
+          string << "\n"
+          text.split("\n").each do |line|
+            string << ' '*(indent+2) + line.strip + "\n"
+          end
+        else
+          string << text.strip + "\n"
+        end
+      end
+      return string
+    end
+
+  end
+
+  #########################################################################
+  #                           CONSOLE LISTENER                            #
+  #########################################################################
+
+  # Listener when running in a console. Prints messages on the console using
+  # a given formatter.
+  class ConsoleListener
+
+    # Formatter used by listener.
+    attr_reader :formatter
+    # Verbosity flag.
+    attr_reader :verbose
+    # Build start time.
+    attr_reader :start_time
+    # Build end time.
+    attr_reader :end_time
+    # Build duration.
+    attr_reader :duration
+    # Build success.
+    attr_reader :success
+    # Last target met.
+    attr_reader :last_target
+    # Last task met.
+    attr_reader :last_task
+
+    # Constructor.
+    # - formatter: the formatter to use to output on console.
+    # - verbose: tells if we run in verbose mode.
+    def initialize(formatter, verbose)
+      @formatter = formatter
+      @verbose = verbose
+    end
+
+    # Called when build is started.
+    # - build: the build object.
+    def build_started(build)
+      @start_time = Time.now
+      @end_time = nil
+      @duration = nil
+      @success = nil
+      @last_target = nil
+      @last_task = nil
+      puts "Starting build '#{build.file}'..." if @verbose
+    end
+
+    # Called when build is finished.
+    # - build: the build object.
+    def build_finished(build)
+      @end_time = Time.now
+      @duration = @end_time - @start_time
+      @success = true
+      puts "Built in #{@duration} s" if @verbose
+      puts @formatter.format_success('OK')
+    end
+
+    # Called when a target is met.
+    # - target: the target object.
+    def target(target)
+      @last_target = target
+      @last_task = nil
+      puts @formatter.format_target(target)
+    end
+
+    # Called when a task is met.
+    # - task: task source (shell, Ruby or task).
+    def task(task)
+      @last_task = task
+      puts @formatter.format_task(task) if @verbose
+    end
+
+    # Called when an error was raised.
+    # - exception: raised exception.
+    def error(exception)
+      @end_time = Time.now
+      @duration = @end_time - @start_time
+      @success = false
+      puts "Built in #{@duration} s" if @verbose
+      message = ''
+      message << "In target '#{@last_target.name}'" if @last_target
+      message << ", in task:\n#{@formatter.format_task(@last_task)}\n" if
+        @last_task
+      message << ': ' if @last_target and not @last_task
+      message << exception.to_s
+      puts "#{@formatter.format_error('ERROR')}: #{message}"
+    end
+
+  end
+
+  #########################################################################
+  #                             BUILD CLASS                               #
+  #########################################################################
+
+  # Class for a given build.
+  class Build
+
+    include BuildErrorMixin
+
+    # Build file.
+    attr_reader :file
+    # Base directory.
+    attr_reader :base
+    # Build name.
+    attr_reader :name
+    # Default target.
+    attr_reader :default
+    # Build description.
+    attr_reader :description
+    # Properties hash (used for project help).
+    attr_reader :properties
+    # Hash for targets, indexed by target name.
+    attr_reader :targets
+    # Context for Ruby scripts and properties.
+    attr_reader :context
+    # Loaded extensions.
+    attr_reader :extensions
+    # Build listener.
+    attr_reader :listener
+
+    # Constructor:
+    # - file: build file to load.
+    def initialize(file)
+      @file = file
+      @properties = {}
+      @targets = {}
+      @context = Context.new
+      @extensions = {}
+      @base = File.expand_path(File.dirname(@file))
+      @context.set('base', @base)
+      @properties['base'] = @base
+      load_context(DEFAULT_CONTEXT)
+      # load build file
+      begin
+        source = File.read(@file)
+        build = YAML::load(source)
+        # parse object entries
+        for entry in build
+          if entry.key?('build')
+            # build info entry
+            error "Duplicate build info" if @name
+            @name = entry['build']
+            @default = entry['default']
+            @description = entry['description']
+            # load context files if any
+            if entry['context']
+              for script in entry['context']
+                begin
+                  based_script = File.join(@base, script)
+                  evaluated_script = @context.evaluate_string(based_script)
+                  source = File.read(evaluated_script)
+                  load_context(source)
+                rescue
+                  error "Error loading context '#{script}': #{$!}"
+                end
+              end
+            end
+          elsif entry.key?('properties')
+            # properties entry
+            for property in entry['properties']
+              begin
+                name = property.keys[0]
+                value = @context.evaluate_string(property[name])
+                error "Duplicate property '#{name}' definition" if 
+                  @properties[name]
+                @properties[name] = value
+                @context.set(name, value)
+              rescue
+                error "Error evaluating property '#{name}': #{$!}"
+              end
+            end
+          elsif entry.key?('target')
+            # target entry
+            target = Target.new(entry, self)
+            @default = target.name if not @default and @targets.keys.length == 0
+            error "Duplicate target definition: '#{target.name}'" if 
+              @targets[target.name]
+            @targets[target.name] = target
+          else
+            # unknown entry
+            error "Unknown entry:\n#{YAML::dump(entry)}"
+          end
+        end
+      rescue
+        error "Error loading build file '#{@file}': #{$!}"
+      end
+    end
+
+    # Run build:
+    # - targets: list of targets to run.
+    # - listener: listener for the build.
+    def run(targets, listener=nil)
+      @listener = listener
+      working_directory = Dir.getwd
+      begin
+        @listener.build_started(self) if @listener
+        Dir.chdir(base)
+        error "No default target given" if (!@default and targets.length == 0)
+        targets = [@default] if targets.length == 0
+        for target in targets
+          run_target(target)
+        end
+        @listener.build_finished(self)
+      rescue BuildError => e
+        if listener
+          @listener.error(e)
+        else
+          raise e
+        end
+      ensure
+        @listener = nil
+        Dir.chdir(working_directory)
+      end
+    end
+
+    # Run a given target.
+    # - target: the target to run.
+    def run_target(target)
+      error "Target '#{target}' not found" if not @targets[target]
+      @targets[target].run      
+    end
+
+    private
+
+    # Load a given context.
+    # - source: the context source.
+    def load_context(source)
+      @context.evaluate(source)
+      @extensions = @context.get('TASKS')
+    end
+
+  end
+
+  #########################################################################
+  #                            TARGET CLASS                               #
+  #########################################################################
+
+  # Class for a given target.
+  class Target
+
+    include BuildErrorMixin
+
+    # Build that encapsulates target.
+    attr_reader :build
+    # Name of the target.
+    attr_reader :name
+    # Target dependencies.
+    attr_reader :depends
+    # Target description.
+    attr_reader :description
+    # Script that run in the target.
+    attr_reader :script
+
+    # Constructor.
+    # - target: target for target, resulting from YAML parsing.
+    # - build: build that encapsulate this target.
+    def initialize(target, build)
+      @build = build
+      @name = target['target']
+      @depends = target['depends']||[]
+      @description = target['description']
+      @script = target['script']
+    end
+
+    # Run target.
+    def run
+      if not @evaluated
+        @evaluated = true
+        for depend in @depends
+          @build.run_target(depend)
+        end
+        @build.listener.target(self) if @build.listener
+        if @script
+          case @script
+          when String
+            run_task(@script)
+          when Array
+            for task in @script
+              run_task(task)
+            end
+          end
+        end
+      end
+    end
+
+    private
+
+    # Run a task.
+    # - task: the task to run.
+    def run_task(task)
+      @build.listener.task(task) if @build.listener
+      case task
+      when String
+        # shell script
+        run_shell(task)
+      when Hash
+        error "A task entry must be a Hash with a single key" if
+          task.keys.length != 1
+        if task.key?('rb')
+          # ruby script
+          script = task['rb']
+          run_ruby(script)
+        else
+          # must be a task
+          run_extension(task)
+        end
+      end
+    end
+
+    # Run a given shell script.
+    # - script: the scrip to run.
+    def run_shell(script)
+      @listener.task(script) if @listener
+      evaluated_script = @build.context.evaluate_string(script)
+      system(evaluated_script)
+      error "Script exited with value #{$?}" if $? != 0
+    end
+
+    # Run a given shell script.
+    # - script: the scrip to run.
+    def run_ruby(script)
+      @listener.task(script) if @listener
+      @build.context.evaluate(script)
+    end
+
+    # Run a given task.
+    # - task: task to run as a Hash.
+    def run_extension(task)
+      @listener.task(task) if @listener
+      name = task.keys[0]
+      error "Unknown task '#{name}'" if 
+        not @build.extensions.key?(name)
+      parameters = task[name]
+      script = "#{name}(#{parameters.inspect})"
+      @build.context.evaluate(script)
+    end
+
+  end
+
+  #########################################################################
+  #                            CONTEXT CLASS                              #
+  #########################################################################
+
+  # Class for Ruby scripts context.
+  class Context
+
+    include BuildErrorMixin
+
+    # Constructor.
+    def initialize
+      @binding = get_binding
+    end
+
+    # Set a given value in context.
+    # - name: the variable name to set.
+    # - value: the variable value.
+    def set(name, value)
+      begin
+        eval("#{name} = #{value.inspect}", @binding)
+      rescue
+        error "Error setting property '#{name} = #{value.inspect}': #{$!}"
+      end
+    end
+
+    # Get a given value in context.
+    # - name: the variable name.
+    def get(name)
+      begin
+        eval("#{name}", @binding)
+      rescue
+        error "Error getting property '#{name}': #{$!}"
+      end
+    end
+
+    # Evaluate a script in context.
+    # - script: script to evaluate.
+    def evaluate(script)
+      begin
+        eval(script, @binding)
+      rescue
+        error "Error running script: #{$!}"
+      end
+    end
+
+    # Process a given string, replacing properties references with their
+    # value. Property references have same form than variable references
+    # in ruby strings: '#{variable}' will be replaced with variable value.
+    # - string: string to process.
+    def evaluate_string(string)
+      return nil if string == nil
+      return string if not string.kind_of?(String)
+      string = string.gsub(/#\{.+?\}/) do |match|
+        property = match[2..-2]
+        value = get(property)
+        error ("Property '#{property}' was not defined") unless value
+        value
+      end
+      return string
+    end
+
+    private
+
+    # Get a binding as script context.
+    def get_binding
+      return binding
+    end
+
+  end
+
+  #########################################################################
+  #                           DEFAULT CONTEXT                             #
+  #########################################################################
+
+  DEFAULT_CONTEXT = '
+# Default context script loaded at startup.
+
+# Hash of tasks help indexed by their name.
+TASKS = {}
+
+######################### TASKS UTILITY FUNCTIONS #########################
+
+# Bind tasks. This method must be called by context scripts defining tasks.
+# - tasks: Hash indexing task help with task names.
+def bind_tasks(tasks)
+  for name, help in tasks
+    raise "Task \'#{name}\' already bound" if TASKS.key?(name)
+    TASKS[name] = help
+  end
+end
+
+# Check a task parameters. Raise a RuntimeError with explanation message if
+# a mandatory parameter is missing or an unknown parameter was found.
+# - params: task parameters as a Hash.
+# - description: parameters description as a Hash associating a parameter
+#   name with symbol :mandatory or :optional.
+def check_parameters(params, description)
+  raise "Parameters must be a Hash" unless params.kind_of?(Hash)
+  for param in description.keys
+    raise "Missing mandatory parameter \'#{param}\'" unless
+      params[param] or description[param] == :optional
+  end
+  for param in params.keys
+    raise "Unknown parameter \'#{param}\'" if not description.key?(param)
+  end
+end
+
+############################ TASK DEFINITIONS #############################
+
+# bind tasks defined hereafter
+bind_tasks({
+  "mkdir" =>
+  "Create a directory and all parent directories if necessary. Do nothing if
+directory already exists. Parameter is a String for directory to create."
+})
+
+# Make a directory and parent directories if necessary.
+def self.mkdir(dir)
+  raise "Parameter must be a String" unless dir.kind_of?(String)
+  require "fileutils"
+  FileUtils.makedirs(dir)
+end
+
+############################ UTILITY FUNCTIONS ############################
+
+# Run a shell script and raise an exception if script returned a value
+# different of 0.
+# - script: script to run.
+def sh(script)
+  system(script) or raise "Script \'#{script}\' exited with value \'#{$?}\'"
+end
+
+# Find files that match a given pattern.
+# - pattern: pattern to select files.
+# - base: base directory for search.
+# - dir: tells if we must include directories.
+# Return: a file list.
+def find(pattern=//, base=\'.\', dir=true)
+  require \'find\'
+  files = []
+  Find.find(base) do |path|
+    if path =~ pattern and (File.file?(path) or (File.directory?(path) and dir))
+      files << path
+    end
+  end
+  return files
+end
+'
+
+  #########################################################################
+  #                            BUILD TEMPLATE                             #
+  #########################################################################
+
+  BUILD_TEMPLATE = 
+'# Template build file
+- build: template
+  description: Template build file.
+  default: hello
+
+# Build properties
+- properties:
+  - user: "#{ENV[\'USER\']}"
+
+# Build targets
+- target: capitalize
+  description: Capitalize user name
+  script:
+  - rb: "who = user.capitalize"
+
+- target: hello
+  depends: capitalize
+  description: Print greatings.
+  script:
+  - "echo \"Hello #{who}!\""
+'
+end