Added help command. Usage pod help [COMMAND]

CHANGELOG.md

@@ -12,6 +12,9 @@
 * CocoaPods now defines the deployment target of the Pods project computed as
   the minimum deployment target of the Pods libraries.
   [#556](https://github.com/CocoaPods/CocoaPods/issues/556)
+* Added `pod help` command. You can still use the old format
+  with --help flag.
+  [#957](https://github.com/CocoaPods/CocoaPods/pull/957)
 
 ###### Bug fixes
 

lib/cocoapods/command.rb

@@ -16,6 +16,7 @@ class Command < CLAide::Command
     require 'cocoapods/command/search'
     require 'cocoapods/command/setup'
     require 'cocoapods/command/spec'
+    require 'cocoapods/command/help'
     require 'cocoapods/command/inter_process_communication'
 
     self.abstract_command = true

lib/cocoapods/command/help.rb

@@ -0,0 +1,23 @@
+module Pod
+  class Command
+    class Help < Command
+      self.summary = 'Show help for the given command.'
+      self.arguments = '[COMMAND]'
+
+      def initialize(argv)
+        @help_command = Pod::Command.parse(argv) unless argv.empty?
+        super
+      end
+
+      def run
+        help_command.help!
+      end
+
+      private
+
+      def help_command
+        @help_command || self
+      end
+    end
+  end
+end

spec/functional/command/help_spec.rb

@@ -0,0 +1,22 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+
+module Pod
+  describe "Command::Help" do
+    extend SpecHelper::Command
+
+    it "invokes the right command with --help flag" do
+      command = command('help', 'push')
+      command.send(:help_command).should.be.instance_of Pod::Command::Push
+      lambda { command.run }.should.raise CLAide::Help
+    end
+
+    it "raises help! if no other command is passed" do
+      lambda { command('help').run }.should.raise CLAide::Help
+    end
+
+    it "shows the right usage" do
+      Pod::Command::Help.arguments.should.equal '[COMMAND]'
+    end
+
+  end
+end

spec/unit/command_spec.rb

@@ -3,6 +3,7 @@
 module Pod
   describe Command do
     it "returns the proper command class" do
+      Command.parse(%w{ help        }).should.be.instance_of Command::Help
       Command.parse(%w{ install     }).should.be.instance_of Command::Install
       Command.parse(%w{ list        }).should.be.instance_of Command::List
       Command.parse(%w{ outdated    }).should.be.instance_of Command::Outdated

spec/unit/resolver_spec.rb

@@ -121,6 +121,7 @@ module Pod
         RestKit
         RestKit/JSON
         RestKit/Network
+        RestKit/ObjectMapping/Core
         RestKit/ObjectMapping/CoreData
         RestKit/ObjectMapping/JSON
         RestKit/UI