gli 2.9.0 → 2.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: d1fffe3ab7b8b3aa4881cfb38de3b7cc1e31508b
-  data.tar.gz: 057ab9061b13527ed56f448cc20ee3ea54a7472d
+SHA256:
+  metadata.gz: f99bcd6fc563c75307924a23694720c7a5a68d0957afbb7b25fb15e21257011c
+  data.tar.gz: 9e508b67d421593391c447f3778c90df01565f36e5db41cab83fce806bdc6417
 SHA512:
-  metadata.gz: c61409e0f16a9d07d9e4f704e05890e48868dc359be530dd2c094d3856a841b224968c1f2902b761355ad3ff2574ab8e9a33af626ceb77e897e3a2dfa17a3580
-  data.tar.gz: 3f26ab6c6026483c986241c506fdf1742a43408eac52605aa7ba2c5a36076f1d48acba70fbba5031b649fc042043d2cdf112ebc175cf9afeb35b49821fd15979
+  metadata.gz: bbfbd6572090c9a8b86ae7e165cbb3b12d5500fa3dda114bb1add6375ea32864e38b0857d29ba399deb3f45250d655ec61c6acb78d8c5bc9172c1e0eebfa0d20
+  data.tar.gz: 8ad9e606b644c9374a616cfd0d013ffc90909851d77f0b96fc366debb274e55698388e749756318db2437d23a640f4118459ada89b8d1ca1e035f507576611ff

data/.circleci/config.yml

@@ -0,0 +1,28 @@
+version: 2.1
+orbs:
+  # See https://circleci.com/developer/orbs/orb/circleci/ruby
+  ruby: circleci/ruby@1.1.2
+jobs:                # keyword
+  test:              # my name for the job
+    parameters:      # keyword
+      ruby-version:  # my parameter name
+        type: string # type is a keyword
+    docker:          # keyword
+      - image: cimg/base:stable
+    steps:                                       # keyword
+      - checkout                                 # magic name
+      - ruby/install:                            # ruby/ is from the orb name, install is a command in that orb
+          version: << parameters.ruby-version >> # magic nonsense for param subst (version param to the command)
+      - run:
+          command: "bin/setup"
+      - run:
+          command: "bin/ci"
+workflows:              # keyword
+  all-rubies:           # my name for the workflow
+    jobs:               # keyword
+      - test:           # my name for the job
+          matrix:       # keyword
+            parameters: # keyword
+              # All rubies being maintained per this page:
+              # https://www.ruby-lang.org/en/downloads/branches/
+              ruby-version: [ "2.5", "2.6", "2.7", "3.0" ]

data/.gitignore

@@ -5,9 +5,9 @@ pkg
 coverage
 .bundle
 tmp
-cruddo.rdoc
-gli.wiki
 Gemfile.lock
+*.gem
 results.html
-.rbx
 .DS_Store
+Session.vim
+scaffold_test

data/.tool-versions

@@ -0,0 +1 @@
+ruby 2.7.1

data/Gemfile

@@ -2,7 +2,5 @@ source 'https://rubygems.org'
 
 gemspec
 
-gem "rcov", ">= 0.9.8", :platforms => :mri_18
 gem "simplecov", "~> 0.6.4", :platforms => :mri_19
 gem "psych", :platforms => :mri_19
-

data/README.rdoc

@@ -1,16 +1,24 @@
-= Git-Like Interface Command Line Parser
+= GLI, the Git-Like Interface Command Line Parser
 
-GLI is the best way to make a "command-suite" command-line application, e.g. one like <tt>git</tt> (for the best way to make a
-simpler command-line application, check out methadone[http://www.github.com/davetron5000/methadone]).
-
-GLI allows you to make a very polished, easy-to-maintain command-line application without a lot
-of syntax, but without restricting you in any way from the power of +OptionParser+.
+GLI allows you to create command-line app in Ruby that behaves like <tt>git</tt> in that it takes subcommands to perform a series of complex action, e.g. <tt>git remote add</tt>.
 
 * {Overview}[http://davetron5000.github.com/gli]
 * {Source on Github}[http://github.com/davetron5000/gli]
 * RDoc[http://davetron5000.github.com/gli/rdoc/index.html]
 
-{<img src="https://secure.travis-ci.org/davetron5000/gli.png?branch=gli-2" alt="Build Status" />}[https://travis-ci.org/davetron5000/gli]
+{<img src="https://secure.travis-ci.org/davetron5000/gli.svg?branch=gli-2" alt="Build Status" />}[https://travis-ci.org/davetron5000/gli]
+
+== What Problem does GLI Solve?
+
+Creating a command-line app that uses subcommands, each of which might accept different command-line options, is somewhat difficult with Ruby's built-in <tt>OptionParser</tt>.  GLI provides an API that wraps <tt>OptionParser</tt> so that you can create a subcommand-based command-line app with minimal boilerplate. This API also produces complete documentation for your command-line app.
+
+== Why is GLI's solution different from others?
+
+There are other RubyGems that allow you to create a command-line app that takes subcommands.  These solutions are often quite limited (e.g. they don't allow deeply nested subcommand structures or sophisticated command-line options per subcommand), or require more code that we think is needed. Some solutions make it difficult or impossible to properly document your command-line  app.
+
+== What you need to know to use GLI
+
+You should know Ruby, and have a basic understanding of how the UNIX command line works: standard input, standard output, standard error, and exit codes.
 
 == Use
 
@@ -18,15 +26,26 @@ Install if you need to:
 
     gem install gli
 
+You can validate you have installed it correctly by running <tt>gli help</tt>. You should see formatted help output.
+
+If you are using GLI in another application, add it to your <tt>Gemfile</tt>:
+
+    gem "gli"
+
+You can test your install via Bundler by running <tt>bundle exec gli help</tt>. This should produce formatted help output from GLI.
+
+== Getting Started
+
 The simplest way to get started is to create a scaffold project
 
     gli init todo list add complete
 
+(note if you installed via Bundler you will need to execute <tt>bundle exec gli init todo list add complete</tt>)
+
 This will create a basic scaffold project in <tt>./todo</tt> with:
 
 * executable in <tt>./todo/bin/todo</tt>.  This file demonstrates most of what you need to describe your command line interface.
 * an empty test in <tt>./todo/test/default_test.rb</tt> that can bootstrap your tests
-* an empty feature in <tt>./todo/features/todo.feature</tt> that can bootstrap testing your CLI via Aruba.
 * a gemspec shell
 * a README shell
 * Rakefile that can generate RDoc, package your Gem and run tests
@@ -73,17 +92,9 @@ Get a more detailed walkthrough on the {main site}[http://davetron5000.github.co
 
 == Supported Platforms
 
-Known to work on
-
-* 1.8.7
-* 1.9.2
-* 1.9.3
-* 2.0.0
-* Ruby Enterprise Edition 1.8.7
-* Rubinius 1.0.1
-* JRuby 1.6.4 
+See `.circleci/config.yml` for the supported rubies, but general we're running tests on the all MRI rubies receiving support, which tends to be the most recent four versions.
 
-If you're interested in other versions of Ruby, let me know, and I'll add them to my test suite
+GLI should work on older Rubies and JRuby, but it's too much work to keep tests passing for those.
 
 == Documentation
 

data/Rakefile

@@ -3,8 +3,6 @@ require 'bundler'
 require 'rake/clean'
 require 'rake/testtask'
 require 'rdoc/task'
-require 'cucumber'
-require 'cucumber/rake/task'
 
 include Rake::DSL
 
@@ -75,48 +73,28 @@ end
 
 Bundler::GemHelper.install_tasks
 
-desc 'run unit tests'
-Rake::TestTask.new do |t|
+desc "run unit tests"
+Rake::TestTask.new("test:unit") do |t|
   t.libs << "test"
-  t.test_files = FileList['test/init_simplecov.rb','test/tc_*.rb']
+  t.libs << "lib"
+  t.test_files = FileList["test/unit/**/*_test.rb"]
 end
 
-CUKE_RESULTS = 'results.html'
-CLEAN << CUKE_RESULTS
-Cucumber::Rake::Task.new(:features) do |t|
-  opts = "features --format html -o #{CUKE_RESULTS} --format progress -x"
-  opts += " --tags #{ENV['TAGS']}" if ENV['TAGS']
-  t.cucumber_opts =  opts
-  t.fork = false
-end
-Cucumber::Rake::Task.new('features:wip') do |t|
-  tag_opts = ' --tags ~@pending'
-  tag_opts = ' --tags @wip'
-  t.cucumber_opts = "features --format html -o #{CUKE_RESULTS} --format pretty -x -s#{tag_opts}"
-  t.fork = false
-end
-
-begin
-  require 'rcov/rcovtask'
-  task :clobber_coverage do
-    rm_rf "coverage"
+desc "run integration tests"
+Rake::TestTask.new("test:integration") do |t|
+  t.libs << "test"
+  explicitly_named_files = ARGV[1..-1]
+  if Array(explicitly_named_files).size == 0
+    t.test_files = FileList["test/integration/**/*_test.rb"]
+  else
+    t.test_files = explicitly_named_files
   end
+end
 
-  desc 'Measures test coverage'
-  task :coverage => :rcov do
-    puts "coverage/index.html contains what you need"
-  end
 
-  Rcov::RcovTask.new do |t|
-    t.libs << 'lib'
-    t.test_files = FileList['test/tc_*.rb']
-  end
+begin
+  require 'simplecov'
 rescue LoadError
-  begin
-    require 'simplecov'
-  rescue LoadError
-    $stderr.puts "neither rcov nor simplecov are installed; you won't be able to check code coverage"
-  end
 end
 
 desc 'Publish rdoc on github pages and push to github'

data/bin/ci

@@ -0,0 +1,29 @@
+#!/bin/bash
+
+set -e
+if [ -z $1 ]; then
+  echo "[bin/ci] Running with default warnings"
+  export RUBYOPT=
+else
+  if [ $1 == 'warnings' ]; then
+    echo "[bin/ci] Running with all warnings on"
+    export RUBYOPT=-w
+  else
+    if [ $1 == 'none' ]; then
+      echo "[bin/ci] Running with all warnings off"
+      export RUBYOPT='-W0'
+    else
+      echo "[bin/ci] '$1' is not a supported option"
+      echo "[bin/ci] usage: $0          # run with default warnings"
+      echo "[bin/ci] usage: $0 warnings # run with all warnings"
+      echo "[bin/ci] usage: $0 none     # run with warnings disabled"
+      exit 1
+    fi
+  fi
+fi
+
+echo "[bin/ci] Running unit tests"
+bin/rake test:unit
+
+echo "[bin/ci] Running integration tests"
+bin/rake test:integration

data/bin/gli

@@ -1,59 +1,29 @@
 #!/usr/bin/env ruby
-
-require 'gli'
-require 'gli/commands/scaffold'
-
-include GLI::App
-
-program_desc 'create scaffolding for a GLI-powered application'
-
-version GLI::VERSION
-
-switch :v, :desc => 'Be verbose'
-
-switch :n, :desc => 'Dry run; don''t change the disk'
-
-desc 'Root dir of project'
-long_desc <<EOS
-This is the directory where the project''s directory will be made, so if you 
-specify a project name ''foo'' and the root dir of ''.'', the directory 
-''./foo'' will be created'
-EOS
-
-flag :r,:root, :default_value => '.'
-
-desc 'Create a new GLI-based project'
-long_desc <<EOS
-This will create a scaffold command line project that uses GLI
-for command line processing.  Specifically, this will create
-an executable ready to go, as well as a lib and test directory, all
-inside the directory named for your project
-EOS
-arg_name 'project_name [command[ command]*]'
-command [:init,:scaffold] do |c|
-
-  c.switch :e,:ext, :desc => 'Create an ext dir'
-
-  c.switch :notest, :desc => 'Do not create a test or features dir', :negatable => false
-
-  c.switch :force, :desc => 'Overwrite/ignore existing files and directories'
-
-  c.switch :rvmrc, :desc => 'Create an .rvmrc based on your current RVM setup'
-
-  c.action do |g,o,args|
-    if args.length < 1
-      raise 'You must specify the name of your project'
-    end
-    GLI::Commands::Scaffold.create_scaffold(g[:r],!o[:notest],o[:e],args[0],args[1..-1],o[:force],g[:n],o[:rvmrc])
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'gli' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
   end
 end
 
-pre do |global,command,options,args|
-  puts "Executing #{command.name}" if global[:v]
-  true
-end
+require "rubygems"
+require "bundler/setup"
 
-post do |global,command,options,args|
-  puts "Executed #{command.name}" if global[:v]
-end
-exit run(ARGV)
+load Gem.bin_path("gli", "gli")

data/bin/rake

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/bin/setup

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+set -e
+
+bundle check || bundle install

data/exe/gli

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+
+require 'gli'
+require 'gli/commands/scaffold'
+
+class App
+  extend GLI::App
+
+  program_desc 'create scaffolding for a GLI-powered application'
+
+  version GLI::VERSION
+
+  # Can't use these without changing the current behavior of gli
+  # arguments :strict
+  # subcommand_option_handling :normal
+
+  switch :v, :desc => 'Be verbose'
+
+  switch :n, :desc => 'Dry run; don''t change the disk'
+
+  desc 'Root dir of project'
+long_desc <<EOS
+  This is the directory where the project''s directory will be made, so if you
+  specify a project name ''foo'' and the root dir of ''.'', the directory
+  ''./foo'' will be created'
+EOS
+
+  flag :r,:root, :default_value => '.'
+
+  desc 'Create a new GLI-based project'
+long_desc <<EOS
+  This will create a scaffold command line project that uses GLI
+  for command line processing.  Specifically, this will create
+  an executable ready to go, as well as a lib and test directory, all
+  inside the directory named for your project
+EOS
+  arg :project_name
+  arg :command_name, [:optional, :multiple]
+  arg_name "project_name [command_name]..."
+  command [:init,:scaffold] do |c|
+
+    c.switch :e,:ext, :desc => 'Create an ext dir'
+
+    c.switch :notest, :desc => 'Do not create a test or features dir', :negatable => false
+
+    c.switch :force, :desc => 'Overwrite/ignore existing files and directories'
+
+    c.switch :rvmrc, :desc => 'Create an .rvmrc based on your current RVM setup'
+
+    c.action do |g,o,args|
+      if args.length < 1
+        raise 'You must specify the name of your project'
+      end
+      GLI::Commands::Scaffold.create_scaffold(g[:r],!o[:notest],o[:e],args[0],args[1..-1],o[:force],g[:n],o[:rvmrc])
+    end
+  end
+
+  pre do |global,command,options,args|
+    puts "Executing #{command.name}" if global[:v]
+    true
+  end
+
+  post do |global,command,options,args|
+    puts "Executed #{command.name}" if global[:v]
+  end
+end
+
+exit App.run(ARGV)

data/gli.gemspec

@@ -1,34 +1,30 @@
 # Make sure we get the gli that's local
-require File.join([File.dirname(__FILE__),'lib','gli','version.rb'])
+require File.join([File.dirname(__FILE__),"lib","gli","version.rb"])
 
-spec = Gem::Specification.new do |s| 
-  s.name = 'gli'
+spec = Gem::Specification.new do |s|
+  s.name = "gli"
   s.version = GLI::VERSION
-  s.author = 'David Copeland'
-  s.email = 'davidcopeland@naildrivin5.com'
-  s.homepage = 'http://davetron5000.github.com/gli'
+  s.licenses = ["Apache-2.0"]
+  s.author = "David Copeland"
+  s.email = "davidcopeland@naildrivin5.com"
+  s.homepage = "http://davetron5000.github.com/gli"
   s.platform = Gem::Platform::RUBY
-  s.summary = 'Build command-suite CLI apps that are awesome.'
-  s.description = 'Build command-suite CLI apps that are awesome.  Bootstrap your app, add commands, options and documentation while maintaining a well-tested idiomatic command-line app'
+  s.summary = "Build command-suite CLI apps that are awesome."
+  s.description = "Build command-suite CLI apps that are awesome.  Bootstrap your app, add commands, options and documentation while maintaining a well-tested idiomatic command-line app"
 
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables   =  'gli'
   s.require_paths = ["lib"]
 
-  s.has_rdoc = true
-  s.extra_rdoc_files = ['README.rdoc', 'gli.rdoc']
-  s.rdoc_options << '--title' << 'Git Like Interface' << '--main' << 'README.rdoc'
-  s.bindir = 'bin'
-  s.rubyforge_project = 'gli'
-  s.add_development_dependency('rake', '~> 0.9.2.2')
-  s.add_development_dependency('rdoc', '~> 3.11')
-  s.add_development_dependency('rainbow', '~> 1.1.1')
-  s.add_development_dependency('clean_test')
-  s.add_development_dependency('cucumber', '1.2.3')
-  s.add_development_dependency('gherkin', '<= 2.11.6')
-  s.add_development_dependency('aruba', '0.5.1') # 0.5.3 randomly breaks with "LaunchError: no such file or directory" and only sometimes.
-  s.add_development_dependency('sdoc')
-  s.add_development_dependency('faker','1.0.0')
-end
+  s.extra_rdoc_files = ["README.rdoc", "gli.rdoc"]
+  s.rdoc_options << "--title" << "Git Like Interface" << "--main" << "README.rdoc"
+
+  s.bindir      = "exe"
+  s.executables = "gli"
 
+  s.add_development_dependency("rake", "~> 0.9.2.2")
+  s.add_development_dependency("rdoc", "~> 4.2")
+  s.add_development_dependency("rainbow", "~> 1.1", "~> 1.1.1")
+  s.add_development_dependency("sdoc", "~> 0.4")
+  s.add_development_dependency("minitest")
+end

data/gli.rdoc

@@ -1,6 +1,6 @@
 == gli - create scaffolding for a GLI-powered application
 
-v2.2.1
+v2.19.2
 
 === Global Options
 === -r|--root arg
@@ -8,9 +8,9 @@ v2.2.1
 Root dir of project
 
 [Default Value] .
-This is the directory where the project''s directory will be made, so if you 
-specify a project name ''foo'' and the root dir of ''.'', the directory 
-''./foo'' will be created'
+This is the directory where the project''s directory will be made, so if you
+  specify a project name ''foo'' and the root dir of ''.'', the directory
+  ''./foo'' will be created'
 
 === --help
 Show this message
@@ -28,7 +28,7 @@ Be verbose
 
 
 === --version
-
+Display the program version
 
 
 
@@ -43,13 +43,13 @@ List commands one per line, to assist with shell completion
 
 
 
-==== Command: <tt>init|scaffold  project_name [command[ command]*]</tt>
+==== Command: <tt>init|scaffold  project_name [command_name]...</tt>
 Create a new GLI-based project
 
 This will create a scaffold command line project that uses GLI
-for command line processing.  Specifically, this will create
-an executable ready to go, as well as a lib and test directory, all
-inside the directory named for your project
+  for command line processing.  Specifically, this will create
+  an executable ready to go, as well as a lib and test directory, all
+  inside the directory named for your project
 ===== Options
 ===== -e|--[no-]ext
 Create an ext dir

data/lib/gli/app.rb

@@ -30,7 +30,7 @@ module GLI
     #     # loads *.rb files from the user's home dir - great and an extension/plugin mechanism
     #     commands_from File.join(ENV["HOME"],".my_app","plugins")
     def commands_from(path)
-      if Pathname.new(path).absolute? and File.exists?(path)
+      if Pathname.new(path).absolute? and File.exist?(path)
         load_commands(path)
       else
         $LOAD_PATH.each do |load_path|
@@ -62,6 +62,17 @@ module GLI
       @program_long_desc
     end
 
+    # Provide a flag to choose whether to hide or not from the help the undescribed commands.
+    # By default the undescribed commands will be shown in the help.
+    #
+    # hide:: A Bool for hide the undescribed commands
+    def hide_commands_without_desc(hide=nil)
+      unless hide.nil?
+        @hide_commands_without_desc = hide
+      end
+      @hide_commands_without_desc || false
+    end
+
     # Use this if the following command should not have the pre block executed.
     # By default, the pre block is executed before each command and can result in
     # aborting the call.  Using this will avoid that behavior for the following command
@@ -83,7 +94,7 @@ module GLI
       @skips_around = true
     end
 
-    # Sets that this app uses a config file as well as the name of the config file.  
+    # Sets that this app uses a config file as well as the name of the config file.
     #
     # +filename+:: A String representing the path to the file to use for the config file.  If it's an absolute
     #              path, this is treated as the path to the file.  If it's *not*, it's treated as relative to the user's home
@@ -141,7 +152,7 @@ module GLI
     # Define a block to run if an error occurs.
     # The block will receive any Exception that was caught.
     # It should evaluate to false to avoid the built-in error handling (which basically just
-    # prints out a message). GLI uses a variety of exceptions that you can use to find out what 
+    # prints out a message). GLI uses a variety of exceptions that you can use to find out what
     # errors might've occurred during command-line parsing:
     # * GLI::CustomExit
     # * GLI::UnknownCommandArgument
@@ -154,7 +165,7 @@ module GLI
 
     # Indicate the version of your application
     #
-    # +version+:: String containing the version of your application.  
+    # +version+:: String containing the version of your application.
     def version(version)
       @version = version
       desc 'Display the program version'
@@ -180,7 +191,7 @@ module GLI
     end
 
     # Configure a type conversion not already provided by the underlying OptionParser.
-    # This works more or less like the OptionParser version.
+    # This works more or less like the OptionParser version. It's global.
     #
     # object:: the class (or whatever) that triggers the type conversion
     # block:: the block that will be given the string argument and is expected
@@ -190,7 +201,7 @@ module GLI
     #
     #     accept(Hash) do |value|
     #       result = {}
-    #       value.split(/,/) do |pair|
+    #       value.split(/,/).each do |pair|
     #         k,v = pair.split(/:/)
     #         result[k] = v
     #       end
@@ -202,7 +213,7 @@ module GLI
       accepts[object] = block
     end
 
-    # Simpler means of exiting with a custom exit code.  This will 
+    # Simpler means of exiting with a custom exit code.  This will
     # raise a CustomExit with the given message and exit code, which will ultimatley
     # cause your application to exit with the given exit_code as its exit status
     # Use #help_now! if you want to show the help in addition to the error message
@@ -280,10 +291,33 @@ module GLI
       @subcommand_option_handling_strategy = handling_strategy
     end
 
+    # How to handle argument validation.
+    #
+    # handling_strategy:: One of:
+    #                     +:loose+:: no argument validation.  Use of `arg` or `arg_name` is for documentation purposes only.  (Default)
+    #                     +:strict+:: arguments are validated according to their specification.  +action+ blocks may assume
+    #                                 the value of `arguments` matches the specification provided in `arg`.  Note that to use
+    #                                 this strategy, you must also be sure that +subcommand_option_handling+ is set.
+    def arguments(handling_strategy)
+      @argument_handling_strategy = handling_strategy
+    end
+
+
+    # Enables/Disables command autocomplete, where partially spelled commands are automatically expanded to their full form
+    #
+    # Example:
+    # When enabled, executing 'shake' would execute 'shake_hand' (if no 'shake' command is defined).
+    # When disabled, executing 'shake' would throw an UnknownCommand error
+    #
+    # +boolean+:: Boolean value to enable or disable autocomplete, respectively. True by default.
+    def autocomplete_commands(boolean)
+      @autocomplete = boolean
+    end
+
     private
 
     def load_commands(path)
-      if File.exists? path
+      if File.exist? path
         Dir.entries(path).sort.each do |entry|
           file = File.join(path,entry)
           if file =~ /\.rb$/