xcocoapods 1.5.3

data/lib/cocoapods/command/ipc/list.rb

@@ -0,0 +1,40 @@
+module Pod
+  class Command
+    class IPC < Command
+      class List < IPC
+        self.summary = 'Lists the specifications known to CocoaPods'
+        self.description = <<-DESC
+          Prints to STDOUT a YAML dictionary where the keys are the name of the
+          specifications and each corresponding value is a dictionary with
+          the following keys:
+          - defined_in_file
+          - version
+          - authors
+          - summary
+          - description
+          - platforms
+        DESC
+
+        def run
+          require 'yaml'
+          sets = config.sources_manager.aggregate.all_sets
+          result = {}
+          sets.each do |set|
+            begin
+              spec = set.specification
+              result[spec.name] = {
+                'authors' => spec.authors.keys,
+                'summary' => spec.summary,
+                'description' => spec.description,
+                'platforms' => spec.available_platforms.map { |p| p.name.to_s },
+              }
+            rescue DSLError
+              next
+            end
+          end
+          output_pipe.puts result.to_yaml
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/ipc/podfile.rb

@@ -0,0 +1,31 @@
+module Pod
+  class Command
+    class IPC < Command
+      class Podfile < IPC
+        include ProjectDirectory
+
+        self.summary = 'Converts a Podfile to YAML'
+        self.description = 'Converts a Podfile to YAML and prints it to STDOUT.'
+        self.arguments = [
+          CLAide::Argument.new('PATH', true),
+        ]
+
+        def initialize(argv)
+          @path = argv.shift_argument
+          super
+        end
+
+        def validate!
+          super
+          help! 'A Podfile path is required.' unless @path
+        end
+
+        def run
+          require 'yaml'
+          podfile = Pod::Podfile.from_file(@path)
+          output_pipe.puts podfile.to_yaml
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/ipc/podfile_json.rb

@@ -0,0 +1,30 @@
+module Pod
+  class Command
+    class IPC < Command
+      class PodfileJSON < IPC
+        include ProjectDirectory
+
+        self.summary = 'Converts a Podfile to JSON'
+        self.description = 'Converts a Podfile to JSON and prints it to STDOUT.'
+        self.arguments = [
+          CLAide::Argument.new('PATH', true),
+        ]
+
+        def initialize(argv)
+          @path = argv.shift_argument
+          super
+        end
+
+        def validate!
+          super
+          help! 'A Podfile path is required.' unless @path
+        end
+
+        def run
+          podfile = Pod::Podfile.from_file(@path)
+          output_pipe.puts podfile.to_hash.to_json
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/ipc/repl.rb

@@ -0,0 +1,51 @@
+module Pod
+  class Command
+    class IPC < Command
+      class Repl < IPC
+        include ProjectDirectory
+
+        END_OF_OUTPUT_SIGNAL = "\n\r".freeze
+
+        self.summary = 'The repl listens to commands on standard input'
+        self.description = <<-DESC
+          The repl listens to commands on standard input and prints their
+          result to standard output.
+          It accepts all the other ipc subcommands. The repl will signal the
+          end of output with the the ASCII CR+LF `\\n\\r`.
+        DESC
+
+        def run
+          print_version
+          signal_end_of_output
+          listen
+        end
+
+        def print_version
+          output_pipe.puts "version: '#{Pod::VERSION}'"
+        end
+
+        def signal_end_of_output
+          output_pipe.puts(END_OF_OUTPUT_SIGNAL)
+          STDOUT.flush
+        end
+
+        def listen
+          while repl_command = STDIN.gets
+            execute_repl_command(repl_command)
+          end
+        end
+
+        def execute_repl_command(repl_command)
+          unless repl_command == '\n'
+            repl_commands = repl_command.split
+            subcommand = repl_commands.shift.capitalize
+            arguments = repl_commands
+            subcommand_class = Pod::Command::IPC.const_get(subcommand)
+            subcommand_class.new(CLAide::ARGV.new(arguments)).run
+            signal_end_of_output
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/ipc/spec.rb

@@ -0,0 +1,29 @@
+module Pod
+  class Command
+    class IPC < Command
+      class Spec < IPC
+        self.summary = 'Converts a podspec to JSON'
+        self.description = 'Converts a podspec to JSON and prints it to STDOUT.'
+        self.arguments = [
+          CLAide::Argument.new('PATH', true),
+        ]
+
+        def initialize(argv)
+          @path = argv.shift_argument
+          super
+        end
+
+        def validate!
+          super
+          help! 'A specification path is required.' unless @path
+        end
+
+        def run
+          require 'json'
+          spec = Specification.from_file(@path)
+          output_pipe.puts(spec.to_pretty_json)
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/ipc/update_search_index.rb

@@ -0,0 +1,24 @@
+module Pod
+  class Command
+    class IPC < Command
+      class UpdateSearchIndex < IPC
+        self.summary = 'Updates the search index'
+        self.description = <<-DESC
+          Updates the search index and prints its path to standard output.
+          The search index is a YAML encoded dictionary where the keys
+          are the names of the Pods and the values are a dictionary containing
+          the following information:
+          - version
+          - summary
+          - description
+          - authors
+        DESC
+
+        def run
+          config.sources_manager.updated_search_index
+          output_pipe.puts(config.sources_manager.search_index_path)
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/lib.rb

@@ -0,0 +1,11 @@
+require 'cocoapods/command/lib/create'
+require 'cocoapods/command/lib/lint'
+
+module Pod
+  class Command
+    class Lib < Command
+      self.abstract_command = true
+      self.summary = 'Develop pods'
+    end
+  end
+end

data/lib/cocoapods/command/lib/create.rb

@@ -0,0 +1,105 @@
+module Pod
+  class Command
+    class Lib < Command
+      class Create < Lib
+        self.summary = 'Creates a new Pod'
+
+        self.description = <<-DESC
+          Creates a scaffold for the development of a new Pod named `NAME`
+          according to the CocoaPods best practices.
+          If a `TEMPLATE_URL`, pointing to a git repo containing a compatible
+          template, is specified, it will be used in place of the default one.
+        DESC
+
+        self.arguments = [
+          CLAide::Argument.new('NAME', true),
+        ]
+
+        def self.options
+          [
+            ['--template-url=URL', 'The URL of the git repo containing a ' \
+                                  'compatible template'],
+          ].concat(super)
+        end
+
+        def initialize(argv)
+          @name = argv.shift_argument
+          @template_url = argv.option('template-url', TEMPLATE_REPO)
+          super
+          @additional_args = argv.remainder!
+        end
+
+        def validate!
+          super
+          help! 'A name for the Pod is required.' unless @name
+          help! 'The Pod name cannot contain spaces.' if @name =~ /\s/
+          help! 'The Pod name cannot contain plusses.' if @name =~ /\+/
+          help! "The Pod name cannot begin with a '.'" if @name[0, 1] == '.'
+        end
+
+        def run
+          clone_template
+          configure_template
+          print_info
+        end
+
+        private
+
+        #----------------------------------------#
+
+        # !@group Private helpers
+
+        extend Executable
+        executable :git
+
+        TEMPLATE_REPO = 'https://github.com/CocoaPods/pod-template.git'.freeze
+        TEMPLATE_INFO_URL = 'https://github.com/CocoaPods/pod-template'.freeze
+        CREATE_NEW_POD_INFO_URL = 'http://guides.cocoapods.org/making/making-a-cocoapod'.freeze
+
+        # Clones the template from the remote in the working directory using
+        # the name of the Pod.
+        #
+        # @return [void]
+        #
+        def clone_template
+          UI.section("Cloning `#{template_repo_url}` into `#{@name}`.") do
+            git! ['clone', template_repo_url, @name]
+          end
+        end
+
+        # Runs the template configuration utilities.
+        #
+        # @return [void]
+        #
+        def configure_template
+          UI.section("Configuring #{@name} template.") do
+            Dir.chdir(@name) do
+              if File.exist?('configure')
+                system({ 'COCOAPODS_VERSION' => Pod::VERSION }, './configure', @name, *@additional_args)
+              else
+                UI.warn 'Template does not have a configure file.'
+              end
+            end
+          end
+        end
+
+        # Runs the template configuration utilities.
+        #
+        # @return [void]
+        #
+        def print_info
+          UI.puts "\nTo learn more about the template see `#{template_repo_url}`."
+          UI.puts "To learn more about creating a new pod, see `#{CREATE_NEW_POD_INFO_URL}`."
+        end
+
+        # Checks if a template URL is given else returns the TEMPLATE_REPO URL
+        #
+        # @return String
+        #
+        def template_repo_url
+          @template_url || TEMPLATE_REPO
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/lib/lint.rb

@@ -0,0 +1,121 @@
+module Pod
+  class Command
+    class Lib < Command
+      class Lint < Lib
+        self.summary = 'Validates a Pod'
+
+        self.description = <<-DESC
+          Validates the Pod using the files in the working directory.
+        DESC
+
+        def self.options
+          [
+            ['--quick', 'Lint skips checks that would require to download and build the spec'],
+            ['--allow-warnings', 'Lint validates even if warnings are present'],
+            ['--subspec=NAME', 'Lint validates only the given subspec'],
+            ['--no-subspecs', 'Lint skips validation of subspecs'],
+            ['--no-clean', 'Lint leaves the build directory intact for inspection'],
+            ['--fail-fast', 'Lint stops on the first failing platform or subspec'],
+            ['--use-libraries', 'Lint uses static libraries to install the spec'],
+            ['--sources=https://github.com/artsy/Specs,master', 'The sources from which to pull dependent pods ' \
+             '(defaults to https://github.com/CocoaPods/Specs.git). ' \
+             'Multiple sources must be comma-delimited.'],
+            ['--platforms=ios,macos', 'Lint against specific platforms' \
+              '(defaults to all platforms supported by the podspec).' \
+              'Multiple platforms must be comma-delimited'],
+            ['--private', 'Lint skips checks that apply only to public specs'],
+            ['--swift-version=VERSION', 'The SWIFT_VERSION that should be used to lint the spec. ' \
+             'This takes precedence over a .swift-version file.'],
+            ['--skip-import-validation', 'Lint skips validating that the pod can be imported'],
+            ['--skip-tests', 'Lint skips building and running tests during validation'],
+          ].concat(super)
+        end
+
+        def initialize(argv)
+          @quick           = argv.flag?('quick')
+          @allow_warnings  = argv.flag?('allow-warnings')
+          @clean           = argv.flag?('clean', true)
+          @fail_fast       = argv.flag?('fail-fast', false)
+          @subspecs        = argv.flag?('subspecs', true)
+          @only_subspec    = argv.option('subspec')
+          @use_frameworks  = !argv.flag?('use-libraries')
+          @source_urls     = argv.option('sources', 'https://github.com/CocoaPods/Specs.git').split(',')
+          @platforms       = argv.option('platforms', '').split(',')
+          @private         = argv.flag?('private', false)
+          @swift_version   = argv.option('swift-version', nil)
+          @skip_import_validation = argv.flag?('skip-import-validation', false)
+          @skip_tests = argv.flag?('skip-tests', false)
+          @podspecs_paths = argv.arguments!
+          super
+        end
+
+        def validate!
+          super
+        end
+
+        def run
+          UI.puts
+          podspecs_to_lint.each do |podspec|
+            validator                = Validator.new(podspec, @source_urls, @platforms)
+            validator.local          = true
+            validator.quick          = @quick
+            validator.no_clean       = !@clean
+            validator.fail_fast      = @fail_fast
+            validator.allow_warnings = @allow_warnings
+            validator.no_subspecs    = !@subspecs || @only_subspec
+            validator.only_subspec   = @only_subspec
+            validator.use_frameworks = @use_frameworks
+            validator.ignore_public_only_results = @private
+            validator.swift_version = @swift_version
+            validator.skip_import_validation = @skip_import_validation
+            validator.skip_tests = @skip_tests
+            validator.validate
+
+            unless @clean
+              UI.puts "Pods workspace available at `#{validator.validation_dir}/App.xcworkspace` for inspection."
+              UI.puts
+            end
+            if validator.validated?
+              UI.puts "#{validator.spec.name} passed validation.".green
+            else
+              spec_name = podspec
+              spec_name = validator.spec.name if validator.spec
+              message = "#{spec_name} did not pass validation, due to #{validator.failure_reason}."
+
+              if @clean
+                message << "\nYou can use the `--no-clean` option to inspect " \
+                  'any issue.'
+              end
+              raise Informative, message
+            end
+          end
+        end
+
+        private
+
+        #----------------------------------------#
+
+        # !@group Private helpers
+
+        # @return [Pathname] The path of the podspec found in the current
+        #         working directory.
+        #
+        # @raise  If no podspec is found.
+        # @raise  If multiple podspecs are found.
+        #
+        def podspecs_to_lint
+          if !@podspecs_paths.empty?
+            Array(@podspecs_paths)
+          else
+            podspecs = Pathname.glob(Pathname.pwd + '*.podspec{.json,}')
+            if podspecs.count.zero?
+              raise Informative, 'Unable to find a podspec in the working ' \
+                'directory'
+            end
+            podspecs
+          end
+        end
+      end
+    end
+  end
+end