cocoapods-links-v2 0.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a201168e823abb58642c8b37326fc52d779d0526f134820371ecd865a49974b2
+  data.tar.gz: b32acb3c0ddaf4f7a1b9b5ba606b118a292c48fa8c55b0974e9dc12398b3c0e4
+SHA512:
+  metadata.gz: fc9b770366bbd74b26cdfc28aff152b055bf504cf8f0013c68e84ec5a22325916e0da59030dd7fabd64c83efe223f667c8869bc5bec3b9d003205d5db81cf3aa
+  data.tar.gz: e3f7cd8d4f303a5e44e4e18ede5d535e9b75ec5a4f120a02d883de4ad3e827d9ebfe0b56046fe4e201ec83bb7177275994ce797891314e02a580102e125b7cfe

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+.bundle
+vendor/bundle

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development do
+  gem 'rake'
+  gem 'bacon'
+  gem 'mocha'
+  gem 'mocha-on-bacon'
+end

data/Gemfile.lock

@@ -0,0 +1,112 @@
+PATH
+  remote: .
+  specs:
+    cocoapods-links (0.3.0)
+      cocoapods (~> 1.0)
+      json (~> 1.8)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (3.0.3)
+    activesupport (5.2.6)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    addressable (2.8.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    algoliasearch (1.27.5)
+      httpclient (~> 2.8, >= 2.8.3)
+      json (>= 1.5.1)
+    atomos (0.1.3)
+    bacon (1.2.0)
+    claide (1.0.3)
+    cocoapods (1.10.2)
+      addressable (~> 2.6)
+      claide (>= 1.0.2, < 2.0)
+      cocoapods-core (= 1.10.2)
+      cocoapods-deintegrate (>= 1.0.3, < 2.0)
+      cocoapods-downloader (>= 1.4.0, < 2.0)
+      cocoapods-plugins (>= 1.0.0, < 2.0)
+      cocoapods-search (>= 1.0.0, < 2.0)
+      cocoapods-trunk (>= 1.4.0, < 2.0)
+      cocoapods-try (>= 1.1.0, < 2.0)
+      colored2 (~> 3.1)
+      escape (~> 0.0.4)
+      fourflusher (>= 2.3.0, < 3.0)
+      gh_inspector (~> 1.0)
+      molinillo (~> 0.6.6)
+      nap (~> 1.0)
+      ruby-macho (~> 1.4)
+      xcodeproj (>= 1.19.0, < 2.0)
+    cocoapods-core (1.10.2)
+      activesupport (> 5.0, < 6)
+      addressable (~> 2.6)
+      algoliasearch (~> 1.0)
+      concurrent-ruby (~> 1.1)
+      fuzzy_match (~> 2.0.4)
+      nap (~> 1.0)
+      netrc (~> 0.11)
+      public_suffix
+      typhoeus (~> 1.0)
+    cocoapods-deintegrate (1.0.4)
+    cocoapods-downloader (1.4.0)
+    cocoapods-plugins (1.0.0)
+      nap
+    cocoapods-search (1.0.0)
+    cocoapods-trunk (1.5.0)
+      nap (>= 0.8, < 2.0)
+      netrc (~> 0.11)
+    cocoapods-try (1.2.0)
+    colored2 (3.1.2)
+    concurrent-ruby (1.1.9)
+    escape (0.0.4)
+    ethon (0.14.0)
+      ffi (>= 1.15.0)
+    ffi (1.15.3)
+    fourflusher (2.3.1)
+    fuzzy_match (2.0.4)
+    gh_inspector (1.1.3)
+    httpclient (2.8.3)
+    i18n (1.8.10)
+      concurrent-ruby (~> 1.0)
+    json (1.8.6)
+    minitest (5.14.4)
+    mocha (1.13.0)
+    mocha-on-bacon (0.2.3)
+      mocha (>= 0.13.0)
+    molinillo (0.6.6)
+    nanaimo (0.3.0)
+    nap (1.1.0)
+    netrc (0.11.0)
+    public_suffix (4.0.6)
+    rake (13.0.6)
+    rexml (3.2.5)
+    ruby-macho (1.4.0)
+    thread_safe (0.3.6)
+    typhoeus (1.4.0)
+      ethon (>= 0.9.0)
+    tzinfo (1.2.9)
+      thread_safe (~> 0.1)
+    xcodeproj (1.20.0)
+      CFPropertyList (>= 2.3.3, < 4.0)
+      atomos (~> 0.1.3)
+      claide (>= 1.0.2, < 2.0)
+      colored2 (~> 3.1)
+      nanaimo (~> 0.3.0)
+      rexml (~> 3.2.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bacon
+  bundler (~> 1.6)
+  cocoapods-links!
+  mocha
+  mocha-on-bacon
+  rake
+
+BUNDLED WITH
+   1.17.2

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Mike Owens <mike.owens11@gmail.com>
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,89 @@
+# cocoapods-links
+
+A CocoaPods plugin to manage local development pods
+
+## Installation
+
+```bash
+gem install cocoapods-links
+```
+
+## Purpose
+Let's face it, pod development with local dependencies can be a pain. Let's say you have a project
+`MyApp` a few pods declared in your `Podfile`:
+
+```ruby
+pod 'Foo', '~> 1.0.0'
+pod 'Bar', :git => 'https://github.com/MyCompany/Bar.git', :tag => "1.0.1"
+```
+
+Perhaps you need to make some modifications to `Bar` to implement a new feature in `MyApp`. So
+you modify your `Podfile`:
+
+```ruby
+pod 'Bar', :path => "/path/to/bar/checkout"
+```
+This development flow requires you to make a temporary change to your `Podfile`
+that is managed by source control. Wouldn't it be great if CocoaPods offered a means to manage 
+development pods without having to alter files under source control? 
+
+Enter cocoapods-links.
+
+With cocoapods-links, developers can easily test their pods using the provided link functionality.
+Linking is a two-step process:
+
+Using `pod link` in a project folder will register a global link. Then, in another pod, 
+`pod link <name>` will create a link to the registered pod as a development pod.
+
+This allows developers to easily test a pod because changes will be reflected immediately.
+When the link is no longer necessary, simply remove it with `pod unlink <name>`.
+
+**NOTE:** Although the `Podfile` and `Podfile.lock` will not be updated using links, the Pods xcodeproj will be updated. If you check in the contents of your Pods directory then you must make sure
+to unlink your development pods prior to committing any changes.
+
+## Usage
+
+#### Register
+To register a pod for local development linking:
+
+```bash
+pod link
+```
+
+#### Unregister
+To unregister a pod:
+
+```bash
+pod unlink
+```
+
+#### Link
+To link a pod for use in another pod project:
+
+```bash
+pod link <name>
+```
+
+#### Unlink
+To unlink a pod from a pod project:
+
+```bash
+pod unlink <name>
+```
+
+#### List
+To list all registered pods
+
+```bash
+pod list links
+```
+
+To list all linked pods in a pod project:
+
+```bash
+pod list links --linked
+```
+
+### License
+
+cocoapods-links is released under the MIT license. See [LICENSE](LICENSE).

data/Rakefile

@@ -0,0 +1,18 @@
+require 'bundler/gem_tasks'
+
+task :default => :spec
+
+task :spec do
+  title 'Running Specs'
+  files = FileList['spec/**/*_spec.rb'].shuffle.join(' ')
+  sh "bundle exec bacon #{files}"
+end
+
+def title(title)
+  cyan_title = "\033[0;36m#{title}\033[0m"
+  puts
+  puts '-' * 80
+  puts cyan_title
+  puts '-' * 80
+  puts
+end

data/cocoapods_links.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cocoapods_links.rb'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'cocoapods-links-v2'
+  spec.version       = CocoapodsLinks::VERSION
+  spec.authors       = ['Hai Feng Kao']
+  spec.email         = ['haifeng@cocoaspice.in']
+  spec.summary       = 'A CocoaPods plugin for linking and unlinking local pods for local development'
+  spec.description   = <<-DESC
+                         This CocoaPods plugin linking functionality allows to easily test their pods.
+
+                         This plugin adds the following commands to the CocoaPods command line:
+
+                          * pod link <name>
+                          * pod unlink <name>
+                          * pod list links
+
+                       DESC
+  spec.homepage      = 'https://github.com/haifengkao/cocoapods-links-v2'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.test_files    = spec.files.grep(%r{^spec/})
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'cocoapods', '~> 1.0'
+  spec.add_dependency 'json', '~> 2'
+
+  spec.add_development_dependency 'bundler', '~> 1.6'
+  spec.add_development_dependency 'rake', '~> 10.4'
+end

data/lib/cocoapods_links.rb

@@ -0,0 +1,3 @@
+module CocoapodsLinks
+  VERSION = '0.4.0'
+end

data/lib/cocoapods_plugin.rb

@@ -0,0 +1,5 @@
+require 'pod/pod'
+require 'pod/lockfile'
+require 'pod/command/link'
+require 'pod/command/unlink'
+require 'pod/command/list'

data/lib/pod/command/link.rb

@@ -0,0 +1,44 @@
+require 'pod/links'
+
+module Pod
+  class Command
+    class Link < Command
+      self.summary = 'Create pod links for local pod development'
+      self.description = <<-DESC
+        The link functionality allows developers to easily test their pods.
+        Linking is a two-step process:
+
+        Using 'pod link' in a project folder will create a global link.
+        Then, in some other pod, 'pod link <name>' will create a link to 
+        the local pod as a Development pod.
+
+        This allows to easily test a pod because changes will be reflected immediately.
+        When the link is no longer necessary, simply remove it with 'pod unlink <name>'.
+      DESC
+
+      self.arguments = [
+        CLAide::Argument.new('POD_NAME', false)
+      ]
+
+      def initialize(argv)
+        @pod = argv.shift_argument()
+        super
+      end
+
+      #
+      # if no pod is given from the command line then we will create a link for the current pod
+      # so other pods can link it as a development dependency
+      #
+      # if a pod name is given from the command line then we will link that pod into the current
+      # pod as a development dependency
+      #
+      def run 
+        unless @pod.nil?
+          Pod::Command::Links.link @pod
+        else
+          Pod::Command::Links.register
+        end
+      end
+    end
+  end
+end

data/lib/pod/command/list.rb

@@ -0,0 +1,30 @@
+require 'pod/links'
+
+module Pod
+  class Command
+    class List
+      class Links < List
+
+        self.summary = 'List links'
+        self.description = <<-DESC
+          List the registered links
+        DESC
+
+        def self.options
+          [[
+            '--linked', 'List pods linked in the current project'
+          ]].concat(super)
+        end
+
+        def initialize(argv)
+          @linked = argv.flag?('linked')
+          super
+        end
+
+        def run
+          Pod::Command::Links.list @linked
+        end
+      end
+    end
+  end
+end

data/lib/pod/command/unlink.rb

@@ -0,0 +1,44 @@
+require 'pod/links'
+
+module Pod
+  class Command
+    class Unlink < Command
+      self.summary = 'Remove pod links'
+      self.description = <<-DESC
+        The unlink functionality allows developers to remove reference to their local pods
+        when they are finished testing
+
+        Using 'pod unlink' in a project folder will remove the global link.
+        
+        Using 'pod unlink <name>' will remove the link to the <name> developement pod
+        and install the <name> pod configured in the Podfile
+
+        This allows to easily remove developement pod references
+      DESC
+
+      self.arguments = [
+        CLAide::Argument.new('POD_NAME', false)
+      ]
+
+      def initialize(argv)
+        @pod = argv.shift_argument()
+        super
+      end
+
+      #
+      # if no pod is given from the command line then we will unregister the pod from the
+      # registered links
+      #
+      # if a pod name is given from the command line then we will unlink the given pod from
+      # the project
+      #
+      def run 
+        unless @pod.nil?
+          Pod::Command::Links.unlink @pod
+        else
+          Pod::Command::Links.unregister
+        end
+      end
+    end
+  end
+end

data/lib/pod/links.rb

@@ -0,0 +1,289 @@
+require 'json'
+require 'fileutils'
+
+module Pod
+  class Command
+
+    #
+    # Links utility that provides functionality around managing CocoaPod links
+    # 
+    module Links
+
+      #
+      # Defines the path where the links database is stored (e.g. from pod link)
+      # 
+      REGISTERED_DB = File.expand_path('~/.cocoapods/plugins/link/registered.json')
+
+      #
+      # Defines the path where per pod links are stored (e.g. from pod link <foo> command)
+      # 
+      LINKED_DB = File.expand_path('~/.cocoapods/plugins/link/linked.json')
+
+      # return the path which has '*.podspec'
+      def self.registerProjectPath
+        spec = Dir["#{Dir.pwd}/*.podspec"]
+        unless spec.empty?
+          return Dir.pwd
+        end
+
+        # check parent directory
+        spec = Dir["#{Dir.pwd}/../*.podspec"]
+        unless spec.empty?
+          return File.expand_path("..", Dir.pwd)
+        end
+
+        help! 'A .podspec must exist in the directory `pod link` is ran'
+      end
+
+      # return the path which contains 'Podfile'
+      def self.linkProjectPath
+        spec = Dir["#{Dir.pwd}/Podfile"]
+        unless spec.empty?
+          return Dir.pwd
+        end
+
+        # check ./Example directory
+        spec = Dir["#{Dir.pwd}/Example/Podfile"]
+        unless spec.empty?
+          return File.expand_path("Example", Dir.pwd)
+        end
+
+        help! 'Podfile must exist in the directory `pod link` is ran'
+      end
+
+      #
+      # Register a pod for local development in the current working directory. This working
+      # directory must have a .podspec defining the pod 
+      # 
+      def self.register
+        self.print "Registering '#{self.podspec.name}' > #{self.registerProjectPath}"
+        self.write_db(REGISTERED_DB, self.registerd_db, {
+          self.podspec.name => {
+            "path" => self.registerProjectPath
+          }
+        })
+      end
+
+      #
+      # Unregister a pod
+      # 
+      def self.unregister
+       self.print "Unregistering '#{self.podspec.name}' > #{self.registerProjectPath}"
+        db = self.registerd_db
+        db.delete(self.podspec.name)
+        self.write_db(REGISTERED_DB, db)
+      end
+
+      #
+      # Creates a link for the given pod into the current project. The pod must be registered
+      # using `pod link`
+      # 
+      # @param pod the name of the pod to link into the current project 
+      # 
+      def self.link(pod)
+        podfileFolder = self.linkProjectPath
+        # only allow registered links to be used
+        registered_link = self.get_registered_link pod
+        if registered_link.nil?
+          Command::help! "Pod '#{pod}'' is not registered. Did you run `pod link` from the #{pod} directory?"
+        end
+
+        # add the linked pod
+        linked_pods = [pod]
+        if self.linked_db.has_key?(podfileFolder)
+          linked_pods = linked_pods.concat self.linked_db[podfileFolder]['pods']
+        end
+
+        self.print "Adding link to '#{pod}' > #{registered_link['path']}"
+        self.write_db(LINKED_DB, self.linked_db, {
+          podfileFolder => {
+            'pods' => linked_pods.uniq
+          }
+        })
+
+        # install pod from link
+        Pod::Command::Install.run(["--project-directory=#{podfileFolder}"])
+      end
+
+      #
+      # Will unlink the give pod from the current pod project
+      # 
+      # @param pod the name of the pod to unlink
+      # 
+      def self.unlink(pod)
+        podfileFolder = self.linkProjectPath
+        if self.linked_db.has_key?(podfileFolder)
+          linked_pods = self.linked_db[podfileFolder]['pods']
+          linked_pods.delete(pod)
+
+          #
+          # Update databased based on link state
+          # if links exist, update list of links
+          # if links do not exist, remove entry
+          # 
+          self.print "Removing link to '#{pod}'"
+          if linked_pods.empty?
+            db = self.linked_db
+            db.delete(podfileFolder)
+            self.write_db(LINKED_DB, db)
+          else
+            self.write_db(LINKED_DB, self.linked_db, {
+              podfileFolder => {
+                'pods' => linked_pods
+              }
+            })
+          end
+
+          # install pod from repo
+          Pod::Command::Install.run(["--project-directory=#{podfileFolder}"])
+        end
+      end
+
+      #
+      # Entry point for the `pod` hook to check if the current pod project should use a linked pod
+      # of installed from the pod requirements. In order for a link to be returned the following
+      # must hold true:
+      # 
+      # 1. The pod must be registered (e.g. pod link)
+      # 2. The current pod project must have linked the registered link (e.g. pod link <name>)
+      # 
+      # @param name the name of the pod to find a link for
+      # 
+      # @returns the registered link for the given name or nil
+      #
+      def self.get_link(name)
+        if self.linked_pods.include?(name)
+          return self.get_registered_link name
+        end
+        return nil
+      end
+
+      #
+      # List the links. 
+      # 
+      # - If linked is true then list the linked pods in the current project
+      # - Id linked is false then list the registered links
+      # 
+      # @param linked flag to determine which links to list
+      # 
+      def self.list(linked = false)
+        if linked
+          self.print "Linked pods:"
+          self.linked_pods.each do |pod|
+            self.print "* #{pod}"
+          end
+        else
+          self.print "Registered pods:"
+          self.registerd_db.each do |pod, link|
+            self.print "* #{pod} > #{link['path']}"
+          end
+        end
+      end
+
+      #
+      # Get list of pods that are linked for the current pod project
+      # 
+      # @return an array of installed links
+      # 
+      def self.installed_links
+        installed = []
+        self.linked_pods.each do |pod|
+          unless self.get_registered_link(pod).nil?
+            installed.append(pod)
+          end
+        end
+        return installed
+      end
+
+      #
+      # Prints a formatted message with the Pod Links prefix
+      # 
+      def self.print(message)
+        UI.puts("Pod #{'Links'.cyan} #{message}")
+      end
+      
+    private
+
+      #
+      # Retrieve the registered links database from disk
+      # 
+      # @returns the registered links database
+      # 
+      def self.registerd_db
+        if File.exists?(REGISTERED_DB)
+          return JSON.parse(File.read(REGISTERED_DB))
+        end
+        return {}
+      end
+
+      #
+      # Retrieve the linked database from disk
+      # 
+      # @returns the linked database
+      # 
+      def self.linked_db
+        if File.exists?(LINKED_DB)
+          return JSON.parse(File.read(LINKED_DB))
+        end
+        return {}
+      end
+
+      #
+      # Retrieve a link for the given name from the database. If the link does not exist in the
+      # for the given name then this will return nil
+      # 
+      # @param name the name of the link to retrieve from the database
+      # 
+      # @return the link for the given name or nil
+      # 
+      def self.get_registered_link(name)
+        if self.registerd_db.has_key?(name)
+          return self.registerd_db[name]
+        end
+        return nil
+      end
+
+      #
+      # Retrieve the names of the linked pods for the current project (e.g. the current directory)
+      # 
+      # @returns a list of pods that are linked for the current project
+      # 
+      def self.linked_pods
+        podfileFolder = self.linkProjectPath
+        if self.linked_db.has_key?(podfileFolder)
+          return self.linked_db[podfileFolder]['pods']
+        end
+        return []
+      end
+
+      # 
+      # Read the podspec in the current working directory
+      # 
+      # @returns the podspec
+      # 
+      def self.podspec
+        spec = Dir["#{self.registerProjectPath}/*.podspec"]
+        if spec.empty?
+          help! 'A .podspec must exist in the directory `pod link` is ran'
+        end
+        return Specification.from_file(spec.fetch(0))
+      end
+
+      #
+      # Will write the provided database to disk with the newly provided link content
+      # 
+      # @param filename the name of the file to write the links to
+      # @param links the content to write to disk
+      # 
+      def self.write_db(db_path, db, entry = {})
+        dirname = File.dirname(db_path)
+        unless File.directory?(dirname)
+          FileUtils.mkdir_p(dirname)
+        end
+        File.open(db_path,'w') do |f|
+          f.write(JSON.pretty_generate(db.merge(entry)))
+        end
+      end
+    end
+  end
+end

data/lib/pod/lockfile.rb

@@ -0,0 +1,244 @@
+require 'pod/links'
+
+#
+# Logic:
+# Override of the Lockfile generation to filter out linked pods in favor of their previously
+# installed state (e.g. the state reflected from the Podfile). This is somewhat brittle as it
+# depends on the format of the Lockfile hash contents. If the format changes, then this will also
+# need to be changed. It would be far better to integrate the link filtering elsewhere but this 
+# works "for now"
+# 
+
+module Pod
+  class Lockfile
+
+    PODFILE_LOCK = "Podfile.lock"
+
+    alias_method :real_write_to_disk, :write_to_disk
+
+    #
+    # Hook the Podfile.lock file generation to allow us to filter out the links added to the
+    # Podfile.lock. The logic here is to replace the new Podfile.lock link content with what existed
+    # before the link was added. Currently, this is called for both Podfile.lock and Manifest.lock
+    # file so we only want to alter the Podfile.lock
+    # 
+    # @param path path to write the .lock file to
+    # 
+    def write_to_disk(path)
+      
+      # code here mimics the original method but with link filtering
+      filename = File.basename(path)
+      path.dirname.mkpath unless path.dirname.exist?
+      yaml = to_link_yaml
+      File.open(path, 'w') { |f| f.write(yaml) }
+      self.defined_in_file = path
+    end
+
+    #
+    # Will create pretty print YAML stringfrom the links hash that is to be dumped to a Podfile.lock
+    # 
+    # This code is identical to `to_yaml` except we pass the `to_link_hash` instead of the `to_hash`
+    # 
+    # @returns the YAML string content to dump to a Podfile.lock without link content
+    # 
+    def to_link_yaml
+      keys_hint = [
+        'PODS',
+        'DEPENDENCIES',
+        'EXTERNAL SOURCES',
+        'CHECKOUT OPTIONS',
+        'SPEC CHECKSUMS',
+        'COCOAPODS',
+      ]
+      YAMLHelper.convert_hash(to_link_hash, keys_hint, "\n\n")
+    end
+
+    #
+    # Will get the Podfile.lock contents hash after replacing the linked content with its previous
+    # Podfile.lock information keeping the Podfile and Podfile.lock in sync and clear of any link
+    # data
+    # 
+    # @returns hash that is to be dumped to the Podfile.lock file without link content
+    # 
+    def to_link_hash
+
+      # retrieve the lock contents with links
+      after_hash = to_hash
+
+      unless File.exists?(PODFILE_LOCK)
+        return after_hash
+      end
+
+      # retrieve the lock content before the links
+      before_hash = YAML.load(File.read(PODFILE_LOCK))
+
+      # retrieve installed links
+      links = Pod::Command::Links.installed_links
+
+      #
+      # Logic:
+      # Here we will replace anything that changed in the contents that will be dumped in the
+      # Podfile.lock due to links with the data that previously exists in the Podfile.lock. This
+      # allows the Podfile.lock with the dependency trees to remain unchanged when linking
+      # developement pods. The Podfile.lock contains several keys, but we only need to alter the
+      # following:
+      # 
+      #  - PODS
+      #  - DEPENDENCIES
+      #  - EXTERNAL SOURCES
+      #  - CHECKOUT OPTIONS
+      #  - SPEC CHECKSUMS
+      # 
+      after_hash['PODS'] = 
+        merge_pods links, before_hash['PODS'], after_hash['PODS'] 
+      
+      after_hash['DEPENDENCIES'] = 
+        merge_dependencies links, before_hash['DEPENDENCIES'], after_hash['DEPENDENCIES']
+
+      after_hash['EXTERNAL SOURCES'] = 
+        merge_hashes links, before_hash['EXTERNAL SOURCES'], after_hash['EXTERNAL SOURCES']
+
+      after_hash['CHECKOUT OPTIONS'] = 
+        merge_hashes links, before_hash['CHECKOUT OPTIONS'], after_hash['CHECKOUT OPTIONS']
+
+      after_hash['SPEC CHECKSUMS'] = 
+        merge_hashes links, before_hash['SPEC CHECKSUMS'], after_hash['SPEC CHECKSUMS']
+
+      return after_hash
+    end
+
+    def merge_pods(links, before, after)
+      links.each do |link|
+        before_index = find_pod_index before, link
+        after_index = find_pod_index after, link
+        unless before_index.nil? || after_index.nil?
+          
+          # get previous value
+          after_value = after[after_index]
+
+          # update new value
+          after[after_index] = before[before_index]
+
+          # iterate and update all dependencies of previous value
+          if after_value.is_a?(Hash)
+
+            # clean all deps that may have been added as new deps
+            after_value[after_value.keys[0]].each do |key|
+              # key: CocoaLumberjack/Core or CocoaLumberjack/Extensions (= 1.9.2)
+              key_desc = key.split(" (", 2)[0]
+
+              inner_after_index = find_pod_index after, key_desc
+              inner_before_index = find_pod_index before, key_desc
+              
+              unless inner_before_index.nil? && inner_after_index.nil?
+                after[inner_after_index] = before[inner_before_index]
+              else 
+                # if it was removed in the new deps
+                unless before_index.nil?
+                  after.insert(before_index, before[before_index])
+                end
+              end   
+            end
+          end
+        end
+      end
+      return after
+    end
+
+    #
+    # Will merge the DEPENDENCIES of the Podfile.lock before a link and after a link
+    # 
+    # @param links the installed links
+    # @param before the DEPENDENCIES in the Podfile.lock before the link occurs
+    # @param after the DEPENDENCIES after the link (includes new link that we want to filter out)
+    # 
+    # @returns the merged DEPENDENCIES replacing any links that were added with their previous value
+    #
+    def merge_dependencies(links, before, after)
+      links.each do |link|
+        before_index = find_dependency_index before, link
+        after_index = find_dependency_index after, link
+        unless before_index.nil? || after_index.nil?
+          after[after_index] = before[before_index]
+        end
+      end
+      return after
+    end
+
+    #
+    # Will merge the hashes of the Podfile.lock before a link and after a link
+    # 
+    # @param links the installed links
+    # @param before the hash in the Podfile.lock before the link occurs
+    # @param after the hash after the link (includes new link that we want to filter out)
+    # 
+    # @returns the merged hash replacing any links that were added with their previous value
+    # 
+    def merge_hashes(links, before, after)
+      if before.nil?
+        return after
+      end
+      links.each do |link|
+        if before.has_key?(link)
+          after[link] = before[link]
+        else
+          if after.has_key?(link)
+            after.delete(link)
+          end
+        end
+      end
+      return after
+    end
+
+  private
+
+    #
+    # Find the index in the pod array based on the link name. The pod array
+    # also contains version/path information so we need to massage the pod value 
+    # for comparison. Pods are in the following format:
+    # 
+    # Name (requirements)
+    # 
+    # Example:
+    # Alamofire (= 1.1.3)
+    # 
+    # @param pods the array to search
+    # @param name the name of the pod to find
+    # 
+    # NOTE: the pods in the array can be strings or hashes, so we will check for both
+    # 
+    # @return the index of nil
+    # 
+    def find_pod_index(pods, name)
+      pods.index { |pod|
+        desc = pod
+        if pod.is_a?(Hash)
+          desc = pod.keys[0]
+        end
+        desc.split(" (", 2)[0] == name
+      }
+    end
+
+    #
+    # Find the index in the dependency array based on the link name. The dependency array
+    # also contains version/path information so we need to massage the dependency value 
+    # for comparison. Dependencies are in the following format:
+    # 
+    # Name (requirements)
+    # 
+    # Example:
+    # Alamofire (= 1.1.3)
+    # Quick (from `https://github.com/Quick/Quick`, tag `v0.2.2`)
+    # 
+    # @param dependencies the array to search
+    # @param name the name of the dependency to find
+    # 
+    # @returns the index of nil
+    # 
+    def find_dependency_index(dependencies, name)
+      dependencies.index { |dependency| 
+        dependency.split(" (", 2)[0] == name
+      }
+    end
+  end
+end

data/lib/pod/pod.rb

@@ -0,0 +1,34 @@
+require 'pod/links'
+
+#
+# In order to support installing pods from links we want to override the pod entry point
+# in the pod spec so we can lookup a link prior to installing the pod
+#
+module Pod
+  class Podfile
+    module DSL
+      alias_method :real_pod, :pod
+      def pod(name = nil, *requirements, &block)
+        #
+        # Logic:
+        # Lookup a link for the given pod name. If a link exists then the pod will be installed
+        # via the link instead of the provided requirements (e.g. it will setup local pod development
+        # for the link). If the link does not exist, then the pod will be installed normally
+        #
+
+        # handle subspec link
+        linked_name = name
+        if name.include? "/"
+          linked_name = name.split("/")[0]
+        end
+        link = Pod::Command::Links.get_link(linked_name)
+        unless link.nil?
+          Pod::Command::Links.print "Using link '#{name}' > #{link['path']}"
+          real_pod(name, :path => link['path'], &block)
+        else
+          real_pod(name, *requirements, &block)
+        end
+      end
+    end
+  end
+end

data/spec/command/link_spec.rb

@@ -0,0 +1,15 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+module Pod
+  describe Command::Link do
+    describe 'CLAide' do
+      it 'registers itself' do
+        Command.parse(['link']).should.be.instance_of Command::Link
+      end
+    end
+
+    before do
+      @command = Pod::Command::Link.new CLAide::ARGV.new []
+    end
+  end
+end

data/spec/command/list_spec.rb

@@ -0,0 +1,15 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+module Pod
+  describe Command::List::Links do
+    describe 'CLAide' do
+      it 'registers itself' do
+        Command.parse(%w(list links)).should.be.instance_of Command::List::Links
+      end
+    end
+
+    before do
+      @command = Pod::Command::List::Links.new CLAide::ARGV.new []
+    end
+  end
+end

data/spec/command/unlink_spec.rb

@@ -0,0 +1,15 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+module Pod
+  describe Command::Unlink do
+    describe 'CLAide' do
+      it 'registers itself' do
+        Command.parse(['unlink']).should.be.instance_of Command::Unlink
+      end
+    end
+
+    before do
+      @command = Pod::Command::Unlink.new CLAide::ARGV.new []
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+ROOT = Pathname.new(File.expand_path('../../', __FILE__))
+$:.unshift((ROOT + 'lib').to_s)
+
+require 'cocoapods'
+require 'cocoapods_plugin'
+
+require 'mocha'
+require 'mocha-on-bacon'

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification
+name: cocoapods-links-v2
+version: !ruby/object:Gem::Version
+  version: 0.4.0
+platform: ruby
+authors:
+- Hai Feng Kao
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-07-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cocoapods
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+description: |2+
+                           This CocoaPods plugin linking functionality allows to easily test their pods.
+
+                           This plugin adds the following commands to the CocoaPods command line:
+
+                            * pod link <name>
+                            * pod unlink <name>
+                            * pod list links
+
+email:
+- haifeng@cocoaspice.in
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- cocoapods_links.gemspec
+- lib/cocoapods_links.rb
+- lib/cocoapods_plugin.rb
+- lib/pod/command/link.rb
+- lib/pod/command/list.rb
+- lib/pod/command/unlink.rb
+- lib/pod/links.rb
+- lib/pod/lockfile.rb
+- lib/pod/pod.rb
+- spec/command/link_spec.rb
+- spec/command/list_spec.rb
+- spec/command/unlink_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/haifengkao/cocoapods-links-v2
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: A CocoaPods plugin for linking and unlinking local pods for local development
+test_files:
+- spec/command/link_spec.rb
+- spec/command/list_spec.rb
+- spec/command/unlink_spec.rb
+- spec/spec_helper.rb