gem-why 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 427248f88372106860306d895e33b9323628582c6bee05b5b83fed9ce5c1b416
-  data.tar.gz: 4e6fec4a6b52226de621ea6d3486e79780c68e3a6e2ba4bcc6e6e843c9bcd0de
+  metadata.gz: a438508ad05fcd88de1eb11236f4e716cf40679dee3072d79caab4598ef19d4c
+  data.tar.gz: 36e198634d2b8db32b26f1a9adf2683dba758a286998d4ef79308db88072b449
 SHA512:
-  metadata.gz: 8c61e858acfd0fa46812f0eb8548e4710137b07fd9d551ad2dc7a75fe456655bb6c45817a2799e8770d2a4fcc1e59f1bb026ed9ebaa814a090411611d67929cd
-  data.tar.gz: bfc45293182646801fc2d3ab7ea7b5f4b464c21c844fd3a7f18743b716e4b4d76b6b0e9e885e036c00774940da1ef6b285b124e10243c4dab296791e4094ec90
+  metadata.gz: 88e93410498b664730885114cb7e0dfa9de839785665cae19103a917135d8ce622baf4c226563c8a32e3e10b91e1e2e6e0a6972e40b073a87973936cac09f5dd
+  data.tar.gz: cfae3e17bb1a250f617cf749ef6f1a80e9563e6b355b09142691c96bf64631f9343e80742e902a8f0b9f9b24a6c758111b311f1b53d0a6eeb32a11ca9a102689

data/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.2] - 2025-10-11
+
+### Fixed
+
+- Add spec memoization to improve performance of recursive analysis
+- Fix terminology: use 'dependents' instead of 'dependencies' in help text
+- Eliminate redundant spec lookups by passing version from analyze
+
 ## [0.0.1] - 2025-10-01
 
 ### Added

data/README.md

@@ -53,6 +53,8 @@ To see which gems depend on a specific gem:
 gem why GEMNAME [options]
 ```
 
+**Bonus:** If you add this gem to your project, you can use the `bundle exec gem why` command to understand the dependencies of your gems in your project.
+
 ### Examples
 
 #### Default Behavior - Deep Dependencies
@@ -128,6 +130,7 @@ No gems depend on nonexistent-gem
 | (none) | | Show full dependency chains (default) |
 | `--direct` | `-d` | Show only direct dependencies |
 | `--tree` | `-t` | Display as a visual tree |
+| `--json` |  | Output in JSON format |
 | `--help` | `-h` | Show help message |
 | `--verbose` | `-V` | Verbose output |
 

data/lib/gem_why/analyzer.rb

@@ -1,22 +1,28 @@
 # frozen_string_literal: true
 
+require_relative "dependent"
+
 module GemWhy
   # Analyzes gem dependencies to find dependents and dependency chains
   class Analyzer
+    def initialize
+      @spec_cache = {}
+    end
+
     # Finds all gems that directly depend on the target gem
     # @param target_gem_name [String] the gem to find dependents for
-    # @return [Array<Array(String, String)>] array of [gem_name, requirement] pairs
+    # @return [Array<Dependent>] array of Dependent objects
     def find_direct_dependents(target_gem_name)
-      dependents = []
-      normalized_target = target_gem_name.downcase
-
-      Gem::Specification.each do |spec|
-        spec.dependencies.each do |dep|
-          dependents << [spec.name, dep.requirement.to_s] if dep.name.downcase == normalized_target
-        end
-      end
-
-      dependents.sort_by(&:first)
+      Gem::Specification
+        .map(&:dependencies).flatten
+        .filter { |dep| dep.name.downcase == target_gem_name.downcase }
+        .map do |dep|
+        Dependent.new(
+          name: spec.name,
+          version: spec.version.to_s,
+          requirement: dep.requirement.to_s
+        )
+      end.sort_by(&:name)
     end
 
     # Finds all dependency chains leading to the target gem
@@ -65,7 +71,7 @@ module GemWhy
     end
 
     def process_dependency(dep, target_gem, path, new_node, visited)
-      if dep.name.downcase == target_gem.downcase
+      if dep.name.downcase == target_gem
         [path + [new_node]]
       else
         find_paths_to_target(dep.name, target_gem, path + [new_node], visited)
@@ -73,9 +79,11 @@ module GemWhy
     end
 
     def load_gem_spec(gem_name)
-      Gem::Specification.find_by_name(gem_name)
-    rescue Gem::MissingSpecError
-      nil
+      @spec_cache.fetch(gem_name) do
+        @spec_cache[gem_name] = Gem::Specification.find_by_name(gem_name)
+      rescue Gem::MissingSpecError
+        @spec_cache[gem_name] = nil
+      end
     end
 
     def build_dependency_node(spec, dep)

data/lib/gem_why/dependent.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module GemWhy
+  # Represents a gem that depends on a target gem
+  Dependent = Data.define(:name, :version, :requirement) do
+    # Returns the dependent as a hash
+    # @return [Hash] hash representation
+    def to_h
+      { name:, version:, requirement: }
+    end
+  end
+end

data/lib/gem_why/formatters/direct_formatter.rb

@@ -8,7 +8,7 @@ module GemWhy
     class DirectFormatter < BaseFormatter
       # Formats and displays direct dependencies
       # @param gem_name [String] the target gem name
-      # @param dependents [Array<Array(String, String)>] the dependent gems
+      # @param dependents [Array<Dependent>] the dependent gems
       # @return [void]
       def format(gem_name, dependents)
         return say "No gems depend on #{colorize(gem_name, :yellow)}" if dependents.empty?
@@ -21,9 +21,9 @@ module GemWhy
       private
 
       def print_direct_dependents(dependents, gem_name)
-        dependents.each do |dependent_name, requirement|
-          spec = Gem::Specification.find_by_name(dependent_name)
-          say "  #{colorize(dependent_name, :blue)} (#{spec.version}) requires #{gem_name} #{requirement}"
+        dependents.each do |dependent|
+          say "  #{colorize(dependent.name,
+                            :blue)} (#{dependent.version}) requires #{gem_name} #{dependent.requirement}"
         end
       end
     end

data/lib/gem_why/json_outputter.rb

@@ -14,17 +14,13 @@ module GemWhy
 
     # Outputs direct dependencies as JSON
     # @param gem_name [String] the target gem name
-    # @param dependents [Array<Array(String, String)>] the dependent gems
+    # @param dependents [Array<Dependent>] the dependent gems
     # @return [void]
     def output_direct(gem_name, dependents)
       target = gem_name
       mode = "direct"
       total = dependents.size
-      dependents_data = dependents.map do |name, requirement|
-        spec = Gem::Specification.find_by_name(name)
-        version = spec.version.to_s
-        { name:, version:, requirement: }
-      end
+      dependents_data = dependents.map(&:to_h)
       output = { target:, mode:, dependents: dependents_data, total: }
       say JSON.pretty_generate(output)
     end

data/lib/gem_why/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GemWhy
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/rubygems/commands/why_command.rb

@@ -14,8 +14,8 @@ module Gem
     # Command to show which gems depend on a specific gem
     #
     # This command helps identify dependency relationships by showing:
-    # - Direct dependencies (--direct): immediate dependents only
-    # - Deep dependencies (default): full dependency chains
+    # - Direct dependents (--direct): immediate dependents only
+    # - Deep dependency chains (default): full dependency chains
     # - Tree visualization (--tree): hierarchical view
     #
     # @example Show all dependency chains
@@ -73,7 +73,7 @@ module Gem
       end
 
       def setup_direct_option
-        add_option("-d", "--direct", "Show only direct dependencies") do |value, options|
+        add_option("-d", "--direct", "Show only direct dependents") do |value, options|
           options[:direct] = value
         end
       end
@@ -130,7 +130,7 @@ module Gem
         end
       end
 
-      # Shows direct dependencies only
+      # Shows direct dependents only
       # @param gem_name [String] the target gem name
       # @return [void]
       def show_direct_dependencies(gem_name)

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: gem-why
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Vitaly Slobodin
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -36,6 +36,7 @@ files:
 - README.md
 - Rakefile
 - lib/gem_why/analyzer.rb
+- lib/gem_why/dependent.rb
 - lib/gem_why/formatters/base_formatter.rb
 - lib/gem_why/formatters/deep_formatter.rb
 - lib/gem_why/formatters/direct_formatter.rb