clio 0.0.1 → 0.2.0

data/spec/commandline/subclass.rd

@@ -0,0 +1,54 @@
+= Test Subclass of Subclass of Command
+
+Require clio/commandline.rb.
+
+  require 'clio/commandline'
+  $0 = 'c0'
+
+Create new subclass of Clio::Commandline.
+
+  @cmd_super = Class.new(Clio::Commandline) do
+    option('o0')
+    command('c1').option('o1')
+    command('c1 c2').option('o2')
+    command('c1 c2').argument('a')
+    command('c1 c2').argument('b')
+    command('c1 c2').argument('c')
+  end
+
+Superclass command display usage string.
+
+  @cmd_super.usage.to_s.assert == 'c0 [--o0] c1 [--o1] c2 [--o2] <a> <b> <c>'
+
+Subclass again.
+
+  @cmd = Class.new(@cmd_super)
+
+Command display usage string.
+
+  @cmd.usage.to_s.assert == 'c0 [--o0] c1 [--o1] c2 [--o2] <a> <b> <c>'
+
+Command initializes.
+
+  @cli = @cmd.new('--o0 c1 --o1 c2 --o2 a b c')
+
+Command is inheritable.
+
+  @cmd2 = Class.new(@cmd)
+
+Inherited command works like parent.
+
+  @cli2 = @cmd2.new('--o0 c1 --o1 c2 --o2 a b c')
+  @cli2.parse
+
+Inherited command parsed correctly.
+
+  @cli2.options.assert == {:o0=>true, :o1=>true, :o2=>true}
+
+Method missing options work.
+
+  @cli2.o0?.assert == true
+  @cli2.o1?.assert == true
+  @cli2.o2?.assert == true
+
+QED.

data/spec/string/unit.rd

@@ -0,0 +1,58 @@
+= Clio::String
+
+Require the Clio String library.
+
+    require 'clio/string'
+
+Define a fest regular strings.
+
+    @s1 = "Hi how are you."
+    @s2 = "Fine thanks."
+
+Define the equivalent Clio strings.
+
+    @c1 = Clio.string("Hi how are you.")
+    @c2 = Clio.string("Fine thanks.")
+
+Applying #color apps the red ANSI code.
+
+    r = @c1.color(:red)
+    e = Clio::ANSICode.red(@s1)
+    e.assert == r.to_s
+
+non-in-place delegation
+
+    r = @c1.upcase
+    e = @s1.upcase
+    e.assert == r.to_s
+
+string addition
+
+    r = @c1 + @c2
+    e = @s1 + @s2
+    e.assert == r.to_s
+
+string single index
+
+    r = @c1[0]
+    e = @s1[0,1]
+    e.assert == r.to_s
+
+string size index
+
+    r = @c1[0,3]
+    e = @s1[0,3]
+    e.assert == r.to_s
+
+string range index
+
+    r = @c1[0..3]
+    e = @s1[0..3]
+    e.assert == r.to_s
+
+Method #sub can replace a substring.
+
+    r = @c1.sub('Hi', 'Hello')
+
+QED.
+

data/spec/usage/define.rd

@@ -0,0 +1,44 @@
+= Usage Definition
+
+Require commandline library.
+
+  require 'clio/usage'
+  $0 = 'test'
+
+Create a Usage object.
+
+  usage = Clio::Usage.new
+
+Handles a command definition using #command.
+
+  usage = Clio::Usage.new
+  usage.command('foo')
+  usage.to_s.assert == 'test foo'
+
+Handles a command definition using #[].
+
+  #usage = Clio::Usage.new
+  #usage['foo']
+  #usage.to_s.assert == 'test foo'
+
+Handles a toplevel switch/option using #option.
+
+  usage = Clio::Usage.new
+  usage.option('verbose?')
+  usage.to_s.assert == 'test [--verbose]'
+
+Handles a toplevel switch/option with aliases using #option.
+
+  usage = Clio::Usage.new
+  usage.option(:verbose?, :v)
+  usage.to_s.assert == 'test [-v --verbose]'
+
+An option and a subcommand.
+
+  usage = Clio::Usage.new
+  usage.opt('--verbose -v')
+  usage.command('foo')
+  usage.to_s.assert == 'test [-v --verbose] foo'
+
+QED.
+

data/spec/usage/parse.rd

@@ -0,0 +1,47 @@
+= Usage Parsing
+
+Require usage library.
+
+  require 'clio/usage'
+
+A single toplevel option.
+
+  usage = Clio::Usage.new
+  usage.option('force')
+  cli = usage.parse('--force')
+
+  cli.options.assert == {:force=>true}
+
+A single toplevel option with an alias.
+
+  usage = Clio::Usage.new
+  usage.option('force', 'f')
+  cli = usage.parse('-f')
+
+  cli.options.assert == {:force=>true}
+
+A subcommand.
+
+  usage = Clio::Usage.new
+  usage.command('foo')
+  cli = usage.parse('foo')
+
+  cli.command.assert == 'foo'
+  cli.commands.assert == ['foo']
+
+A subcommand with an option.
+
+  usage = Clio::Usage.new
+  usage.command('foo')
+  usage.command('foo').option('verbose')
+  cli = usage.parse('foo --verbose')
+
+  cli.command.assert == 'foo'
+  cli.commands.assert == ['foo']
+  cli.options.assert == {:verbose=>true}
+
+  cli[0].options.assert == {}
+  cli[1].options.assert == {:verbose=>true}
+
+QED.
+

metadata

@@ -1,29 +1,20 @@
 --- !ruby/object:Gem::Specification 
 name: clio
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.2.0
 platform: ruby
-authors: []
-
+authors: 
+- 7rans <transfire@gmail.com>
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2008-09-03 00:00:00 -04:00
+date: 2008-11-15 00:00:00 -05:00
 default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: facets
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 2.4.4
-    version: 
-description: Clio makes commandline interfaces easy.
-email: 
+dependencies: []
+
+description: Clio makes commandline interfaces easy. It provides both commandline parsing as well as console output routines.
+email: transfire@gmail.com
 executables: []
 
 extensions: []
@@ -31,193 +22,72 @@ extensions: []
 extra_rdoc_files: 
 - README
 - MANIFEST
-- HISTORY
-- METADATA
-- NEWS
+- CHANGES
+- RELEASE
+- VERSION
 - COPYING
 files: 
-- vendor
-- vendor/Console
-- vendor/Console/doc
-- vendor/Console/doc/fr_file_index.html
-- vendor/Console/doc/classes
-- vendor/Console/doc/classes/Win32
-- vendor/Console/doc/classes/Win32/Console
-- vendor/Console/doc/classes/Win32/Console/ANSI.html
-- vendor/Console/doc/classes/Win32/Console/Constants.html
-- vendor/Console/doc/classes/Win32/Console/API.html
-- vendor/Console/doc/classes/Win32/Console/ANSI
-- vendor/Console/doc/classes/Win32/Console/ANSI/IO.src
-- vendor/Console/doc/classes/Win32/Console/ANSI/IO.src/M000037.html
-- vendor/Console/doc/classes/Win32/Console/ANSI/IO.src/M000035.html
-- vendor/Console/doc/classes/Win32/Console/ANSI/IO.src/M000036.html
-- vendor/Console/doc/classes/Win32/Console/ANSI/IO.src/M000038.html
-- vendor/Console/doc/classes/Win32/Console/ANSI/IO.html
-- vendor/Console/doc/classes/Win32/Console/API.src
-- vendor/Console/doc/classes/Win32/Console/API.src/M000047.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000052.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000066.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000069.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000041.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000073.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000063.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000076.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000046.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000050.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000039.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000080.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000048.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000071.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000072.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000062.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000079.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000078.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000060.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000057.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000044.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000058.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000067.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000053.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000068.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000055.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000049.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000065.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000064.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000045.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000075.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000070.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000077.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000059.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000051.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000040.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000043.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000056.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000061.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000042.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000054.html
-- vendor/Console/doc/classes/Win32/Console/API.src/M000074.html
-- vendor/Console/doc/classes/Win32/Console.html
-- vendor/Console/doc/classes/Win32/Console.src
-- vendor/Console/doc/classes/Win32/Console.src/M000030.html
-- vendor/Console/doc/classes/Win32/Console.src/M000031.html
-- vendor/Console/doc/classes/Win32/Console.src/M000002.html
-- vendor/Console/doc/classes/Win32/Console.src/M000014.html
-- vendor/Console/doc/classes/Win32/Console.src/M000019.html
-- vendor/Console/doc/classes/Win32/Console.src/M000017.html
-- vendor/Console/doc/classes/Win32/Console.src/M000033.html
-- vendor/Console/doc/classes/Win32/Console.src/M000028.html
-- vendor/Console/doc/classes/Win32/Console.src/M000020.html
-- vendor/Console/doc/classes/Win32/Console.src/M000009.html
-- vendor/Console/doc/classes/Win32/Console.src/M000015.html
-- vendor/Console/doc/classes/Win32/Console.src/M000029.html
-- vendor/Console/doc/classes/Win32/Console.src/M000005.html
-- vendor/Console/doc/classes/Win32/Console.src/M000001.html
-- vendor/Console/doc/classes/Win32/Console.src/M000003.html
-- vendor/Console/doc/classes/Win32/Console.src/M000021.html
-- vendor/Console/doc/classes/Win32/Console.src/M000011.html
-- vendor/Console/doc/classes/Win32/Console.src/M000006.html
-- vendor/Console/doc/classes/Win32/Console.src/M000013.html
-- vendor/Console/doc/classes/Win32/Console.src/M000010.html
-- vendor/Console/doc/classes/Win32/Console.src/M000012.html
-- vendor/Console/doc/classes/Win32/Console.src/M000032.html
-- vendor/Console/doc/classes/Win32/Console.src/M000034.html
-- vendor/Console/doc/classes/Win32/Console.src/M000025.html
-- vendor/Console/doc/classes/Win32/Console.src/M000008.html
-- vendor/Console/doc/classes/Win32/Console.src/M000022.html
-- vendor/Console/doc/classes/Win32/Console.src/M000004.html
-- vendor/Console/doc/classes/Win32/Console.src/M000027.html
-- vendor/Console/doc/classes/Win32/Console.src/M000026.html
-- vendor/Console/doc/classes/Win32/Console.src/M000007.html
-- vendor/Console/doc/classes/Win32/Console.src/M000018.html
-- vendor/Console/doc/classes/Win32/Console.src/M000023.html
-- vendor/Console/doc/classes/Win32/Console.src/M000024.html
-- vendor/Console/doc/classes/Win32/Console.src/M000016.html
-- vendor/Console/doc/classes/Win32.html
-- vendor/Console/doc/rdoc-style.css
-- vendor/Console/doc/files
-- vendor/Console/doc/files/Console_rdoc.html
-- vendor/Console/doc/files/lib
-- vendor/Console/doc/files/lib/Win32
-- vendor/Console/doc/files/lib/Win32/Console
-- vendor/Console/doc/files/lib/Win32/Console/ANSI_rb.html
-- vendor/Console/doc/files/lib/Win32/Console_rb.html
-- vendor/Console/doc/files/Console_ANSI_rdoc.html
-- vendor/Console/doc/files/Console_cpp.html
-- vendor/Console/doc/fr_class_index.html
-- vendor/Console/doc/index.html
-- vendor/Console/doc/created.rid
-- vendor/Console/doc/fr_method_index.html
-- vendor/Console/test
-- vendor/Console/test/test_readinput.rb
-- vendor/Console/test/test_mouse.rb
-- vendor/Console/test/test_write.rb
-- vendor/Console/test/test_sendevent.rb
-- vendor/Console/test/test_cursor.rb
-- vendor/Console/test/test_readoutput.rb
-- vendor/Console/test/test_title.rb
-- vendor/Console/INSTALL.txt
-- vendor/Console/README.txt
-- vendor/Console/Console_ANSI.rdoc
-- vendor/Console/Console.cpp
-- vendor/Console/HISTORY.txt
-- vendor/Console/Makefile
-- vendor/Console/lib
-- vendor/Console/lib/Win32
-- vendor/Console/lib/Win32/Console
-- vendor/Console/lib/Win32/Console/ANSI.rb
-- vendor/Console/lib/Win32/Console.rb
-- vendor/Console/lib/Term
-- vendor/Console/lib/Term/ansicolor.rb
-- vendor/Console/extconf.rb
-- vendor/Console/Console.rdoc
-- doc
-- doc/book
-- MANIFEST
-- test
-- test/test_command.rb
-- test/test_commandline.rb
-- README
-- HISTORY
-- METADATA
+- bin
 - lib
+- meta
+- spec
+- CHANGES
+- RELEASE
+- README
+- VERSION
+- COPYING
 - lib/clio
+- lib/clio/facets
+- lib/clio/usage
 - lib/clio/commandline.rb
-- lib/clio/command.rb
-- lib/clio/runmode.rb
 - lib/clio/ansicode.rb
 - lib/clio/commandable.rb
+- lib/clio/layout
 - lib/clio/consoleutils.rb
+- lib/clio/buffer.rb
 - lib/clio/errors.rb
-- lib/clio/option.rb
+- lib/clio/usage.rb
+- lib/clio/layout.rb
 - lib/clio/progressbar.rb
 - lib/clio/string.rb
-- data
-- NEWS
-- bin
-- admin
-- admin/web
-- admin/temps
-- admin/temps/lib
-- admin/temps/lib/clio
-- admin/temps/lib/clio/about.rb.erb
-- admin/config
-- admin/config/reap.yaml
-- admin/depot
-- admin/depot/commandline.rb
-- admin/depot/test_multicommand.rb
-- admin/depot/multicommand.rb
-- admin/share
-- admin/share/sow
-- admin/share/reap
-- admin/share/reap/example.rb
-- admin/pack
-- admin/pack/clio-0.0.1.gem
-- admin/log
-- admin/log/notes.xml
-- admin/log/stats.html
-- admin/log/syntax.log
-- admin/log/testunit.log
-- COPYING
+- lib/clio/facets/kernel.rb
+- lib/clio/facets/string.rb
+- lib/clio/usage/main.rb
+- lib/clio/usage/signature.rb
+- lib/clio/usage/command.rb
+- lib/clio/usage/parser.rb
+- lib/clio/usage/argument.rb
+- lib/clio/usage/interface.rb
+- lib/clio/usage/option.rb
+- lib/clio/layout/list.rb
+- lib/clio/layout/flow.rb
+- lib/clio/layout/stack.rb
+- lib/clio/layout/split.rb
+- lib/clio/layout/table.rb
+- lib/clio/layout/line.rb
+- meta/created
+- meta/repository
+- meta/homepage
+- meta/summary
+- meta/abstract
+- meta/license
+- meta/authors
+- spec/usage
+- spec/commandline
+- spec/string
+- spec/commandable
+- spec/usage/define.rd
+- spec/usage/parse.rd
+- spec/commandline/bracket.rd
+- spec/commandline/subclass.rd
+- spec/commandline/completion.rd
+- spec/commandline/define.rd
+- spec/commandline/autousage.rd
+- spec/commandline/method.rd
+- spec/commandline/parse.rd
+- spec/commandline/scenario.rd
+- spec/string/unit.rd
+- MANIFEST
 has_rdoc: true
 homepage: http://clio.rubyforge.org
 post_install_message: 
@@ -248,6 +118,5 @@ rubygems_version: 1.2.0
 signing_key: 
 specification_version: 2
 summary: Clio makes commandline interfaces easy.
-test_files: 
-- test/test_command.rb
-- test/test_commandline.rb
+test_files: []
+