cocoapods-square-stable 0.19.3

data/lib/cocoapods/command/push.rb

@@ -0,0 +1,172 @@
+require 'fileutils'
+require 'active_support/core_ext/string/inflections'
+
+module Pod
+  class Command
+    class Push < Command
+      self.summary = 'Push new specifications to a spec-repo'
+
+      self.description = <<-DESC
+        Validates NAME.podspec or `*.podspec' in the current working dir, creates
+        a directory and version folder for the pod in the local copy of 
+        REPO (~/.cocoapods/[REPO]), copies the podspec file into the version directory,
+        and finally it pushes REPO to its remote.
+      DESC
+
+      self.arguments = 'REPO [NAME.podspec]'
+
+      def self.options
+        [ ["--allow-warnings", "Allows pushing even if there are warnings"],
+          ["--local-only", "Does not perform the step of pushing REPO to its remote"] ].concat(super)
+      end
+
+      def initialize(argv)
+        @allow_warnings = argv.flag?('allow-warnings')
+        @local_only = argv.flag?('local-only')
+        @repo = argv.shift_argument
+        if @repo.nil?
+          @repo = "master"
+        elsif @repo.end_with? ".podspec"
+          @podspec = @repo
+          @repo = "master"
+        else
+          @podspec = argv.shift_argument
+        end
+        super
+      end
+
+      def validate!
+        super
+        help! "A spec-repo name is required." unless @repo
+      end
+
+      def run
+        validate_podspec_files
+        check_repo_status
+        update_repo
+        add_specs_to_repo
+        push_repo unless @local_only
+      end
+
+      #-----------------------------------------------------------------------#
+
+      private
+
+      # @!group Push sub-steps
+
+      extend Executable
+      executable :git
+
+      # Performs a full lint against the podspecs.
+      #
+      def validate_podspec_files
+        UI.puts "\nValidating #{'spec'.pluralize(count)}".yellow
+        podspec_files.each do |podspec|
+          validator = Validator.new(podspec)
+          validator.only_errors = @allow_warnings
+          begin
+            validator.validate
+          rescue Exception
+            raise Informative, "The `#{podspec}` specification does not validate."
+          end
+          raise Informative, "The `#{podspec}` specification does not validate." unless validator.validated?
+        end
+      end
+
+      # Checks that the repo is clean.
+      #
+      # @raise  If the repo is not clean.
+      #
+      # @todo   Add specs for staged and unstaged files.
+      #
+      # @todo   Gracefully handle the case where source is not under git 
+      #         source control.
+      #
+      # @return [void]
+      #
+      def check_repo_status
+        clean = Dir.chdir(repo_dir) { `git status --porcelain  2>&1` } == ''
+        raise Informative, "The repo `#{@repo}` is not clean" unless clean
+      end
+
+      # Updates the git repo against the remote.
+      #
+      # @return [void]
+      #
+      def update_repo
+        UI.puts "Updating the `#{@repo}' repo\n".yellow
+        Dir.chdir(repo_dir) { UI.puts `git pull 2>&1` }
+      end
+
+      # Commits the podspecs to the source, which should be a git repo.
+      #
+      # @note   The pre commit hook of the repo is skipped as the podspecs have
+      #         already been linted.
+      #
+      # @return [void]
+      #
+      def add_specs_to_repo
+        UI.puts "\nAdding the #{'spec'.pluralize(count)} to the `#{@repo}' repo\n".yellow
+        podspec_files.each do |spec_file|
+          spec = Pod::Specification.from_file(spec_file)
+          output_path = File.join(repo_dir, spec.name, spec.version.to_s)
+          if Pathname.new(output_path).exist?
+            message = "[Fix] #{spec}"
+          elsif Pathname.new(File.join(repo_dir, spec.name)).exist?
+            message = "[Update] #{spec}"
+          else
+            message = "[Add] #{spec}"
+          end
+          UI.puts " - #{message}"
+
+          FileUtils.mkdir_p(output_path)
+          FileUtils.cp(spec_file, output_path)
+          Dir.chdir(repo_dir) do
+            git!("add #{spec.name}")
+            git!("commit --no-verify -m '#{message}'")
+          end
+        end
+      end
+
+      # Pushes the git repo against the remote.
+      #
+      # @return [void]
+      #
+      def push_repo
+        UI.puts "\nPushing the `#{@repo}' repo\n".yellow
+        Dir.chdir(repo_dir) { UI.puts `git push 2>&1` }
+      end
+
+      #-----------------------------------------------------------------------#
+
+      private
+
+      # @!group Private helpers
+
+      # @return [Pathname] The directory of the repository.
+      #
+      def repo_dir
+        dir = config.repos_dir + @repo
+        raise Informative, "`#{@repo}` repo not found" unless dir.exist?
+        dir
+      end
+
+      # @return [Array<Pathname>] The path of the specifications to push.
+      #
+      def podspec_files
+        files = Pathname.glob(@podspec || "*.podspec")
+        raise Informative, "Couldn't find any .podspec file in current directory" if files.empty?
+        files
+      end
+
+      # @return [Integer] The number of the podspec files to push.
+      #
+      def count
+        podspec_files.count
+      end
+
+      #-----------------------------------------------------------------------#
+
+    end
+  end
+end

data/lib/cocoapods/command/repo.rb

@@ -0,0 +1,145 @@
+require 'fileutils'
+
+module Pod
+  class Command
+    class Repo < Command
+      self.abstract_command = true
+
+      # @todo should not show a usage banner!
+      #
+      self.summary = 'Manage spec-repositories'
+
+      class Add < Repo
+        self.summary = 'Add a spec repo.'
+
+        self.description = <<-DESC
+          Clones `URL` in the local spec-repos directory at `~/.cocoapods`. The
+          remote can later be referred to by `NAME`.
+        DESC
+
+        self.arguments = 'NAME URL [BRANCH]'
+
+        def initialize(argv)
+          @name, @url, @branch = argv.shift_argument, argv.shift_argument, argv.shift_argument
+          super
+        end
+
+        def validate!
+          super
+          unless @name && @url
+            help! "Adding a repo needs a `NAME` and a `URL`."
+          end
+        end
+
+        def run
+          UI.section("Cloning spec repo `#{@name}` from `#{@url}`#{" (branch `#{@branch}`)" if @branch}") do
+            config.repos_dir.mkpath
+            Dir.chdir(config.repos_dir) { git!("clone '#{@url}' #{@name}") }
+            Dir.chdir(dir) { git!("checkout #{@branch}") } if @branch
+            SourcesManager.check_version_information(dir)
+          end
+        end
+      end
+
+      #-----------------------------------------------------------------------#
+
+      class Update < Repo
+        self.summary = 'Update a spec repo.'
+
+        self.description = <<-DESC
+          Updates the local clone of the spec-repo `NAME`. If `NAME` is omitted
+          this will update all spec-repos in `~/.cocoapods`.
+        DESC
+
+        self.arguments = '[NAME]'
+
+        def initialize(argv)
+          @name = argv.shift_argument
+          super
+        end
+
+        def run
+          SourcesManager.update(@name, true)
+        end
+      end
+
+      #-----------------------------------------------------------------------#
+
+      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 = '[ NAME | DIRECTORY ]'
+
+        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
+
+        # @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
+          if @name
+            dirs = File.exists?(@name) ? [ Pathname.new(@name) ] : [ dir ]
+          else
+            dirs = config.repos_dir.children.select {|c| c.directory?}
+          end
+          dirs.each do |dir|
+            SourcesManager.check_version_information(dir)
+            UI.puts "\nLinting spec repo `#{dir.realpath.basename}`\n".yellow
+
+            validator = Source::HealthReporter.new(dir)
+            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
+
+      #-----------------------------------------------------------------------#
+
+      extend Executable
+      executable :git
+
+      def dir
+        config.repos_dir + @name
+      end
+    end
+  end
+end
+

data/lib/cocoapods/command/search.rb

@@ -0,0 +1,61 @@
+module Pod
+  class Command
+    class Search < Command
+      self.summary = 'Search pods'
+
+      self.description = <<-DESC
+        Searches for pods, ignoring case, whose name matches `QUERY'. If the
+        `--full' option is specified, this will also search in the summary and
+        description of the pods.
+      DESC
+
+      self.arguments = '[QUERY]'
+
+      def self.options
+        [
+          ["--full",  "Search by name, summary, and description"],
+          ["--stats", "Show additional stats (like GitHub watchers and forks)"],
+          ["--ios",   "Restricts the search to Pods supported on iOS"],
+          ["--osx",   "Restricts the search to Pods supported on OS X"]
+        ].concat(super)
+      end
+
+      def initialize(argv)
+        @full_text_search = argv.flag?('full')
+        @stats = argv.flag?('stats')
+        @supported_on_ios = argv.flag?('ios')
+        @supported_on_osx = argv.flag?('osx')
+        @query = argv.shift_argument
+        super
+      end
+
+      def validate!
+        super
+        help! "A search query is required." unless @query
+      end
+
+      def run
+        sets = SourcesManager.search_by_name(@query.strip, @full_text_search)
+        if @supported_on_ios
+          sets.reject!{ |set| !set.specification.available_platforms.map(&:name).include?(:ios) }
+        end
+        if @supported_on_osx
+          sets.reject!{ |set| !set.specification.available_platforms.map(&:name).include?(:osx) }
+        end
+
+        statistics_provider = Specification::Set::Statistics.new(STATISTICS_CACHE_FILE)
+        sets.each do |set|
+          begin
+            if @stats
+              UI.pod(set, :stats, statistics_provider)
+            else
+              UI.pod(set, :normal)
+            end
+          rescue DSLError
+            UI.warn "Skipping `#{set.name}` because the podspec contains errors."
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/setup.rb

@@ -0,0 +1,134 @@
+module Pod
+  class Command
+    class Setup < Command
+      self.summary = 'Setup the CocoaPods environment'
+
+      self.description = <<-DESC
+        Creates a directory at `~/.cocoapods` which will hold your spec-repos.
+        This is where it will create a clone of the public `master` spec-repo from:
+
+            https://github.com/CocoaPods/Specs
+
+        If the clone already exists, it will ensure that it is up-to-date.
+      DESC
+
+      def self.options
+        [["--push", "Use this option to enable push access once granted"]].concat(super)
+      end
+
+      extend Executable
+      executable :git
+
+      def initialize(argv)
+        @push_option  = argv.flag?('push')
+        super
+      end
+
+      def run
+        UI.section "Setting up CocoaPods master repo" do
+          if master_repo_dir.exist?
+            set_master_repo_url
+            set_master_repo_branch
+            update_master_repo
+          else
+            add_master_repo
+          end
+        end
+
+        access_type = push? ? "push" : "read-only"
+        UI.puts "Setup completed (#{access_type} access)".green
+      end
+
+      #--------------------------------------#
+
+      # @!group Setup steps
+
+      # Sets the url of the master repo according to whether it is push.
+      #
+      # @return [void]
+      #
+      def set_master_repo_url
+        Dir.chdir(master_repo_dir) do
+          git("remote set-url origin '#{url}'")
+        end
+      end
+
+      # Adds the master repo from the remote.
+      #
+      # @return [void]
+      #
+      def add_master_repo
+        @command ||= Repo::Add.parse(['master', url, 'master']).run
+      end
+
+      # Updates the master repo against the remote.
+      #
+      # @return [void]
+      #
+      def update_master_repo
+        SourcesManager.update('master', true)
+      end
+
+      # Sets the repo to the master branch.
+      #
+      # @note   This is not needed anymore as it was used for CocoaPods 0.6
+      #         release candidates.
+      #
+      # @return [void]
+      #
+      def set_master_repo_branch
+        Dir.chdir(master_repo_dir) do
+          git("checkout master")
+        end
+      end
+
+      #--------------------------------------#
+
+      # @!group Private helpers
+
+      # @return [String] the url to use according to whether push mode should
+      #         be enabled.
+      #
+      def url
+        (push?) ? read_write_url : read_only_url
+      end
+
+      # @return [String] the read only url of the master repo.
+      #
+      def read_only_url
+        'https://github.com/CocoaPods/Specs.git'
+      end
+
+      # @return [String] the read-write url of the master repo.
+      #
+      def read_write_url
+        'git@github.com:CocoaPods/Specs.git'
+      end
+
+      # Checks if the user asked to setup the master repo in push mode or if
+      # the repo was already in push mode.
+      #
+      # @return [String] whether the master repo should be set up in push mode.
+      #
+      def push?
+        @push ||= (@push_option || master_repo_is_push?)
+      end
+
+      # @return [Bool] if the master repo is already configured in push mode.
+      #
+      def master_repo_is_push?
+        return false unless master_repo_dir.exist?
+        Dir.chdir(master_repo_dir) do
+          url = git('config --get remote.origin.url')
+          url.chomp == read_write_url
+        end
+      end
+
+      # @return [Pathname] the directory of the master repo.
+      #
+      def master_repo_dir
+        SourcesManager.master_repo_dir
+      end
+    end
+  end
+end