bbcloud 0.11.2 → 0.12.0

data/lib/bbcloud/vendor/gli/README.rdoc

@@ -0,0 +1,54 @@
+= Git-Like Interface Command Line Parser
+
+Author::  Dave Copeland (mailto:davetron5000 at g mail dot com)
+Copyright:: Copyright (c) 2010 by Dave Copeland
+License:: Distributes under the Apache License, see LICENSE.txt in the source distro
+
+This is a DSL you can use to create a command line interface like git, gem or svn, in that the first argument is a command, and there are global and command specific flags.
+
+* {Source on Github}[http://github.com/davetron5000/gli]
+* RDoc[http://davetron5000.github.com/gli]
+
+== Use
+
+Install if you need to:
+
+    gem install gli
+
+The simplest way to get started is to create a scaffold project
+
+    gli init my_proj command_name other_command_name
+
+This will create a basic scaffold project in <tt>./my_proj</tt> with:
+
+* executable in <tt>./my_proj/bin/my_proj</tt>.  This file demonstrates most of what you need to describe your command line interface.
+* an empty test in <tt>./my_proj/test/tc_nothing.rb</tt> that can bootstrap your tests
+* a gemspec shell
+* a README shell
+* Rakefile that can generate RDoc, package your Gem and run tests
+* A <tt>Gemfile</tt> suitable for use with Bundler to manage development-time dependencies
+
+== Supported Platforms
+
+Known to work on
+
+* 1.8.7
+* 1.9.2
+* Ruby Enterprise Edition 1.8.7
+* Rubinius 1.0.1
+* JRuby 1.5.2 
+
+If you're interested in other versions of Ruby, let me know, and I'll add them to my test suite
+
+== Documentation
+
+Extensive documentation is {available at the wiki}[https://github.com/davetron5000/gli/wiki].  For API Documentation, start with the GLI module.
+
+== Links
+
+* [http://davetron5000.github.com/gli] - RubyDoc
+* [http://www.github.com/davetron5000/gli] - Source on GitHub
+* [http://www.github.com/davetron5000/gli/wiki] - Documentation Wiki
+* [http://www.github.com/davetron5000/gli/wiki/Changelog] - Changelog
+
+:include:gli.rdoc

data/lib/bbcloud/vendor/gli/Rakefile

@@ -0,0 +1,84 @@
+require 'rake/clean'
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'sdoc'
+require 'grancher/task'
+require 'reek/rake/task'
+require 'roodi'
+require 'roodi_task'
+require 'cucumber'
+require 'cucumber/rake/task'
+
+CLEAN << "cruddo.rdoc"
+CLEAN << "log"
+CLOBBER << FileList['**/*.rbc']
+
+Grancher::Task.new do |g|
+  g.branch = 'gh-pages'
+  g.push_to = 'origin'
+  g.directory 'html'
+end
+
+Rake::RDocTask.new do |rd|
+  rd.main = "README.rdoc"
+  rd.rdoc_files.include("README.rdoc","lib/**/*.rb","bin/**/*")
+  rd.options << '--fmt' << 'shtml'
+  rd.template = 'direct'
+  rd.title = 'Git Like Interface'
+end
+
+spec = eval(File.read('gli.gemspec'))
+
+Rake::GemPackageTask.new(spec) do |pkg|
+end
+
+Reek::Rake::Task.new do |t|
+  t.fail_on_error = true
+  t.config_files = ['test/gli.reek']
+  t.source_files = FileList['lib/**/*.rb'] - FileList['lib/support/*.rb']
+end
+
+RoodiTask.new do |t|
+  t.patterns = ['lib/*.rb','lib/gli/*.rb']
+  t.config = 'test/roodi.yaml'
+end
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/tc_*.rb']
+end
+
+CUKE_RESULTS = 'results.html'
+CLEAN << CUKE_RESULTS
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format html -o #{CUKE_RESULTS} --format progress -x"
+  t.fork = false
+end
+
+begin
+  require 'rcov/rcovtask'
+  task :clobber_coverage do
+    rm_rf "coverage"
+  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
+rescue LoadError
+  $stderr.puts "rcov not installed; you won't be able to check code coverage"
+  $stderr.puts "Since rcov only works on MRI 1.8.7, this shouldn't be a problem"
+end
+
+desc 'Publish rdoc on github pages and push to github'
+task :publish_rdoc => [:rdoc,:publish]
+
+task :default => [:test,:features,:roodi,:reek]
+

data/lib/bbcloud/vendor/gli/bin/gli

@@ -0,0 +1,72 @@
+#!/usr/bin/env ruby
+# 1.9 adds realpath to resolve symlinks; 1.8 doesn't
+# have this method, so we add it so we get resolved symlinks
+# and compatibility
+unless File.respond_to? :realpath
+  class File #:nodoc:
+    def self.realpath path
+      return realpath(File.readlink(path)) if symlink?(path)
+      path
+    end
+  end
+end
+
+$: << File.expand_path(File.dirname(File.realpath(__FILE__)) + '/../lib') 
+
+require 'gli'
+require 'support/scaffold'
+require 'gli_version'
+
+include GLI
+
+program_desc 'gli allows you to create the scaffolding for a GLI-powered application'
+
+version GLI::VERSION
+desc 'Be verbose'
+switch :v
+
+desc 'Dry run; don''t change the disk'
+switch :n
+
+desc 'Root dir of project'
+long_desc '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'
+default_value '.'
+flag [:r,:root]
+
+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.desc 'Create an ext dir'
+  c.switch [:e,:ext]
+
+  c.desc 'Do not create a test dir'
+  c.switch [:notest]
+
+  c.desc 'Overwrite/ignore existing files and directories'
+  c.switch [:force]
+
+  c.action do |g,o,args|
+    if args.length < 1
+      raise 'You must specify the name of your project'
+    end
+    Scaffold.create_scaffold(g[:r],!o[:notest],o[:e],args[0],args[1..-1],o[:force],g[:n])
+  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
+
+exit run(ARGV)

data/lib/bbcloud/vendor/gli/bin/report_on_rake_results

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+require 'yaml'
+require 'rainbow'
+
+results = YAML::load(STDIN)
+success = results["successes"] || []
+errors = results["errors"] || []
+success.each { |ruby| puts ruby.color(:green) }
+errors.each { |ruby| puts ruby.color(:red) }
+exit -1 unless errors.empty?

data/lib/bbcloud/vendor/gli/bin/test_all_rubies.sh

@@ -0,0 +1,2 @@
+rvm 1.9.2@gli-dev,1.8.7@gli-dev,jruby@gli-dev,rbx@gli-dev,ree@gli-dev --yaml rake test | bin/report_on_rake_results
+rake clobber > /dev/null 2>&1

data/lib/bbcloud/vendor/gli/features/gli_executable.feature

@@ -0,0 +1,88 @@
+Feature: The GLI executable works as intended
+  As a developer who wants to make a GLI-powered command-line app
+  When I use the app provided by GLI
+  I get a reasonably working application
+
+  Background:
+    Given I have GLI installed
+      And my terminal size is "80x24"
+
+  Scenario Outline: Getting Help for GLI
+    When I run `gli <command>`
+    Then the exit status should be 0
+     And the output should contain:
+    """
+    usage: gli [global options] command [command options]
+
+    Version:
+    """
+     And the output should contain:
+    """
+    Global Options:
+        -n             - Dry run; dont change the disk
+        -r, --root=arg - Root dir of project (default: .)
+        -v             - Be verbose
+
+    Commands:
+        help           - Shows list of commands or help for one command
+        init, scaffold - Create a new GLI-based project
+    """
+
+    Examples:
+    |command|
+    |       |
+    |help   |
+
+
+  Scenario Outline: Getting help on scaffolding
+    When I run `gli help <command>`
+    Then the exit status should be 0
+     And the output should contain exactly:
+    """
+    init [command options] project_name [command[ command]*]
+        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
+
+    Command Options:
+        -e, --ext - Create an ext dir
+        --force   - Overwrite/ignore existing files and directories
+        --notest  - Do not create a test dir
+
+    """
+
+    Examples:
+      |command  |
+      |init     |
+      |scaffold |
+
+
+  Scenario: GLI correctly identifies non-existent command
+    When I run `gli foobar`
+    Then the exit status should not be 0
+     And the output should contain exactly:
+     """
+     error: Unknown command 'foobar'. Use 'gli help' for a list of commands
+
+     """
+
+  Scenario: GLI correctly identifies non-existent global flag
+    When I run `gli -q help`
+    Then the exit status should not be 0
+     And the output should contain exactly:
+     """
+     error: Unknown option -q. Use 'gli help' for a list of global options
+
+     """
+
+  Scenario: GLI correctly identifies non-existent command flag
+    When I run `gli init -q`
+    Then the exit status should not be 0
+     And the output should contain exactly:
+     """
+     error: Unknown option -q. Use 'gli help init' for a list of command options
+
+     """

data/lib/bbcloud/vendor/gli/features/gli_init.feature

@@ -0,0 +1,122 @@
+Feature: The scaffold GLI generates works
+  As a developer who wants to make a GLI-powered command-line app
+  When I generate a GLI-powered app
+  Things work out of the box
+
+  Background:
+    Given I have GLI installed
+      And GLI's libs are in my path
+      And my terminal size is "80x24"
+
+  Scenario: Scaffold generates and things look good
+    When I run `gli init todo add complete list`
+    Then the exit status should be 0
+     And the output should contain exactly:
+    """
+    Creating dir ./todo/lib...
+    Creating dir ./todo/bin...
+    Creating dir ./todo/test...
+    Created ./todo/bin/todo
+    Created ./todo/README.rdoc
+    Created ./todo/todo.rdoc
+    Created ./todo/todo.gemspec
+    Created ./todo/test/tc_nothing.rb
+    Created ./todo/Rakefile
+    Created ./todo/Gemfile
+    Created ./todo/lib/todo_version.rb
+
+    """
+     And the following directories should exist:
+       |todo      |
+       |todo/bin  |
+       |todo/test |
+       |todo/lib  |
+     And the following files should exist:
+       |todo/bin/todo            |
+       |todo/README.rdoc         |
+       |todo/todo.rdoc           |
+       |todo/todo.gemspec        |
+       |todo/test/tc_nothing.rb  |
+       |todo/Rakefile            |
+       |todo/Gemfile             |
+       |todo/lib/todo_version.rb |
+    When I cd to "todo"
+     And I run `bin/todo`
+    Then the output should contain:
+    """
+    usage: todo [global options] command [command options]
+    
+    Version: 0.0.1
+    
+    Global Options:
+        -f, --flagname=The name of the argument - Describe some flag here (default: 
+                                                  the default)
+        -s, --switch                            - Describe some switch here
+    
+    Commands:
+        add      - Describe add here
+        complete - Describe complete here
+        help     - Shows list of commands or help for one command
+        list     - Describe list here
+
+    """
+    When I run `bin/todo help add`
+    Then the output should contain:
+    """
+    add [command options] Describe arguments to add here
+        Describe add here
+
+    Command Options:
+        -f arg - Describe a flag to add (default: default)
+        -s     - Describe a switch to add
+    """
+    When I run `rake test`
+    Then the output should contain:
+    """
+    Started
+    .
+    """
+    And the output should contain:
+    """
+
+    1 tests, 1 assertions, 0 failures, 0 errors
+    """
+    When I run `bin/todo rdoc`
+    Then the file "todo.rdoc" should contain "todo [global options] command_name [command-specific options] [--] arguments..."
+     And the file "todo.rdoc" should contain "[<tt>add</tt>] Describe add here"
+     And the file "todo.rdoc" should contain "[<tt>complete</tt>] Describe complete here"
+     And the file "todo.rdoc" should contain "[<tt>list</tt>] Describe list here"
+
+      @debug
+  Scenario: Scaffold generates and respects flags to create ext dir and avoid test dir
+    When I run `gli init -e --notest todo add complete list`
+    Then the exit status should be 0
+     And the output should contain exactly:
+    """
+    Creating dir ./todo/lib...
+    Creating dir ./todo/bin...
+    Creating dir ./todo/ext...
+    Created ./todo/bin/todo
+    Created ./todo/README.rdoc
+    Created ./todo/todo.rdoc
+    Created ./todo/todo.gemspec
+    Created ./todo/Rakefile
+    Created ./todo/Gemfile
+    Created ./todo/lib/todo_version.rb
+
+    """
+     And the following directories should exist:
+       |todo      |
+       |todo/bin  |
+       |todo/ext  |
+       |todo/lib  |
+     And the following directories should not exist:
+       |todo/test|
+     And the following files should exist:
+       |todo/bin/todo            |
+       |todo/README.rdoc         |
+       |todo/todo.rdoc           |
+       |todo/todo.gemspec        |
+       |todo/Rakefile            |
+       |todo/Gemfile             |
+       |todo/lib/todo_version.rb |

data/lib/bbcloud/vendor/gli/features/step_definitions/gli_executable_steps.rb

@@ -0,0 +1,12 @@
+Given /^I have GLI installed$/ do
+end
+
+Given /^my terminal size is "([^"]*)"$/ do |terminal_size|
+  if terminal_size =~/^(\d+)x(\d+)$/
+    ENV['COLUMNS'] = $1
+    ENV['LINES'] = $2
+  else
+    raise "Terminal size should be COLxLines, e.g. 80x24" 
+  end
+end
+