doing 2.0.7.pre → 2.0.11

data/lib/doing/string.rb

@@ -2,14 +2,59 @@
 
 module Doing
   ##
-  ## @brief      String helpers
+  ## String helpers
   ##
   class ::String
     include Doing::Color
-    def to_rx(distance)
-      gsub(/(.)/, "\\1.{0,#{distance}}")
+    ##
+    ## Determines if receiver is surrounded by slashes or starts with single quote
+    ##
+    ## @return     True if regex, False otherwise.
+    ##
+    def is_rx?
+      self =~ %r{(^/.*?/$|^')}
+    end
+
+    ##
+    ## Convert string to fuzzy regex. Characters in words
+    ## can be separated by up to *distance* characters in
+    ## haystack, spaces indicate unlimited distance.
+    ##
+    ## @example    "this word".to_rx(2) =>
+    ## /t.{0,3}h.{0,3}i.{0,3}s.{0,3}.*?w.{0,3}o.{0,3}r.{0,3}d/
+    ##
+    ## @param      distance   [Integer] Allowed distance
+    ##                        between characters
+    ## @param      case_type  The case type
+    ##
+    ## @return     [Regexp] Regex pattern
+    ##
+    def to_rx(distance: 3, case_type: :smart)
+      case_sensitive = case case_type
+                       when :smart
+                         self =~ /[A-Z]/ ? true : false
+                       when :sensitive
+                         true
+                       else
+                         false
+                       end
+
+      pattern = case dup.strip
+                when %r{^/.*?/$}
+                  sub(%r{/(.*?)/}, '\1')
+                when /^'/
+                  sub(/^'(.*?)'?$/, '\1')
+                else
+                  split(/ +/).map { |w| w.split('').join(".{0,#{distance}}") }.join('.*?')
+                end
+      Regexp.new(pattern, !case_sensitive)
     end
 
+    ##
+    ## Test string for truthiness (0, "f", "false", "n", "no" all return false, case insensitive, otherwise true)
+    ##
+    ## @return     [Boolean] String is truthy
+    ##
     def truthy?
       if self =~ /^(0|f(alse)?|n(o)?)$/i
         false
@@ -18,10 +63,18 @@ module Doing
       end
     end
 
+    ## @param (see #highlight_tags)
     def highlight_tags!(color = 'yellow')
       replace highlight_tags(color)
     end
 
+    ##
+    ## Colorize @tags with ANSI escapes
+    ##
+    ## @param      color  [String] color (see #Color)
+    ##
+    ## @return     [String] string with @tags highlighted
+    ##
     def highlight_tags(color = 'yellow')
       escapes = scan(/(\e\[[\d;]+m)[^\e]+@/)
       tag_color = Doing::Color.send(color)
@@ -34,7 +87,7 @@ module Doing
     end
 
     ##
-    ## @brief      Test if line should be ignored
+    ## Test if line should be ignored
     ##
     ## @return     [Boolean] line is empty or comment
     ##
@@ -44,7 +97,7 @@ module Doing
     end
 
     ##
-    ## @brief      Truncate to nearest word
+    ## Truncate to nearest word
     ##
     ## @param      len   The length
     ##
@@ -68,7 +121,7 @@ module Doing
     end
 
     ##
-    ## @brief      Truncate string in the middle
+    ## Truncate string in the middle
     ##
     ## @param      len       The length
     ## @param      ellipsis  The ellipsis
@@ -87,7 +140,7 @@ module Doing
     end
 
     ##
-    ## @brief      Remove color escape codes
+    ## Remove color escape codes
     ##
     ## @return     clean string
     ##
@@ -100,7 +153,7 @@ module Doing
     end
 
     ##
-    ## @brief      Wrap string at word breaks, respecting tags
+    ## Wrap string at word breaks, respecting tags
     ##
     ## @param      len     [Integer] The length
     ## @param      offset  [Integer] (Optional) The width to pad each subsequent line
@@ -134,7 +187,7 @@ module Doing
     end
 
     ##
-    ## @brief      Capitalize on the first character on string
+    ## Capitalize on the first character on string
     ##
     ## @return     Capitalized string
     ##
@@ -145,12 +198,12 @@ module Doing
     end
 
     ##
-    ## @brief      Convert a sort order string to a qualified type
+    ## Convert a sort order string to a qualified type
     ##
-    ## @return     (String) 'asc' or 'desc'
+    ## @return     [String] 'asc' or 'desc'
     ##
-    def normalize_order!
-      replace normalize_order
+    def normalize_order!(default = 'asc')
+      replace normalize_order(default)
     end
 
     def normalize_order(default = 'asc')
@@ -165,12 +218,34 @@ module Doing
     end
 
     ##
-    ## @brief      Convert a boolean string to a symbol
+    ## Convert a case sensitivity string to a symbol
+    ##
+    ## @return     Symbol :smart, :sensitive, :ignore
+    ##
+    def normalize_case!
+      replace normalize_case
+    end
+
+    def normalize_case(default = :smart)
+      case self
+      when /^c/i
+        :sensitive
+      when /^i/i
+        :ignore
+      when /^s/i
+        :smart
+      else
+        default.is_a?(Symbol) ? default : default.normalize_case
+      end
+    end
+
+    ##
+    ## Convert a boolean string to a symbol
     ##
     ## @return     Symbol :and, :or, or :not
     ##
-    def normalize_bool!
-      replace normalize_bool
+    def normalize_bool!(default = :and)
+      replace normalize_bool(default)
     end
 
     def normalize_bool(default = :and)
@@ -204,7 +279,7 @@ module Doing
 
     def add_tags(tags, remove: false)
       title = self.dup
-      tags = tags.to_tags if tags.is_a?(String)
+      tags = tags.to_tags
       tags.each { |tag| title.tag!(tag, remove: remove) }
       title
     end
@@ -268,7 +343,7 @@ module Doing
     end
 
     ##
-    ## @brief      Remove duplicate tags, leaving only first occurrence
+    ## Remove duplicate tags, leaving only first occurrence
     ##
     ## @return     Deduplicated string
     ##
@@ -278,7 +353,7 @@ module Doing
 
     def dedup_tags
       title = dup
-      tags = title.scan(/(?<=^| )(@(\S+?)(\([^)]+\))?)(?= |$)/).uniq
+      tags = title.scan(/(?<=\A| )(@(\S+?)(\([^)]+\))?)(?= |\Z)/).uniq
       tags.each do |tag|
         found = false
         title.gsub!(/( |^)#{tag[1]}(\([^)]+\))?(?= |$)/) do |m|
@@ -294,9 +369,9 @@ module Doing
     end
 
     ##
-    ## @brief      Turn raw urls into HTML links
+    ## Turn raw urls into HTML links
     ##
-    ## @param      opt   (Hash) Additional Options
+    ## @param      opt   [Hash] Additional Options
     ##
     def link_urls!(opt = {})
       replace link_urls(opt)

data/lib/doing/symbol.rb

@@ -2,15 +2,19 @@
 
 module Doing
   ##
-  ## @brief      Symbol helpers
+  ## Symbol helpers
   ##
   class ::Symbol
-    def normalize_bool
-      to_s.normalize_bool
+    def normalize_bool(default = :and)
+      to_s.normalize_bool(default)
     end
 
-    def normalize_order
-      to_s.normalize_order
+    def normalize_order(default = 'asc')
+      to_s.normalize_order(default)
+    end
+
+    def normalize_case
+      self
     end
   end
 end

data/lib/doing/time.rb

@@ -1,6 +1,6 @@
 module Doing
   ##
-  ## @brief      Date helpers
+  ## Date helpers
   ##
   class ::Time
     def relative_date

data/lib/doing/util.rb

@@ -14,9 +14,9 @@ module Doing
     end
 
     ##
-    ## @brief      Test if command line tool is available
+    ## Test if command line tool is available
     ##
-    ## @param      cli   (String) The name or path of the cli
+    ## @param      cli   [String] The name or path of the cli
     ##
     def exec_available(cli)
       return false if cli.nil?
@@ -40,9 +40,14 @@ module Doing
       end
     end
 
-    # Non-destructive version of deep_merge_hashes! See that method.
+    # Non-destructive version of deep_merge_hashes! See that
+    # method.
+    #
+    # @return     the merged hashes.
+    #
+    # @param      [Hash] master_hash  The master hash
+    # @param      [Hash] other_hash   The other hash
     #
-    # Returns the merged hashes.
     def deep_merge_hashes(master_hash, other_hash)
       deep_merge_hashes!(master_hash.dup, other_hash)
     end
@@ -90,11 +95,11 @@ module Doing
     end
 
     ##
-    ## @brief      Write content to a file
+    ## Write content to a file
     ##
-    ## @param      file     (String) The path to the file to (over)write
-    ## @param      content  (String) The content to write to the file
-    ## @param      backup   (Boolean) create a ~ backup
+    ## @param      file     [String] The path to the file to (over)write
+    ## @param      content  [String] The content to write to the file
+    ## @param      backup   [Boolean] create a ~ backup
     ##
     def write_to_file(file, content, backup: true)
       unless file
@@ -143,6 +148,8 @@ module Doing
     end
 
     def find_default_editor(editor_for = 'default')
+      # return nil unless $stdout.isatty || ENV['DOING_EDITOR_TEST']
+
       if ENV['DOING_EDITOR_TEST']
         return ENV['EDITOR']
       end
@@ -156,20 +163,20 @@ module Doing
 
       if editor_config[editor_for]
         editor = editor_config[editor_for]
-        Doing.logger.debug('Editor:', "Using #{editor} from config 'editors->#{editor_for}'")
+        # Doing.logger.debug('Editor:', "Using #{editor} from config 'editors->#{editor_for}'")
         return editor unless editor.nil? || editor.empty?
       end
 
       if editor_for != 'editor' && editor_config['default']
         editor = editor_config['default']
-        Doing.logger.debug('Editor:', "Using #{editor} from config: 'editors->default'")
+        # Doing.logger.debug('Editor:', "Using #{editor} from config: 'editors->default'")
         return editor unless editor.nil? || editor.empty?
       end
 
       editor ||= ENV['DOING_EDITOR'] || ENV['GIT_EDITOR'] || ENV['EDITOR']
 
       unless editor.nil? || editor.empty?
-        Doing.logger.debug('Editor:', "Found editor in environment variables: #{editor}")
+        # Doing.logger.debug('Editor:', "Found editor in environment variables: #{editor}")
         return editor
       end
 

data/lib/doing/version.rb

@@ -1,3 +1,3 @@
 module Doing
-  VERSION = '2.0.7.pre'
+  VERSION = '2.0.11'
 end