dao 5.5.0 → 8.0.0

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    ODJiYmNmMGY2MDdkYjM1MThiOTUyOGFkMzc5ZDkwMTNhYjA1YjNhYw==
-  data.tar.gz: !binary |-
-    YzRmOWI5Y2ViYjM0NjM5MWFiMDYzZjFhMjEwYjNkMjJkMTJlNmY1Mw==
-!binary "U0hBNTEy":
-  metadata.gz: !binary |-
-    YzU1M2Y0NWM5MGU2OWI0NTU5MGFlOGQzZWI0MjRkNzEwZTllZGRmMDJkOGNk
-    ZjhlNjAzZjc4OWFmM2M5YjhmMTNlNWVhMWMxNWFhOTgwZTQ4MDdlYTg1MGY0
-    YmY5NWI5N2E0NjYzZmM4NjA5ZDYwNWYyYmI5Zjk4NWJiZTNiOTg=
-  data.tar.gz: !binary |-
-    YTc5NDY5OTBlYjA1MWRjZjA3MjI5MzliOTlhNzQ1MTljZjc3NGJiMjFhY2Y0
-    ZjJjYmQxN2RmZmViMDEzMjlhOWE5ZDEwODVlOTUwMmUwMGE3ZWZiMzEwZDkw
-    ZjdlNGFkMjJmN2JmZWZhZTg0N2U1ZDUyMWEwMGY4ZDJmMDJlYjg=
+SHA256:
+  metadata.gz: 6a987da50df407863683e68b28b64a48a2e4e825d015e5c62a3dc027f456d959
+  data.tar.gz: b4a2c2ede251574cb1224b75fc0532bdeb761d4597b7ffdc0af460e1ee4b904b
+SHA512:
+  metadata.gz: 32740b72cf6a178a8279cd56b3d88c35ee2f1d5f021f544f2e9122d1b7df3f4f70a328eb52f53067a109e788c5b39329b2a3f28d9bb61809a3526f61b4341ea8
+  data.tar.gz: 678ee2e96b9e1a112b29e96eb690c2cff992dabe1b2a70629b99dae052b2ab2893574e14acf14ff79f7aa90f0fc1110d83982e725e28137fc5cbac8cdf8c1278

data/README.md

@@ -0,0 +1,258 @@
+# dao
+
+## SYNOPSIS
+
+a sa-weet-ass library for structuring rails applications using the 'data
+access object' design pattern.  dao consists of two main data access
+objects, *api* objects and *conducer* objects.  conducers combine the
+presenter pattern with the conductor pattern.
+
+
+### API
+
+    class Api < Dao::Api
+      call('/posts') do
+        get do
+          data[:posts] = Post.all.map{|post| post.attributes}
+        end
+
+        post do
+          post = Post.new(params[:post])
+
+          if post.save
+            data[:post] = post.attributes
+          else
+            status 420
+          end
+        end
+      end
+    end
+
+### CONDUCER
+
+  * TODO
+
+wikipedia has this to say about dao in general
+
+  >
+  > In computer software, a data access object (DAO) is an object that
+  > provides an abstract interface to some type of database or other
+  > persistence mechanism. By mapping application calls to the persistence
+  > layer, DAOs provide some specific data operations without exposing
+  > details of the database. This isolation supports the single
+  > responsibility principle. It separates what data accesses the
+  > application needs, in terms of domain-specific objects and data types
+  > (the public interface of the DAO), from how these needs can be satisfied
+  > with a specific DBMS, database schema, etc. (the implementation of the
+  > DAO).
+  >
+  -- http://en.wikipedia.org/wiki/Data_access_object
+
+and this to say about the single responsibility principle
+
+  >
+  > In object-oriented programming, the single responsibility principle
+  > states that every class should have a single responsibility, and that
+  > responsibility should be entirely encapsulated by the class. All its
+  > services should be narrowly aligned with that responsibility.
+
+  > Responsibility [is defined] as a reason to change, and [single
+  > responsibility means] that a class or module should have one, and only
+  > one, reason to change. As an example, consider a module that compiles and
+  > prints a report. Such a module can be changed for two reasons. First,
+  > the content of the report can change. Second, the format of the report
+  > can change. These two things change for very different causes; one
+  > substantive, and one cosmetic. The single responsibility principle says
+  > that these two aspects of the problem are really two separate
+  > responsibilities, and should therefore be in separate classes or
+  > modules. It would be a bad design to couple two things that change for
+  > different reasons at different times.
+  >
+  -- http://en.wikipedia.org/wiki/Single_responsibility_principle
+
+even though rails is the sweet, its ActiveRecord class violates (or, at
+least, encourages a programmer to violate) the single responsibility
+principle
+
+this leads to obvious problems
+
+  >
+  > Jim Weirich, at the end of his SOLID Ruby Talk at the 2009 Ruby
+  > Conference, asks the audience: "ActiveRecord objects implement a domain
+  > concept and a persistence concept. Does this violate the SRP (Single
+  > Responsibility Principle)?" The audience agrees that it does violate the
+  > SRP. Jim asks if this bothers them. Many members of the audience say
+  > yes. Why? It makes testing harder. It makes the persistence object a lot
+  > heavier.
+  >
+  -- http://programmers.stackexchange.com/questions/119352/does-the-activerecord-pattern-follow-encourage-the-solid-design-principles#comment293734_119352
+
+and subtle yet sweeping consequences (as described by uncle bob)
+
+  >
+  > The problem I have with ActiveRecord is that it creates confusion about
+  > ... two very different styles of programming. A database table is a
+  > data structure. It has exposed data and no behavior. But an ActiveRecord
+  > appears to be an object. It has “hidden” data, and exposed behavior. I
+  > put the word “hidden” in quotes because the data is, in fact, not
+  > hidden. Almost all ActiveRecord derivatives export the database columns
+  > through accessors and mutators. Indeed, the Active Record is meant to be
+  > used like a data structure.
+
+  > On the other hand, many people put business rule methods in their
+  > ActiveRecord classes; which makes them appear to be objects. This leads
+  > to a dilemma. On which side of the line does the Active Record really
+  > fall? Is it an object? Or is it a data structure?
+
+  > This dilemma is the basis for the oft-cited impedance mismatch between
+  > relational databases and object oriented languages. Tables are data
+  > structures, not classes. Objects are encapsulated behavior, not database
+  > rows.
+
+  > ...
+
+  > The problem is that Active Records are data structures. Putting business
+  > rule methods in them doesn’t turn them into true objects. In the end,
+  > the algorithms that employ ActiveRecords are vulnerable to changes in
+  > schema, and changes in type. They are not immune to changes in type, the
+  > way algorithms that use objects are.
+
+  > ...
+
+  > So applications built around ActiveRecord are applications built around
+  > data structures. And applications that are built around data structures
+  > are procedural—they are not object oriented. The opportunity we miss
+  > when we structure our applications around ActiveRecord is the
+  > opportunity to use object oriented design.
+  >
+  -- https://sites.google.com/site/unclebobconsultingllc/active-record-vs-objects
+
+and a clear solution (again, uncle bob)
+
+  > I am not recommending against the use of ActiveRecord. I think the
+  > pattern is very useful. What I am advocating is a separation between the
+  > application and ActiveRecord.
+
+  > ActiveRecord belongs in the layer that separates the database from the
+  > application. It makes a very convenient halfway-house between the hard
+  > data structures of database tables, and the behavior exposing objects in
+  > the application.
+
+  > Applications should be designed and structured around objects, not data
+  > structures. Those objects should expose business behaviors, and hide any
+  > vestige of the database.
+  >
+  -- https://sites.google.com/site/unclebobconsultingllc/active-record-vs-objects
+
+welcome to the dao
+
+
+## DESCRIPTION
+
+### API
+
+applications that are written on dao look like this in ruby
+
+      result = api.call('/posts/new', params)
+
+and like this in javascript
+
+      result = api.call('/posts/new', params)
+
+in command-line applications they look like this
+
+      result = api.call('/posts/new', params)
+
+and in tests this syntax is used
+
+      result = api.call('/posts/new', params)
+
+when a developer wants to understand the interface of a dao application she does
+this
+
+      vi app/api.rb
+
+when a developer of a dao application wants to play with a dao application
+interactively she does
+
+      (rails console)
+
+      > api = Api.new result = api.call('/posts/new', params)
+
+when a remote client wants to understand the api of a dao application she
+does
+
+      curl --silent http://dao.app.com/api | less
+
+
+
+this kind of brutally consistent interface is made possible by structuring
+access to data around the finest data structure of all time - the hash.
+in the case of dao the hash is a well structured and slightly clever hash,
+but a simple hash interface is the basis of every bit of goodness dao has
+to offer.
+
+in dao, application developers do not bring models into controllers and,
+especially not into views.  instead, a unified interface to application
+logic and data is used everywhere: in tests, in controllers, from the
+command-line, and also from javascript.
+
+this seperation of concerns brings with it many, many desirable qualities:
+
+  - total seperation of concerns between the front and back end of a web
+    application.  when developers are using dao changes to the data model
+    have zero effect on controllers and views.
+
+  - issues related to having models in controllers and views such as
+    difficulty reasoning about caching and n+1 queries in views killing
+    the db simply disappear.
+
+  - bad programming practices like using quasi-global variables
+    (current_user) or decorating models with view specific attributes
+    (password_verification) are no longer needed.
+
+  - developers are able to reason over the abilities of an application by
+    reading only a few source files.
+
+  - databases can be swapped, mixed, or alternate storage/caching
+    mechanisms added at any time without affecting the application's
+    controllers or views.
+
+  - transition from form based views to semi-ajax ones to fully-ajax ones
+    is direct.
+
+  - forms and interfaces that involve dozens of models are as easy to deal
+    with as simple ones.
+
+  - code can be optimized at the interface.
+
+## READING
+
+  * http://blog.plataformatec.com.br/2012/03/barebone-models-to-use-with-actionpack-in-rails-4-0/
+  * http://martinfowler.com/eaaCatalog/serviceLayer.html
+  * http://blog.firsthand.ca/2011/10/rails-is-not-your-application.html
+  * http://best-practice-software-engineering.ifs.tuwien.ac.at/patterns/dao.html
+  * http://www.codefutures.com/data-access-object/
+  * http://java.sun.com/blueprints/corej2eepatterns/Patterns/DataAccessObject.html
+  * http://www.paperplanes.de/2010/5/7/activerecord_callbacks_ruined_my_life.html
+  * http://google-styleguide.googlecode.com/svn/trunk/jsoncstyleguide.xml
+  * http://pragdave.blogs.pragprog.com/pragdave/2007/03/the_radar_archi.html
+  * http://borisstaal.com/post/22586260753/mvc-in-a-browser-vs-reality
+
+
+## INSTALL
+
+    gem 'dao', :path => File.expand_path('..') ### Gemfile
+    rails generate dao api
+    vim -o app/api.rb app/controllers/api_controller.rb
+    curl --silent http://0.0.0.0:3000/api
+    curl --silent http://0.0.0.0:3000/api/ping
+
+## HISTORY
+
+###  4.0.0
+  - dao depends has tied itself to rails, for better or worse...
+  - drop custom form encoding.  just use a rack-like approach.
+  - dao form parameter encoding has changed slightly to 'dao[/api/path][x,y,z]=42'
+  - dao form paramters are now preparsed in a before filter
+

data/Rakefile

@@ -1,10 +1,10 @@
-This.rubyforge_project = 'codeforpeople'
+#This.rubyforge_project = 'codeforpeople'
 This.author = "Ara T. Howard"
 This.email = "ara.t.howard@gmail.com"
 This.homepage = "https://github.com/ahoward/#{ This.lib }"
 
 task :license do
-  open('LICENSE', 'w'){|fd| fd.puts "same as ruby's"}
+  open('LICENSE', 'w'){|fd| fd.puts "Ruby"}
 end
 
 task :default do
@@ -93,7 +93,7 @@ task :gemspec do
   test_files  = "test/#{ lib }.rb" if File.file?("test/#{ lib }.rb")
   summary     = object.respond_to?(:summary) ? object.summary : "summary: #{ lib } kicks the ass"
   description = object.respond_to?(:description) ? object.description : "description: #{ lib } kicks the ass"
-  license     = object.respond_to?(:license) ? object.license : "same as ruby's"
+  license     = object.respond_to?(:license) ? object.license : "Ruby"
 
   if This.extensions.nil?
     This.extensions = []
@@ -145,7 +145,6 @@ task :gemspec do
 
             spec.extensions.push(*<%= extensions.inspect %>)
 
-            spec.rubyforge_project = <%= This.rubyforge_project.inspect %>
             spec.author = <%= This.author.inspect %>
             spec.email = <%= This.email.inspect %>
             spec.homepage = <%= This.homepage.inspect %>
@@ -297,7 +296,7 @@ BEGIN {
 
 # discover full path to this ruby executable
 #
-  c = Config::CONFIG
+  c = RbConfig::CONFIG
   bindir = c["bindir"] || c['BINDIR']
   ruby_install_name = c['ruby_install_name'] || c['RUBY_INSTALL_NAME'] || 'ruby'
   ruby_ext = c['EXEEXT'] || ''

data/coerce-0.0.8/README

@@ -0,0 +1,28 @@
+NAME
+  coerce
+
+DESCRIPTION
+  a ruby library full of common cast/coercion operations
+
+INSTALL
+  gem install coerce
+
+USAGE
+
+  :~/git/coerce $ irb -r lib/coerce.rb 
+
+  ruby-1.8.7-p330 :001 > Coerce.integer('42')
+   => 42
+
+  ruby-1.8.7-p330 :002 > Coerce.number('42.0')
+   => 42.0 
+
+  ruby-1.8.7-p330 :003 > Coerce.time('yesterday')
+   => Wed Aug 24 12:00:00 -0600 2011 
+
+  ruby-1.8.7-p330 :004 > Coerce.list_of_times('yesterday, today')
+   => [Wed Aug 24 12:00:00 -0600 2011, Thu Aug 25 19:30:00 -0600 2011] 
+
+  ruby-1.8.7-p330 :005 > Coerce.list_of_floats("42, 4.2\n\n 420")
+   => [42.0, 4.2, 420.0] 
+  

data/coerce-0.0.8/Rakefile

@@ -0,0 +1,392 @@
+This.rubyforge_project = 'codeforpeople'
+This.author = "Ara T. Howard"
+This.email = "ara.t.howard@gmail.com"
+This.homepage = "https://github.com/ahoward/#{ This.lib }"
+
+
+task :default do
+  puts((Rake::Task.tasks.map{|task| task.name.gsub(/::/,':')} - ['default']).sort)
+end
+
+task :test do
+  run_tests!
+end
+
+namespace :test do
+  task(:unit){ run_tests!(:unit) }
+  task(:functional){ run_tests!(:functional) }
+  task(:integration){ run_tests!(:integration) }
+end
+
+def run_tests!(which = nil)
+  which ||= '**'
+  test_dir = File.join(This.dir, "test")
+  test_glob ||= File.join(test_dir, "#{ which }/**_test.rb")
+  test_rbs = Dir.glob(test_glob).sort
+        
+  div = ('=' * 119)
+  line = ('-' * 119)
+
+  test_rbs.each_with_index do |test_rb, index|
+    testno = index + 1
+    command = "#{ This.ruby } -I ./lib -I ./test/lib #{ test_rb }"
+
+    puts
+    say(div, :color => :cyan, :bold => true)
+    say("@#{ testno } => ", :bold => true, :method => :print)
+    say(command, :color => :cyan, :bold => true)
+    say(line, :color => :cyan, :bold => true)
+
+    system(command)
+
+    say(line, :color => :cyan, :bold => true)
+
+    status = $?.exitstatus
+
+    if status.zero? 
+      say("@#{ testno } <= ", :bold => true, :color => :white, :method => :print)
+      say("SUCCESS", :color => :green, :bold => true)
+    else
+      say("@#{ testno } <= ", :bold => true, :color => :white, :method => :print)
+      say("FAILURE", :color => :red, :bold => true)
+    end
+    say(line, :color => :cyan, :bold => true)
+
+    exit(status) unless status.zero?
+  end
+end
+
+
+task :gemspec do
+  ignore_extensions = ['git', 'svn', 'tmp', /sw./, 'bak', 'gem']
+  ignore_directories = ['pkg']
+  ignore_files = ['test/log', 'a.rb'] + Dir['db/*'] + %w'db'
+
+  shiteless = 
+    lambda do |list|
+      list.delete_if do |entry|
+        next unless test(?e, entry)
+        extension = File.basename(entry).split(%r/[.]/).last
+        ignore_extensions.any?{|ext| ext === extension}
+      end
+      list.delete_if do |entry|
+        next unless test(?d, entry)
+        dirname = File.expand_path(entry)
+        ignore_directories.any?{|dir| File.expand_path(dir) == dirname}
+      end
+      list.delete_if do |entry|
+        next unless test(?f, entry)
+        filename = File.expand_path(entry)
+        ignore_files.any?{|file| File.expand_path(file) == filename}
+      end
+    end
+
+  lib         = This.lib
+  object      = This.object
+  version     = This.version
+  files       = shiteless[Dir::glob("**/**")]
+  executables = shiteless[Dir::glob("bin/*")].map{|exe| File.basename(exe)}
+  #has_rdoc    = true #File.exist?('doc')
+  test_files  = test(?e, "test/#{ lib }.rb") ? "test/#{ lib }.rb" : nil
+  summary     = object.respond_to?(:summary) ? object.summary : "summary: #{ lib } kicks the ass"
+  description = object.respond_to?(:description) ? object.description : "description: #{ lib } kicks the ass"
+  license = object.respond_to?(:license) ? object.license : "same as ruby's"
+
+  if This.extensions.nil?
+    This.extensions = []
+    extensions = This.extensions
+    %w( Makefile configure extconf.rb ).each do |ext|
+      extensions << ext if File.exists?(ext)
+    end
+  end
+  extensions = [extensions].flatten.compact
+
+# TODO
+  if This.dependencies.nil?
+    dependencies = []
+  else
+    case This.dependencies
+      when Hash
+        dependencies = This.dependencies.values
+      when Array
+        dependencies = This.dependencies
+    end
+  end
+
+  template = 
+    if test(?e, 'gemspec.erb')
+      Template{ IO.read('gemspec.erb') }
+    else
+      Template {
+        <<-__
+          ## <%= lib %>.gemspec
+          #
+
+          Gem::Specification::new do |spec|
+            spec.name = <%= lib.inspect %>
+            spec.version = <%= version.inspect %>
+            spec.platform = Gem::Platform::RUBY
+            spec.summary = <%= lib.inspect %>
+            spec.description = <%= description.inspect %>
+            spec.license = <%= license.inspect %>
+
+            spec.files =\n<%= files.sort.pretty_inspect %>
+            spec.executables = <%= executables.inspect %>
+            
+            spec.require_path = "lib"
+
+            spec.test_files = <%= test_files.inspect %>
+
+            <% dependencies.each do |lib_version| %>
+              spec.add_dependency(*<%= Array(lib_version).flatten.inspect %>)
+            <% end %>
+
+            spec.extensions.push(*<%= extensions.inspect %>)
+
+            spec.rubyforge_project = <%= This.rubyforge_project.inspect %>
+            spec.author = <%= This.author.inspect %>
+            spec.email = <%= This.email.inspect %>
+            spec.homepage = <%= This.homepage.inspect %>
+          end
+        __
+      }
+    end
+
+  Fu.mkdir_p(This.pkgdir)
+  gemspec = "#{ lib }.gemspec"
+  open(gemspec, "w"){|fd| fd.puts(template)}
+  This.gemspec = gemspec
+end
+
+task :gem => [:clean, :gemspec] do
+  Fu.mkdir_p(This.pkgdir)
+  before = Dir['*.gem']
+  cmd = "gem build #{ This.gemspec }"
+  `#{ cmd }`
+  after = Dir['*.gem']
+  gem = ((after - before).first || after.first) or abort('no gem!')
+  Fu.mv(gem, This.pkgdir)
+  This.gem = File.join(This.pkgdir, File.basename(gem))
+end
+
+task :readme do
+  samples = ''
+  prompt = '~ > '
+  lib = This.lib
+  version = This.version
+
+  Dir['sample*/*'].sort.each do |sample|
+    samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
+
+    cmd = "cat #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+    samples << Util.indent(`#{ cmd }`, 4) << "\n"
+
+    cmd = "ruby #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+
+    cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -I ./lib #{ sample })'"
+    samples << Util.indent(`#{ cmd } 2>&1`, 4) << "\n"
+  end
+
+  template = 
+    if test(?e, 'readme.erb')
+      Template{ IO.read('readme.erb') }
+    else
+      Template {
+        <<-__
+          NAME
+            #{ lib }
+
+          DESCRIPTION
+
+          INSTALL
+            gem install #{ lib }
+
+          SAMPLES
+            #{ samples }
+        __
+      }
+    end
+
+  open("README", "w"){|fd| fd.puts template}
+end
+
+
+task :clean do
+  Dir[File.join(This.pkgdir, '**/**')].each{|entry| Fu.rm_rf(entry)}
+end
+
+
+task :release => [:clean, :gemspec, :gem] do
+  gems = Dir[File.join(This.pkgdir, '*.gem')].flatten
+  raise "which one? : #{ gems.inspect }" if gems.size > 1
+  raise "no gems?" if gems.size < 1
+
+  cmd = "gem push #{ This.gem }"
+  puts cmd
+  puts
+  system(cmd)
+  abort("cmd(#{ cmd }) failed with (#{ $?.inspect })") unless $?.exitstatus.zero?
+
+  cmd = "rubyforge login && rubyforge add_release #{ This.rubyforge_project } #{ This.lib } #{ This.version } #{ This.gem }"
+  puts cmd
+  puts
+  system(cmd)
+  abort("cmd(#{ cmd }) failed with (#{ $?.inspect })") unless $?.exitstatus.zero?
+end
+
+
+
+
+
+BEGIN {
+# support for this rakefile
+#
+  $VERBOSE = nil
+
+  require 'ostruct'
+  require 'erb'
+  require 'fileutils'
+  require 'rbconfig'
+  require 'pp'
+
+# fu shortcut
+#
+  Fu = FileUtils
+
+# cache a bunch of stuff about this rakefile/environment
+#
+  This = OpenStruct.new
+
+  This.file = File.expand_path(__FILE__)
+  This.dir = File.dirname(This.file)
+  This.pkgdir = File.join(This.dir, 'pkg')
+
+# grok lib
+#
+  lib = ENV['LIB']
+  unless lib
+    lib = File.basename(Dir.pwd).sub(/[-].*$/, '')
+  end
+  This.lib = lib
+
+# grok version
+#
+  version = ENV['VERSION']
+  unless version
+    require "./lib/#{ This.lib }"
+    This.name = lib.capitalize
+    This.object = eval(This.name)
+    version = This.object.send(:version)
+  end
+  This.version = version
+
+# see if dependencies are export by the module
+#
+  if This.object.respond_to?(:dependencies)
+    This.dependencies = This.object.dependencies
+  end
+
+# we need to know the name of the lib an it's version
+#
+  abort('no lib') unless This.lib
+  abort('no version') unless This.version
+
+# discover full path to this ruby executable
+#
+  c = Config::CONFIG
+  bindir = c["bindir"] || c['BINDIR']
+  ruby_install_name = c['ruby_install_name'] || c['RUBY_INSTALL_NAME'] || 'ruby'
+  ruby_ext = c['EXEEXT'] || ''
+  ruby = File.join(bindir, (ruby_install_name + ruby_ext))
+  This.ruby = ruby
+
+# some utils
+#
+  module Util
+    def indent(s, n = 2)
+      s = unindent(s)
+      ws = ' ' * n
+      s.gsub(%r/^/, ws)
+    end
+
+    def unindent(s)
+      indent = nil
+      s.each_line do |line|
+      next if line =~ %r/^\s*$/
+      indent = line[%r/^\s*/] and break
+    end
+    indent ? s.gsub(%r/^#{ indent }/, "") : s
+  end
+    extend self
+  end
+
+# template support
+#
+  class Template
+    def initialize(&block)
+      @block = block
+      @template = block.call.to_s
+    end
+    def expand(b=nil)
+      ERB.new(Util.unindent(@template)).result((b||@block).binding)
+    end
+    alias_method 'to_s', 'expand'
+  end
+  def Template(*args, &block) Template.new(*args, &block) end
+
+# colored console output support
+#
+  This.ansi = {
+    :clear      => "\e[0m",
+    :reset      => "\e[0m",
+    :erase_line => "\e[K",
+    :erase_char => "\e[P",
+    :bold       => "\e[1m",
+    :dark       => "\e[2m",
+    :underline  => "\e[4m",
+    :underscore => "\e[4m",
+    :blink      => "\e[5m",
+    :reverse    => "\e[7m",
+    :concealed  => "\e[8m",
+    :black      => "\e[30m",
+    :red        => "\e[31m",
+    :green      => "\e[32m",
+    :yellow     => "\e[33m",
+    :blue       => "\e[34m",
+    :magenta    => "\e[35m",
+    :cyan       => "\e[36m",
+    :white      => "\e[37m",
+    :on_black   => "\e[40m",
+    :on_red     => "\e[41m",
+    :on_green   => "\e[42m",
+    :on_yellow  => "\e[43m",
+    :on_blue    => "\e[44m",
+    :on_magenta => "\e[45m",
+    :on_cyan    => "\e[46m",
+    :on_white   => "\e[47m"
+  }
+  def say(phrase, *args)
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    options[:color] = args.shift.to_s.to_sym unless args.empty?
+    keys = options.keys
+    keys.each{|key| options[key.to_s.to_sym] = options.delete(key)}
+
+    color = options[:color]
+    bold = options.has_key?(:bold)
+
+    parts = [phrase]
+    parts.unshift(This.ansi[color]) if color
+    parts.unshift(This.ansi[:bold]) if bold
+    parts.push(This.ansi[:clear]) if parts.size > 1
+
+    method = options[:method] || :puts
+
+    Kernel.send(method, parts.join)
+  end
+
+# always run out of the project dir
+#
+  Dir.chdir(This.dir)
+}