cocoapods 0.5.1 → 0.6.0.rc1

data/lib/cocoapods/command/error_report.rb

@@ -0,0 +1,102 @@
+# encoding: UTF-8
+
+require 'rbconfig'
+require 'cgi'
+require 'rubygems'
+
+module Pod
+  class Command
+    module ErrorReport
+      class << self
+        def report(error)
+          return <<-EOS
+
+#{'――― MARKDOWN TEMPLATE ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――'.reversed}
+
+### Report
+
+* What did you do?
+
+* What did you expect to happen?
+
+* What happened instead?
+
+
+### Stack
+
+```
+   CocoaPods : #{Pod::VERSION}
+        Ruby : #{RUBY_DESCRIPTION}
+    RubyGems : #{Gem::VERSION}
+        Host : #{host_information}
+       Xcode : #{xcode_information}
+Ruby lib dir : #{RbConfig::CONFIG['libdir']}
+Repositories : #{repo_information.join("\n               ")}
+```
+#{markdown_podfile}
+### Error
+
+```
+#{error.message}
+#{error.backtrace.join("\n")}
+```
+
+#{'――― TEMPLATE END ――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――'.reversed}
+
+#{'[!] Oh no, an error occurred.'.red}
+#{error_from_podfile(error)}
+#{'Search for existing github issues similar to yours:'.yellow}
+#{"https://github.com/CocoaPods/CocoaPods/issues/search?q=#{CGI.escape(error.message)}"}
+
+#{'If none exists, create a ticket, with the template displayed above, on:'.yellow}
+https://github.com/CocoaPods/CocoaPods/issues/new
+
+Don't forget to anonymize any private data!
+
+EOS
+        end
+
+        private
+
+        def markdown_podfile
+          return '' unless Config.instance.project_podfile && Config.instance.project_podfile.exist?
+<<-EOS
+
+### Podfile
+
+```ruby
+#{Config.instance.project_podfile.read.strip}
+```
+EOS
+        end
+
+        def error_from_podfile(error)
+          if error.message =~ /Podfile:(\d*)/
+            "\nIt appears to have originated from your Podfile at line #{$1}.\n"
+          end
+        end
+
+        def host_information
+          product, version, build =`sw_vers`.strip.split("\n").map { |line| line.split(":").last.strip }
+          "#{product} #{version} (#{build})"
+        end
+
+        def xcode_information
+          version, build = `xcodebuild -version`.strip.split("\n").map { |line| line.split(" ").last }
+          "#{version} (#{build})"
+        end
+
+        def repo_information
+          Pod::Source.all.map do |source|
+            repo = source.repo
+            Dir.chdir(repo) do
+              url = `git config --get remote.origin.url`.strip
+              sha = `git rev-parse HEAD`.strip
+              "#{repo.basename} - #{url} @ #{sha}"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/install.rb

@@ -4,45 +4,53 @@ module Pod
       def self.banner
 %{Installing dependencies of a project:
 
-    $ pod install [PROJECT]
+    $ pod install
 
       Downloads all dependencies defined in `Podfile' and creates an Xcode
       Pods library project in `./Pods'.
 
-      In case `PROJECT' is given, it configures it to use the specified Pods
-      and generates a workspace with the Pods project and `PROJECT'. (It is
-      important that once you have run this you open the workspace instead of
-      `PROJECT'.) You usually specify `PROJECT' only the first time that you
-      run `pod install'.
+      The Xcode project file should be specified in your `Podfile` like this:
+
+        xcodeproj 'path/to/XcodeProject'
+
+      If no xcodeproj is specified, then a search for an Xcode project will
+      be made.  If more than one Xcode project is found, the command will
+      raise an error.
+
+      This will configure the project to reference the Pods static library,
+      add a build configuration file, and add a post build script to copy
+      Pod resources.
 }
       end
 
       def self.options
-        "    --no-clean  Leave SCM dirs like `.git' and `.svn' in tact after downloading\n" +
-        "    --no-update Skip running `pod repo update` before install\n" +
-        super
+        [
+          ["--no-clean",     "Leave SCM dirs like `.git' and `.svn' intact after downloading"],
+          ["--no-doc",       "Skip documentation generation with appledoc"],
+          ["--no-integrate", "Skip integration of the Pods libraries in the Xcode project(s)"],
+          ["--no-update",    "Skip running `pod repo update` before install"],
+        ].concat(super)
       end
 
       def initialize(argv)
-        config.clean = !argv.option('--no-clean')
-        @update_repo = !argv.option('--no-update')
-        @projpath = argv.shift_argument
+        config.clean             = !argv.option('--no-clean')
+        config.generate_docs     = !argv.option('--no-doc')
+        config.integrate_targets = !argv.option('--no-integrate')
+        @update_repo             = !argv.option('--no-update')
         super unless argv.empty?
       end
 
       def run
-        unless podfile = config.rootspec
+        unless podfile = config.podfile
           raise Informative, "No `Podfile' found in the current working directory."
         end
-        if @projpath && !File.exist?(@projpath)
-          raise Informative, "The specified project `#{@projpath}' does not exist."
-        end
+
         if @update_repo
+          print_title 'Updating Spec Repositories', true
           Repo.new(ARGV.new(["update"])).run
         end
-        installer = Installer.new(podfile)
-        installer.install!
-        installer.configure_project(@projpath) if @projpath
+
+        Installer.new(podfile).install!
       end
     end
   end

data/lib/cocoapods/command/list.rb

@@ -2,24 +2,67 @@ module Pod
   class Command
     class List < Command
       def self.banner
-%{List all pods:
+        %{List all pods:
 
     $ pod list
 
-      Lists all available pods.}
+      Lists all available pods.
+
+    $ pod list new
+
+      Lists the pods introduced in the master repository since the last check.}
+      end
+
+      def self.options
+        [["--update", "Run `pod repo update` before listing"]].concat(Presenter.options).concat(super)
       end
 
+      extend Executable
+      executable :git
+
       def initialize(argv)
+        @update    = argv.option('--update')
+        @new       = argv.option('new')
+        @presenter = Presenter.new(argv)
+        super unless argv.empty?
       end
 
-      def run
-        Source.all.each do |source|
-          source.pod_sets.each do |set|
-            puts "==> #{set.name} (#{set.versions.reverse.join(", ")})"
-            puts "    #{set.specification.summary.strip}"
-            puts
+      def list_all
+        sets = Source.all_sets
+        sets.each {|s| puts @presenter.describe(s)}
+        puts "\n#{sets.count} pods were found"
+      end
+
+      def list_new
+        days = [1,2,3,5,8]
+        dates, groups = {}, {}
+        days.each {|d| dates[d] = Time.now - 60 * 60 * 24 * d}
+        sets = Source.all_sets
+        creation_dates = Pod::Specification::Statistics.instance.creation_dates(sets)
+
+        sets.each do |set|
+          set_date = creation_dates[set.name]
+          days.each do |d|
+            if set_date >= dates[d]
+              groups[d] = [] unless groups[d]
+              groups[d] << set
+              break
+            end
           end
         end
+        days.reverse.each do |d|
+          sets = groups[d]
+          next unless sets
+          puts "\nPods added in the last #{d == 1 ? 'day' : "#{d} days"}".yellow
+          sets.sort_by {|s| creation_dates[s.name]}.each {|s| puts @presenter.describe(s)}
+        end
+      end
+
+      def run
+        puts "\nUpdating Spec Repositories\n".yellow if @update && config.verbose?
+        Repo.new(ARGV.new(["update"])).run           if @update
+        @new ? list_new : list_all
+        puts
       end
     end
   end

data/lib/cocoapods/command/presenter.rb

@@ -0,0 +1,61 @@
+module Pod
+  class Command
+    class Presenter
+      def self.options
+        [["--stats", "Show additional stats (like GitHub watchers and forks)"]]
+      end
+
+      autoload :CocoaPod, 'cocoapods/command/presenter/cocoa_pod'
+
+      def initialize(argv)
+        @stats = argv.option('--stats')
+      end
+
+      def render(array)
+        result = "\n"
+        seats.each {|s| puts describe(s)}
+        result
+      end
+
+      def describe(set)
+        pod = CocoaPod.new(set)
+        result = "\n--> #{pod.name} (#{pod.versions})\n".green
+        result << wrap_string(pod.summary)
+        result << detail('Homepage', pod.homepage)
+        result << detail('Source',   pod.source_url)
+        if @stats
+          result << detail('Pushed',   pod.github_last_activity)
+          result << detail('Authors',  pod.authors) if pod.authors =~ /,/
+          result << detail('Author',   pod.authors) if pod.authors !~ /,/
+          result << detail('License',  pod.license)
+          result << detail('Platform', pod.platform)
+          result << detail('Watchers', pod.github_watchers)
+          result << detail('Forks',    pod.github_forks)
+        end
+        result << detail('Sub specs', pod.subspecs)
+        result
+      end
+
+      private
+
+      # adapted from http://blog.macromates.com/2006/wrapping-text-with-regular-expressions/
+      def wrap_string(txt, col = 80, indentation = 4)
+        indent = ' ' * indentation
+        txt.strip.gsub(/(.{1,#{col}})( +|$)\n?|(.{#{col}})/, indent + "\\1\\3\n")
+      end
+
+      def detail(title, value)
+        return '' if !value
+        ''.tap do |t|
+          t << "    - #{title}:".ljust(16)
+          if value.class == Array
+            separator = "\n      - "
+            t << separator << value.join(separator)
+          else
+            t << value.to_s << "\n"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/command/presenter/cocoa_pod.rb

@@ -0,0 +1,123 @@
+module Pod
+  class Command
+    class Presenter
+      class CocoaPod
+        attr_accessor :set
+
+        def initialize(set)
+          @set = set
+        end
+
+        # set information
+        def name
+          @set.name
+        end
+
+        def version
+          @set.versions.last
+        end
+
+        def versions
+          @set.versions.reverse.join(", ")
+        end
+
+        # specification information
+        def spec
+          @set.specification
+        end
+
+        def authors
+          oxfordify spec.authors.keys
+        end
+
+        def homepage
+          spec.homepage
+        end
+
+        def description
+          spec.description
+        end
+
+        def summary
+          spec.summary
+        end
+
+        def source_url
+          spec.source.reject {|k,_| k == :commit || k == :tag }.values.first
+        end
+
+        def platform
+          spec.available_platforms.sort { |a,b| a.to_s.downcase <=> b.to_s.downcase }.join(' - ')
+        end
+
+        def license
+          spec.license[:type] if spec.license
+        end
+
+        # will return array of all subspecs (recursevly) or nil
+        def subspecs
+          (spec.recursive_subspecs.any? && spec.recursive_subspecs) || nil
+        end
+
+        # Statistics information
+        def creation_date
+          Pod::Specification::Statistics.instance.creation_date(@set)
+        end
+
+        def github_watchers
+          Pod::Specification::Statistics.instance.github_watchers(@set)
+        end
+
+        def github_forks
+          Pod::Specification::Statistics.instance.github_forks(@set)
+        end
+
+        def github_last_activity
+          distance_from_now_in_words(Pod::Specification::Statistics.instance.github_pushed_at(@set))
+        end
+
+        def ==(other)
+          self.class === other && @set == other.set
+        end
+
+        def eql?(other)
+         self.class === other && name.eql?(other.name)
+        end
+
+        def hash
+          name.hash
+        end
+
+        private
+        def oxfordify words
+          if words.size < 3
+            words.join ' and '
+          else
+            "#{words[0..-2].join(', ')}, and #{words.last}"
+          end
+        end
+
+        def distance_from_now_in_words(from_time)
+          return nil unless from_time
+          from_time = Time.parse(from_time)
+          to_time = Time.now
+          distance_in_days = (((to_time - from_time).abs)/60/60/24).round
+
+          case distance_in_days
+          when 0..7
+            "less than a week ago"
+          when 8..29
+            "#{distance_in_days} days ago"
+          when 30..45
+            "1 month ago"
+          when 46..365
+            "#{(distance_in_days.to_f / 30).round} months ago"
+          else
+            "more than a year ago"
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/cocoapods/command/push.rb

@@ -0,0 +1,102 @@
+require 'fileutils'
+
+module Pod
+  class Command
+    class Push < Command
+      def self.banner
+        %{Pushing new specifications to a spec-repo:
+
+  $ pod push [REPO]
+
+    Validates `*.podspec' in the current working dir, updates
+    the local copy of the repository named REPO, adds specifications
+    to REPO, and finally it pushes REPO to its remote.}
+      end
+
+      def self.options
+        [["--allow-warnings", "Allows to push if warnings are not evitable"]].concat(super)
+      end
+
+      extend Executable
+      executable :git
+
+      def initialize(argv)
+        @allow_warnings = argv.option('--allow-warnings')
+        @repo = argv.shift_argument
+        super unless argv.empty? && @repo
+      end
+
+      def run
+        validate_podspec_files
+        check_repo_status
+        update_repo
+        add_specs_to_repo
+        push_repo
+        puts
+      end
+
+      private
+
+      def update_repo
+        puts "Updating the `#{@repo}' repo\n".yellow unless config.silent
+        # show the output of git even if not verbose
+        Dir.chdir(repo_dir) { puts `git pull 2>&1` }
+      end
+
+      def push_repo
+        puts "\nPushing the `#{@repo}' repo\n".yellow unless config.silent
+        Dir.chdir(repo_dir) { puts `git push 2>&1` }
+      end
+
+      def repo_dir
+        dir = config.repos_dir + @repo
+        raise Informative, "[!] `#{@repo}' repo not found".red unless dir.exist?
+        dir
+      end
+
+      def check_repo_status
+        # TODO: add specs for staged and unstaged files (tested manually)
+        clean = Dir.chdir(repo_dir) { `git status --porcelain  2>&1` } == ''
+        raise Informative, "[!] `#{@repo}' repo not clean".red unless clean
+      end
+
+      def podspec_files
+        files = Pathname.glob("*.podspec")
+        raise Informative, "[!] Couldn't find .podspec file in current directory".red if files.empty?
+        files
+      end
+
+      def validate_podspec_files
+        puts "\nValidating specs".yellow unless config.silent
+        lint_argv = ["lint"]
+        lint_argv << "--only-errors" if @allow_warnings
+        lint_argv << "--silent" if config.silent
+        all_valid = Spec.new(ARGV.new(lint_argv)).run
+      end
+
+      def add_specs_to_repo
+        puts "\nAdding the specs to the #{@repo} repo\n".yellow unless config.silent
+        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
+          puts " - #{message}" unless config.silent
+
+          FileUtils.mkdir_p(output_path)
+          FileUtils.cp(Pathname.new(spec.name+'.podspec'), output_path)
+          Dir.chdir(repo_dir) do
+            git("add #{spec.name}")
+            # Bypass the pre-commit hook because we already performed validation
+            git("commit --no-verify -m '#{message}'")
+          end
+        end
+      end
+    end
+  end
+end