quickl 0.1.1 → 0.2.0

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+# 0.2.0 / 2011-01-10
+
+* Enhancements
+
+  * Command#run now takes a (optional) second argument (get it at command runtime via :requester reader)
+  * Renamed Delegate -> Delegator (Quickl::Delegate is kept but should not be used anymore)
+  * Added IOAccessError with default reaction to Exit
+  * Added valid_read_file! robustness utility
+  * Moved to rspec 2.4.0, modified Rakefile and tests accordingly  
+
 # 0.1.1 / 2010-12-24
 
 * Fixed gemspec and binaries problems

data/README.md

@@ -36,10 +36,10 @@ Running them as simply as:
 
     SimpleCommand.run(ARGV)
     
-From simple command to complex delegate (_ala_ 'git [--version] [--help] COMMAND [cmd options] ARGS...'), Quickl provides (or aims at providing) the following features:
+From simple command to complex delegator (_ala_ 'git [--version] [--help] COMMAND [cmd options] ARGS...'), Quickl provides (or aims at providing) the following features:
 
 * Simple command creations via simple classes
-* Delegate commands and categories via ruby namespaces and naming conventions
+* Delegator commands and categories via ruby namespaces and naming conventions
 * Command help and documentation provided through _rdoc_
 * Command options via standard OptionParser
 * Error handling trought special blocks, assertions methods and dedicated Error classes
@@ -70,7 +70,7 @@ Try this:
 Additional examples (see examples folder):
 
 * [hello world example](https://github.com/blambeau/quickl/blob/master/examples/hello_world)
-* [delegate example](https://github.com/blambeau/quickl/blob/master/examples/delegate)
+* [delegator example](https://github.com/blambeau/quickl/blob/master/examples/delegator)
 
 ## Version policy
 
@@ -81,8 +81,8 @@ Until version 1.0.0, moditications of public interfaces increase the minor versi
     
 Public interfaces are:
 
-* Quickl::Command and Quickl::Delegate calls
-* DSL methods used in "subclasses" built by Quickl::Command and Quickl::Delegate
+* Quickl::Command and Quickl::Delegator calls
+* DSL methods used in "subclasses" built by Quickl::Command and Quickl::Delegator
 * RDoc -> command line documentation recognizers (synopsis, overview, documentation, ...)
 * Naming conventions (module <-> command conversions)
 * Default reactions to errors (Quickl::Help, Quickl::Exit, ...)

data/Rakefile

@@ -1,9 +1,9 @@
 # -*- ruby -*-
-$here = File.dirname(__FILE__)
 require 'rubygems'
 require "rake/testtask"
-require 'spec/rake/spectask'
+require "rspec/core/rake_task"
 require "yard"
+require "rake/gempackagetask"
 
 task :default => :test
 task :test    => [:spec, :examples]
@@ -11,7 +11,7 @@ task :test    => [:spec, :examples]
 # About yard documentation
 YARD::Rake::YardocTask.new do |t|
   t.files   = ['lib/**/*.rb', 'examples/**/*.rb']
-  t.options = ['--output-dir', 'doc/api', '-', "README.md", "HISTORY.md"]
+  t.options = ['--output-dir', 'doc/api', '-', "README.md", "CHANGELOG.md"]
 end
 
 desc "Lauches unit tests on examples"
@@ -21,44 +21,17 @@ Rake::TestTask.new(:examples) do |test|
   test.verbose    =  true
 end
 
-desc "Run all rspec test"
-Spec::Rake::SpecTask.new(:spec) do |t|
-  t.ruby_opts = ['-I.', '-Ilib', '-Itest']
-  t.spec_files = Dir["#{$here}/test/**/*.spec"]
+desc "Run all examples"
+RSpec::Core::RakeTask.new(:spec) do |t|
+	t.rspec_opts = %w[--color]
+	t.verbose = false
 end
 
-# PACKAGING & INSTALLATION ####################################################
-# Largely inspired from the Citrus project
-
-if defined?(Gem)
-  $spec = eval("#{File.read('quickl.gemspec')}")
-
-  directory 'dist'
-
-  def package(ext='')
-    "dist/#{$spec.name}-#{$spec.version}" + ext
-  end
-
-  file package('.gem') => %w< dist > + $spec.files do |f|
-    sh "gem build quickl.gemspec"
-    mv File.basename(f.name), f.name
-  end
-
-  file package('.tar.gz') => %w< dist > + $spec.files do |f|
-    sh "git archive --format=tar HEAD | gzip > #{f.name}"
-  end
-
-  desc "Build packages"
-  task :package => %w< .gem .tar.gz >.map {|e| package(e) }
+desc "Create the .gem package"
+$spec = Kernel.eval(File.read(File.expand_path('../quickl.gemspec', __FILE__)))
+Rake::GemPackageTask.new($spec) do |pkg|
+	pkg.need_tar = true
+end
 
-  desc "Build and install as local gem"
-  task :install => package('.gem') do |t|
-    sh "gem install #{package('.gem')}"
-  end
 
-  desc "Upload gem to rubygems.org"
-  task :release => package('.gem') do |t|
-    sh "gem push #{package('.gem')}"
-  end
-end
 # vim: syntax=ruby

data/bin/quickl

@@ -113,4 +113,4 @@ class Quickl::Main < Quickl::Command(__FILE__, __LINE__)
   end
   
 end # class Quickl::Command::Main
-Quickl::Main.run(ARGV)
+Quickl::Main.run(ARGV, __FILE__)

data/examples/{delegate → delegator}/README.md

@@ -1,14 +1,14 @@
-# Quickl example: delegate
+# Quickl example: delegator
 
-This example shows how to delegate commands. Delegate commands are command
+This example shows how to create delegator commands. Delegators are commands
 that delegate the actual execution to sub commands (well known example is
-'git'). A delegate command typically has a signature like:
+'git'). A delegator command typically has a signature like:
 
-    delegate [main options] COMMAND [cmd options] ARGS...
+    delegator [main options] COMMAND [cmd options] ARGS...
 
 ## Structure
 
-The structure for delegate commands is as follows:
+The structure for delegator commands is as follows:
 
     #
     # Main command overview
@@ -27,7 +27,7 @@ The structure for delegate commands is as follows:
     #
     # See '#{command_name} help COMMAND' for more information on a specific command.
     #
-    class DelegateCommand < Quickl::Delegate(__FILE__, __LINE__)
+    class DelegatorCommand < Quickl::Delegator(__FILE__, __LINE__)
     
       # install options below
       options do |opt|
@@ -60,26 +60,26 @@ The structure for delegate commands is as follows:
     
     # To run the command, typically in a bin/simple_command 
     # shell file
-    DelegateCommand.run(ARGV)
+    DelegatorCommand.run(ARGV)
     
 
 ## Example
 
 Try the following:
 
-    ./delegate 
+    ./delegator
     # => [ ... complete help with subcommands summary ... ]
     
-    ./delegate --help
+    ./delegator --help
     # => [ ... complete help with subcommands summary ... ]
     
-    ./delegate help 
+    ./delegator help 
     # => [ ... complete help with subcommands summary ... ]
     
-    ./delegate help hello-world 
+    ./delegator help hello-world 
     # => [ ... help of hello-world's subcommand ... ]
 
-    ./delegate hello-world bob
+    ./delegator hello-world bob
     # => Hello bob!
     
     ./hello_world --capitalize bob

data/examples/{delegate/bin/delegate → delegator/bin/delegator}

@@ -3,7 +3,7 @@ require File.expand_path('../../../helper', __FILE__)
 
 # Load the delegate tool
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
-require "delegate"
+require "delegator"
 
 # Run the command
-Delegate.run(ARGV)
+Delegator.run(ARGV, __FILE__)

data/examples/{delegate/lib/delegate.rb → delegator/lib/delegator.rb}

@@ -11,12 +11,12 @@
 # #{summarized_subcommands}
 #
 # DESCRIPTION
-#   This example shows how to write a delegate command, that is, a
+#   This example shows how to write a delegator command, that is, a
 #   command which delegates to a subcommand
 #
 # See '#{program_name} help COMMAND' for more information on a specific command.
 #
-class Delegate < Quickl::Delegate(__FILE__, __LINE__)
+class Delegator < Quickl::Delegator(__FILE__, __LINE__)
 
   # Single command version
   VERSION = "0.1.0"
@@ -36,6 +36,6 @@ class Delegate < Quickl::Delegate(__FILE__, __LINE__)
 
   end
 
-end # class Delegate
+end # class Delegator
 require "help"
 require "hello_world"

data/examples/{delegate → delegator}/lib/hello_world.rb

@@ -1,4 +1,4 @@
-class Delegate
+class Delegator
   #
   # Say hello 
   #
@@ -36,4 +36,4 @@ class Delegate
     end
   
   end # class HelloWorld
-end # class Delegate
+end # class Delegator

data/examples/{delegate → delegator}/lib/help.rb

@@ -1,4 +1,4 @@
-class Delegate
+class Delegator
   # 
   # Show help about a specific command
   #
@@ -21,4 +21,4 @@ class Delegate
     end
     
   end # class Help
-end # class Delegate
+end # class Delegator

data/examples/{delegate/test/delegate_test.rb → delegator/test/delegator_test.rb}

@@ -7,9 +7,9 @@ rescue LoadError
   require 'quickl'
 end
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
-require 'delegate'
+require 'Delegator'
 
-class DelegateTest < Test::Unit::TestCase
+class DelegatorTest < Test::Unit::TestCase
 
   def assert_exits(match, exit_code)  
     yield
@@ -21,8 +21,8 @@ class DelegateTest < Test::Unit::TestCase
   
   def run_command(*args)
     $stdout = StringIO.new
-    Delegate.no_react_to(Quickl::Exit)
-    Delegate.run args
+    Delegator.no_react_to(Quickl::Exit)
+    Delegator.run args
     $stdout.string
   ensure
     $stdout = STDOUT

data/examples/hello/hello

@@ -53,5 +53,5 @@ class Hello < Quickl::Command(__FILE__, __LINE__)
 end # class Hello
 
 if __FILE__ == $0
-  Hello.run(ARGV)
+  Hello.run(ARGV, __FILE__)
 end

data/lib/quickl.rb

@@ -6,7 +6,7 @@ require 'quickl/command'
 module Quickl
 
   # Quickl's VERSION
-  VERSION = '0.1.1'.freeze
+  VERSION = '0.2.0'.freeze
   
   # Quickl's COPYRIGHT info 
   COPYRIGHT = "(c) 2010, Bernard Lambeau"

data/lib/quickl/command.rb

@@ -72,8 +72,8 @@ module Quickl
       end
       
       # Runs the command
-      def run(*args)
-        self.new.run(*args)
+      def run(argv = [], requester = nil)
+        self.new.run(argv, requester)
       end
       
       ############################################### Error handling 
@@ -100,7 +100,10 @@ module Quickl
     
     # Methods installed on all command instances
     module InstanceMethods
-
+      
+      # Who is requesting command execution?
+      attr_reader :requester
+      
       # Delegate unrecognized calls to the command class
       # (gives access to options, help, usage, ...)
       def method_missing(name, *args, &block)
@@ -132,7 +135,8 @@ module Quickl
       # This method is intended to be overriden and does nothing
       # by default.
       #
-      def run(argv)
+      def run(argv, requester = nil)
+        @requester = requester
         _run(argv)
       rescue Quickl::Error => ex
         handle_error(ex)
@@ -151,4 +155,4 @@ require 'quickl/command/builder'
 require 'quickl/command/robustness'
 require 'quickl/command/options'
 require 'quickl/command/single'
-require 'quickl/command/delegate'
+require 'quickl/command/delegator'

data/lib/quickl/command/{delegate.rb → delegator.rb}

@@ -1,7 +1,7 @@
 module Quickl
-  module Command::Delegate
+  module Command::Delegator
     module InstanceMethods
-    
+     
       # Run the command by delegation
       def _run(argv = [])
         # My own options
@@ -13,7 +13,7 @@ module Quickl
       
         # Run the subcommand now
         if cmd = argv.shift
-          has_command!(cmd).run(argv)
+          cmd = has_command!(cmd).run(argv, self)
         else
           raise Quickl::Help.new(cmd.nil? ? 0 : -1)
         end
@@ -36,18 +36,23 @@ module Quickl
       end
       
     end
-  end # module Command::Delegate
+  end # module Command::Delegator
   
   #
-  # Create a delegate command
+  # Create a delegator command
   #
-  def self.Delegate(*args)
+  def self.Delegator(*args)
     command_builder do |b|
       b.document *args
-      b.class_module    Command::Delegate::ClassMethods
-      b.instance_module Command::Delegate::InstanceMethods
+      b.class_module    Command::Delegator::ClassMethods
+      b.instance_module Command::Delegator::InstanceMethods
     end
     Command
   end
   
+  # @see Delegator
+  def self.Delegate(*args)
+    self.Delegator(*args)
+  end
+  
 end # module Quickl

data/lib/quickl/command/robustness.rb

@@ -13,6 +13,18 @@ module Quickl
         raise NoSuchCommand, "No such command #{name}", ex.backtrace
       end
       
+      # Checks that _file_ is a readable file or raises an error.
+      # Returns _file_ on success.
+      def valid_read_file!(file, error_class = nil, msg = nil)
+        if File.file?(file) and File.readable?(file)
+          file
+        else
+          error_class ||= Quickl::IOAccessError
+          msg ||= "Not a file or not readable: #{file}"
+          raise error_class, msg, caller
+        end
+      end
+      
     end # module Robustness
   end # class Command
 end # module Quickl

data/lib/quickl/command/single.rb

@@ -11,10 +11,10 @@ module Quickl
       execute(parse_options(argv))
     end
     
-  end # module Command::Delegate
+  end # module Command::Single
   
   #
-  # Create a delegate command
+  # Create a single command
   #
   def self.Command(*args)
     command_builder do |b|

data/lib/quickl/errors.rb

@@ -173,7 +173,7 @@ module Quickl
   
   # 
   # This error can be raised to indicate that a command has not been
-  # found (typically by delegates).
+  # found (typically by delegators).
   #
   # Default exit code:
   #   -1
@@ -193,4 +193,26 @@ module Quickl
     
   end # class NoSuchCommand
   
+  #
+  # This error can be raised to indicate that some file/dir 
+  # access has failed.
+  #
+  # Default exit code:
+  #   -1
+  #
+  # Default reaction:
+  #   raise Exit.new(code), message, backtrace
+  #
+  class IOAccessError < Error
+
+    def initialize(*args)
+      super(*(args + [ -1 ]))
+    end
+    
+    def react!
+      raise Exit.new(self.exit_code), self.message, backtrace
+    end
+    
+  end # class IOAccessError
+  
 end # module Quickl

data/quickl.gemspec

@@ -23,12 +23,13 @@ Gem::Specification.new do |s|
     Dir['test/**/*'] +
     %w{ quickl.gemspec Rakefile README.md CHANGELOG.md }
 
-  s.test_files = s.files.select {|path| path =~ /^test\/.*_test.rb/ }
-
   s.bindir = "bin"
   s.executables = ["quickl"]
 
   s.add_development_dependency('rake')
+  s.add_development_dependency('rspec', ">= 2.4.0")
+  s.add_development_dependency('yard', ">= 0.6.4")
+  s.add_development_dependency('bluecloth', ">= 0.6.4")
 
   s.has_rdoc = true
   s.rdoc_options = %w< --line-numbers --inline-source --title Quickl --main Quickl >

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: quickl
 version: !ruby/object:Gem::Version 
-  hash: 25
   prerelease: false
   segments: 
   - 0
-  - 1
-  - 1
-  version: 0.1.1
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Bernard Lambeau
@@ -15,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-24 00:00:00 +01:00
+date: 2011-01-10 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -26,12 +25,56 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
         segments: 
         - 0
         version: "0"
   type: :development
   version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 4
+        - 0
+        version: 2.4.0
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 4
+        version: 0.6.4
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: bluecloth
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 4
+        version: 0.6.4
+  type: :development
+  version_requirements: *id004
 description: Generate Ruby command line apps quickly
 email: blambeau@gmail.com
 executables: 
@@ -42,7 +85,7 @@ extra_rdoc_files:
 - README.md
 files: 
 - lib/quickl/command/builder.rb
-- lib/quickl/command/delegate.rb
+- lib/quickl/command/delegator.rb
 - lib/quickl/command/options.rb
 - lib/quickl/command/robustness.rb
 - lib/quickl/command/single.rb
@@ -52,36 +95,18 @@ files:
 - lib/quickl/naming.rb
 - lib/quickl/ruby_tools.rb
 - lib/quickl.rb
-- examples/delegate/bin/delegate
-- examples/delegate/lib/delegate.rb
-- examples/delegate/lib/hello_world.rb
-- examples/delegate/lib/help.rb
-- examples/delegate/README.md
-- examples/delegate/test/delegate_test.rb
+- examples/delegator/bin/delegator
+- examples/delegator/lib/delegator.rb
+- examples/delegator/lib/hello_world.rb
+- examples/delegator/lib/help.rb
+- examples/delegator/README.md
+- examples/delegator/test/delegator_test.rb
 - examples/hello/hello
 - examples/hello/hello_test.rb
 - examples/hello/README.md
 - examples/helper.rb
 - templates/single.erb
 - bin/quickl
-- test/command/command_name.spec
-- test/command/documentation.spec
-- test/command/overview.spec
-- test/command/run.spec
-- test/command/subcommands.spec
-- test/command/usage.spec
-- test/mini_client.rb
-- test/naming/command2module.spec
-- test/naming/module2command.spec
-- test/ruby_tools/class_unqualified_name.spec
-- test/ruby_tools/extract_file_rdoc.spec
-- test/ruby_tools/fixtures/RubyTools.rdoc
-- test/ruby_tools/fixtures/Utils.rdoc
-- test/ruby_tools/fixtures.rb
-- test/ruby_tools/optional_args_block_call.spec
-- test/ruby_tools/parent_module.spec
-- test/spec_helper.rb
-- test/wrapping.rb
 - quickl.gemspec
 - Rakefile
 - README.md
@@ -105,7 +130,6 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
@@ -114,7 +138,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"

data/test/command/command_name.spec

@@ -1,16 +0,0 @@
-require File.expand_path('../../spec_helper', __FILE__)
-module Quickl
-  describe "Command::command_name /" do
-    
-    it "should be installed from inline rdoc" do
-      MiniClient::Say::Hello.command_name.should == "hello"
-      MiniClient::Say::Goodbye.command_name.should == "goodbye"
-    end
-    
-    it "should be accessible on instance" do
-      MiniClient::Say::Hello.new.command_name.should == "hello"
-      MiniClient::Say::Goodbye.new.command_name.should == "goodbye"
-    end
-
-  end # Command::command_name
-end # module Quickl

data/test/command/documentation.spec

@@ -1,23 +0,0 @@
-$hello_doc = <<EOF
-
-Say hello to the user whose name is requested on the standard input
-
-SYNOPSIS
-  mini-client say:hello
-
-DESCRIPTION
-  And an explanation here
-  on multiple lines with replacement: hello
-
-EOF
-
-require File.expand_path('../../spec_helper', __FILE__)
-module Quickl
-  describe "Command::documentation /" do
-    
-    it "should be correctly installed" do
-      MiniClient::Say::Hello.documentation.should == $hello_doc[0..-1]
-    end
-
-  end # Command::command
-end # module Quickl

data/test/command/overview.spec

@@ -1,14 +0,0 @@
-require File.expand_path('../../spec_helper', __FILE__)
-module Quickl
-  describe "Command::overview /" do
-    
-    it "should be installed from inline rdoc" do
-      MiniClient::Help.overview.should == "Print help"
-    end
-
-    it "should be installed accessible on instance" do
-      MiniClient::Help.new.overview.should == "Print help"
-    end
-
-  end # Command::overview
-end # module Quickl

data/test/command/run.spec

@@ -1,22 +0,0 @@
-require File.expand_path('../../spec_helper', __FILE__)
-module Quickl
-  describe "Command::run /" do
-    
-    it "when invoked on a terminal command" do
-      MiniClient::Say::Hello.run.should == :hello
-      MiniClient::Say::Goodbye.run.should == :goodbye
-    end
-
-    it "when invoked on a delegate command" do
-      MiniClient.run(["help"]).should == :help
-      MiniClient::Say.run(["hello"]).should == :hello
-      MiniClient::Say.run(["goodbye"]).should == :goodbye
-    end
-
-    it "when invoked on qualified command names" do
-      MiniClient.run(["say:hello"]).should == :hello
-      MiniClient.run(["say:goodbye"]).should == :goodbye
-    end
-
-  end # Command::command
-end # module Quickl

data/test/command/subcommands.spec

@@ -1,20 +0,0 @@
-require File.expand_path('../../spec_helper', __FILE__)
-module Quickl
-  describe "Command::subcommands /" do
-    
-    it "should return installed commands in an array" do
-      MiniClient.subcommands.should == [ 
-        MiniClient::Help, 
-        MiniClient::Say 
-      ]
-    end
-    
-    it "should return installed commands in an array" do
-      MiniClient::Say.subcommands.should == [ 
-        MiniClient::Say::Hello,
-        MiniClient::Say::Goodbye
-      ]
-    end
-
-  end # Command::subcommand
-end # module Quickl

data/test/command/usage.spec

@@ -1,16 +0,0 @@
-require File.expand_path('../../spec_helper', __FILE__)
-module Quickl
-  describe "Command::usage /" do
-    
-    it "should be installed from inline rdoc" do
-      MiniClient::Say::Hello.usage.should == "mini-client say:hello"
-      MiniClient::Say::Goodbye.usage.should == "mini-client say:goodbye"
-    end
-    
-    it "should be accessible on instance" do
-      MiniClient::Say::Hello.new.usage.should == "mini-client say:hello"
-      MiniClient::Say::Goodbye.new.usage.should == "mini-client say:goodbye"
-    end
-
-  end # Command::usage
-end # module Quickl

data/test/mini_client.rb

@@ -1,59 +0,0 @@
-#
-# MiniClient main command
-#
-class MiniClient < Quickl::Delegate(__FILE__, __LINE__)
-    
-  #
-  # Print help
-  #
-  # SYNOPSIS
-  #   #{MiniClient.command_name} help
-  #
-  # DESCRIPTION
-  #   #{command_name} prints help
-  #
-  class Help < Quickl::Command(__FILE__, __LINE__)
-
-    def run(*args)
-      :help
-    end
-      
-  end # class Help
-  
-  class Say < Quickl::Delegate(__FILE__, __LINE__)
-
-    #
-    # Say hello to the user whose name is requested on the standard input
-    #
-    # SYNOPSIS
-    #   #{MiniClient.command_name} say:hello
-    #
-    # DESCRIPTION
-    #   And an explanation here
-    #   on multiple lines with replacement: #{command_name}
-    #
-    class Hello < Quickl::Command(__FILE__, __LINE__)
-      
-      def run(*args)
-        :hello
-      end
-      
-    end # class Hello
-
-    #
-    # Say goodbye to the currently connected user
-    #
-    # SYNOPSIS
-    #   #{MiniClient.command_name} say:goodbye
-    #
-    class Goodbye < Quickl::Command(__FILE__, __LINE__)
-
-      def run(*args)
-        :goodbye
-      end
-      
-    end # class Goodbye
-
-  end # class Say
-    
-end # module MiniClient

data/test/naming/command2module.spec

@@ -1,17 +0,0 @@
-require File.expand_path('../../spec_helper', __FILE__)
-module Quickl
-  describe "Naming::command2module /" do
-    include Naming
-    
-    it "should capitalize first char" do
-      command2module("say").should == "Say"
-      command2module(:say).should == :Say
-    end
-
-    it "should capitalize support dashes" do
-      command2module("say-hello").should == "SayHello"
-      command2module(:"say-hello").should == :SayHello
-    end
-    
-  end # module Quickl
-end # module Quickl

data/test/naming/module2command.spec

@@ -1,21 +0,0 @@
-require File.expand_path('../../spec_helper', __FILE__)
-module Quickl
-  describe "Naming::module2command /" do
-    include Naming
-    
-    it "should uncapitalize first char" do
-      module2command("Say").should == "say"
-      module2command(:Say).should == :say
-    end
-
-    it "should uncapitalize and introduce dashes" do
-      module2command("SayHello").should == "say-hello"
-      module2command(:"SayHello").should == :"say-hello"
-    end
-    
-    it "should support taking modules as argument" do
-      module2command(Quickl::Command).should == "command"
-    end
-    
-  end # module Quickl
-end # module Quickl

data/test/ruby_tools/class_unqualified_name.spec

@@ -1,28 +0,0 @@
-require File.expand_path('../fixtures', __FILE__)
-module Quickl
-  describe "RubyTools#class_unqualified_name /" do
-  
-    subject{ RubyTools::class_unqualified_name(clazz) }
-  
-    describe "when called on unqualified class" do
-      let(:clazz){ ::String }
-      it{ should == "String" }
-    end
-  
-    describe "when called on qualified class" do
-      let(:clazz){ RubyTools }
-      it{ should == "RubyTools" }
-    end
-  
-    describe "when called on long qualified class" do
-      let(:clazz){ Quickl::Fixtures::Utils }
-      it{ should == "Utils" }
-    end
-  
-    describe "when piped with parent_module" do
-      let(:clazz){ RubyTools::parent_module(Quickl::Fixtures::Utils) }
-      it{ should == "Fixtures" }
-    end
-
-  end
-end

data/test/ruby_tools/extract_file_rdoc.spec

@@ -1,28 +0,0 @@
-require File.expand_path('../fixtures', __FILE__)
-module Quickl
-  describe "RubyTools#extract_file_rdoc /" do
-    
-    let(:file){ File.expand_path('../fixtures.rb', __FILE__) }
-    
-    describe "when used without line and reverse options" do
-
-      subject{ RubyTools::extract_file_rdoc(file) }
-  
-      it "should be as expected" do
-        subject.should == File.read(File.expand_path('../fixtures/RubyTools.rdoc', __FILE__))
-      end
-
-    end
-    
-    describe "when used with line and reverse options" do
-
-      subject{ RubyTools::extract_file_rdoc(file, 23, true) }
-  
-      it "should be as expected" do
-        subject.should == File.read(File.expand_path('../fixtures/Utils.rdoc', __FILE__))
-      end
-
-    end
-  
-  end # RubyTools#extract_file_rdoc
-end # module Quickl

data/test/ruby_tools/fixtures.rb

@@ -1,27 +0,0 @@
-require File.expand_path('../../spec_helper', __FILE__)
-module Quickl
-  module Fixtures
-
-    #
-    # This is a fixtures helper that matches documentation conventions.
-    #
-    # This is a second paragraph
-    # That append on two lines
-    #
-    #
-    # WARNING:
-    #   This kind of indentation should not be interpreted as code
-    #
-    #   But this one yes
-    #
-    module RubyTools
-    end # module RubyTools
-    
-    #
-    # This is the documentation of the Utils module
-    #
-    module Utils
-    end # module Utils
-
-  end # module Fixtures
-end # module Quickl

data/test/ruby_tools/fixtures/RubyTools.rdoc

@@ -1,12 +0,0 @@
-
-This is a fixtures helper that matches documentation conventions.
-
-This is a second paragraph
-That append on two lines
-
-
-WARNING:
-  This kind of indentation should not be interpreted as code
-
-  But this one yes
-

data/test/ruby_tools/fixtures/Utils.rdoc

@@ -1,3 +0,0 @@
-
-This is the documentation of the Utils module
-

data/test/ruby_tools/optional_args_block_call.spec

@@ -1,37 +0,0 @@
-require File.expand_path('../fixtures', __FILE__)
-module Quickl
-  describe "RubyTools#optional_args_block_call /" do
-  
-    subject{ RubyTools::optional_args_block_call(block, args) }
-  
-    describe "when block has no arguments /" do
-      let(:block){ lambda {
-        "ok"
-      } }
-
-      describe "when no args are given" do
-        let(:args){ [ ] } 
-        it { should == "ok" }
-      end
-
-      describe "when no args are given" do
-        let(:args){ [ "hello" ] } 
-        it { should == "ok" }
-      end
-
-    end
-  
-    describe "when block has one arguments /" do
-      let(:block){ lambda {|name|
-        name
-      } }
-
-      describe "when args are given" do
-        let(:args){ [ "hello" ] } 
-        it { should == "hello" }
-      end
-
-    end
-  
-  end
-end

data/test/ruby_tools/parent_module.spec

@@ -1,23 +0,0 @@
-require File.expand_path('../fixtures', __FILE__)
-module Quickl
-  describe "RubyTools#parent_module /" do
-  
-    subject{ RubyTools::parent_module(clazz) }
-  
-    describe "when called on unqualified class" do
-      let(:clazz){ ::String }
-      it{ should be_nil }
-    end
-  
-    describe "when called on qualified class" do
-      let(:clazz){ RubyTools }
-      it{ should == Quickl }
-    end
-  
-    describe "when called on long qualified class" do
-      let(:clazz){ Quickl::Fixtures::Utils }
-      it{ should == Quickl::Fixtures }
-    end
-  
-  end
-end

data/test/spec_helper.rb

@@ -1,13 +0,0 @@
-dir = File.dirname(__FILE__)
-$LOAD_PATH.unshift "#{dir}/../lib"
-
-require 'rubygems'
-require 'spec'
-require 'spec/autorun'
-require 'pp'
-require 'fileutils'
-require 'quickl'
-require 'mini_client'
-
-Spec::Runner.configure do |config|
-end

data/test/wrapping.rb

@@ -1,39 +0,0 @@
-$LOAD_PATH.unshift('../../lib', __FILE__)
-require "quickl"
-$wrappers = []
-
-def wrap(filter, &block)
-  $wrappers << [ filter, block ]
-end
-
-def build_wrapper(command, filter, continuation)
-  lambda{|cont|
-    if !filter || command.instance_eval(&filter)
-      command.instance_exec(continuation, &b)
-    else
-      continuation.call
-    end
-  }
-end
-
-def execute(command, &block)
-  first = build_wrapper(command, *$wrappers.first)
-  c = $wrappers[1..-1].inject(first){|cont,wrapper|
-    build_wrapper(command, *wrapper)
-  }
-  c.call(block)
-end
-
-wrap(lambda{ true }){|cont|
-  puts "wrap 1"
-  cont.call
-  puts "end wrap 1"
-}
-wrap(lambda{ true }){|cont|
-  puts "wrap 2"
-  cont.call
-  puts "end wrap 2"
-}
-execute(self){
-  puts "hello"
-}