cocoapods 0.36.4 → 0.37.0.beta.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 95984b64c13cb23f477eff2906659dbd76d1d522
-  data.tar.gz: 2f1c29bfb21e2a5d921a88891da091b02084bb97
+  metadata.gz: ab74bb5d0f584952ffd9115c2e61a0b624b9fb03
+  data.tar.gz: a935b3bff32b56d454932f95bff73eb4b6b780b5
 SHA512:
-  metadata.gz: ddb355e60588c50b120453daf9a67fb2280f20e45dd1eb853c6f55945fffde882b4126211c8b00358ed7a2c34fa67f56a3ec8fba51526a5f5e5569ebefedaaa1
-  data.tar.gz: a41f06c36dd9c75ac731b7f9cc8672fd99625c363bffcd73fa444ad518da23ac897511c157772744a180430a132072701f3d3d3b7e841a39f17c1e7282885018
+  metadata.gz: b4c2c341908e2cceb3ee3ad114c21296648f583a19e1f11f31c062540727b3647c64e4fcab70ac8d3d32c3903fd0c611bd638eee052ce527a1fccfe2494e6921
+  data.tar.gz: d0161a847678e8d4d35efdf85dbf95e03dfc477af4348849c2230c84864b40096f5aeb287b9d9fbbf36473ee939527bfce4440b341e4839cda943bd99cd8d41b

data/CHANGELOG.md

@@ -4,6 +4,60 @@ To install or update CocoaPods see this [guide](http://docs.cocoapods.org/guides
 
 To install release candidates run `[sudo] gem install cocoapods --pre`
 
+## 0.37.0.beta.1
+
+##### Enhancements
+
+* Allow the specification of custom module map files.  
+  [Samuel Giddins](https://github.com/segiddins)
+  [Marius Rackwitz](https://github.com/mrackwitz)
+  [#3145](https://github.com/CocoaPods/CocoaPods/issues/3145)
+
+* Show the source URI for local Pod specification repositories in
+  `pod repo list`.  
+  [Kyle Fuller](https://github.com/kylef)
+
+* Only show a warning when there is a minimum deployment target mismatch
+  between target and spec, instead of throwing a hard error.  
+  [Samuel Giddins](https://github.com/segiddins)
+  [#1241](https://github.com/CocoaPods/CocoaPods/issues/1241)
+
+* Add download caching for pods, which speeds up `pod install` and linting,
+  potentially by several orders of magnitude.  
+  [Samuel Giddins](https://github.com/segiddins)
+  [#2863](https://github.com/CocoaPods/CocoaPods/issues/2863)
+  [#3172](https://github.com/CocoaPods/CocoaPods/issues/3172)
+
+* Add a `--fail-fast` option to both `pod spec lint` and `pod lib lint` that
+  causes the linter to exit as soon as a single subspec or platform fails
+  linting.  
+  [Marius Rackwitz](https://github.com/mrackwitz)
+
+* Naïvely prevent base xcconfig warnings for targets that have custom
+  config files set.  
+  [Chris Brauchli](https://github.com/cbrauchli)
+  [#2633](https://github.com/CocoaPods/CocoaPods/issues/2633)
+
+* Ensure private headers are declared as such in a framework's generated module
+  map.  
+  [Samuel Giddins](https://github.com/segiddins)
+  [#2974](https://github.com/CocoaPods/CocoaPods/issues/2974)
+
+##### Bug Fixes
+
+* Do not pass code-sign arguments to xcodebuild when linting OS X targets.  
+  [Boris Bügling](https://github.com/neonichu)
+  [#3310](https://github.com/CocoaPods/CocoaPods/issues/3310)
+
+* Fixes an issue showing the URL to remote resources in `pod repo list`.  
+  [Kyle Fuller](https://github.com/kylef)
+
+* Fixes a problem with code signing when integrating CocoaPods
+  into a Today Widget extension.  
+  [Christian Sampaio](https://github.com/chrisfsampaio)
+  [#3390](https://github.com/CocoaPods/CocoaPods/pull/3390)
+
+
 ## 0.36.4
 
 ##### Bug Fixes

data/LICENSE

@@ -1,7 +1,13 @@
 This project is licensed under the MIT license.
 
-Copyright (c) 2011 - 2014 Eloy Durán <eloy.de.enige@gmail.com>
-Copyright (c) 2012 - 2014 Fabio Pelosin <fabiopelosin@gmail.com>
+Copyright (c) 2011 - 2015 Eloy Durán <eloy.de.enige@gmail.com>,
+                          Fabio Pelosin <fabiopelosin@gmail.com>,
+                          Samuel Giddins <segiddins@segiddins.me>,
+                          Marius Rackwitz <git@mariusrackwitz.de>,
+                          Kyle Fuller <kyle@fuller.li>,
+                          Boris Bügling <boris@buegling.com>,
+                          Orta Therox <orta.therox@gmail.com>, and
+                          Olivier Halligon <olivier@halligon.net>.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -8,39 +8,60 @@
 
 CocoaPods manages dependencies for your Xcode projects.
 
-You specify the dependencies for your project in one easy text file. CocoaPods
-resolves dependencies between libraries, fetches source code for the
-dependencies, and creates and maintains an Xcode workspace to build your
-project.
-
-Ultimately, the goal is to improve discoverability of, and engagement in, third
-party open-source libraries, by creating a more centralized ecosystem.
+You specify the dependencies for your project in a simple text file: your `Podfile`. 
+CocoaPods recursively resolves dependencies between libraries, fetches 
+source code for all dependencies, and creates and maintains an Xcode 
+workspace to build your project.
 
 Installing and updating CocoaPods is very easy. Don't miss the [Installation
 guide](http://guides.cocoapods.org/using/getting-started.html#installation) and the
-[Getting started guide](http://guides.cocoapods.org/using/getting-started.html).
+[Getting started guide](https://guides.cocoapods.org/using/getting-started.html).
+
+## Project Goals
+
+CocoaPods aims to improve the engagement with, and discoverability 
+of, third party open-source Cocoa libraries. These
+project goals influence and drive the design of CocoaPods:
+
+- Create and share libraries, and use them in your own projects,
+  without creating extra work for library authors. Integrate
+  non-CocoaPods libraries and hack on your own fork of any
+  CocoaPods library with a simple transparent `Podspec` standard.
+- Allow library authors to structure their libraries however they like.
+- Save time for library authors by automating a lot of Xcode work not 
+  related to their libraries' functionality.
+- Support any source management system. (Currently supported are git, 
+  svn, mercurial, bazaar, and various types of archives downloaded over HTTP.)
+- Promote a culture of distributed collaboration on pods, but also provide
+  features only possible with a centralised solution to foster a community.
+- Build tools on top of the core Cocoa development system, including those 
+  typically deployed to other operating systems, such as web-services.
+- Provide opinionated and automated integration, but make it completely
+  optional. You may manually integrate your CocoaPods dependencies
+  into your Xcode project as you see fit, with or without a workspace.
+- Solve everyday problems for Cocoa and Xcode developers.
 
 ## Sponsors
 
-Lovingly sponsored by a collection of companies, see the footer of [CocoaPods.org](http://cocoapods.org) for an up-to-date list. 
+Lovingly sponsored by a collection of companies, see the footer of [CocoaPods.org](https://cocoapods.org) for an up-to-date list. 
 
 ## Collaborate
 
 All CocoaPods development happens on GitHub. Contributions make for good karma and
-we [welcome new](http://blog.cocoapods.org/starting-open-source/) contributors with joy. We take contributors seriously, and thus have a 
+we [welcome new](https://blog.cocoapods.org/starting-open-source/) contributors with joy. We take contributors seriously, and thus have a 
 contributor [code of conduct](CODE_OF_CONDUCT.md).
 
 ## Links
 
 | Link | Description |
 | :----- | :------ |
-[CocoaPods.org](http://cocoapods.org/) | Homepage and search for Pods.
-[@CocoaPods](http://twitter.com/CocoaPods) | Follow CocoaPods on Twitter to stay up to date.
-[Blog](http://blog.cocoapods.org) | The CocoaPods blog.
+[CocoaPods.org](https://cocoapods.org/) | Homepage and search for Pods.
+[@CocoaPods](https://twitter.com/CocoaPods) | Follow CocoaPods on Twitter to stay up to date.
+[Blog](https://blog.cocoapods.org) | The CocoaPods blog.
 [Mailing List](http://groups.google.com/group/cocoapods) | Feel free to ask any kind of question.
-[Guides](http://guides.cocoapods.org) | Everything you want to know about CocoaPods.
+[Guides](https://guides.cocoapods.org) | Everything you want to know about CocoaPods.
 [Changelog](https://github.com/CocoaPods/CocoaPods/blob/master/CHANGELOG.md) | See the changes introduced in each CocoaPods version.
-[New Pods RSS](http://feeds.cocoapods.org/new-pods.rss) | Don't miss any new Pods.
+[New Pods RSS](https://feeds.cocoapods.org/new-pods.rss) | Don't miss any new Pods.
 [Code of Conduct](CODE_OF_CONDUCT.md) | Find out the standards we hold ourselves to.
 
 ## Projects
@@ -49,7 +70,7 @@ CocoaPods is composed of the following projects:
 
 | Status | Project | Description | Info |
 | :----- | :------ | :--- | :--- |
-| [![Build Status](http://img.shields.io/travis/CocoaPods/CocoaPods/master.svg?style=flat)](http://travis-ci.org/CocoaPods/CocoaPods) | [CocoaPods](https://github.com/CocoaPods/CocoaPods) | The CocoaPods command line tool. | [guides](http://guides.cocoapods.org)
+| [![Build Status](http://img.shields.io/travis/CocoaPods/CocoaPods/master.svg?style=flat)](http://travis-ci.org/CocoaPods/CocoaPods) | [CocoaPods](https://github.com/CocoaPods/CocoaPods) | The CocoaPods command line tool. | [guides](https://guides.cocoapods.org)
 | [![Build Status](http://img.shields.io/travis/CocoaPods/Core/master.svg?style=flat)](http://travis-ci.org/CocoaPods/Core) | [CocoaPods Core](https://github.com/CocoaPods/Core) | Support for working with specifications and podfiles. | [docs](http://docs.cocoapods.org/cocoapods_core)
 | [![Build Status](http://img.shields.io/travis/CocoaPods/cocoapods-downloader/master.svg?style=flat)](http://travis-ci.org/CocoaPods/cocoapods-downloader) |[CocoaPods Downloader](https://github.com/CocoaPods/cocoapods-downloader) |  Downloaders for various source types. |  [docs](http://docs.cocoapods.org/cocoapods_downloader/index.html)
 | [![Build Status](http://img.shields.io/travis/CocoaPods/Xcodeproj/master.svg?style=flat)](https://travis-ci.org/CocoaPods/Xcodeproj) | [Xcodeproj](https://github.com/CocoaPods/Xcodeproj) | Create and modify Xcode projects from Ruby. |  [docs](http://docs.cocoapods.org/xcodeproj/index.html)

data/lib/cocoapods/command/lib.rb

@@ -113,6 +113,7 @@ module Pod
            ['--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 dependant pods ' \
             '(defaults to https://github.com/CocoaPods/Specs.git). '\
@@ -123,6 +124,7 @@ module Pod
           @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')
@@ -142,6 +144,7 @@ module Pod
             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

data/lib/cocoapods/command/repo.rb

@@ -24,37 +24,6 @@ module Pod
       def dir
         config.repos_dir + @name
       end
-
-      # Returns the branch name (i.e. master).
-      #
-      # @return [String] The name of the current branch.
-      #
-      def branch_name
-        `git name-rev --name-only HEAD`.strip
-      end
-
-      # Returns the branch remote name (i.e. origin).
-      #
-      # @param  [#to_s] branch_name
-      #         The branch name to look for the remote name.
-      #
-      # @return [String] The given branch's remote name.
-      #
-      def branch_remote_name(branch_name)
-        `git config branch.#{branch_name}.remote`.strip
-      end
-
-      # Returns the url of the given remote name
-      # (i.e. git@github.com:CocoaPods/Specs.git).
-      #
-      # @param  [#to_s] remote_name
-      #         The branch remote name to look for the url.
-      #
-      # @return [String] The URL of the given remote.
-      #
-      def url_of_git_repo(remote_name)
-        `git config remote.#{remote_name}.url`.strip
-      end
     end
   end
 end

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

@@ -20,12 +20,13 @@ module Pod
         # @output  Examples:
         #
         #          master
-        #          - type: git (origin)
+        #          - type: git (master)
         #          - URL:  https://github.com/CocoaPods/Specs.git
         #          - path: /Users/lascorbe/.cocoapods/repos/master
         #
         #          test
         #          - type: local copy
+        #          - URL: file:///Users/lascorbe/.cocoapods/repos/test
         #          - path: /Users/lascorbe/.cocoapods/repos/test
         #
         def run
@@ -38,27 +39,24 @@ module Pod
 
         # Pretty-prints the source at the given path.
         #
-        # @param  [String,Pathname] path
-        #         The path of the source to be printed.
+        # @param  [Source] source
+        #         The source repository to be printed.
         #
         # @return [void]
         #
-        def print_source_at_path(path)
-          Dir.chdir(path) do
-            if SourcesManager.git_repo?(path)
-              remote_name = branch_remote_name(branch_name)
-              if remote_name
-                UI.puts "- Type: git (#{remote_name})"
-                url = url_of_git_repo(remote_name)
-                UI.puts "- URL:  #{url}"
-              else
-                UI.puts '- Type: git (no remote information available)'
-              end
-            else
-              UI.puts '- Type: local copy'
+        def print_source(source)
+          if SourcesManager.git_repo?(source.repo)
+            Dir.chdir(source.repo) do
+              branch_name = `git name-rev --name-only HEAD 2>/dev/null`.strip
+              branch_name = 'unknown' if branch_name.empty?
+              UI.puts "- Type: git (#{branch_name})"
             end
-            UI.puts "- Path: #{path}"
+          else
+            UI.puts '- Type: local'
           end
+
+          UI.puts "- URL:  #{source.url}"
+          UI.puts "- Path: #{source.repo}"
         end
 
         # Pretty-prints the given sources.
@@ -71,7 +69,7 @@ module Pod
         def print_sources(sources)
           sources.each do |source|
             UI.title source.name do
-              print_source_at_path source.repo
+              print_source(source)
             end
           end
           UI.puts "\n"

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

@@ -20,6 +20,7 @@ module Pod
            ['--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 dependant pods ' \
             '(defaults to https://github.com/CocoaPods/Specs.git). '\
@@ -30,6 +31,7 @@ module Pod
           @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')
@@ -45,6 +47,7 @@ module Pod
             validator                = Validator.new(podspec, @source_urls)
             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

data/lib/cocoapods/config.rb

@@ -15,6 +15,7 @@ module Pod
       :verbose             => false,
       :silent              => false,
       :skip_repo_update    => false,
+      :skip_download_cache => !ENV['COCOAPODS_SKIP_CACHE'].nil?,
 
       :clean               => true,
       :integrate_targets   => true,
@@ -66,6 +67,11 @@ module Pod
     attr_accessor :skip_repo_update
     alias_method :skip_repo_update?, :skip_repo_update
 
+    # @return [Bool] Whether the installer should skip the download cache.
+    #
+    attr_accessor :skip_download_cache
+    alias_method :skip_download_cache?, :skip_download_cache
+
     public
 
     #-------------------------------------------------------------------------#

data/lib/cocoapods/downloader.rb

@@ -1,8 +1,48 @@
 require 'cocoapods-downloader'
 require 'claide/informative_error'
+require 'fileutils'
+require 'tmpdir'
 
 module Pod
   module Downloader
+    require 'cocoapods/downloader/cache'
+    require 'cocoapods/downloader/request'
+    require 'cocoapods/downloader/response'
+
+    # Downloads a pod from the given `request` to the given `target` location.
+    #
+    # @return [Response] The download response for this download.
+    #
+    # @param  [Request] request
+    #         the request that describes this pod download.
+    #
+    # @param  [Pathname,Nil] target
+    #         the location to which this pod should be downloaded. If `nil`,
+    #         then the pod will only be cached.
+    #
+    # @param  [Pathname,Nil] cache_path
+    #         the path used to cache pod downloads. If `nil`, then no caching
+    #         will be done.
+    #
+    def self.download(
+      request,
+      target,
+      cache_path: !Config.instance.skip_download_cache && Config.instance.cache_root + 'Pods'
+    )
+      cache_path, tmp_cache = Pathname(Dir.mktmpdir), true unless cache_path
+      cache = Cache.new(cache_path)
+      result = cache.download_pod(request)
+      if target
+        UI.message "Copying #{request.name} from `#{result.location}` to #{UI.path target}", '> ' do
+          FileUtils.rm_rf target
+          FileUtils.cp_r(result.location, target)
+        end
+      end
+      result
+    ensure
+      FileUtils.rm_r cache_path if tmp_cache
+    end
+
     class DownloaderError; include CLAide::InformativeError; end
 
     class Base

data/lib/cocoapods/downloader/cache.rb

@@ -0,0 +1,210 @@
+require 'fileutils'
+require 'tmpdir'
+
+module Pod
+  module Downloader
+    # The class responsible for managing Pod downloads, transparently caching
+    # them in a cache directory.
+    #
+    class Cache
+      # @return [Pathname] The root directory where this cache store its
+      #         downloads.
+      #
+      attr_reader :root
+
+      # @param  [Pathname,String] root
+      #         see {#root}
+      #
+      def initialize(root)
+        @root = Pathname(root)
+        @root.mkpath
+      end
+
+      # Downloads the Pod from the given `request`
+      #
+      # @param  [Request] request
+      #         the request to be downloaded.
+      #
+      # @return [Response] the response from downloading `request`
+      #
+      def download_pod(request)
+        cached_pod(request) || uncached_pod(request)
+      rescue Informative
+        raise
+      rescue
+        UI.notice("Error installing #{request.name}")
+        raise
+      end
+
+      private
+
+      # @param  [Request] request
+      #         the request to be downloaded.
+      #
+      # @param  [Hash<Symbol,String>] slug_opts
+      #         the download options that should be used in constructing the
+      #         cache slug for this request.
+      #
+      # @return [Pathname] The path for the Pod downloaded from the given
+      #         `request`.
+      #
+      def path_for_pod(request, slug_opts = {})
+        root + request.slug(slug_opts)
+      end
+
+      # @param  [Request] request
+      #         the request to be downloaded.
+      #
+      # @param  [Hash<Symbol,String>] slug_opts
+      #         the download options that should be used in constructing the
+      #         cache slug for this request.
+      #
+      # @return [Pathname] The path for the podspec downloaded from the given
+      #         `request`.
+      #
+      def path_for_spec(request, slug_opts = {})
+        path = root + 'Specs' + request.slug(slug_opts)
+        path.sub_ext('.podspec.json')
+      end
+
+      # @param  [Request] request
+      #         the request to be downloaded.
+      #
+      # @return [Response] The download response for the given `request` that
+      #         was found in the download cache.
+      #
+      def cached_pod(request)
+        path = path_for_pod(request)
+        spec = request.spec || cached_spec(request)
+        return unless spec && path.directory?
+        Response.new(path, spec, request.params)
+      end
+
+      # @param  [Request] request
+      #         the request to be downloaded.
+      #
+      # @return [Specification] The cached specification for the given
+      #         `request`.
+      #
+      def cached_spec(request)
+        path = path_for_spec(request)
+        path.file? && Specification.from_file(path)
+      end
+
+      # @param  [Request] request
+      #         the request to be downloaded.
+      #
+      # @return [Response] The download response for the given `request` that
+      #         was not found in the download cache.
+      #
+      def uncached_pod(request)
+        in_tmpdir do |target|
+          result = Response.new
+          result.checkout_options = download(request.name, target, request.params, request.head?)
+
+          if request.released_pod?
+            result.spec = request.spec
+            result.location = destination = path_for_pod(request, :params => result.checkout_options)
+            copy_and_clean(target, destination, request.spec)
+            write_spec(request.spec, path_for_spec(request, :params => result.checkout_options))
+          else
+            podspecs = Sandbox::PodspecFinder.new(target).podspecs
+            podspecs[request.name] = request.spec if request.spec
+            podspecs.each do |name, spec|
+              destination = path_for_pod(request, :name => name, :params => result.checkout_options)
+              copy_and_clean(target, destination, spec)
+              write_spec(spec, path_for_spec(request, :name => name, :params => result.checkout_options))
+              if request.name == name
+                result.location = destination
+                result.spec = spec
+              end
+            end
+          end
+
+          result
+        end
+      end
+
+      # Downloads a pod with the given `name` and `params` to `target`.
+      #
+      # @param  [String] name
+      #
+      # @param  [Pathname] target
+      #
+      # @param  [Hash<Symbol,String>] params
+      #
+      # @param  [Boolean] head
+      #
+      # @return [Hash] The checkout options required to re-download this exact
+      #         same source.
+      #
+      def download(name, target, params, head)
+        downloader = Downloader.for_target(target, params)
+        if head
+          unless downloader.head_supported?
+            raise Informative, "The pod '#{name}' does not " \
+              "support the :head option, as it uses a #{downloader.name} " \
+              'source. Remove that option to use this pod.'
+          end
+          downloader.download_head
+        else
+          downloader.download
+        end
+
+        if downloader.options_specific? && !head
+          params
+        else
+          downloader.checkout_options
+        end
+      end
+
+      # Performs the given block inside a temporary directory,
+      # which is removed at the end of the block's scope.
+      #
+      # @return [Object] The return value of the given block
+      #
+      def in_tmpdir(&blk)
+        tmpdir = Pathname(Dir.mktmpdir)
+        blk.call(tmpdir)
+      ensure
+        FileUtils.remove_entry(tmpdir) if tmpdir.exist?
+      end
+
+      # Copies the `source` directory to `destination`, cleaning the directory
+      # of any files unused by `spec`.
+      #
+      # @param  [Pathname] source
+      #
+      # @param  [Pathname] destination
+      #
+      # @param  [Specification] spec
+      #
+      # @return [Void]
+      #
+      def copy_and_clean(source, destination, spec)
+        specs_by_platform = {}
+        spec.available_platforms.each do |platform|
+          specs_by_platform[platform] = [spec, *spec.recursive_subspecs].select { |ss| ss.supported_on_platform?(platform) }
+        end
+        destination.parent.mkpath
+        FileUtils.cp_r(source, destination)
+        Sandbox::PodDirCleaner.new(destination, specs_by_platform).clean!
+      end
+
+      # Writes the given `spec` to the given `path`.
+      #
+      # @param  [Specification] spec
+      #         the specification to be written.
+      #
+      # @param  [Pathname] path
+      #         the path the specification is to be written to.
+      #
+      # @return [Void]
+      #
+      def write_spec(spec, path)
+        path.dirname.mkpath
+        path.open('w') { |f| f.write spec.to_pretty_json }
+      end
+    end
+  end
+end