toggle-local-spm 2.2.2 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf5e1291d028c334f9fd40a089700d1bba713a637b6def0a7b46fe9b970decc4
-  data.tar.gz: 6c8ee86f80b2a062f4949d07027781a5ce35f42ff7ad6c51e33f0a4a1efb86df
+  metadata.gz: 32196698f6117197a108c6250d2adb35b2c3002166facfe7fb9298882fb0cc6d
+  data.tar.gz: 9eeaf34c8e8414ef256bb8a6874397f9ca072abf2824e886ca2e3af67b242452
 SHA512:
-  metadata.gz: 2c5fd4f849cbdf6280e5bba06cd9839b64c6aa4b4ddb52eef40c43b7b1a41bc6328ce1f978152c814f3d35a9750a27ccc36b3ec118b48c53ac333e6832e90def
-  data.tar.gz: 14a34f2964b727573e5f45197d71cb62a94a2a6b00447f2e5eaf696fa9fabe25b03dc8e2bcf29a5575a26f30ab1838ee0d3c0abd5ae42f025d62426122f58a8e
+  metadata.gz: 9259e3b22e9f7970d5bc752311fa3551fdd4b1d4a654116d19eb19b09ca625109a9b5578bac842ace1f374d481c7e3e465dd2eea92fde46ac5f834ad97318ffb
+  data.tar.gz: c6224ec033fee21369ec52e15a31f59e22a530f131d509c91be4ac281ac4a88496b60c66c87581cee7f7daeaba7834f2bdafb9d3974f1540a486a011860ef417

data/README.md

@@ -73,14 +73,20 @@ bundle exec toggle-local-spm
 
 The interactive menu lists every direct dependency (from the project itself)
 and every indirect one (from `Package.resolved`) as a table, each tagged with
-its type, current state, and whether it has a record in
-`spm-local-overrides.json` (see below), e.g.:
+its type, current state, and whether it has a known local checkout recorded
+in `spm-local-overrides.json` (see below), followed by a legend explaining
+the Managed column, e.g.:
 
 ```
-  #  Package                        Type        State     Managed
-  1  mob-bifrost-ios                🎯 direct    🌏 remote  ✅
-  2  DeviceKit                      🎯 direct    🌏 remote
-  3  mob-redtail-widgets-generator  🧩 indirect  🌏 remote
+  #  Package        Type        State     Managed
+  1  my-shared-ios  🎯 direct    📁 local   ✅
+  2  DeviceKit      🎯 direct    🌏 remote  ⚠️
+  3  my-model-lib   🧩 indirect  🌏 remote  📁
+
+Legend:
+  ✅  Local mock set
+  📁  Mock not set. Mock found (localPath in spm-local-overrides.json exists)
+  ⚠️  Mock not set. Mock not found (localPath in spm-local-overrides.json not existing)
 ```
 
 Each package toggles independently based on what's currently wired up in the
@@ -133,8 +139,8 @@ since the project genuinely, permanently depends on it.
 
 An **indirect** dependency has no such entry — it's only known because it
 shows up in `Package.resolved`, meaning some *other* dependency's own
-`Package.swift` depends on it (e.g. `mob-bifrost-ios` depending on
-`mob-redtail-widgets-generator`). Toggling one of these on doesn't edit that
+`Package.swift` depends on it (e.g. `my-shared-ios` depending on
+`my-model-lib`). Toggling one of these on doesn't edit that
 other package's `Package.swift` at all. Instead it adds a brand-new,
 *unlinked* local package reference directly to the project — not attached to
 any target — purely so Xcode/SwiftPM's identity-based dependency resolution

data/lib/toggle_local_spm/cli.rb

@@ -41,7 +41,7 @@ module ToggleLocalSpm
     LocalRef = Xcodeproj::Project::Object::XCLocalSwiftPackageReference
     ProductDependency = Xcodeproj::Project::Object::XCSwiftPackageProductDependency
 
-    Candidate = Struct.new(:name, :ref, :type, :resolved_entry, :managed) do
+    Candidate = Struct.new(:name, :ref, :type, :resolved_entry, :local_path_known) do
       def local?
         ref.is_a?(LocalRef)
       end
@@ -50,6 +50,13 @@ module ToggleLocalSpm
     TYPE_LABELS = { "direct" => "🎯 direct", "indirect" => "🧩 indirect" }.freeze
     STATE_LABELS = { local: "📁 local", remote: "🌏 remote" }.freeze
 
+    MANAGED_LABELS = { set: "✅", found: "📁", not_found: "⚠️" }.freeze
+    MANAGED_LEGEND = [
+      "#{MANAGED_LABELS[:set]}  Local mock set",
+      "#{MANAGED_LABELS[:found]}  Mock not set. Mock found (localPath in spm-local-overrides.json exists)",
+      "#{MANAGED_LABELS[:not_found]}  Mock not set. Mock not found (localPath in spm-local-overrides.json not existing)"
+    ].freeze
+
     def self.run(argv)
       new(argv).run
     end
@@ -166,16 +173,20 @@ module ToggleLocalSpm
       direct = refs.map do |ref|
         name = ref_name(ref)
         type = state.dig(name, "type") || "direct"
-        Candidate.new(name, ref, type, nil, state.key?(name))
+        Candidate.new(name, ref, type, nil, local_path_known?(state, name))
       end
 
       resolved = load_resolved_packages(xcodeproj_path)
       indirect = resolved.reject { |name, _| direct.any? { |c| c.name.casecmp(name).zero? } }
-                          .map { |name, info| Candidate.new(name, nil, "indirect", info, state.key?(name)) }
+                          .map { |name, info| Candidate.new(name, nil, "indirect", info, local_path_known?(state, name)) }
 
       direct + indirect
     end
 
+    def local_path_known?(state, name)
+      !!state.dig(name, "localPath")
+    end
+
     def resolved_file_path(xcodeproj_path)
       workspace = find_workspace_path
       if workspace
@@ -242,10 +253,13 @@ module ToggleLocalSpm
       candidates.each_with_index do |c, i|
         type_label = TYPE_LABELS.fetch(c.type, c.type).ljust(type_width)
         state_label = STATE_LABELS[c.local? ? :local : :remote].ljust(state_width)
-        managed_label = c.managed ? "✅" : ""
-        puts "  #{(i + 1).to_s.rjust(index_width)}  #{c.name.ljust(name_width)}  #{type_label}  #{state_label}  #{managed_label}"
+        puts "  #{(i + 1).to_s.rjust(index_width)}  #{c.name.ljust(name_width)}  #{type_label}  #{state_label}  #{managed_label_for(c)}"
       end
 
+      puts
+      puts "Legend:"
+      MANAGED_LEGEND.each { |line| puts "  #{line}" }
+
       print "\n> "
       choice = $stdin.gets&.strip
       abort_with("invalid selection") if choice.nil? || choice.empty?
@@ -260,6 +274,13 @@ module ToggleLocalSpm
       end.uniq
     end
 
+    def managed_label_for(candidate)
+      return MANAGED_LABELS[:set] if candidate.local?
+      return MANAGED_LABELS[:found] if candidate.local_path_known
+
+      MANAGED_LABELS[:not_found]
+    end
+
     # --- Toggling -------------------------------------------------------
 
     def toggle(project, xcodeproj_path, candidate, state)
@@ -330,7 +351,7 @@ module ToggleLocalSpm
     # in packageReferences is enough for SwiftPM to unify the identity with
     # the local checkout wherever else in the graph it's referenced
     # (verified: it overrides the transitive pin even when the package that
-    # actually declares the dependency, e.g. mob-bifrost-ios, stays remote).
+    # actually declares the dependency, e.g. my-shared-ios, stays remote).
     def add_indirect_local_ref(project, xcodeproj_path, candidate, state)
       name = candidate.name
       entry = state[name] || {}

data/lib/toggle_local_spm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ToggleLocalSpm
-  VERSION = "2.2.2"
+  VERSION = "3.0.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: toggle-local-spm
 version: !ruby/object:Gem::Version
-  version: 2.2.2
+  version: 3.0.1
 platform: ruby
 authors:
 - Sushant Verma
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-23 00:00:00.000000000 Z
+date: 2026-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xcodeproj