lux-hammer 0.3.5 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 851bca602512cce6e27c0b2ddba4b9282d0aab24fa86f24de0ec04aabc98a034
-  data.tar.gz: 4176bbdc0763fea935d6f8758128c61f09262f029a36e161bd4f9d3cdbe523f4
+  metadata.gz: 62eaadbe6e088375e7762d4b16050df8b17f3242a5e92bf611776ff58b3c3e91
+  data.tar.gz: 765045381a51f5e6cea55f8250ed0543ead5ba67f765241a3e8db3faa108d92b
 SHA512:
-  metadata.gz: ae6d18d7c53d52c04cd783a745b420caa420dd6e440cd512afc6d80b5c9ec05ef806732c58aa7467266bf3f4bceb0f0b72cbd7f80b6cee5bf61e0c4e7b78aafb
-  data.tar.gz: c02de0cdb479bf2a8d88ceb6d7306835426719ed735a2beb7e3c6b3fd881dda97f7d2d9dbc9d64e7c8fe2fb794cf91cdc6f6f844570d9ff8d99859dd0538a963
+  metadata.gz: 9de3baba0031948bb5e11c37f282b6d8e0af7a33d703d69f4d6c7026473f1985207c186882a19c313454cdc6e0eea310a109f708a393b269e1c043695d4daf0d
+  data.tar.gz: ff7e9f42651d68b8ba7f3f649693fc66171dc758d9b98f3ff58859f16419ebbeee976bae4931b4d4008acaad9b7635f5250a24d6e2f49df823ce47ea5e882c46

data/.version

@@ -1 +1 @@
-0.3.5
+0.3.6

data/lib/hammer/command.rb

@@ -2,7 +2,7 @@ class Hammer
   # A single registered command on a Hammer class.
   class Command
     attr_reader :name, :desc, :options, :examples, :alts, :needs
-    attr_accessor :handler
+    attr_accessor :handler, :location, :prev_location
 
     def initialize(name:, desc: '', handler: nil)
       @name     = name.to_s

data/lib/lux-hammer.rb

@@ -141,6 +141,7 @@ class Hammer
     # lives at `opts[:args]`.
     def task(name, &block)
       cmd = Command.new(name: name.to_s)
+      cmd.location = source_location_of(block)
       handler = CommandBuilder.new(cmd).instance_eval(&block)
       unless handler.is_a?(Proc)
         raise Error, <<~MSG
@@ -161,6 +162,12 @@ class Hammer
         MSG
       end
       cmd.handler = handler
+
+      if (prev = commands[cmd.name])
+        cmd.prev_location = prev.location
+        warn_redefinition('task', cmd.name, prev.location, cmd.location)
+      end
+
       commands[cmd.name] = cmd
 
       # `task` ignores pending class-level state, but clear it so a
@@ -199,7 +206,14 @@ class Hammer
       # "myapp ns:cmd" with the same prefix everywhere - and so the value
       # captured pre-chdir (see `Hammer.cli`) survives into nested classes.
       sub.instance_variable_set(:@program_name, program_name)
+      sub.instance_variable_set(:@location, source_location_of(block))
       Hammer.with_target(sub) { sub.class_eval(&block) } if block
+
+      if (prev = @namespaces[name.to_s])
+        sub.instance_variable_set(:@prev_location, prev.instance_variable_get(:@location))
+        warn_redefinition('namespace', name.to_s, prev.instance_variable_get(:@location), sub.instance_variable_get(:@location))
+      end
+
       @namespaces[name.to_s] = sub
     end
 
@@ -236,6 +250,21 @@ class Hammer
       @parent
     end
 
+    # "file:line" of the block that defined a task/namespace. Falls back
+    # to "(unknown)" for blocks without a usable source_location (rare -
+    # built-in C-defined procs, eval'd blocks).
+    def source_location_of(block)
+      loc = block&.source_location
+      loc ? "#{loc[0]}:#{loc[1]}" : '(unknown)'
+    end
+
+    # Emit a yellow [hammer] warning on stderr when a task/namespace is
+    # redefined. Last write wins (commands[name] = cmd), but the prior
+    # location is captured so listings can tag the entry as `(redefined)`.
+    def warn_redefinition(kind, name, prev_loc, new_loc)
+      warn Shell.paint("[hammer] redefined #{kind} :#{name} - was #{prev_loc || '(unknown)'}, now #{new_loc || '(unknown)'}", :yellow)
+    end
+
     # Root -> ... -> self. Used to gather `before` hooks for a command.
     def ancestor_chain
       chain = []
@@ -755,6 +784,7 @@ class Hammer
     def emit_rows(rows, width)
       rows.each do |full, c|
         brief = c.alts.empty? ? c.brief : "#{c.brief} (alt: #{c.alts.join(', ')})"
+        brief = "#{brief} #{Shell.paint('(redefined)', :yellow)}" if c.prev_location
         Shell.say "  #{program_name} #{full.ljust(width)}  # #{brief}"
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lux-hammer
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.3.6
 platform: ruby
 authors:
 - Dino Reic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-24 00:00:00.000000000 Z
+date: 2026-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest