xcocoapods 1.5.3

data/lib/cocoapods/command/list.rb

@@ -0,0 +1,39 @@
+module Pod
+  class Command
+    class List < Command
+      self.summary = 'List pods'
+      self.description = 'Lists all available pods.'
+
+      def self.options
+        [
+          ['--update', 'Run `pod repo update` before listing'],
+          ['--stats',  'Show additional stats (like GitHub watchers and forks)'],
+        ].concat(super)
+      end
+
+      def initialize(argv)
+        @update = argv.flag?('update')
+        @stats  = argv.flag?('stats')
+        super
+      end
+
+      def run
+        update_if_necessary!
+
+        sets = config.sources_manager.aggregate.all_sets
+        sets.each { |set| UI.pod(set, :name_and_version) }
+        UI.puts "\n#{sets.count} pods were found"
+      end
+
+      def update_if_necessary!
+        if @update && config.verbose?
+          UI.section("\nUpdating Spec Repositories\n".yellow) do
+            Repo.new(ARGV.new(['update'])).run
+          end
+        end
+      end
+
+      #-----------------------------------------------------------------------#
+    end
+  end
+end

data/lib/cocoapods/command/options/project_directory.rb

@@ -0,0 +1,36 @@
+module Pod
+  class Command
+    module Options
+      # Provides support for commands to take a user-specified `project directory`
+      #
+      module ProjectDirectory
+        module Options
+          def options
+            [
+              ['--project-directory=/project/dir/', 'The path to the root of the project directory'],
+            ].concat(super)
+          end
+        end
+
+        def self.included(base)
+          base.extend(Options)
+        end
+
+        def initialize(argv)
+          if project_directory = argv.option('project-directory')
+            @project_directory = Pathname.new(project_directory).expand_path
+          end
+          config.installation_root = @project_directory
+          super
+        end
+
+        def validate!
+          super
+          if @project_directory && !@project_directory.directory?
+            raise Informative, "`#{@project_directory}` is not a valid directory."
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/options/repo_update.rb

@@ -0,0 +1,34 @@
+module Pod
+  class Command
+    module Options
+      # Provides support for commands to skip updating the spec repositories.
+      #
+      module RepoUpdate
+        module Options
+          def options
+            [
+              ['--no-repo-update', 'Skip running `pod repo update` before install'],
+            ].concat(super)
+          end
+        end
+
+        def self.included(base)
+          base.extend(Options)
+        end
+
+        def repo_update?(default: false)
+          if @repo_update.nil?
+            default
+          else
+            @repo_update
+          end
+        end
+
+        def initialize(argv)
+          @repo_update = argv.flag?('repo-update')
+          super
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/outdated.rb

@@ -0,0 +1,140 @@
+module Pod
+  class Command
+    class Outdated < Command
+      include RepoUpdate
+      include ProjectDirectory
+
+      self.summary = 'Show outdated project dependencies'
+
+      self.description = <<-DESC
+        Shows the outdated pods in the current Podfile.lock, but only those from
+        spec repos, not those from local/external sources.
+      DESC
+
+      # Run the command
+      #
+      def run
+        if updates.empty?
+          UI.puts 'No pod updates are available.'.yellow
+        else
+          UI.section 'The color indicates what happens when you run `pod update`' do
+            UI.puts "#{'<green>'.green}\t - Will be updated to the newest version"
+            UI.puts "#{'<blue>'.blue}\t - Will be updated, but not to the newest version because of specified version in Podfile"
+            UI.puts "#{'<red>'.red}\t - Will not be updated because of specified version in Podfile"
+            UI.puts ''
+          end
+          UI.section 'The following pod updates are available:' do
+            updates.each do |(name, from_version, matching_version, to_version)|
+              color = :blue
+              if matching_version == to_version
+                color = :green
+              elsif from_version == matching_version
+                color = :red
+              end
+              # For the specs, its necessary that to_s is called here even though it is redundant
+              # https://github.com/CocoaPods/CocoaPods/pull/7204#issuecomment-342512015
+              UI.puts "- #{name} #{from_version.to_s.send(color)} -> #{matching_version.to_s.send(color)} " \
+              "(latest version #{to_version.to_s})" # rubocop:disable Lint/StringConversionInInterpolation
+            end
+          end
+        end
+
+        if deprecated_pods.any?
+          UI.section 'The following pods are deprecated:' do
+            deprecated_pods.each do |spec|
+              if spec.deprecated_in_favor_of
+                UI.puts "- #{spec.name}" \
+                  " (in favor of #{spec.deprecated_in_favor_of})"
+              else
+                UI.puts "- #{spec.name}"
+              end
+            end
+          end
+        end
+      end
+
+      private
+
+      def analyzer
+        @analyzer ||= begin
+          verify_podfile_exists!
+          Installer::Analyzer.new(config.sandbox, config.podfile, config.lockfile)
+        end
+      end
+
+      def updates
+        @updates ||= begin
+          ensure_external_podspecs_present!
+          spec_sets.map do |set|
+            spec = set.specification
+            source_version = set.versions.first
+            pod_name = spec.root.name
+            lockfile_version = lockfile.version(pod_name)
+            if source_version > lockfile_version
+              matching_spec = unlocked_pods.find { |s| s.name == pod_name }
+              matching_version =
+                matching_spec ? matching_spec.version : '(unused)'
+              [pod_name, lockfile_version, matching_version, source_version]
+            end
+          end.compact.uniq
+        end
+      end
+
+      def unlocked_pods
+        @unlocked_pods ||= begin
+          pods = []
+          UI.titled_section('Analyzing dependencies') do
+            pods = Installer::Analyzer.new(config.sandbox, config.podfile).
+              analyze(false).
+              specs_by_target.values.flatten.uniq
+          end
+          pods
+        end
+      end
+
+      def deprecated_pods
+        @deprecated_pods ||= begin
+          spec_sets.map(&:specification).select do |spec|
+            spec.deprecated || spec.deprecated_in_favor_of
+          end.compact.uniq
+        end
+      end
+
+      def spec_sets
+        @spec_sets ||= begin
+          analyzer.send(:update_repositories) if repo_update?(:default => true)
+          aggregate = Source::Aggregate.new(analyzer.sources)
+          installed_pods.map do |pod_name|
+            aggregate.search(Dependency.new(pod_name))
+          end.compact.uniq
+        end
+      end
+
+      def installed_pods
+        @installed_pods ||= begin
+          verify_podfile_exists!
+
+          lockfile.pod_names
+        end
+      end
+
+      def lockfile
+        @lockfile ||= begin
+          verify_lockfile_exists!
+          config.lockfile
+        end
+      end
+
+      def ensure_external_podspecs_present!
+        return unless config.podfile
+        config.podfile.dependencies.each do |dep|
+          next if dep.external_source.nil?
+          unless config.sandbox.specification(dep.root_name)
+            raise Informative, 'You must run `pod install` first to ensure that the ' \
+              "podspec for `#{dep.root_name}` has been fetched."
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/repo.rb

@@ -0,0 +1,29 @@
+require 'fileutils'
+require 'cocoapods/command/repo/add'
+require 'cocoapods/command/repo/lint'
+require 'cocoapods/command/repo/list'
+require 'cocoapods/command/repo/push'
+require 'cocoapods/command/repo/remove'
+require 'cocoapods/command/repo/update'
+
+module Pod
+  class Command
+    class Repo < Command
+      self.abstract_command = true
+
+      # @todo should not show a usage banner!
+      #
+      self.summary = 'Manage spec-repositories'
+      self.default_subcommand = 'list'
+
+      #-----------------------------------------------------------------------#
+
+      extend Executable
+      executable :git
+
+      def dir
+        config.repos_dir + @name
+      end
+    end
+  end
+end

data/lib/cocoapods/command/repo/add.rb

@@ -0,0 +1,103 @@
+module Pod
+  class Command
+    class Repo < Command
+      class Add < Repo
+        self.summary = 'Add a spec repo'
+
+        self.description = <<-DESC
+          Clones `URL` in the local spec-repos directory at `#{Config.instance.repos_dir}`. The
+          remote can later be referred to by `NAME`.
+        DESC
+
+        self.arguments = [
+          CLAide::Argument.new('NAME',   true),
+          CLAide::Argument.new('URL',    true),
+          CLAide::Argument.new('BRANCH', false),
+        ]
+
+        def self.options
+          [
+            ['--progress', 'Show the progress of cloning the spec repository'],
+          ].concat(super)
+        end
+
+        def initialize(argv)
+          @name = argv.shift_argument
+          @url = argv.shift_argument
+          @branch = argv.shift_argument
+          @progress = argv.flag?('progress')
+          super
+        end
+
+        def validate!
+          super
+          unless @name && @url
+            help! 'Adding a repo needs a `NAME` and a `URL`.'
+          end
+          if @name == 'master' || @url =~ %r{github.com[:/]+cocoapods/specs}i
+            raise Informative,
+                  'To setup the master specs repo, please run `pod setup`.'
+          end
+        end
+
+        def run
+          section = "Cloning spec repo `#{@name}` from `#{@url}`"
+          section << " (branch `#{@branch}`)" if @branch
+          UI.section(section) do
+            create_repos_dir
+            clone_repo
+            checkout_branch
+            config.sources_manager.sources([dir.basename.to_s]).each(&:verify_compatibility!)
+          end
+        end
+
+        private
+
+        # Creates the repos directory specified in the configuration by
+        # `config.repos_dir`.
+        #
+        # @return [void]
+        #
+        # @raise  If the directory cannot be created due to a system error.
+        #
+        def create_repos_dir
+          config.repos_dir.mkpath
+        rescue => e
+          raise Informative, "Could not create '#{config.repos_dir}', the CocoaPods repo cache directory.\n" \
+            "#{e.class.name}: #{e.message}"
+        end
+
+        # Clones the git spec-repo according to parameters passed to the
+        # command.
+        #
+        # @return [void]
+        #
+        def clone_repo
+          changes = if @progress
+                      { :verbose => true }
+                    else
+                      {}
+          end
+
+          config.with_changes(changes) do
+            Dir.chdir(config.repos_dir) do
+              command = ['clone', @url, @name]
+              if @progress
+                command << '--progress'
+              end
+              git!(command)
+            end
+          end
+        end
+
+        # Checks out the branch of the git spec-repo if provided.
+        #
+        # @return [void]
+        #
+        def checkout_branch
+          Dir.chdir(dir) { git!('checkout', @branch) } if @branch
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,82 @@
+module Pod
+  class Command
+    class Repo < Command
+      class Lint < Repo
+        self.summary = 'Validates all specs in a repo'
+
+        self.description = <<-DESC
+          Lints the spec-repo `NAME`. If a directory is provided it is assumed
+          to be the root of a repo. Finally, if `NAME` is not provided this
+          will lint all the spec-repos known to CocoaPods.
+        DESC
+
+        self.arguments = [
+          CLAide::Argument.new(%w(NAME DIRECTORY), false),
+        ]
+
+        def self.options
+          [
+            ['--only-errors', 'Lint presents only the errors'],
+          ].concat(super)
+        end
+
+        def initialize(argv)
+          @name = argv.shift_argument
+          @only_errors = argv.flag?('only-errors')
+          super
+        end
+
+        # Run the command
+        #
+        # @todo Part of this logic needs to be ported to cocoapods-core so web
+        #       services can validate the repo.
+        #
+        # @todo add UI.print and enable print statements again.
+        #
+        def run
+          sources = if @name
+                      if File.exist?(@name)
+                        [Source.new(Pathname(@name))]
+                      else
+                        config.sources_manager.sources([@name])
+                      end
+                    else
+                      config.sources_manager.all
+                    end
+
+          sources.each do |source|
+            source.verify_compatibility!
+            UI.puts "\nLinting spec repo `#{source.name}`\n".yellow
+
+            validator = Source::HealthReporter.new(source.repo)
+            validator.pre_check do |_name, _version|
+              UI.print '.'
+            end
+            report = validator.analyze
+            UI.puts
+            UI.puts
+
+            report.pods_by_warning.each do |message, versions_by_name|
+              UI.puts "-> #{message}".yellow
+              versions_by_name.each { |name, versions| UI.puts "  - #{name} (#{versions * ', '})" }
+              UI.puts
+            end
+
+            report.pods_by_error.each do |message, versions_by_name|
+              UI.puts "-> #{message}".red
+              versions_by_name.each { |name, versions| UI.puts "  - #{name} (#{versions * ', '})" }
+              UI.puts
+            end
+
+            UI.puts "Analyzed #{report.analyzed_paths.count} podspecs files.\n\n"
+            if report.pods_by_error.count.zero?
+              UI.puts 'All the specs passed validation.'.green << "\n\n"
+            else
+              raise Informative, "#{report.pods_by_error.count} podspecs failed validation."
+            end
+          end
+        end
+      end
+    end
+  end
+end