org-converge 0.0.4 → 0.0.5

data/README.org

@@ -1,15 +1,15 @@
 # -*- mode: org; mode: auto-fill; -*-
-#+TITLE:	Org Converge
 #+STARTUP:	showeverything
 
-* Description
+* Org Converge
+** Description
 
   This attempts to be an experiment of using Org mode syntax to
   describe, configure and setting up something, borrowing some ideas
   of what is possible to do with tools like =chef-solo=, =puppet=,
   =ansible=, etc...
 
-* Motivation
+** Motivation
 
   The Org babel syntax has proven to be flexible enough to produce
   /reproducible research/ papers. Then, I believe that configuring and setting up
@@ -17,11 +17,84 @@
   the same syntax, given that /converging/ the configuration is something
   that one ought to be able to reproduce.
 
-* Usage
-
-: org-converge path/to/setup-file.org
-
-* How it works
+** Usage
+
+   To run the blocks in parallel:
+
+#+begin_src sh
+org-converge path/to/setup-file.org
+#+end_src
+
+   Or sequentially:
+
+#+begin_src sh
+org-converge path/to/setup-file.org --runmode=sequential
+#+end_src
+
+** Quick example
+
+   The following is an example of running 3 processes
+   in parallel by defining them as code blocks from 
+   an Org mode file:
+
+#+begin_src sh
+  ,#+TITLE: Running Org babel processes in parallel
+   
+  * Print with different languages
+   　
+  ,#+name: hello_from_bash
+  ,#+begin_src sh :shebang #!/bin/bash
+  while true; do echo "hello world from bash"; sleep 1; done
+  ,#+end_src
+  　 
+  ,#+name: hello_from_ruby
+  ,#+begin_src ruby :shebang #!/usr/local/bin/ruby
+  $stdout.sync = true
+  loop { puts "hello world from ruby" ; sleep 1 }
+  ,#+end_src
+  　 
+  ,#+name: hello_from_python
+  ,#+begin_src python :shebang #!/usr/bin/python
+  import time
+  import sys
+  for i in range(0,100):
+    print "hello world from python"
+    sys.stdout.flush()
+    time.sleep(1)
+  ,#+end_src   
+#+end_src
+
+  We store this in a file named =hello.org= and then run it as follows:
+
+#+begin_src sh
+org-converge hello.org
+#+end_src
+
+  This would produce an output similar to the following:
+
+#+begin_src sh
+I, [2014-04-17T23:48:44.663545 #1710]  INFO -- : Tangling 0 files...
+I, [2014-04-17T23:48:44.663698 #1710]  INFO -- : Tangling succeeded!
+I, [2014-04-17T23:48:44.664829 #1710]  INFO -- : Running code blocks now! (4 runnable blocks found in total)
+I, [2014-04-17T23:48:44.762899 #1710]  INFO -- : hello_from_bash       (1711) -- started with pid 1711
+I, [2014-04-17T23:48:44.808717 #1710]  INFO -- : hello_from_ruby       (1712) -- started with pid 1712
+I, [2014-04-17T23:48:44.837878 #1710]  INFO -- : hello_from_python     (1713) -- started with pid 1713
+I, [2014-04-17T23:48:44.878336 #1710]  INFO -- :                       (1714) -- started with pid 1714
+I, [2014-04-17T23:48:44.879284 #1710]  INFO -- : hello_from_bash       (1711) -- hello world from bash
+I, [2014-04-17T23:48:44.882778 #1710]  INFO -- : hello_from_ruby       (1712) -- hello world from ruby
+I, [2014-04-17T23:48:44.883637 #1710]  INFO -- : hello_from_python     (1713) -- hello world from python
+I, [2014-04-17T23:48:45.778681 #1710]  INFO -- : hello_from_bash       (1711) -- hello world from bash
+I, [2014-04-17T23:48:45.792321 #1710]  INFO -- : hello_from_ruby       (1712) -- hello world from ruby
+I, [2014-04-17T23:48:45.882020 #1710]  INFO -- : hello_from_python     (1713) -- hello world from python
+I, [2014-04-17T23:48:46.787106 #1710]  INFO -- : hello_from_bash       (1711) -- hello world from bash
+I, [2014-04-17T23:48:46.793347 #1710]  INFO -- : hello_from_ruby       (1712) -- hello world from ruby
+I, [2014-04-17T23:48:46.883511 #1710]  INFO -- : hello_from_python     (1713) -- hello world from python
+I, [2014-04-17T23:48:47.794846 #1710]  INFO -- : hello_from_ruby       (1712) -- hello world from ruby
+I, [2014-04-17T23:48:47.796387 #1710]  INFO -- : hello_from_bash       (1711) -- hello world from bash
+I, [2014-04-17T23:48:47.884196 #1710]  INFO -- : hello_from_python     (1713) -- hello world from python
+#+end_src
+
+** How it works
 
   Org Converge uses an liberally extended version of Org Babel
   features in order to give support for converging the configuration
@@ -30,10 +103,7 @@
   For example, using Org Babel and macros we can easily spread config
   files on a server by writing the following on a ~server.org~ file.
 
-  #+begin_src org
-    ,#+MACRO: multitenancy_enabled true
-    ,#+MACRO: status_port true
-    
+  #+begin_src sh
     ,#+begin_src yaml :tangle /etc/component.yml
     multitenant: false
     status_port: 10004
@@ -41,69 +111,49 @@
   #+end_src
 
   And then configure it by running it as follows, (considering we have
-  the correct permissions): 
-
-  #+begin_src sh
-  org-converge server.org
-  #+end_src
-
-  This leverages on the syntax already provided by Org Babel, but one
-  difference here is that if we run it once again without changes...
+  the correct permissions for tangling at =/etc/component.yml=): 
 
   #+begin_src sh
-  org-converge server.org
+  sudo org-converge server.org
   #+end_src
-  
-  ...it would finish soon since the configuration has already converged.
 
   Next, let's say that we no only one want to set the configured templates,
   but that we also want to install some packages. In that case, we
   should be able to do the following:
 
-  #+begin_src org
-    ,#+macro: multitenancy_enabled true
-    ,#+macro: status_port  true
-    ,#+macro: project_path path/to/project
-
-    ,* Configuring the component
-
-    ,#+begin_src yaml :tangle /etc/component.yml
-    multitenant: false
-    status_port: 10004
-    ,#+end_src  
-
-    ,* Installing the dependencies
-
-    Need the following so that ~bundle install~ can compile 
-    the native extensions correctly.
-
-    ,#+begin_src sh
-    apt-get install build-essentials -y
-    ,#+end_src
-
-    Then the following should work:
-
-    ,#+begin_src sh
-    cd {{{project_path}}}
-    bundle install
-    ,#+end_src
+  #+begin_src sh
+  ,* Configuring the component
+
+  ,#+begin_src yaml :tangle /etc/component.yml
+  multitenant: false
+  status_port: 10004
+  ,#+end_src  
+　
+  ,* Installing the dependencies
+　
+  Need the following so that ~bundle install~ can compile 
+  the native extensions correctly.
+　
+  ,#+begin_src sh
+  apt-get install build-essentials -y
+  ,#+end_src
+　
+  Then the following should work:
+　
+  ,#+begin_src sh
+  cd project_path
+  bundle install
+  ,#+end_src
   #+end_src
 
   As long as the repo has been already checked out in the directory, 
   the previous example will succeed. 
 
-  #+begin_src sh
-  org-converge server.org
-  #+end_src
-
-  If that is not the case, then org-converge will fail 
-  and pickup from that last step.
-
-  More practical examples can be found [[here]], more will be added as
+  More practical examples can be found [[https://github.com/wallyqs/org-converge/tree/master/examples][here]], more will be added as
   long as dogfooding from this goes well.
 
-* Contributing
+** Contributing
 
-The project is in very early development at this moment, but if you
-feel that it is interesting enough, please create a ticket so start
-the discussion.
+  The project is in very early development at this moment, but if you
+  feel that it is interesting enough, please create a ticket so start
+  the discussion.

data/TODO

@@ -2,9 +2,8 @@
 #+TODO:    TODO | DONE CANCELED 
 #+startup: showeverything
 
-* [0/6] 0.0.4 version
+* [0/7] > 0.0.9 version
 
-- [ ] Support runlists notifications via =#+NAME:=
 - [ ] Macros can be loaded and applied to the configuration
 - [ ] Actually support converging and idempotency
   + Do not do an operation unless it is required
@@ -16,6 +15,21 @@
 - [ ] Use :eval for evaling blocks (off by default)
 - [ ] Can use :dir for running a process relative to that directory
 
+* [0/3] 0.0.6 version
+
+- [ ] Keyword to accumulate run blocks
+- [ ] Do not run commented blocks
+- [ ] Use rake task manager
+
+* [2/2] 0.0.5 version
+
+- [X] Do not run or tangle blocks without arguments
+- [X] Keyword to activate runmode in the text itself
+
+* [1/1] 0.0.4 version
+
+- [X] Support runlists notifications via =#+NAME:=
+
 * [2/2] 0.0.3 version
 
 - [X] Support sequential and parallel execution
@@ -39,7 +53,7 @@ Need some basic functionality of what Org babel offers first.
 - [X] ~--tangle~ flag
 - [X] Support a root dir for when not running relative to the directory
 
-* [1/19] Ideas
+* [3/19] Ideas
 ** CANCELED How to set the permissions from the directory from the file that is being tangled when it does not exists?
 
 By default, this would be 0644, but we also need to specify the
@@ -131,7 +145,7 @@ Kind of like the chef-solo runlist, a headline like this...
 org-converge fluentd.org -t config
 #+end_src
 
-** TODO Managing dependencies: could be handled with ~#+include~ directives
+** DONE Managing dependencies: could be handled with ~#+include~ directives
 
 One idea is that it would be useful to compile different manuals
 that are dependent among each other. 
@@ -181,7 +195,7 @@ sudo service td-agent start
 sudo /etc/register-to-balancer
 #+end_src
 
-** TODO ~#+NAME:~ could be used in the logger for identifying the process
+** DONE ~#+NAME:~ could be used in the logger for identifying the process
 ** TODO Support caching?
 
 #+begin_src emacs-lisp :cache yes :exports results
@@ -199,6 +213,6 @@ sudo /etc/register-to-balancer
 
 * Links
 
-Super useful notes:
 http://eschulte.github.io/org-scraps
 
+http://doc.norang.ca/org-mode.html

data/examples/simple/setup.org

@@ -7,20 +7,11 @@ It does not get more simple than this:
   #+begin_src conf :tangle /tmp/my-conf
 <source>
   bind 0.0.0.0
-
-
-
   port 4224
-
-
-
-
 </source>
 
 <match **>
   type file
-
-
   path /var/tmp/a.log
 </match>
   #+end_src

data/lib/org-converge/babel_output_buffer.rb

@@ -2,10 +2,13 @@ module Orgmode
   class BabelOutputBuffer < OutputBuffer
     attr_reader :tangle
     attr_reader :scripts
+    attr_reader :in_buffer_settings
 
-    def initialize(output)
+    def initialize(output, opts={})
       super(output)
 
+      @in_buffer_settings = opts[:in_buffer_settings]
+
       # ~@tangle~ files are put in the right path
       # : @tangle['/path'] = [Lines]
       @tangle  = Hash.new {|h,k| h[k] = {:lines => '', :header => {}, :lang => ''}}
@@ -14,7 +17,6 @@ module Orgmode
       # : @scripts = [text, text, ...]
       @scripts = Hash.new {|h,k| h[k] = {:lines => '', :header => {}, :lang => ''}}
       @scripts_counter = 0
-
       @buffer = ''
     end
 
@@ -29,7 +31,7 @@ module Orgmode
     end
 
     def insert(line)
-      # We try to get the lang from #+BEGIN_SRC blocks
+      # We try to get the lang from #+BEGIN_SRC and #+BEGIN_EXAMPLE blocks
       if line.begin_block?
         case
         when line.block_header_arguments[':tangle']
@@ -39,7 +41,8 @@ module Orgmode
             :mkdirp  => line.block_header_arguments[':mkdirp']
           }
           @tangle[@current_tangle][:lang] = line.block_lang
-        when line.block_header_arguments[':shebang']
+        when line.properties['block_name']
+          # unnamed blocks are not run
           @current_tangle = nil
           @buffer = ''
 
@@ -50,11 +53,12 @@ module Orgmode
             :name    => line.properties['block_name']
           }
           @scripts[@scripts_counter][:lang] = line.block_lang
-
         # TODO: have a way to specify which are the default binaries to be used per language
         # when binary_detected?(@block_lang)
         else
-          # pass
+          # reset tangling
+          @current_tangle = nil
+          @buffer = ''
         end
       end
 
@@ -66,7 +70,8 @@ module Orgmode
         # When a tangle is not going on, it means that the lines would go
         # into a runnable script
         @buffer << line.output_text << "\n"
-      when (!@buffer.empty? and not (line.begin_block? or line.assigned_paragraph_type == :code))
+      when (!@buffer.empty? and not (line.begin_block? or \
+                                     line.assigned_paragraph_type == :code))
         # Fix indentation and remove fix commas from Org mode before flushing
         strip_code_block!
         @scripts[@scripts_counter][:lines] << @buffer

data/lib/org-converge/command.rb

@@ -37,14 +37,24 @@ module OrgConverge
 
     def converge!
       tangle!
-      case @options['--runmode']
+      if @options['--runmode']
+        dispatch_runmode(@options['--runmode'])
+      else
+        # Try to find one in the buffer
+        runmode = ob.in_buffer_settings['RUNMODE']
+        dispatch_runmode(runmode)
+      end
+    end
+
+    def dispatch_runmode(runmode)
+      case runmode
       when 'parallel'
         run_blocks_in_parallel!
       when 'sequential'
         run_blocks_sequentially!
       when 'runlist'
         # TODO
-      else
+      else # parallel by default
         run_blocks_in_parallel!
       end
     end
@@ -52,7 +62,7 @@ module OrgConverge
     def tangle!
       results = babel.tangle!
     rescue Orgmode::Babel::TangleError
-      logger.error "Cannot converge because there were errors during tangle step".red
+      logger.error "Cannot converge because there were errors during tangle step".fg 'red'
     end
 
     def run_blocks_sequentially!
@@ -66,14 +76,18 @@ module OrgConverge
 
       while not runlist_stack.empty?
         key, script = runlist_stack.shift
+
+        # Decision: Only run blocks which have a name
+        next unless script[:header][:name]
+
+        display_name = script[:header][:name]
         with_running_engine do |engine|
           file = File.expand_path("#{@run_dir}/#{key}")
           cmd = "#{script[:lang]} #{file}"
-          display_name = script[:header][:name] || script[:lang]
           engine.register display_name, cmd, { :cwd => @root_dir, :logger => logger }
         end
       end
-      logger.info "Run has completed successfully.".green
+      logger.info "Run has completed successfully.".fg 'green'
     end
 
     # TODO: Too much foreman has made this running blocks in parallel the default behavior.
@@ -84,12 +98,16 @@ module OrgConverge
       babel.ob.scripts.each do |key, script|
         file = File.expand_path("#{@run_dir}/#{key}")
         cmd = "#{script[:lang]} #{file}"
-        display_name = script[:header][:name] || script[:lang]
+
+        # Decision: Only run blocks which have a name
+        next unless script[:header][:name]
+
+        display_name = script[:header][:name]
         @engine.register display_name, cmd, { :cwd => @root_dir, :logger => logger }
       end
       logger.info "Running code blocks now! (#{babel.ob.scripts.count} runnable blocks found in total)"
       @engine.start
-      logger.info "Run has completed successfully.".green
+      logger.info "Run has completed successfully.".fg 'green'
     end
 
     def with_running_engine
@@ -104,12 +122,12 @@ module OrgConverge
 
     def showfiles
       ob.tangle.each do |file, block|
-        puts "---------- #{file} --------------".green
+        puts "---------- #{file} --------------".fg 'green'
         puts block[:lines]
       end
 
       ob.scripts.each do |index, block|
-        puts "---------- script: #{index} to be run with: #{block[:header][:shebang]} --------------".green
+        puts "---------- script: #{index} to be run with: #{block[:header][:shebang]} --------------".fg 'green'
         puts block[:lines]
       end
     end

data/lib/org-converge/version.rb

@@ -1,3 +1,3 @@
 module OrgConverge
-  VERSION = "0.0.4"
+  VERSION = "0.0.5"
 end

data/lib/org-converge.rb

@@ -14,7 +14,10 @@ module Orgmode
       # Feed the parsed contens and create the necessary internal structures
       # for doing babel like features
       output = ''
-      ob = BabelOutputBuffer.new(output)
+      babel_options = { 
+        :in_buffer_settings => @in_buffer_settings
+      }
+      ob = BabelOutputBuffer.new(output, babel_options)
       translate(@header_lines, ob)
       @headlines.each do |headline|
         translate(headline.body_lines, ob)
@@ -25,20 +28,8 @@ module Orgmode
   end
 end
 
-module StringWithColors
-  def red;            colorize("\e[0m\e[31m");  end
-  def green;          colorize("\e[0m\e[32m");  end
-  def yellow;         colorize("\e[0m\e[33m");  end
-  def blue;           colorize("\e[0m\e[34m");  end
-  def magenta;        colorize("\e[0m\e[35m"); end
-  def cyan;           colorize("\e[0m\e[36m"); end
-  def white;          colorize("\e[0m\e[37m"); end
-  def bright_black;   colorize("\e[0m\e[30m"); end
-  def bright_magenta; colorize("\e[0m\e[35m"); end
-  def bold;   colorize("\e[0m\e[1m");   end
-  def colorize(color_code); "#{color_code}#{self}\e[0m"; end
-end
-
-class String
-  include StringWithColors
-end
+require 'tco'
+conf = Tco.config
+conf.names["green"] = "#02a552"
+conf.names["red"]   = "#eb443b"
+Tco.reconfigure conf

data/org-converge.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
   gem.version       = OrgConverge::VERSION
   gem.add_runtime_dependency('docopt', '0.5.0')
-  gem.add_runtime_dependency('org-ruby', '~> 0.9.2')
+  gem.add_runtime_dependency('org-ruby', '~> 0.9.4')
   gem.add_runtime_dependency('foreman', '~> 0.63.0')
   gem.add_runtime_dependency('tco', '~> 0.1.0')
 end

data/spec/converge_examples/basic_run_example/setup.org

@@ -1,33 +1,45 @@
-#+title: Running scripts in parallel
+#+TITLE:        Running scripts in parallel
 
 In the following example, the following 3 scripts should be run in parallel
 with all output being flushed to the screen.
 
 - Count some numbers with bash
 
-  #+begin_src sh :shebang #!/bin/bash
-  echo '' > out.log
-  for i in `seq 1 5`; do 
-  echo "Writing! $i"
-  echo "hello $i" >> out.log
-  sleep $(($RANDOM % 10))
-  done
-  #+end_src
+#+name: bash_counter
+#+begin_src sh :shebang #!/bin/bash
+echo '' > out.log
+for i in `seq 1 5`; do 
+echo "Writing! $i"
+echo "hello $i" >> out.log
+sleep $(($RANDOM % 5))
+done
+#+end_src
 
 - Count some numbers with ruby
 
-  #+begin_src ruby :shebang #!/usr/bin/ruby
-  sleep 0.2
-  10.times do |n|
-    puts "And now writing! #{n}"
-    File.open("out.log", "a") {|f| f.puts "Hello again #{n}" }
-    sleep rand.round(2)
-  end
-  #+end_src
+#+name: ruby_counter
+#+begin_src ruby :shebang #!/usr/bin/ruby
+$stdout.sync = true
+sleep 0.2
+10.times do |n|
+  puts "And now writing! #{n}"
+  File.open("out.log", "a") {|f| f.puts "Hello again #{n}" }
+  sleep rand.round(2)
+end
+#+end_src
 
 - Print some numbers with python
 
+#+name: python_counter
 #+begin_src python :shebang #!/usr/bin/python
 for i in range(0,3):
   print i
 #+end_src
+
+- Block that should not be run
+
+#+begin_src js
+{
+  "hello": "world"
+}
+#+end_src

data/spec/converge_examples/runlist_example/setup.org

@@ -1,8 +1,10 @@
 # -*- mode: org; mode: auto-fill; -*-
-#+TITLE: Runlist example
+#+TITLE:	Runlist example
+#+runmode:	sequential
 
 In this example, we will have scripts being chained one after another.
 
+#+name: first
 #+begin_src sh :shebang #!/bin/bash
 sleep 5
 echo "first" > out.log
@@ -10,6 +12,7 @@ echo "first" > out.log
 
 The script below will only be called once the one above is run.
 
+#+name: second
 #+begin_src ruby :shebang #!/usr/local/bin/ruby
 File.open("out.log", 'a') {|f| f.puts "second" }
 #+end_src

data/spec/converge_spec.rb

@@ -44,8 +44,7 @@ describe OrgConverge::Command do
 
     o = OrgConverge::Command.new({ 
                                    '<org_file>' => setup_file,
-                                   '--root-dir' => example_dir,
-                                   '--runmode'  => 'sequential'
+                                   '--root-dir' => example_dir
                                  })
     success = o.execute!
     success.should == true

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: org-converge
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-17 00:00:00.000000000 Z
+date: 2014-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: docopt
-  requirement: &70205749443760 !ruby/object:Gem::Requirement
+  requirement: &70344197198100 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -21,21 +21,21 @@ dependencies:
         version: 0.5.0
   type: :runtime
   prerelease: false
-  version_requirements: *70205749443760
+  version_requirements: *70344197198100
 - !ruby/object:Gem::Dependency
   name: org-ruby
-  requirement: &70205749424220 !ruby/object:Gem::Requirement
+  requirement: &70344197197620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.9.4
   type: :runtime
   prerelease: false
-  version_requirements: *70205749424220
+  version_requirements: *70344197197620
 - !ruby/object:Gem::Dependency
   name: foreman
-  requirement: &70205749407080 !ruby/object:Gem::Requirement
+  requirement: &70344196892060 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: 0.63.0
   type: :runtime
   prerelease: false
-  version_requirements: *70205749407080
+  version_requirements: *70344196892060
 - !ruby/object:Gem::Dependency
   name: tco
-  requirement: &70205749404660 !ruby/object:Gem::Requirement
+  requirement: &70344196890840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,7 +54,7 @@ dependencies:
         version: 0.1.0
   type: :runtime
   prerelease: false
-  version_requirements: *70205749404660
+  version_requirements: *70344196890840
 description: A light configuration management tool for Org mode
 email:
 - waldemar.quevedo@gmail.com
@@ -67,7 +67,6 @@ files:
 - .travis.yml
 - Gemfile
 - LICENSE
-- README.md
 - README.org
 - Rakefile
 - TODO

data/README.md

@@ -1,157 +0,0 @@
-Org Converge
-------------
-[![Build Status](https://travis-ci.org/wallyqs/org-converge.svg?branch=master)](https://travis-ci.org/wallyqs/org-converge)
-
-# Description
-
-A tool which uses Org mode syntax to describe, configure and
-setup something, borrowing some ideas of what is possible to 
-do with tools like `chef-solo`, `puppet`, `ansible`, etc...
-
-Can also be used for tangling code blocks like Org Babel does.
-
-# Installing
-
-    $ gem install org-converge
-
-# Motivation
-
-The Org babel syntax has proven to be flexible enough to produce
-*reproducible research* papers. Then, I believe that configuring and setting up
-a server for example is something that could be also be done using
-the same syntax, given that *converging* the configuration is something
-that one ought to be able to reproduce.
-
-# Example usage
-
-Inspecting the files that would be tangled:
-
-	$ org-converge spec/converge_examples/basic_tangle/setup.org --showfiles 
-	
-	---------- conf.yml --------------
-	bind: 0.0.0.0
-	port: 2442
-
-	mysql:
-	 db: users
-     host: somewhere-example.local
-	 password: 111111111
-	 
-Executing the tangle:
-	 
-	$ org-converge spec/converge_examples/basic_tangle/setup.org --tangle
-	
-	I, [2014-03-24T00:21:08.073506 #660]  INFO -- : Tangling 1 files...
-    I, [2014-03-24T00:21:08.073668 #660]  INFO -- : BEGIN(conf.yml): Tangling 7 lines at 'conf.yml'
-    I, [2014-03-24T00:21:08.075562 #660]  INFO -- : END(conf.yml): done.
-    I, [2014-03-24T00:21:08.075638 #660]  INFO -- : Tangling succeeded!
-
-Run the code blocks in sequence:
-
-    $ org-converge spec/converge_examples/runlist_example/setup.org --runmode=sequential
-	I, [2014-04-02T01:18:17.336255 #65462]  INFO -- : Tangling 0 files...
-	I, [2014-04-02T01:18:17.336376 #65462]  INFO -- : Tangling succeeded!
-	I, [2014-04-02T01:18:17.336698 #65462]  INFO -- : Tangling 2 scripts within directory: /Users/mariko/repos/org-converge/run...
-	I, [2014-04-02T01:18:17.340638 #65462]  INFO -- : sh(65466) -- started with pid 65466
-	I, [2014-04-02T01:18:22.365128 #65462]  INFO -- : sh(65466) -- exited with code 0
-	I, [2014-04-02T01:18:22.398983 #65462]  INFO -- : ruby(65469) -- started with pid 65469
-	I, [2014-04-02T01:18:23.013195 #65462]  INFO -- : ruby(65469) -- exited with code 0
-	I, [2014-04-02T01:18:23.013354 #65462]  INFO -- : Run has completed successfully.
-
-Running the code blocks in parallel mode is also possible:
-
-    $ org-converge spec/converge_examples/basic_run_example/setup.org --runmode=parallel
-	
-	I, [2014-04-02T01:16:27.660259 #65126]  INFO -- : Tangling 0 files...
-	I, [2014-04-02T01:16:27.660390 #65126]  INFO -- : Tangling succeeded!
-	I, [2014-04-02T01:16:27.661640 #65126]  INFO -- : Running code blocks now! (3 runnable blocks found in total)
-	I, [2014-04-02T01:16:27.732659 #65126]  INFO -- : sh(65157)     -- started with pid 65157
-	I, [2014-04-02T01:16:27.732819 #65126]  INFO -- : ruby(65158)   -- started with pid 65158
-	I, [2014-04-02T01:16:27.732915 #65126]  INFO -- : python(65160) -- started with pid 65160
-	I, [2014-04-02T01:16:27.733565 #65126]  INFO -- : sh(65157)     -- Writing! 1
-	I, [2014-04-02T01:16:27.771819 #65126]  INFO -- : sh(65157)     -- Writing! 2
-	I, [2014-04-02T01:16:27.914407 #65126]  INFO -- : python(65160) -- 0
-	I, [2014-04-02T01:16:27.914674 #65126]  INFO -- : python(65160) -- 1
-	I, [2014-04-02T01:16:27.914887 #65126]  INFO -- : python(65160) -- 2
-	I, [2014-04-02T01:16:27.921333 #65126]  INFO -- : python(65160) -- exited with code 0
-	I, [2014-04-02T01:16:33.226998 #65126]  INFO -- : ruby(65158)   -- And now writing! 0
-	I, [2014-04-02T01:16:33.227257 #65126]  INFO -- : ruby(65158)   -- And now writing! 1
-	I, [2014-04-02T01:16:33.227458 #65126]  INFO -- : ruby(65158)   -- And now writing! 2
-	I, [2014-04-02T01:16:33.227673 #65126]  INFO -- : ruby(65158)   -- And now writing! 3
-	I, [2014-04-02T01:16:33.248160 #65126]  INFO -- : ruby(65158)   -- And now writing! 4
-	I, [2014-04-02T01:16:33.248378 #65126]  INFO -- : ruby(65158)   -- And now writing! 5
-	I, [2014-04-02T01:16:33.248552 #65126]  INFO -- : ruby(65158)   -- And now writing! 6
-	I, [2014-04-02T01:16:33.301512 #65126]  INFO -- : ruby(65158)   -- And now writing! 7
-	I, [2014-04-02T01:16:33.301877 #65126]  INFO -- : ruby(65158)   -- And now writing! 8
-	I, [2014-04-02T01:16:33.302186 #65126]  INFO -- : ruby(65158)   -- And now writing! 9
-	I, [2014-04-02T01:16:33.363135 #65126]  INFO -- : ruby(65158)   -- exited with code 0
-	I, [2014-04-02T01:16:36.736210 #65126]  INFO -- : sh(65157)     -- Writing! 3
-	I, [2014-04-02T01:16:41.747375 #65126]  INFO -- : sh(65157)     -- Writing! 4
-	I, [2014-04-02T01:16:47.754810 #65126]  INFO -- : sh(65157)     -- Writing! 5
-	I, [2014-04-02T01:16:50.764513 #65126]  INFO -- : sh(65157)     -- exited with code 0
-	I, [2014-04-02T01:16:50.764636 #65126]  INFO -- : Run has completed successfully.
-
-# How it works
-
-Org Converge uses an liberally extended version of Org Babel
-features in order to give support for converging the configuration
-of a server.
-
-For example, using Org Babel and macros we can easily spread config
-files on a server by writing the following on a `server.org` file.
-
-```org
-    #+begin_src yaml :tangle /etc/component.yml
-    multitenant: false
-    status_port: 10004
-    #+end_src
-```
-
-And then configure it by running it as follows, (considering we have
-the correct permissions):
-
-```sh
-  $ org-converge server.org
-```
-
-Next, let's say that we no only one want to set the configured templates,
-but that we also want to install some packages. In that case, we
-should be able to do the following:
-
-```org
-    * Configuring the component
-
-    #+begin_src yaml :tangle /etc/component.yml
-    multitenant: false
-    status_port: 10004
-    #+end_src  
-
-    * Installing the dependencies
-
-    Need the following so that ~bundle install~ can compile 
-    the native extensions correctly.
-
-    #+begin_src sh :shebang #!/bin/bash
-    apt-get install build-essentials -y
-    #+end_src
-
-    Then the following should work:
-
-    #+begin_src sh :shebang #!/bin/bash
-    cd {{{project_path}}}
-    bundle install
-    #+end_src
-```
-
-As long as the repo has been already checked out in the directory,
-the previous example will succeed. Note that we are also setting 
-the `:shebang` on the scripts so that the script is executable.
-
-More practical examples can be found in the examples directory. 
-Many more will be added as long as dogfooding from this goes well.
-
-# Contributing
-
-The project is in very early development at this moment, but if you
-feel that it is interesting enough, please create a ticket to start
-the discussion.