xcocoapods 1.5.3

data/lib/cocoapods/external_sources/downloader_source.rb

@@ -0,0 +1,30 @@
+module Pod
+  module ExternalSources
+    # Provides support for fetching a specification file from a source handled
+    # by the downloader. Supports all the options of the downloader
+    #
+    # @note The podspec must be in the root of the repository and should have a
+    #       name matching the one of the dependency.
+    #
+    class DownloaderSource < AbstractExternalSource
+      # @see AbstractExternalSource#fetch
+      #
+      def fetch(sandbox)
+        pre_download(sandbox)
+      end
+
+      # @see AbstractExternalSource#description
+      #
+      def description
+        strategy = Downloader.strategy_from_options(params)
+        options = params.dup
+        url = options.delete(strategy)
+        result = "from `#{url}`"
+        options.each do |key, value|
+          result << ", #{key} `#{value}`"
+        end
+        result
+      end
+    end
+  end
+end

data/lib/cocoapods/external_sources/path_source.rb

@@ -0,0 +1,55 @@
+module Pod
+  module ExternalSources
+    # Provides support for fetching a specification file from a path local to
+    # the machine running the installation.
+    #
+    class PathSource < AbstractExternalSource
+      # @see  AbstractExternalSource#fetch
+      #
+      def fetch(sandbox)
+        title = "Fetching podspec for `#{name}` #{description}"
+        UI.titled_section(title,  :verbose_prefix => '-> ') do
+          podspec = podspec_path
+          unless podspec.exist?
+            raise Informative, "No podspec found for `#{name}` in " \
+              "`#{declared_path}`"
+          end
+          store_podspec(sandbox, podspec, podspec.extname == '.json')
+          is_absolute = absolute?(declared_path)
+          sandbox.store_local_path(name, podspec, is_absolute)
+          sandbox.remove_checkout_source(name)
+        end
+      end
+
+      # @see  AbstractExternalSource#description
+      #
+      def description
+        "from `#{declared_path}`"
+      end
+
+      private
+
+      # @!group Helpers
+
+      # @return [String] The path as declared by the user.
+      #
+      def declared_path
+        result = params[:path]
+        result.to_s if result
+      end
+
+      # @return [Pathname] The absolute path of the podspec.
+      #
+      def podspec_path
+        path = Pathname(normalized_podspec_path(declared_path))
+        path.exist? ? path : Pathname("#{path}.json")
+      end
+
+      # @return [Bool]
+      #
+      def absolute?(path)
+        Pathname(path).absolute? || path.to_s.start_with?('~')
+      end
+    end
+  end
+end

data/lib/cocoapods/external_sources/podspec_source.rb

@@ -0,0 +1,54 @@
+module Pod
+  module ExternalSources
+    # Provides support for fetching a specification file from an URL. Can be
+    # http, file, etc.
+    #
+    class PodspecSource < AbstractExternalSource
+      # @see AbstractExternalSource#fetch
+      #
+      def fetch(sandbox)
+        title = "Fetching podspec for `#{name}` #{description}"
+        UI.titled_section(title,  :verbose_prefix => '-> ') do
+          podspec_path = Pathname(podspec_uri)
+          is_json = podspec_path.extname == '.json'
+          if podspec_path.exist?
+            store_podspec(sandbox, podspec_path, is_json)
+          else
+            require 'cocoapods/open-uri'
+            begin
+              open(podspec_uri) { |io| store_podspec(sandbox, io.read, is_json) }
+            rescue OpenURI::HTTPError => e
+              status = e.io.status.join(' ')
+              raise Informative, "Failed to fetch podspec for `#{name}` at `#{podspec_uri}`.\n Error: #{status}"
+            end
+          end
+        end
+      end
+
+      # @see AbstractExternalSource#description
+      #
+      def description
+        "from `#{params[:podspec]}`"
+      end
+
+      private
+
+      # @!group Helpers
+
+      # @return [String] The uri of the podspec appending the name of the file
+      #         and expanding it if necessary.
+      #
+      # @note   If the declared path is expanded only if the represents a path
+      #         relative to the file system.
+      #
+      def podspec_uri
+        declared_path = params[:podspec].to_s
+        if declared_path =~ %r{^.+://}
+          declared_path
+        else
+          normalized_podspec_path(declared_path)
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/gem_version.rb

@@ -0,0 +1,5 @@
+module Pod
+  # The version of the CocoaPods command line tool.
+  #
+  VERSION = '1.5.3'.freeze unless defined? Pod::VERSION
+end

data/lib/cocoapods/generator/acknowledgements.rb

@@ -0,0 +1,107 @@
+module Pod
+  module Generator
+    class Acknowledgements
+      # @return [Array<Class>] The classes of the acknowledgements generator
+      #         subclasses.
+      #
+      def self.generators
+        [Plist, Markdown]
+      end
+
+      # @return [Array<Sandbox::FileAccessor>] the list of the file accessors
+      #         for the specs of the target that needs to generate the
+      #         acknowledgements.
+      #
+      attr_reader :file_accessors
+
+      # @param [Array<Sandbox::FileAccessor>] @see file_accessors.
+      #
+      def initialize(file_accessors)
+        @file_accessors = file_accessors
+      end
+
+      #-----------------------------------------------------------------------#
+
+      # !@group Configuration
+
+      # @return [String] The title of the acknowledgements file.
+      #
+      def header_title
+        'Acknowledgements'
+      end
+
+      # @return [String] A text to present before listing the acknowledgements.
+      #
+      def header_text
+        'This application makes use of the following third party libraries:'
+      end
+
+      # @return [String] The title of the foot notes.
+      #
+      def footnote_title
+        ''
+      end
+
+      # @return [String] the foot notes.
+      #
+      def footnote_text
+        'Generated by CocoaPods - https://cocoapods.org'
+      end
+
+      #-----------------------------------------------------------------------#
+
+      private
+
+      # !@group Private methods
+
+      # @return [Array<Specification>] The root specifications for which the
+      #         acknowledgements should be generated.
+      #
+      def specs
+        file_accessors.map { |accessor| accessor.spec.root }.uniq
+      end
+
+      # Returns the text of the license for the given spec.
+      #
+      # @param  [Specification] spec
+      #         the specification for which license is needed.
+      #
+      # @return [String] The text of the license.
+      # @return [Nil] If not license text could be found.
+      #
+      def license_text(spec)
+        return nil unless spec.license
+        text = spec.license[:text]
+        unless text
+          if license_file = spec.license[:file]
+            license_path = file_accessor(spec).root + license_file
+            if File.exist?(license_path)
+              text = IO.read(license_path)
+            else
+              UI.warn "Unable to read the license file `#{license_file}` " \
+              "for the spec `#{spec}`"
+            end
+          elsif license_file = file_accessor(spec).license
+            text = IO.read(license_file)
+          end
+        end
+        text
+      end
+
+      protected
+
+      # Returns the file accessor for the given spec.
+      #
+      # @param  [Specification] spec
+      #         the specification for which the file accessor is needed.
+      #
+      # @return [Sandbox::FileAccessor] The file accessor.
+      #
+      def file_accessor(spec)
+        file_accessors.find { |accessor| accessor.spec.root == spec }
+      end
+
+      #-----------------------------------------------------------------------#
+    end
+  end
+end

data/lib/cocoapods/generator/acknowledgements/markdown.rb

@@ -0,0 +1,44 @@
+module Pod
+  module Generator
+    class Markdown < Acknowledgements
+      def self.path_from_basepath(path)
+        Pathname.new(path.dirname + "#{path.basename}.markdown")
+      end
+
+      def save_as(path)
+        file = File.new(path, 'w')
+        file.write(licenses)
+        file.close
+      end
+
+      # @return [String] The contents of the acknowledgements in Markdown format.
+      #
+      def generate
+        licenses
+      end
+
+      def title_from_string(string, level)
+        unless string.empty?
+          '#' * level << " #{string}"
+        end
+      end
+
+      def string_for_spec(spec)
+        if (license_text = license_text(spec))
+          "\n" << title_from_string(spec.name, 2) << "\n\n" << license_text << "\n"
+        end
+      end
+
+      def licenses
+        licenses_string = "#{title_from_string(header_title, 1)}\n#{header_text}\n"
+        specs.each do |spec|
+          if (license = string_for_spec(spec))
+            license = license.force_encoding('UTF-8') if license.respond_to?(:force_encoding)
+            licenses_string += license
+          end
+        end
+        licenses_string += "#{title_from_string(footnote_title, 2)}#{footnote_text}\n"
+      end
+    end
+  end
+end

data/lib/cocoapods/generator/acknowledgements/plist.rb

@@ -0,0 +1,94 @@
+require 'stringio'
+
+module Pod
+  module Generator
+    class Plist < Acknowledgements
+      def self.path_from_basepath(path)
+        Pathname.new(path.dirname + "#{path.basename}.plist")
+      end
+
+      def save_as(path)
+        Xcodeproj::Plist.write_to_path(plist, path)
+      end
+
+      # @return [String] The contents of the plist
+      #
+      def generate
+        plist = Nanaimo::Plist.new(plist, :xml)
+        contents = StringIO.new
+        Nanaimo::Writer::XMLWriter.new(plist, :pretty => true, :output => contents, :strict => false).write
+        contents.string
+      end
+
+      def plist
+        {
+          :Title => plist_title,
+          :StringsTable => plist_title,
+          :PreferenceSpecifiers => licenses,
+        }
+      end
+
+      def plist_title
+        'Acknowledgements'
+      end
+
+      def licenses
+        licences_array = [header_hash]
+        specs.each do |spec|
+          if (hash = hash_for_spec(spec))
+            licences_array << hash
+          end
+        end
+        licences_array << footnote_hash
+      end
+
+      def hash_for_spec(spec)
+        if (license = license_text(spec))
+          hash =  {
+            :Type => 'PSGroupSpecifier',
+            :Title => sanitize_encoding(spec.name),
+            :FooterText => sanitize_encoding(license),
+          }
+          hash[:License] = sanitize_encoding(spec.license[:type]) if spec.license[:type]
+
+          hash
+        end
+      end
+
+      def header_hash
+        {
+          :Type => 'PSGroupSpecifier',
+          :Title => sanitize_encoding(header_title),
+          :FooterText => sanitize_encoding(header_text),
+        }
+      end
+
+      def footnote_hash
+        {
+          :Type => 'PSGroupSpecifier',
+          :Title => sanitize_encoding(footnote_title),
+          :FooterText => sanitize_encoding(footnote_text),
+        }
+      end
+
+      #-----------------------------------------------------------------------#
+
+      private
+
+      # !@group Private methods
+
+      # Returns the sanitized text with UTF-8 invalid characters eliminated.
+      #
+      # @param  [String] text
+      #         the text we want to sanitize.
+      #
+      # @return [String] The sanitized UTF-8 text.
+      #
+      def sanitize_encoding(text)
+        text.encode('UTF-8', :invalid => :replace, :undef => :replace, :replace => '')
+      end
+
+      #-----------------------------------------------------------------------#
+    end
+  end
+end

data/lib/cocoapods/generator/app_target_helper.rb

@@ -0,0 +1,244 @@
+module Pod
+  module Generator
+    # Stores the common logic for creating app targets within projects including
+    # generating standard import and main files for app hosts.
+    #
+    module AppTargetHelper
+      # Adds a single app target to the given project with the provided name.
+      #
+      # @param  [Project] project
+      #         the Xcodeproj to generate the target into.
+      #
+      # @param  [Symbol] platform
+      #         the platform of the target. Can be `:ios` or `:osx`, etc.
+      #
+      # @param  [String] deployment_target
+      #         the deployment target for the platform.
+      #
+      # @param  [String] name
+      #         The name to use for the target, defaults to 'App'.
+      #
+      # @return [PBXNativeTarget] the new target that was created.
+      #
+      def self.add_app_target(project, platform, deployment_target, name = 'App')
+        project.new_target(:application, name, platform, deployment_target)
+      end
+
+      # Creates and links an import file for the given pod target and into the given native target.
+      #
+      # @param  [Project] project
+      #         the Xcodeproj to generate the target into.
+      #
+      # @param  [PBXNativeTarget] target
+      #         the native target to link the generated import file into.
+      #
+      # @param  [PodTarget] pod_target
+      #         the pod target to use for when generating the contents of the import file.
+      #
+      # @param  [Symbol] platform
+      #         the platform of the target. Can be `:ios` or `:osx`, etc.
+      #
+      # @param  [String] name
+      #         The name to use for the target, defaults to 'App'.
+      #
+      # @return [Array<PBXBuildFile>] the created build file references.
+      #
+      def self.add_app_project_import(project, target, pod_target, platform, name = 'App')
+        source_file = AppTargetHelper.create_app_import_source_file(project, pod_target, platform, name)
+        group = project[name] || project.new_group(name, name)
+        source_file_ref = group.new_file(source_file)
+        target.add_file_references([source_file_ref])
+      end
+
+      # Creates and links an empty Swift file for the given target.
+      #
+      # @param  [Project] project
+      #         the Xcodeproj to generate the target into.
+      #
+      # @param  [PBXNativeTarget] target
+      #         the native target to link the generated import file into.
+      #
+      # @param  [String] name
+      #         The name to use for the target, defaults to 'App'.
+      #
+      # @return [Array<PBXBuildFile>] the created build file references.
+      #
+      def self.add_empty_swift_file(project, target, name = 'App')
+        swift_file = project.path.dirname.+("#{name}/dummy.swift")
+        swift_file.parent.mkpath
+        File.write(swift_file, '')
+        group = project[name] || project.new_group(name, name)
+        swift_file_ref = group.new_file(swift_file)
+        target.add_file_references([swift_file_ref])
+      end
+
+      # Creates and links a default app host 'main.m' file.
+      #
+      # @param  [Project] project
+      #         the Xcodeproj to generate the target into.
+      #
+      # @param  [PBXNativeTarget] target
+      #         the native target to link the generated main file into.
+      #
+      # @param  [Symbol] platform
+      #         the platform of the target. Can be `:ios` or `:osx`, etc.
+      #
+      # @param  [String] name
+      #         The name to use for the target, defaults to 'App'.
+      #
+      # @return [Array<PBXBuildFile>] the created build file references.
+      #
+      def self.add_app_host_main_file(project, target, platform, name = 'App')
+        source_file = AppTargetHelper.create_app_host_main_file(project, platform, name)
+        source_file_ref = project.new_group(name, name).new_file(source_file)
+        target.add_file_references([source_file_ref])
+      end
+
+      # Adds the xctest framework search paths into the given target.
+      #
+      # @param  [PBXNativeTarget] target
+      #         the native target to add XCTest into.
+      #
+      # @return [void]
+      #
+      def self.add_xctest_search_paths(target)
+        target.build_configurations.each do |configuration|
+          search_paths = configuration.build_settings['FRAMEWORK_SEARCH_PATHS'] ||= '$(inherited)'
+          search_paths << ' "$(PLATFORM_DIR)/Developer/Library/Frameworks"'
+        end
+      end
+
+      # Adds the provided swift version into the given target.
+      #
+      # @param  [PBXNativeTarget] target
+      #         the native target to add the swift version into.
+      #
+      # @param  [String] swift_version
+      #         the swift version to set to.
+      #
+      # @return [void]
+      #
+      def self.add_swift_version(target, swift_version)
+        raise 'Cannot set empty Swift version to target.' if swift_version.blank?
+        target.build_configurations.each do |configuration|
+          configuration.build_settings['SWIFT_VERSION'] = swift_version
+        end
+      end
+
+      # Creates a default import file for the given pod target.
+      #
+      # @param  [Project] project
+      #         the Xcodeproj to generate the target into.
+      #
+      # @param  [PodTarget] pod_target
+      #         the pod target to use for when generating the contents of the import file.
+      #
+      # @param  [Symbol] platform
+      #         the platform of the target. Can be `:ios` or `:osx`, etc.
+      #
+      # @param  [String] name
+      #         The name of the folder to use and save the generated main file.
+      #
+      # @return [Pathname] the new source file that was generated.
+      #
+      def self.create_app_import_source_file(project, pod_target, platform, name = 'App')
+        language = pod_target.uses_swift? ? :swift : :objc
+
+        if language == :swift
+          source_file = project.path.dirname.+("#{name}/main.swift")
+          source_file.parent.mkpath
+          import_statement = pod_target.should_build? && pod_target.defines_module? ? "import #{pod_target.product_module_name}\n" : ''
+          source_file.open('w') { |f| f << import_statement }
+        else
+          source_file = project.path.dirname.+("#{name}/main.m")
+          source_file.parent.mkpath
+          import_statement = if pod_target.should_build? && pod_target.defines_module?
+                               "@import #{pod_target.product_module_name};\n"
+                             else
+                               header_name = "#{pod_target.product_module_name}/#{pod_target.product_module_name}.h"
+                               if pod_target.sandbox.public_headers.root.+(header_name).file?
+                                 "#import <#{header_name}>\n"
+                               else
+                                 ''
+                               end
+                             end
+          source_file.open('w') do |f|
+            f << "@import Foundation;\n"
+            f << "@import UIKit;\n" if platform == :ios || platform == :tvos
+            f << "@import Cocoa;\n" if platform == :osx
+            f << "#{import_statement}int main() {}\n"
+          end
+        end
+        source_file
+      end
+
+      # Creates a default app host 'main.m' file.
+      #
+      # @param  [Project] project
+      #         the Xcodeproj to generate the target into.
+      #
+      # @param  [Symbol] platform
+      #         the platform of the target. Can be `:ios` or `:osx`.
+      #
+      # @param  [String] name
+      #         The name of the folder to use and save the generated main file.
+      #
+      # @return [Pathname] the new source file that was generated.
+      #
+      def self.create_app_host_main_file(project, platform, name = 'App')
+        source_file = project.path.dirname.+("#{name}/main.m")
+        source_file.parent.mkpath
+        source_file.open('w') do |f|
+          case platform
+          when :ios, :tvos
+            f << IOS_APP_HOST_MAIN_CONTENTS
+          when :osx
+            f << MACOS_APP_APP_HOST_MAIN_CONTENTS
+          end
+        end
+        source_file
+      end
+
+      IOS_APP_HOST_MAIN_CONTENTS = <<EOS.freeze
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+
+@interface CPTestAppHostAppDelegate : UIResponder <UIApplicationDelegate>
+
+@property (nonatomic, strong) UIWindow *window;
+
+@end
+
+@implementation CPTestAppHostAppDelegate
+
+- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
+{
+    self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
+    self.window.rootViewController = [UIViewController new];
+
+    [self.window makeKeyAndVisible];
+
+    return YES;
+}
+
+@end
+
+int main(int argc, char *argv[])
+{
+    @autoreleasepool
+    {
+        return UIApplicationMain(argc, argv, nil, NSStringFromClass([CPTestAppHostAppDelegate class]));
+    }
+}
+EOS
+
+      MACOS_APP_APP_HOST_MAIN_CONTENTS = <<EOS.freeze
+#import <Cocoa/Cocoa.h>
+
+int main(int argc, const char * argv[]) {
+    return NSApplicationMain(argc, argv);
+}
+EOS
+    end
+  end
+end