howzit 2.1.26 → 2.1.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19fc185635709d53c4d7dcf0b437d4ec6b00cdd341d734e4655ef4e8e1dbfd3a
-  data.tar.gz: 9305e6edf7a8c4f7bf6d2d6a4a1aed14313aac73b658595a877314e929c15c8b
+  metadata.gz: cfddcd9969d36eaa46a5441a912b60a0d4622c7536ffd34c6aebe83cc3c840a3
+  data.tar.gz: 9e5d7fee17c7931fc03b455eebe411f1490e1c27d70545f5e5a3d62f492a2f50
 SHA512:
-  metadata.gz: a35475dfaf7aa381157964466046ff8c94b0a4282bd9bbb8c067b7d344527d8ba95a296934ce935375111c4c255122cd3c684829d761b4962c517ea6dfadc14b
-  data.tar.gz: 41ae72b53d9602fb9b6df8231a4d1db8d9f134b78460e2243e8afaf616528279d0e7b08d68820a330994935579186058838a5d5e5c288b809aa46d0670b71b0f
+  metadata.gz: '019b3813e1f3ed8a79f70711a0f2dae38a83f0cfca205a32d9ab14794ba9815ce8d971d26f6bed0afbb90ce9d4ffd5d0d926cf50ef965cf806ffa45565203611'
+  data.tar.gz: c77fdeea70957604027d8152517498e8fe6df7043f36e139f8a81b23daca958d701a2dda786385921a6d9bf5c01acaca068375e7d3b9bd680091a3e988275069

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+### 2.1.27
+
+2025-12-26 08:59
+
+#### IMPROVED
+
+- Task titles now support variable substitution using ${VAR} syntax, so titles like "@run(echo test) Title with ${var}" will replace ${var} with its value from topic metadata. This applies to all task types (run, copy, open, include) and code block titles.
+
+#### FIXED
+
+- Task and topic names containing dollar signs (like $text$ or ${VAR}) now display correctly in run report output without causing color code interpretation issues. Dollar signs are properly escaped during formatting and unescaped in the final output.
+
 ### 2.1.26
 
 2025-12-26 04:53

data/lib/howzit/colors.rb

@@ -288,8 +288,8 @@ module Howzit
                    d: dark, b: bold, u: underline, i: italic, x: reset }
 
         result = fmt.empty? ? input : format(fmt, colors)
-        # Unescape braces that were escaped to prevent color code interpretation
-        result.gsub(/\\\{/, '{').gsub(/\\\}/, '}')
+        # Unescape braces and dollar signs that were escaped to prevent color code interpretation
+        result.gsub(/\\\{/, '{').gsub(/\\\}/, '}').gsub(/\\\$/, '$')
       end
     end
 

data/lib/howzit/run_report.rb

@@ -30,13 +30,13 @@ module Howzit
       symbol = entry[:success] ? '✅' : '❌'
       parts = ["#{symbol} "]
       if prefix_topic && entry[:topic] && !entry[:topic].empty?
-        # Escape braces in topic name to prevent color code interpretation
-        topic_escaped = entry[:topic].gsub(/\{/, '\\{').gsub(/\}/, '\\}')
+        # Escape braces and dollar signs in topic name to prevent color code interpretation
+        topic_escaped = entry[:topic].gsub(/\{/, '\\{').gsub(/\}/, '\\}').gsub(/\$/, '\\$')
         parts << "{bw}#{topic_escaped}{x}: "
       end
-      # Escape braces in task name to prevent color code interpretation
-      task_escaped = entry[:task].gsub(/\{/, '\\{').gsub(/\}/, '\\}')
-      parts << "{by}#{task_escaped}{x}"
+      # Escape braces and dollar signs in task name to prevent color code interpretation
+      task_escaped = entry[:task].gsub(/\{/, '\\{').gsub(/\}/, '\\}').gsub(/\$/, '\\$')
+      parts << "{by}#{task_escaped} {x}"
       unless entry[:success]
         reason = entry[:exit_status] ? "exit code #{entry[:exit_status]}" : 'failed'
         parts << " {br}(#{reason}){x}"
@@ -82,15 +82,15 @@ module Howzit
       task_parts_plain = []
 
       if prefix_topic && entry[:topic] && !entry[:topic].empty?
-        # Escape braces in topic name to prevent color code interpretation
-        topic_escaped = entry[:topic].gsub(/\{/, '\\{').gsub(/\}/, '\\}')
+        # Escape braces and dollar signs in topic name to prevent color code interpretation
+        topic_escaped = entry[:topic].gsub(/\{/, '\\{').gsub(/\}/, '\\}').gsub(/\$/, '\\$')
         task_parts << "{bw}#{topic_escaped}{x}: "
         task_parts_plain << "#{entry[:topic]}: "
       end
 
-      # Escape braces in task name to prevent color code interpretation
-      task_escaped = entry[:task].gsub(/\{/, '\\{').gsub(/\}/, '\\}')
-      task_parts << "{by}#{task_escaped}{x}"
+      # Escape braces and dollar signs in task name to prevent color code interpretation
+      task_escaped = entry[:task].gsub(/\{/, '\\{').gsub(/\}/, '\\}').gsub(/\$/, '\\$')
+      task_parts << "{by}#{task_escaped} {x}"
       task_parts_plain << entry[:task]
 
       unless entry[:success]

data/lib/howzit/topic.rb

@@ -302,26 +302,31 @@ module Howzit
                     title: title.dup,  # Make a copy to avoid reference issues
                     action: obj,
                     parent: self }
+      # Set named_arguments before processing titles for variable substitution
+      Howzit.named_arguments = @named_args
       case cmd
       when /include/i
         if title =~ /\[(.*?)\] *$/
-          Howzit.named_arguments = @named_args
           args = Regexp.last_match(1).split(/ *, */).map(&:render_arguments)
           Howzit.arguments = args
           arguments
           title.sub!(/ *\[.*?\] *$/, '')
-          task_args[:title] = title
         end
+        # Apply variable substitution to title after bracket processing
+        task_args[:title] = title.render_arguments
 
         task_args[:type] = :include
         task_args[:arguments] = Howzit.named_arguments
       when /run/i
         task_args[:type] = :run
+        task_args[:title] = title.render_arguments
       when /copy/i
         task_args[:type] = :copy
         task_args[:action] = Shellwords.escape(obj)
+        task_args[:title] = title.render_arguments
       when /open|url/i
         task_args[:type] = :open
+        task_args[:title] = title.render_arguments
       end
 
       task_args
@@ -373,6 +378,8 @@ module Howzit
         if c[:cmd].nil?
           optional, default = define_optional(c[:optional2])
           title = c[:title2].nil? ? '' : c[:title2].strip
+          # Apply variable substitution to block title
+          title = title.render_arguments if title && !title.empty?
           block = c[:block]&.strip
           runnable << Howzit::Task.new({ type: :block,
                                          title: title,

data/lib/howzit/version.rb

@@ -3,5 +3,5 @@
 # Primary module for this gem.
 module Howzit
   # Current Howzit version.
-  VERSION = '2.1.26'
+  VERSION = '2.1.27'
 end

data/spec/run_report_spec.rb

@@ -47,5 +47,25 @@ describe Howzit::RunReport do
     # Second line should be separator
     expect(lines[1]).to match(/^\|[\s:-]+\|[\s:-]+\|$/)
   end
+
+  it 'preserves dollar signs in task names without interfering with color codes' do
+    Howzit::RunReport.log({ topic: 'Test Topic', task: '$text$', success: true, exit_status: 0 })
+    Howzit::RunReport.log({ topic: 'Test', task: 'echo ${VAR}', success: true, exit_status: 0 })
+    plain = Howzit::RunReport.format.uncolor
+    expect(plain).to include('$text$')
+    expect(plain).to include('${VAR}')
+    # Verify dollar signs are preserved and not causing color code issues
+    expect(plain).not_to include('{x}')
+    expect(plain.scan(/\$\{x\}/).length).to eq(0)
+  end
+
+  it 'preserves dollar signs in topic names without interfering with color codes' do
+    Howzit.multi_topic_run = true
+    Howzit::RunReport.log({ topic: '$dollar$ Topic', task: 'Some Task', success: true, exit_status: 0 })
+    plain = Howzit::RunReport.format.uncolor
+    expect(plain).to include('$dollar$ Topic')
+    expect(plain).not_to include('{x}')
+    expect(plain.scan(/\$\{x\}/).length).to eq(0)
+  end
 end
 

data/spec/topic_spec.rb

@@ -101,4 +101,33 @@ describe Howzit::Topic do
       expect(topic.print_out({ single: true, header: true }).join("\n").uncolor).to match(/▶ ls -1/)
     end
   end
+
+
+  describe '.arguments' do
+    before do
+      Howzit.arguments = []
+    end
+
+    it 'extracts named arguments from topic title with defaults' do
+      topic = Howzit::Topic.new('Test Topic (var1:default1, var2:default2)', 'Content')
+      expect(topic.named_args['var1']).to eq('default1')
+      expect(topic.named_args['var2']).to eq('default2')
+    end
+
+    it 'does nothing when title has no arguments' do
+      topic = Howzit::Topic.new('Test Topic', 'Content')
+      expect(topic.named_args).to eq({})
+    end
+
+    it 'cleans title after extracting arguments' do
+      topic = Howzit::Topic.new('Test Topic (var:val)', 'Content')
+      expect(topic.title).to eq('Test Topic')
+    end
+
+    it 'uses provided arguments over defaults' do
+      Howzit.arguments = ['provided_value']
+      topic = Howzit::Topic.new('Test Topic (var:default_value)', 'Content')
+      expect(topic.named_args['var']).to eq('provided_value')
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: howzit
 version: !ruby/object:Gem::Version
-  version: 2.1.26
+  version: 2.1.27
 platform: ruby
 authors:
 - Brett Terpstra