howzit 2.1.27 → 2.1.29

data/lib/howzit/conditional_content.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Howzit
+  # Conditional Content processor
+  # Handles @if/@unless/@end blocks in topic content
+  module ConditionalContent
+    class << self
+      ##
+      ## Process conditional blocks in content
+      ##
+      ## @param      content  [String] The content to process
+      ## @param      context  [Hash] Context for condition evaluation
+      ##
+      ## @return     [String] Content with conditional blocks processed
+      ##
+      def process(content, context = {})
+        lines = content.split(/\n/)
+        output = []
+        condition_stack = []
+        # Track if any condition in the current chain has been true
+        # This is used for @elsif and @else to know if a previous branch matched
+        chain_matched_stack = []
+
+        lines.each do |line|
+          # Check for @if or @unless
+          if line =~ /^@(if|unless)\s+(.+)$/i
+            directive = Regexp.last_match(1).downcase
+            condition = Regexp.last_match(2).strip
+
+            # Evaluate condition
+            result = ConditionEvaluator.evaluate(condition, context)
+            # For @unless, negate the result
+            result = !result if directive == 'unless'
+
+            condition_stack << result
+            chain_matched_stack << result
+
+            # Don't include the @if/@unless line itself
+            next
+          end
+
+          # Check for @elsif
+          if line =~ /^@elsif\s+(.+)$/i
+            condition = Regexp.last_match(1).strip
+
+            # If previous condition in chain was true, this branch is false
+            # Otherwise, evaluate the condition
+            if !condition_stack.empty? && chain_matched_stack.last
+              # Previous branch matched, so this one is false
+              condition_stack[-1] = false
+            else
+              # Previous branch didn't match, evaluate this condition
+              result = ConditionEvaluator.evaluate(condition, context)
+              condition_stack[-1] = result
+              chain_matched_stack[-1] = result if result
+            end
+
+            # Don't include the @elsif line itself
+            next
+          end
+
+          # Check for @else
+          if line =~ /^@else\s*$/i
+            # If any previous condition in chain was true, this branch is false
+            # Otherwise, this branch is true
+            if !condition_stack.empty? && chain_matched_stack.last
+              # Previous branch matched, so else is false
+              condition_stack[-1] = false
+            else
+              # No previous branch matched, so else is true
+              condition_stack[-1] = true
+              chain_matched_stack[-1] = true
+            end
+
+            # Don't include the @else line itself
+            next
+          end
+
+          # Check for @end - only skip if it's closing an @if/@unless/@elsif/@else block
+          if (line =~ /^@end\s*$/) && !condition_stack.empty?
+            # This @end closes a conditional block, so skip it
+            condition_stack.pop
+            chain_matched_stack.pop
+            next
+          end
+          # Otherwise, this @end is for @before/@after, so include it
+
+          # Include the line only if all conditions in stack are true
+          output << line if condition_stack.all? { |cond| cond }
+        end
+
+        output.join("\n")
+      end
+    end
+  end
+end

data/lib/howzit/config.rb

@@ -129,14 +129,26 @@ module Howzit
 
     ## Update editor config
     def update_editor
-      puts 'No $EDITOR defined, no value in config'
+      begin
+        puts 'No $EDITOR defined, no value in config'
+      rescue Errno::EPIPE
+        # Pipe closed, ignore
+      end
       editor = Prompt.read_editor
       if editor.nil?
-        puts 'Cancelled, no editor stored.'
+        begin
+          puts 'Cancelled, no editor stored.'
+        rescue Errno::EPIPE
+          # Pipe closed, ignore
+        end
         Process.exit 1
       end
       update_config_option({ config_editor: editor, editor: editor })
-      puts "Default editor set to #{editor}, modify in config file"
+      begin
+        puts "Default editor set to #{editor}, modify in config file"
+      rescue Errno::EPIPE
+        # Pipe closed, ignore
+      end
       editor
     end
 

data/lib/howzit/console_logger.rb

@@ -39,7 +39,13 @@ module Howzit
     ## @param      level  [Symbol] The level
     ##
     def write(msg, level = :info)
-      $stderr.puts msg if LOG_LEVELS[level] >= @log_level
+      return unless LOG_LEVELS[level] >= @log_level
+
+      begin
+        $stderr.puts msg
+      rescue Errno::EPIPE
+        # Pipe closed, ignore
+      end
     end
 
     ##
@@ -66,7 +72,13 @@ module Howzit
     ## @param      msg   The message
     ##
     def warn(msg)
-      write msg, :warn
+      return unless LOG_LEVELS[:warn] >= @log_level
+
+      begin
+        $stderr.puts msg
+      rescue Errno::EPIPE
+        # Pipe closed, ignore
+      end
     end
 
     ##

data/lib/howzit/prompt.rb

@@ -100,9 +100,7 @@ module Howzit
           return fzf_result(res)
         end
 
-        if Util.command_exist?('gum')
-          return gum_choose(matches, query: query, multi: true)
-        end
+        return gum_choose(matches, query: query, multi: true) if Util.command_exist?('gum')
 
         tty_menu(matches, query: query)
       end
@@ -150,7 +148,11 @@ module Howzit
         end
 
         if query
-          puts "\nSelect a topic for `#{query}`:"
+          begin
+            puts "\nSelect a topic for `#{query}`:"
+          rescue Errno::EPIPE
+            # Pipe closed, ignore
+          end
         end
         options_list(matches)
         read_selection(matches)
@@ -168,7 +170,11 @@ module Howzit
 
           return [matches[line - 1]] if line.positive? && line <= matches.length
 
-          puts 'Out of range'
+          begin
+            puts 'Out of range'
+          rescue Errno::EPIPE
+            # Pipe closed, ignore
+          end
           read_selection(matches)
         end
       ensure
@@ -229,9 +235,7 @@ module Howzit
           return res.empty? ? [] : res.split(/\n/)
         end
 
-        if Util.command_exist?('gum')
-          return gum_choose(matches, prompt: prompt_text, multi: true, required: false)
-        end
+        return gum_choose(matches, prompt: prompt_text, multi: true, required: false) if Util.command_exist?('gum')
 
         text_template_input(matches)
       end
@@ -265,7 +269,11 @@ module Howzit
           exit
         end
 
-        puts "\n{bw}Available templates:{x} #{available.join(', ')}".c
+        begin
+          puts "\n{bw}Available templates:{x} #{available.join(', ')}".c
+        rescue Errno::EPIPE
+          # Pipe closed, ignore
+        end
         printf '{bw}Enter templates to include, comma-separated (return to skip):{x} '.c
         input = Readline.readline('', true).strip
 
@@ -321,7 +329,7 @@ module Howzit
       ## @return     [String] the entered value
       ##
       def get_line(prompt_text, default: nil)
-        return (default || '') unless $stdout.isatty
+        return default || '' unless $stdout.isatty
 
         if Util.command_exist?('gum')
           result = gum_input(prompt_text, placeholder: default || '')
@@ -346,7 +354,7 @@ module Howzit
       ##
       def gum_choose(matches, prompt: nil, multi: false, required: true, query: nil)
         prompt_text = prompt || (query ? "Select for '#{query}'" : 'Select')
-        args = ['gum', 'choose']
+        args = %w[gum choose]
         args << '--no-limit' if multi
         args << "--header=#{Shellwords.escape(prompt_text)}"
         args << '--cursor.foreground=6'
@@ -376,7 +384,7 @@ module Howzit
       ## @return     [String] The entered value
       ##
       def gum_input(prompt_text, placeholder: '')
-        args = ['gum', 'input']
+        args = %w[gum input]
         args << "--header=#{Shellwords.escape(prompt_text)}"
         args << "--placeholder=#{Shellwords.escape(placeholder)}" unless placeholder.empty?
         args << '--cursor.foreground=6'

data/lib/howzit/run_report.rb

@@ -57,7 +57,7 @@ module Howzit
 
       # Build the table with emoji header - center emoji in 6-char column
       header = "|  🚥  | #{'Task'.ljust(task_width)} |"
-      separator = "| :--: | #{':' + '-' * (task_width - 1)} |"
+      separator = "| :--: | #{":#{'-' * (task_width - 1)}"} |"
 
       table_lines = [header, separator]
       rows.each do |row|

data/lib/howzit/script_comm.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Howzit
+  # Script Communication module
+  # Handles communication from scripts to Howzit via a communication file
+  module ScriptComm
+    class << self
+      ##
+      ## Create a communication file for scripts to write to
+      ##
+      ## @return     [String] Path to the communication file
+      ##
+      def create_comm_file
+        file = Tempfile.new('howzit_comm')
+        file.close
+        file.path
+      end
+
+      ##
+      ## Set up the communication file and environment variable
+      ##
+      ## @return     [String] Path to the communication file
+      ##
+      def setup
+        comm_file = create_comm_file
+        ENV['HOWZIT_COMM_FILE'] = comm_file
+        comm_file
+      end
+
+      ##
+      ## Read and process the communication file after script execution
+      ##
+      ## @param      comm_file  [String] Path to the communication file
+      ##
+      ## @return     [Hash] Hash with :logs and :vars keys
+      ##
+      def process(comm_file)
+        return { logs: [], vars: {} } unless File.exist?(comm_file)
+
+        logs = []
+        vars = {}
+
+        begin
+          content = File.read(comm_file)
+          content.each_line do |line|
+            line = line.strip
+            next if line.empty?
+
+            case line
+            when /^LOG:(info|warn|error|debug):(.+)$/i
+              level = Regexp.last_match(1).downcase.to_sym
+              message = Regexp.last_match(2)
+              logs << { level: level, message: message }
+            when /^VAR:([A-Z0-9_]+)=(.*)$/i
+              key = Regexp.last_match(1)
+              value = Regexp.last_match(2)
+              vars[key] = value
+            end
+          end
+        rescue StandardError => e
+          Howzit.console&.warn("Error reading communication file: #{e.message}")
+        ensure
+          # Clean up the file
+          File.unlink(comm_file) if File.exist?(comm_file)
+        end
+
+        { logs: logs, vars: vars }
+      end
+
+      ##
+      ## Process communication and apply logs/variables
+      ##
+      ## @param      comm_file  [String] Path to the communication file
+      ##
+      def apply(comm_file)
+        result = process(comm_file)
+        return if result[:logs].empty? && result[:vars].empty?
+
+        # Apply log messages
+        result[:logs].each do |log_entry|
+          level = log_entry[:level]
+          message = log_entry[:message]
+          next unless Howzit.console
+
+          case level
+          when :info
+            Howzit.console.info(message)
+          when :warn
+            Howzit.console.warn(message)
+          when :error
+            Howzit.console.error(message)
+          when :debug
+            Howzit.console.debug(message)
+          end
+        end
+
+        # Apply variables to named_arguments
+        return if result[:vars].empty?
+
+        Howzit.named_arguments ||= {}
+        Howzit.named_arguments.merge!(result[:vars])
+      end
+    end
+  end
+end

data/lib/howzit/stringutils.rb

@@ -38,7 +38,7 @@ module Howzit
       position = 0
       in_order = 0
       chars.each do |char|
-        new_pos = self[position..-1] =~ /#{char}/i
+        new_pos = self[position..] =~ /#{char}/i
         if new_pos
           position += new_pos
           in_order += 1
@@ -72,7 +72,7 @@ module Howzit
     ##
     def distance(chars)
       distance = 0
-      max = self.length - chars.length
+      max = length - chars.length
       return max unless in_order(chars) == chars.length
 
       while distance < max
@@ -175,9 +175,43 @@ module Howzit
       when 'beginswith'
         /^#{self}/i
       when 'fuzzy'
-        /#{split(//).join('.{0,3}?')}/i
+        # For fuzzy matching, use token-based matching where each word gets fuzzy character matching
+        # This allows "lst tst" to match "List Available Tests" by applying fuzzy matching to each token
+        words = split(/\s+/).reject(&:empty?)
+        if words.length > 1
+          # Multiple words: apply character-by-character fuzzy matching to each word token
+          # Then allow flexible matching between words
+          pattern = words.map do |w|
+            # Apply fuzzy matching to each word (character-by-character with up to 3 chars between)
+            w.split(//).map { |c| Regexp.escape(c) }.join('.{0,3}?')
+          end.join('.*')
+          /#{pattern}/i
+        else
+          # Single word: character-by-character fuzzy matching for flexibility
+          /#{split(//).join('.{0,3}?')}/i
+        end
+      when 'token'
+        # Token-based matching: match words in order with any text between them
+        # "list tests" matches "list available tests", "list of tests", etc.
+        words = split(/\s+/).reject(&:empty?)
+        if words.length > 1
+          pattern = words.map { |w| Regexp.escape(w) }.join('.*')
+          /#{pattern}/i
+        else
+          /#{Regexp.escape(self)}/i
+        end
       else
-        /#{self}/i
+        # Default 'partial' mode: token-based matching for multi-word searches
+        # This allows "list tests" to match "list available tests"
+        words = split(/\s+/).reject(&:empty?)
+        if words.length > 1
+          # Token-based: match words in order with any text between
+          pattern = words.map { |w| Regexp.escape(w) }.join('.*')
+          /#{pattern}/i
+        else
+          # Single word: simple substring match
+          /#{Regexp.escape(self)}/i
+        end
       end
     end
 
@@ -185,7 +219,7 @@ module Howzit
     def uncolor
       # force UTF-8 and remove invalid characters, then remove color codes
       # and iTerm markers
-      gsub(Howzit::Color::COLORED_REGEXP, "").gsub(/\e\]1337;SetMark/, "")
+      gsub(Howzit::Color::COLORED_REGEXP, '').gsub(/\e\]1337;SetMark/, '')
     end
 
     # Wrap text at a specified width.
@@ -337,7 +371,7 @@ module Howzit
       gsub!(/\$\{(?<name>[A-Z0-9_]+(?::.*?)?)\}/i) do
         m = Regexp.last_match
         arg, default = m['name'].split(/:/).map(&:strip)
-        if Howzit.named_arguments && Howzit.named_arguments.key?(arg) && !Howzit.named_arguments[arg].nil?
+        if Howzit.named_arguments&.key?(arg) && !Howzit.named_arguments[arg].nil?
           Howzit.named_arguments[arg]
         elsif default
           default

data/lib/howzit/task.rb

@@ -26,7 +26,7 @@ module Howzit
       @arguments = attributes[:arguments] || []
 
       @type = attributes[:type] || :run
-      @title = attributes[:title].nil? ? nil : attributes[:title].to_s
+      @title = attributes[:title]&.to_s
       @parent = attributes[:parent] || nil
 
       @action = attributes[:action].render_arguments || nil
@@ -61,6 +61,7 @@ module Howzit
       Howzit.console.info "#{@prefix}{bg}Running block {bw}#{@title}{x}".c if Howzit.options[:log_level] < 2
       block = @action
       script = Tempfile.new('howzit_script')
+      comm_file = ScriptComm.setup
       begin
         script.write(block)
         script.close
@@ -69,6 +70,8 @@ module Howzit
       ensure
         script.close
         script.unlink
+        # Process script communication
+        ScriptComm.apply(comm_file) if comm_file
       end
 
       update_last_status(res ? 0 : 1)
@@ -112,7 +115,13 @@ module Howzit
                       end
       Howzit.console.info("#{@prefix}{bg}Running {bw}#{display_title}{x}".c)
       ENV['HOWZIT_SCRIPTS'] = File.expand_path('~/.config/howzit/scripts')
-      res = system(@action)
+      comm_file = ScriptComm.setup
+      begin
+        res = system(@action)
+      ensure
+        # Process script communication
+        ScriptComm.apply(comm_file) if comm_file
+      end
       update_last_status(res ? 0 : 1)
       res
     end

data/lib/howzit/topic.rb

@@ -14,13 +14,15 @@ module Howzit
     ##
     ## @param      title    [String] The topic title
     ## @param      content  [String] The raw topic content
+    ## @param      metadata [Hash] Optional metadata hash
     ##
-    def initialize(title, content)
+    def initialize(title, content, metadata = nil)
       @title = title
       @content = content
       @parent = nil
       @nest_level = 0
       @named_args = {}
+      @metadata = metadata
       arguments
 
       @tasks = gather_tasks
@@ -37,7 +39,7 @@ module Howzit
       args.each_with_index do |arg, idx|
         arg_name, default = arg.split(/:/).map(&:strip)
 
-        @named_args[arg_name] = if Howzit.arguments.count >= idx + 1
+        @named_args[arg_name] = if Howzit.arguments && Howzit.arguments.count >= idx + 1
                                   Howzit.arguments[idx]
                                 else
                                   default
@@ -81,7 +83,11 @@ module Howzit
 
       if @tasks.count.positive?
         unless @prereqs.empty?
-          puts TTY::Box.frame("{by}#{@prereqs.join("\n\n").wrap(cols - 4)}{x}".c, width: cols)
+          begin
+            puts TTY::Box.frame("{by}#{@prereqs.join("\n\n").wrap(cols - 4)}{x}".c, width: cols)
+          rescue Errno::EPIPE
+            # Pipe closed, ignore
+          end
           res = Prompt.yn('Have the above prerequisites been met?', default: true)
           Process.exit 1 unless res
 
@@ -123,7 +129,13 @@ module Howzit
 
       output.push(@results[:message]) if Howzit.options[:log_level] < 2 && !nested && !Howzit.options[:run]
 
-      puts TTY::Box.frame("{bw}#{@postreqs.join("\n\n").wrap(cols - 4)}{x}".c, width: cols) unless @postreqs.empty?
+      unless @postreqs.empty?
+        begin
+          puts TTY::Box.frame("{bw}#{@postreqs.join("\n\n").wrap(cols - 4)}{x}".c, width: cols)
+        rescue Errno::EPIPE
+          # Pipe closed, ignore
+        end
+      end
 
       output
     end
@@ -175,6 +187,7 @@ module Howzit
       return [] if matches.empty?
 
       topic = matches[0]
+      return [] if topic.nil?
 
       rule = '{kKd}'
       color = '{Kyd}'
@@ -253,14 +266,16 @@ module Howzit
         output.push(@title.format_header)
         output.push('')
       end
-      topic = @content.dup
+      # Process conditional blocks first
+      metadata = @metadata || Howzit.buildnote&.metadata
+      topic = ConditionalContent.process(@content.dup, { metadata: metadata })
       unless Howzit.options[:show_all_code]
         topic.gsub!(/(?mix)^(`{3,})run([?!]*)\s*
                     ([^\n]*)[\s\S]*?\n\1\s*$/, '@@@run\2 \3')
       end
       topic.split(/\n/).each do |l|
         case l
-        when /@(before|after|prereq|end)/
+        when /@(before|after|prereq|end|if|unless)/
           next
         when /@include(?<optional>[!?]{1,2})?\((?<action>[^)]+)\)/
           output.concat(process_include(Regexp.last_match.named_captures.symbolize_keys, opt))
@@ -299,7 +314,7 @@ module Howzit
       # Store the actual title (not overridden by show_all_code - that's only for display)
       task_args = { type: :include,
                     arguments: nil,
-                    title: title.dup,  # Make a copy to avoid reference issues
+                    title: title.dup, # Make a copy to avoid reference issues
                     action: obj,
                     parent: self }
       # Set named_arguments before processing titles for variable substitution
@@ -362,15 +377,21 @@ module Howzit
 
     def gather_tasks
       runnable = []
-      @prereqs = @content.scan(/(?<=@before\n).*?(?=\n@end)/im).map(&:strip)
-      @postreqs = @content.scan(/(?<=@after\n).*?(?=\n@end)/im).map(&:strip)
+      # Process conditional blocks first
+      # Set named_arguments before processing so conditions can access them
+      Howzit.named_arguments = @named_args
+      metadata = @metadata || Howzit.buildnote&.metadata
+      processed_content = ConditionalContent.process(@content, { metadata: metadata })
+
+      @prereqs = processed_content.scan(/(?<=@before\n).*?(?=\n@end)/im).map(&:strip)
+      @postreqs = processed_content.scan(/(?<=@after\n).*?(?=\n@end)/im).map(&:strip)
 
       rx = /(?mix)(?:
             @(?<cmd>include|run|copy|open|url)(?<optional>[!?]{1,2})?\((?<action>[^)]*?)\)(?<title>[^\n]+)?
             |(?<fence>`{3,})run(?<optional2>[!?]{1,2})?(?<title2>[^\n]+)?(?<block>.*?)\k<fence>
             )/
       matches = []
-      @content.scan(rx) { matches << Regexp.last_match }
+      processed_content.scan(rx) { matches << Regexp.last_match }
       matches.each do |m|
         c = m.named_captures.symbolize_keys
         Howzit.named_arguments = @named_args

data/lib/howzit/util.rb

@@ -118,7 +118,11 @@ module Howzit
       # Paginate the output
       def page(text)
         unless $stdout.isatty
-          puts text
+          begin
+            puts text
+          rescue Errno::EPIPE
+            # Pipe closed, ignore
+          end
           return
         end
 
@@ -181,7 +185,11 @@ module Howzit
         if options[:paginate] && Howzit.options[:paginate]
           page(output)
         else
-          puts output
+          begin
+            puts output
+          rescue Errno::EPIPE
+            # Pipe closed, ignore
+          end
         end
       end
 
@@ -219,7 +227,7 @@ module Howzit
       ##
       def os_paste
         os = RbConfig::CONFIG['target_os']
-        out = "{bg}Pasting from clipboard".c
+        out = '{bg}Pasting from clipboard'.c
         case os
         when /darwin.*/i
           Howzit.console.debug("#{out} (macOS){x}".c)

data/lib/howzit/version.rb

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

data/lib/howzit.rb

@@ -13,7 +13,7 @@ COLOR_FILE = 'theme.yaml'
 IGNORE_FILE = 'ignore.yaml'
 
 # Available options for matching method
-MATCHING_OPTIONS = %w[partial exact fuzzy beginswith].freeze
+MATCHING_OPTIONS = %w[partial exact fuzzy beginswith token].freeze
 
 # Available options for multiple_matches method
 MULTIPLE_OPTIONS = %w[first best all choose].freeze
@@ -38,6 +38,9 @@ require_relative 'howzit/stringutils'
 
 require_relative 'howzit/console_logger'
 require_relative 'howzit/config'
+require_relative 'howzit/script_comm'
+require_relative 'howzit/condition_evaluator'
+require_relative 'howzit/conditional_content'
 require_relative 'howzit/task'
 require_relative 'howzit/topic'
 require_relative 'howzit/buildnote'