puppet-module 0.3.0

data/vendor/thor-852190ae/spec/fixtures/task.thor

@@ -0,0 +1,10 @@
+# module: random
+
+class Amazing < Thor
+  desc "describe NAME", "say that someone is amazing"
+  method_options :forcefully => :boolean
+  def describe(name, opts)
+    ret = "#{name} is amazing"
+    puts opts["forcefully"] ? ret.upcase : ret
+  end
+end

data/vendor/thor-852190ae/spec/group_spec.rb

@@ -0,0 +1,171 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Thor::Group do
+  describe "#start" do
+    it "invokes all the tasks under the Thor group" do
+      MyCounter.start(["1", "2", "--third", "3"]).must == [ 1, 2, 3 ]
+    end
+
+    it "uses argument default value" do
+      MyCounter.start(["1", "--third", "3"]).must == [ 1, 2, 3 ]
+    end
+
+    it "invokes all the tasks in the Thor group and his parents" do
+      BrokenCounter.start(["1", "2", "--third", "3"]).must == [ nil, 2, 3, false, 5 ]
+    end
+
+    it "raises an error if a required argument is added after a non-required" do
+      lambda {
+        MyCounter.argument(:foo, :type => :string)
+      }.must raise_error(ArgumentError, 'You cannot have "foo" as required argument after the non-required argument "second".')
+    end
+
+    it "raises when an exception happens within the task call" do
+      lambda { BrokenCounter.start(["1", "2", "--fail"]) }.must raise_error
+    end
+
+    it "raises an error when a Thor group task expects arguments" do
+      lambda { WhinyGenerator.start }.must raise_error(ArgumentError, /Are you sure it has arity equals to 0\?/)
+    end
+
+    it "invokes help message if any of the shortcuts is given" do
+      MyCounter.should_receive(:help)
+      MyCounter.start(["-h"])
+    end
+  end
+
+  describe "#desc" do
+    it "sets the description for a given class" do
+      MyCounter.desc.must == "Description:\n  This generator run three tasks: one, two and three.\n"
+    end
+
+    it "can be inherited" do
+      BrokenCounter.desc.must == "Description:\n  This generator run three tasks: one, two and three.\n"
+    end
+
+    it "can be nil" do
+      WhinyGenerator.desc.must be_nil
+    end
+  end
+
+  describe "#help" do
+    before(:each) do
+      @content = capture(:stdout){ MyCounter.help(Thor::Base.shell.new) }
+    end
+
+    it "provides usage information" do
+      @content.must =~ /my_counter N \[N\]/
+    end
+
+    it "shows description" do
+      @content.must =~ /Description:/
+      @content.must =~ /This generator run three tasks: one, two and three./
+    end
+
+    it "shows options information" do
+      @content.must =~ /Options/
+      @content.must =~ /\[\-\-third=THREE\]/
+    end
+  end
+
+  describe "#invoke" do
+    before(:each) do
+      @content = capture(:stdout){ E.start }
+    end
+
+    it "allows to invoke a class from the class binding" do
+      @content.must =~ /1\n2\n3\n4\n5\n/
+    end
+
+    it "shows invocation information to the user" do
+      @content.must =~ /invoke  Defined/
+    end
+
+    it "uses padding on status generated by the invoked class" do
+      @content.must =~ /finished    counting/
+    end
+
+    it "allows invocation to be configured with blocks" do
+      capture(:stdout) do
+        F.start.must == ["Valim, Jose"]
+      end
+    end
+
+    it "shows invoked options on help" do
+      content = capture(:stdout){ E.help(Thor::Base.shell.new) }
+      content.must =~ /Defined options:/
+      content.must =~ /\[--unused\]/
+      content.must =~ /# This option has no use/
+    end
+  end
+
+  describe "#invoke_from_option" do
+    describe "with default type" do
+      before(:each) do
+        @content = capture(:stdout){ G.start }
+      end
+
+      it "allows to invoke a class from the class binding by a default option" do
+        @content.must =~ /1\n2\n3\n4\n5\n/
+      end
+
+      it "does not invoke if the option is nil" do
+        capture(:stdout){ G.start(["--skip-invoked"]) }.must_not =~ /invoke/
+      end
+
+      it "prints a message if invocation cannot be found" do
+        content = capture(:stdout){ G.start(["--invoked", "unknown"]) }
+        content.must =~ /error  unknown \[not found\]/
+      end
+
+      it "allows to invoke a class from the class binding by the given option" do
+        content = capture(:stdout){ G.start(["--invoked", "e"]) }
+        content.must =~ /invoke  e/
+      end
+
+      it "shows invocation information to the user" do
+        @content.must =~ /invoke  defined/
+      end
+
+      it "uses padding on status generated by the invoked class" do
+        @content.must =~ /finished    counting/
+      end
+
+      it "shows invoked options on help" do
+        content = capture(:stdout){ G.help(Thor::Base.shell.new) }
+        content.must =~ /defined options:/
+        content.must =~ /\[--unused\]/
+        content.must =~ /# This option has no use/
+      end
+    end
+
+    describe "with boolean type" do
+      before(:each) do
+        @content = capture(:stdout){ H.start }
+      end
+
+      it "allows to invoke a class from the class binding by a default option" do
+        @content.must =~ /1\n2\n3\n4\n5\n/
+      end
+
+      it "does not invoke if the option is false" do
+        capture(:stdout){ H.start(["--no-defined"]) }.must_not =~ /invoke/
+      end
+
+      it "shows invocation information to the user" do
+        @content.must =~ /invoke  defined/
+      end
+
+      it "uses padding on status generated by the invoked class" do
+        @content.must =~ /finished    counting/
+      end
+
+      it "shows invoked options on help" do
+        content = capture(:stdout){ H.help(Thor::Base.shell.new) }
+        content.must =~ /defined options:/
+        content.must =~ /\[--unused\]/
+        content.must =~ /# This option has no use/
+      end
+    end
+  end
+end

data/vendor/thor-852190ae/spec/invocation_spec.rb

@@ -0,0 +1,107 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'thor/base'
+
+describe Thor::Invocation do
+  describe "#invoke" do
+    it "invokes a task inside another task" do
+      capture(:stdout){ A.new.invoke(:two) }.must == "2\n3\n"
+    end
+
+    it "invokes a task just once" do
+      capture(:stdout){ A.new.invoke(:one) }.must == "1\n2\n3\n"
+    end
+
+    it "invokes a task just once even if they belongs to different classes" do
+      capture(:stdout){ Defined.new.invoke(:one) }.must == "1\n2\n3\n4\n5\n"
+    end
+
+    it "invokes a task with arguments" do
+      A.new.invoke(:five, [5]).must be_true
+      A.new.invoke(:five, [7]).must be_false
+    end
+
+    it "invokes the default task if none is given to a Thor class" do
+      content = capture(:stdout){ A.new.invoke("b") }
+      content.must =~ /Tasks/
+      content.must =~ /LAST_NAME/
+    end
+
+    it "accepts a class as argument without a task to invoke" do
+      content = capture(:stdout){ A.new.invoke(B) }
+      content.must =~ /Tasks/
+      content.must =~ /LAST_NAME/
+    end
+
+    it "accepts a class as argument with a task to invoke" do
+      base = A.new([], :last_name => "Valim")
+      base.invoke(B, :one, ["Jose"]).must == "Valim, Jose"
+    end
+
+    it "accepts a Thor instance as argument" do
+      invoked = B.new([], :last_name => "Valim")
+      base = A.new
+      base.invoke(invoked, :one, ["Jose"]).must == "Valim, Jose"
+      base.invoke(invoked, :one, ["Jose"]).must be_nil
+    end
+
+    it "allows customized options to be given" do
+      base = A.new([], :last_name => "Wrong")
+      base.invoke(B, :one, ["Jose"], :last_name => "Valim").must == "Valim, Jose"
+    end
+
+    it "reparses options in the new class" do
+      A.start(["invoker", "--last-name", "Valim"]).must == "Valim, Jose"
+    end
+
+    it "shares initialize options with invoked class" do
+      A.new([], :foo => :bar).invoke("b:two").must == { "foo" => :bar }
+    end
+
+    it "dump configuration values to be used in the invoked class" do
+      base = A.new
+      base.invoke("b:three").shell.must == base.shell
+    end
+
+    it "allow extra configuration values to be given" do
+      base, shell = A.new, Thor::Base.shell.new
+      base.invoke("b:three", [], {}, :shell => shell).shell.must == shell
+    end
+
+    it "invokes a Thor::Group and all of its tasks" do
+      capture(:stdout){ A.new.invoke(:c) }.must == "1\n2\n3\n"
+    end
+
+    it "does not invoke a Thor::Group twice" do
+      base = A.new
+      silence(:stdout){ base.invoke(:c) }
+      capture(:stdout){ base.invoke(:c) }.must be_empty
+    end
+
+    it "does not invoke any of Thor::Group tasks twice" do
+      base = A.new
+      silence(:stdout){ base.invoke(:c) }
+      capture(:stdout){ base.invoke("c:one") }.must be_empty
+    end
+
+    it "raises Thor::UndefinedTaskError if the task can't be found" do
+      lambda do
+        A.new.invoke("foo:bar")
+      end.must raise_error(Thor::UndefinedTaskError)
+    end
+
+    it "raises Thor::UndefinedTaskError if the task can't be found even if all tasks where already executed" do
+      base = C.new
+      silence(:stdout){ base.invoke }
+
+      lambda do
+        base.invoke("foo:bar")
+      end.must raise_error(Thor::UndefinedTaskError)
+    end
+
+    it "raises an error if a non Thor class is given" do
+      lambda do
+        A.new.invoke(Object)
+      end.must raise_error(RuntimeError, "Expected Thor class, got Object")
+    end
+  end
+end

data/vendor/thor-852190ae/spec/parser/argument_spec.rb

@@ -0,0 +1,47 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'thor/parser'
+
+describe Thor::Argument do
+
+  def argument(name, type=:string, default=nil, required=nil)
+    @argument ||= Thor::Argument.new(name, nil, required || default.nil?, type, default)
+  end
+
+  describe "errors" do
+    it "raises an error if name is not supplied" do
+      lambda {
+        argument(nil)
+      }.must raise_error(ArgumentError, "Argument name can't be nil.")
+    end
+
+    it "raises an error if type is unknown" do
+      lambda {
+        argument(:task, :unknown)
+      }.must raise_error(ArgumentError, "Type :unknown is not valid for arguments.")
+    end
+
+    it "raises an error if argument is required and have default values" do
+      lambda {
+        argument(:task, :string, "bar", true)
+      }.must raise_error(ArgumentError, "An argument cannot be required and have default value.")
+    end
+  end
+
+  describe "#usage" do
+    it "returns usage for string types" do
+      argument(:foo, :string).usage.must == "FOO"
+    end
+
+    it "returns usage for numeric types" do
+      argument(:foo, :numeric).usage.must == "N"
+    end
+
+    it "returns usage for array types" do
+      argument(:foo, :array).usage.must == "one two three"
+    end
+
+    it "returns usage for hash types" do
+      argument(:foo, :hash).usage.must == "key:value"
+    end
+  end
+end

data/vendor/thor-852190ae/spec/parser/arguments_spec.rb

@@ -0,0 +1,64 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'thor/parser'
+
+describe Thor::Arguments do
+  def create(opts={})
+    arguments = opts.map do |type, default|
+      Thor::Argument.new(type.to_s, nil, default.nil?, type, default)
+    end
+
+    arguments.sort!{ |a,b| b.name <=> a.name }
+    @opt = Thor::Arguments.new(arguments)
+  end
+
+  def parse(*args)
+    @opt.parse(args)
+  end
+
+  describe "#parse" do
+    it "parses arguments in the given order" do
+      create :string => nil, :numeric => nil
+      parse("name", "13")["string"].must == "name"
+      parse("name", "13")["numeric"].must == 13
+    end
+
+    it "accepts hashes" do
+      create :string => nil, :hash => nil
+      parse("product", "title:string", "age:integer")["string"].must == "product"
+      parse("product", "title:string", "age:integer")["hash"].must == { "title" => "string", "age" => "integer"}
+    end
+
+    it "accepts arrays" do
+      create :string => nil, :array => nil
+      parse("product", "title", "age")["string"].must == "product"
+      parse("product", "title", "age")["array"].must == %w(title age)
+    end
+
+    describe "with no inputs" do
+      it "and no arguments returns an empty hash" do
+        create
+        parse.must == {}
+      end
+
+      it "and required arguments raises an error" do
+        create :string => nil, :numeric => nil
+        lambda { parse }.must raise_error(Thor::RequiredArgumentMissingError, "No value provided for required arguments 'string', 'numeric'")
+      end
+
+      it "and default arguments returns default values" do
+        create :string => "name", :numeric => 13
+        parse.must == { "string" => "name", "numeric" => 13 }
+      end
+    end
+
+    it "returns the input if it's already parsed" do
+      create :string => nil, :hash => nil, :array => nil, :numeric => nil
+      parse("", 0, {}, []).must == { "string" => "", "numeric" => 0, "hash" => {}, "array" => [] }
+    end
+
+    it "returns the default value if none is provided" do
+      create :string => "foo", :numeric => 3.0
+      parse("bar").must == { "string" => "bar", "numeric" => 3.0 }
+    end
+  end
+end

data/vendor/thor-852190ae/spec/parser/option_spec.rb

@@ -0,0 +1,202 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'thor/parser'
+
+describe Thor::Option do
+  def parse(key, value)
+    Thor::Option.parse(key, value)
+  end
+
+  def option(name, description=nil, required=false, type=nil, default=nil, banner=nil, group=nil, aliases=[])
+    @option ||= Thor::Option.new(name, description, required, type, default, banner, group, aliases)
+  end
+
+  describe "#parse" do
+
+    describe "with value as a symbol" do
+      describe "and symbol is a valid type" do
+        it "has type equals to the symbol" do
+          parse(:foo, :string).type.must == :string
+          parse(:foo, :numeric).type.must == :numeric
+        end
+
+        it "has not default value" do
+          parse(:foo, :string).default.must be_nil
+          parse(:foo, :numeric).default.must be_nil
+        end
+      end
+
+      describe "equals to :required" do
+        it "has type equals to :string" do
+          parse(:foo, :required).type.must == :string
+        end
+
+        it "has no default value" do
+          parse(:foo, :required).default.must be_nil
+        end
+      end
+
+      describe "and symbol is not a reserved key" do
+        it "has type equals to :string" do
+          parse(:foo, :bar).type.must == :string
+        end
+
+        it "has no default value" do
+          parse(:foo, :bar).default.must be_nil
+        end
+      end
+    end
+
+    describe "with value as hash" do
+      it "has default type :hash" do
+        parse(:foo, :a => :b).type.must == :hash
+      end
+
+      it "has default value equals to the hash" do
+        parse(:foo, :a => :b).default.must == { :a => :b }
+      end
+    end
+
+    describe "with value as array" do
+      it "has default type :array" do
+        parse(:foo, [:a, :b]).type.must == :array
+      end
+
+      it "has default value equals to the array" do
+        parse(:foo, [:a, :b]).default.must == [:a, :b]
+      end
+    end
+
+    describe "with value as string" do
+      it "has default type :string" do
+        parse(:foo, "bar").type.must == :string
+      end
+
+      it "has default value equals to the string" do
+        parse(:foo, "bar").default.must == "bar"
+      end
+    end
+
+    describe "with value as numeric" do
+      it "has default type :numeric" do
+        parse(:foo, 2.0).type.must == :numeric
+      end
+
+      it "has default value equals to the numeric" do
+        parse(:foo, 2.0).default.must == 2.0
+      end
+    end
+
+    describe "with value as boolean" do
+      it "has default type :boolean" do
+        parse(:foo, true).type.must == :boolean
+        parse(:foo, false).type.must == :boolean
+      end
+
+      it "has default value equals to the boolean" do
+        parse(:foo, true).default.must == true
+        parse(:foo, false).default.must == false
+      end
+    end
+
+    describe "with key as a symbol" do
+      it "sets the name equals to the key" do
+        parse(:foo, true).name.must == "foo"
+      end
+    end
+
+    describe "with key as an array" do
+      it "sets the first items in the array to the name" do
+        parse([:foo, :bar, :baz], true).name.must == "foo"
+      end
+
+      it "sets all other items as aliases" do
+        parse([:foo, :bar, :baz], true).aliases.must == [:bar, :baz]
+      end
+    end
+  end
+
+  it "returns the switch name" do
+    option("foo").switch_name.must == "--foo"
+    option("--foo").switch_name.must == "--foo"
+  end
+
+  it "returns the human name" do
+    option("foo").human_name.must == "foo"
+    option("--foo").human_name.must == "foo"
+  end
+
+  it "converts underscores to dashes" do
+    option("foo_bar").switch_name.must == "--foo-bar"
+  end
+
+  it "can be required and have default values" do
+    option = option("foo", nil, true, :string, "bar")
+    option.default.must == "bar"
+    option.must be_required
+  end
+
+  it "cannot be required and have type boolean" do
+    lambda {
+      option("foo", nil, true, :boolean)
+    }.must raise_error(ArgumentError, "An option cannot be boolean and required.")
+  end
+
+  it "allows type predicates" do
+    parse(:foo, :string).must be_string
+    parse(:foo, :boolean).must be_boolean
+    parse(:foo, :numeric).must be_numeric
+  end
+
+  it "raises an error on method missing" do
+    lambda {
+      parse(:foo, :string).unknown?
+    }.must raise_error(NoMethodError)
+  end
+
+  describe "#usage" do
+
+    it "returns usage for string types" do
+      parse(:foo, :string).usage.must == "[--foo=FOO]"
+    end
+
+    it "returns usage for numeric types" do
+      parse(:foo, :numeric).usage.must == "[--foo=N]"
+    end
+
+    it "returns usage for array types" do
+      parse(:foo, :array).usage.must == "[--foo=one two three]"
+    end
+
+    it "returns usage for hash types" do
+      parse(:foo, :hash).usage.must == "[--foo=key:value]"
+    end
+
+    it "returns usage for boolean types" do
+      parse(:foo, :boolean).usage.must == "[--foo]"
+    end
+
+    it "uses padding when no aliases is given" do
+      parse(:foo, :boolean).usage(4).must == "    [--foo]"
+    end
+
+    it "uses banner when supplied" do
+      option(:foo, nil, false, :string, nil, "BAR").usage.must == "[--foo=BAR]"
+    end
+
+    it "checkes when banner is an empty string" do
+      option(:foo, nil, false, :string, nil, "").usage.must == "[--foo]"
+    end
+
+    describe "with required values" do
+      it "does not show the usage between brackets" do
+        parse(:foo, :required).usage.must == "--foo=FOO"
+      end
+    end
+
+    describe "with aliases" do
+      it "does not show the usage between brackets" do
+        parse([:foo, "-f", "-b"], :required).usage.must == "-f, -b, --foo=FOO"
+      end
+    end
+  end
+end