doing 2.0.9.pre → 2.0.10

data/lib/doing/item.rb

@@ -2,11 +2,24 @@
 
 module Doing
   ##
-  ## @brief      This class describes a single WWID item
+  ## This class describes a single WWID item
   ##
   class Item
+    include Amatch
+
     attr_accessor :date, :title, :section, :note
 
+    ##
+    ## Initialize an item with date, title, section, and
+    ## optional note
+    ##
+    ## @param      date     [Time] The item's start date
+    ## @param      title    [String] The title
+    ## @param      section  [String] The section to which
+    ##                      the item belongs
+    ## @param      note     [Array or String] The note
+    ##                      (optional)
+    ##
     def initialize(date, title, section, note = nil)
       @date = date.is_a?(Time) ? date : Time.parse(date)
       @title = title
@@ -18,14 +31,36 @@ module Doing
     #   @date = new_date.is_a?(Time) ? new_date : Time.parse(new_date)
     # end
 
+    ##
+    ## Get the difference between the item's start date and
+    ## the value of its @done tag (if present)
+    ##
+    ## @return     Interval in seconds
+    ##
     def interval
       @interval ||= calc_interval
     end
 
+    ##
+    ## Get the value of the item's @done tag
+    ##
+    ## @return     [Time] @done value
+    ##
     def end_date
       @end_date ||= Time.parse(Regexp.last_match(1)) if @title =~ /@done\((\d{4}-\d\d-\d\d \d\d:\d\d.*?)\)/
     end
 
+    def hash_id
+      (@date.to_s + @title + @section + @note.join(' ')).hash
+    end
+
+    ##
+    ## Test for equality between items
+    ##
+    ## @param      other [Item] The other item
+    ##
+    ## @return     [Boolean] is equal?
+    ##
     def equal?(other)
       return false if @title.strip != other.title.strip
 
@@ -36,10 +71,25 @@ module Doing
       true
     end
 
+    ##
+    ## Test if two items occur at the same time (same start date and equal duration)
+    ##
+    ## @param      item_b  [Item] The item to compare
+    ##
+    ## @return     [Boolean] is equal?
+    ##
     def same_time?(item_b)
       date == item_b.date ? interval == item_b.interval : false
     end
 
+    ##
+    ## Test if the interval between start date and @done
+    ## value overlaps with another item's
+    ##
+    ## @param      item_b  [Item] The item to compare
+    ##
+    ## @return     [Boolean] overlaps?
+    ##
     def overlapping_time?(item_b)
       return true if same_time?(item_b)
 
@@ -52,14 +102,37 @@ module Doing
       (start_a >= start_b && start_a <= end_b) || (end_a >= start_b && end_a <= end_b) || (start_a < start_b && end_a > end_b)
     end
 
+    ##
+    ## Add (or remove) tags from the title of the item
+    ##
+    ## @param      tag        [String] The tag to add
+    ## @param      value      [String] A value to include as @tag(value)
+    ## @param      remove     [Boolean] if true remove instead of adding
+    ## @param      rename_to  [String] if not nil, rename target tag to this tag name
+    ## @param      regex      [Boolean] treat target tag string as regex pattern
+    ##
     def tag(tag, value: nil, remove: false, rename_to: nil, regex: false)
       @title.tag!(tag, value: value, remove: remove, rename_to: rename_to, regex: regex).strip!
     end
 
+    ##
+    ## Get a list of tags on the item
+    ##
+    ## @return     [Array] array of tags (no values)
+    ##
     def tags
       @title.scan(/(?<= |\A)@([^\s(]+)/).map {|tag| tag[0]}.sort.uniq
     end
 
+    ##
+    ## Test if item contains tag(s)
+    ##
+    ## @param      tags    (Array or String) The tags to test. Can be an array or a comma-separated string.
+    ## @param      bool    (Symbol) The boolean to use for multiple tags (:and, :or, :not)
+    ## @param      negate  [Boolean] negate the result?
+    ##
+    ## @return     [Boolean] true if tag/bool combination passes
+    ##
     def tags?(tags, bool = :and, negate: false)
       tags = split_tags(tags)
       bool = bool.normalize_bool
@@ -75,26 +148,37 @@ module Doing
       negate ? !matches : matches
     end
 
-    def search(search, negate: false, case_type: :smart)
+    ##
+    ## Test if item matches search string
+    ##
+    ## @param      search     [String] The search string
+    ## @param      negate     [Boolean] negate results
+    ## @param      case_type  (Symbol) The case-sensitivity
+    ##                        type (:sensitive,
+    ##                        :ignore, :smart)
+    ##
+    ## @return     [Boolean] matches search criteria
+    ##
+    def search(search, distance: 3, negate: false, case_type: :smart, fuzzy: false)
       text = @title + @note.to_s
-      pattern = case search.strip
-                when %r{^/.*?/$}
-                  search.sub(%r{/(.*?)/}, '\1')
-                when /^'/
-                  case_sensitive = true
-                  search.sub(/^'(.*?)'?$/, '\1')
-                else
-                  if case_type == :smart
-                    case_sensitive = true if search =~ /[A-Z]/
-                  else
-                    case_sensitive = case_type == :sensitive
-                  end
 
-                  search.split('').join('.{0,3}')
+      if search.is_rx? || !fuzzy
+        matches = text =~ search.to_rx(distance: distance, case_type: case_type)
+      else
+        distance = 0.25 if distance > 1
+        score = if (case_type == :smart && search !~ /[A-Z]/) || case_type == :ignore
+                  text.downcase.pair_distance_similar(search.downcase)
+                else
+                  score = text.pair_distance_similar(search)
                 end
-      rx = Regexp.new(pattern, !case_sensitive)
 
-      negate ? text !~ rx : text =~ rx
+        if score >= distance
+          matches = true
+          Doing.logger.debug('Fuzzy Match:', %(#{@title}, "#{search}" #{score}))
+        end
+      end
+
+      negate ? !matches : matches
     end
 
     def should_finish?

data/lib/doing/log_adapter.rb

@@ -2,7 +2,7 @@
 
 module Doing
   ##
-  ## @brief      Log adapter
+  ## Log adapter
   ##
   class LogAdapter
     attr_writer :logdev, :max_length
@@ -32,7 +32,7 @@ module Doing
     ].freeze
 
     #
-    # @brief      Create a new instance of a log writer
+    # Create a new instance of a log writer
     #
     # @param      level   (optional, symbol) the log level
     #
@@ -47,29 +47,25 @@ module Doing
     end
 
     #
-    # @brief      Set the log level on the writer
+    # Set the log level on the writer
     #
     # @param      level  (symbol) the log level
     #
     # @return     nothing
     #
-    def log_level=(level)
-      level ||= 'info'
+    def log_level=(level = 'info')
       level = level.to_s
-      if level.is_a?(String) && level =~ /^([ewid]\w+|[0123])$/
-        level = case level
-                when /^[e0]/
-                  :error
-                when /^[w1]/
-                  :warn
-                when /^[i2]/
-                  :info
-                when /^[d3]/
-                  :debug
-                end
-      else
-        level = level.downcase.to_sym
-      end
+
+      level = case level
+              when /^[e0]/i
+                :error
+              when /^[w1]/i
+                :warn
+              when /^[d3]/i
+                :debug
+              else
+                :info
+              end
 
       @level = level
     end
@@ -84,46 +80,6 @@ module Doing
       # log_now :debug, 'Doing Version:', Doing::VERSION
     end
 
-    def format_counter(key, data)
-      case key
-      when :added_tags
-        ['Tagged:', data[:message] || 'added %tags to %count %items']
-      when :removed_tags
-        ['Untagged:', data[:message] || 'removed %tags from %count %items']
-      when :added
-        ['Added:', data[:message] || 'added %count new %items']
-      when :updated
-        ['Updated:', data[:message] || 'updated %count %items']
-      when :deleted
-        ['Deleted:', data[:message] || 'deleted %count %items']
-      when :moved
-        ['Moved:', data[:message] || 'moved %count %items']
-      when :completed
-        ['Completed:', data[:message] || 'completed %count %items']
-      when :archived
-        ['Archived:',  data[:message] || 'archived %count %items']
-      when :completed_archived
-        ['Archived:',  data[:message] || 'completed and archived %count %items']
-      when :skipped
-        ['Skipped:', data[:message] || '%count %items were unchanged']
-      end
-    end
-
-    def total_counters
-      @counters.each do |key, data|
-        next if data[:count].zero?
-
-        count = data[:count]
-        tags = data[:tag] ? data[:tag].uniq.map { |t| "@#{t}".cyan }.join(', ') : 'tags'
-        topic, m = format_counter(key, data)
-        message = m.dup
-        message.sub!(/%count/, count.to_s)
-        message.sub!(/%items/, count == 1 ? 'item' : 'items')
-        message.sub!(/%tags/, tags)
-        write(data[:level], topic, message)
-      end
-    end
-
     def count(key, level: :info, count: 1, tag: nil, message: nil)
       raise ArgumentError, 'invalid counter key' unless COUNT_KEYS.include?(key)
 
@@ -134,7 +90,7 @@ module Doing
     end
 
     #
-    # @brief      Print a debug message
+    # Print a debug message
     #
     # @param      topic    the topic of the message
     # @param      message  the message detail
@@ -146,7 +102,7 @@ module Doing
     end
 
     #
-    # @brief      Print a message
+    # Print a message
     #
     # @param      topic    the topic of the message, e.g.
     #                      "Configuration file",
@@ -160,7 +116,7 @@ module Doing
     end
 
     #
-    # @brief      Print a message
+    # Print a message
     #
     # @param      topic    the topic of the message, e.g.
     #                      "Configuration file",
@@ -174,7 +130,7 @@ module Doing
     end
 
     #
-    # @brief      Print an error message
+    # Print an error message
     #
     # @param      topic    the topic of the message, e.g.
     #                      "Configuration file",
@@ -188,7 +144,7 @@ module Doing
     end
 
     #
-    # @brief      Print an error message and immediately
+    # Print an error message and immediately
     #             abort the process
     #
     # @param      topic    the topic of the message, e.g.
@@ -204,33 +160,8 @@ module Doing
       abort
     end
 
-    # Internal: Build a topic method
     #
-    # @param      topic    the topic of the message, e.g.
-    #                      "Configuration file",
-    #                      "Deprecation", etc.
-    # @param      message  the message detail
-    #
-    # @return     the formatted message
-    #
-    def message(topic, message = nil)
-      raise ArgumentError, 'block or message, not both' if block_given? && message
-
-      message = yield if block_given?
-      message = message.to_s.gsub(/\s+/, ' ')
-
-      return topic.ljust(TOPIC_WIDTH) if topic && message.strip.empty?
-
-      topic = formatted_topic(topic, colon: block_given?)
-      message.truncmiddle!(@max_length - TOPIC_WIDTH - 5)
-      out = topic + message
-      out.truncate!(@max_length) if @max_length.positive?
-      messages << out
-      out
-    end
-
-    #
-    # @brief      Format the topic
+    # Format the topic
     #
     # @param      topic  the topic of the message, e.g.
     #                    "Configuration file",
@@ -250,39 +181,34 @@ module Doing
     end
 
     #
-    # @brief      Check if the message should be written
-    #             given the log level.
-    #
-    # @param      level_of_message  the Symbol level of
-    #                               message, one of :debug,
-    #                               :info, :warn, :error
-    #
-    # @return     whether the message should be written.
-    #
-    def write_message?(level_of_message)
-      LOG_LEVELS.fetch(@level) <= LOG_LEVELS.fetch(level_of_message)
-    end
-
-    #
-    # @brief      Log a message.
+    # Log a message.
     #
-    # @param      level_of_message  the Symbol level of
-    #                               message, one of :debug,
-    #                               :info, :warn, :error
-    # @param      topic             the String topic or full
-    #                               message
-    # @param      message           the String message
-    #                               (optional)
+    # @param      level_of_message  [Symbol] the Symbol
+    #                               level of message, one of
+    #                               :debug, :info, :warn,
+    #                               :error
+    # @param      topic             [String] the String
+    #                               topic or full message
+    # @param      message           [String] the String
+    #                               message (optional)
     # @param      block             a block containing the
     #                               message (optional)
     #
-    # @return     false if the message was not written
+    # @return     [Boolean] false if the message was not written
     #
     def write(level_of_message, topic, message = nil, &block)
       @results << { level: level_of_message, message: message(topic, message, &block) }
       true
     end
 
+    ##
+    ## Log to console immediately instead of writing messages on exit
+    ##
+    ## @param      level    [Symbol] The level
+    ## @param      topic    [String] The topic or full message
+    ## @param      message  [String] The message (optional)
+    ## @param      block    a block containing the message (optional)
+    ##
     def log_now(level, topic, message = nil, &block)
       return false unless write_message?(level)
 
@@ -293,6 +219,11 @@ module Doing
       end
     end
 
+    ##
+    ## Output registers based on log level
+    ##
+    ## @return     nothing
+    ##
     def output_results
       total_counters
 
@@ -309,6 +240,85 @@ module Doing
 
     private
 
+    def format_counter(key, data)
+      case key
+      when :added_tags
+        ['Tagged:', data[:message] || 'added %tags to %count %items']
+      when :removed_tags
+        ['Untagged:', data[:message] || 'removed %tags from %count %items']
+      when :added
+        ['Added:', data[:message] || 'added %count new %items']
+      when :updated
+        ['Updated:', data[:message] || 'updated %count %items']
+      when :deleted
+        ['Deleted:', data[:message] || 'deleted %count %items']
+      when :moved
+        ['Moved:', data[:message] || 'moved %count %items']
+      when :completed
+        ['Completed:', data[:message] || 'completed %count %items']
+      when :archived
+        ['Archived:',  data[:message] || 'archived %count %items']
+      when :completed_archived
+        ['Archived:',  data[:message] || 'completed and archived %count %items']
+      when :skipped
+        ['Skipped:', data[:message] || '%count %items were unchanged']
+      end
+    end
+
+    def total_counters
+      @counters.each do |key, data|
+        next if data[:count].zero?
+
+        count = data[:count]
+        tags = data[:tag] ? data[:tag].uniq.map { |t| "@#{t}".cyan }.join(', ') : 'tags'
+        topic, m = format_counter(key, data)
+        message = m.dup
+        message.sub!(/%count/, count.to_s)
+        message.sub!(/%items/, count == 1 ? 'item' : 'items')
+        message.sub!(/%tags/, tags)
+        write(data[:level], topic, message)
+      end
+    end
+
+    #
+    # Check if the message should be written
+    #             given the log level.
+    #
+    # @param      level_of_message  the Symbol level of
+    #                               message, one of :debug,
+    #                               :info, :warn, :error
+    #
+    # @return     whether the message should be written.
+    #
+    def write_message?(level_of_message)
+      LOG_LEVELS.fetch(@level) <= LOG_LEVELS.fetch(level_of_message)
+    end
+
+    # Internal: Build a topic method
+    #
+    # @param      topic    the topic of the message, e.g.
+    #                      "Configuration file",
+    #                      "Deprecation", etc.
+    # @param      message  the message detail
+    #
+    # @return     the formatted message
+    #
+    def message(topic, message = nil)
+      raise ArgumentError, 'block or message, not both' if block_given? && message
+
+      message = yield if block_given?
+      message = message.to_s.gsub(/\s+/, ' ')
+
+      return topic.ljust(TOPIC_WIDTH) if topic && message.strip.empty?
+
+      topic = formatted_topic(topic, colon: block_given?)
+      message.truncmiddle!(@max_length - TOPIC_WIDTH - 5)
+      out = topic + message
+      out.truncate!(@max_length) if @max_length.positive?
+      messages << out
+      out
+    end
+
     def color_message(level, topic, message = nil, &block)
       colors = Doing::Color
       message = message(topic, message, &block)

data/lib/doing/note.rb

@@ -2,7 +2,7 @@
 
 module Doing
   ##
-  ## @brief      This class describes an item note.
+  ## This class describes an item note.
   ##
   class Note < Array
     def initialize(note = [])

data/lib/doing/plugin_manager.rb

@@ -107,7 +107,7 @@ module Doing
       end
 
       ##
-      ## @brief      List available plugins to stdout
+      ## List available plugins to stdout
       ##
       ## @param      options  { type, separator }
       ##
@@ -129,11 +129,11 @@ module Doing
       end
 
       ##
-      ## @brief      Return array of available plugin names
+      ## Return array of available plugin names
       ##
       ## @param      type  Plugin type (:import, :export)
       ##
-      ## @returns    [Array<String>] plugin names
+      ## @return     [Array<String>] plugin names
       ##
       def available_plugins(type: :export)
         type = valid_type(type)
@@ -141,7 +141,7 @@ module Doing
       end
 
       ##
-      ## @brief      Return string version of plugin names
+      ## Return string version of plugin names
       ##
       ## @param      type       Plugin type (:import, :export)
       ## @param      separator  The separator to join names with
@@ -154,7 +154,7 @@ module Doing
       end
 
       ##
-      ## @brief      Return a regular expression of all
+      ## Return a regular expression of all
       ##             plugin triggers for type
       ##
       ## @param      type  The type :import or :export

data/lib/doing/plugins/export/csv_export.rb

@@ -6,7 +6,7 @@
 # url: https://brettterpstra.com
 module Doing
   ##
-  ## @brief      CSV Export
+  ## CSV Export
   ##
   class CSVExport
     include Doing::Util

data/lib/doing/plugins/export/template_export.rb

@@ -94,7 +94,7 @@ module Doing
         end
 
         if note.empty?
-          output.gsub!(/%([io]d|(\^.)?(([ _t]|[^a-z0-9])?\d+)?(.[ _t]?)?)?note/, '')
+          output.gsub!(/%(chomp|[io]d|(\^.)?(([ _t]|[^a-z0-9])?\d+)?(.[ _t]?)?)?note/, '')
         else
           output.sub!(/%note/, "\n#{note.map { |l| "\t#{l.strip}  " }.join("\n")}")
           output.sub!(/%idnote/, "\n#{note.map { |l| "\t\t#{l.strip}  " }.join("\n")}")
@@ -111,15 +111,13 @@ module Doing
             prefix = m['prefix'] || ''
             "\n#{note.map { |l| "#{mark}#{indent}#{prefix}#{l.strip}  " }.join("\n")}"
           end
-          output.sub!(/%chompnote/) do |_m|
-            chomp_note = note.map do |l|
-              l.gsub(/\n+/, ' ').gsub(/(^\s*|\s*$)/, '').gsub(/\s+/, ' ')
-            end
-            chomp_note.join(' ')
+
+          output.sub!(/%chompnote/) do
+            note.map { |l| l.gsub(/\n+/, ' ').gsub(/(^\s*|\s*$)/, '').gsub(/\s+/, ' ') }.join(' ')
           end
         end
 
-        output.gsub!(/%hr(_under)?/) do |_m|
+        output.gsub!(/%hr(_under)?/) do
           o = ''
           `tput cols`.to_i.times do
             o += Regexp.last_match(1).nil? ? '-' : '_'

data/lib/doing/plugins/import/calendar_import.rb

@@ -8,7 +8,7 @@ require 'json'
 
 module Doing
   ##
-  ## @brief      Plugin for importing from Calendar.app on macOS
+  ## Plugin for importing from Calendar.app on macOS
   ##
   class CalendarImport
     include Doing::Util

data/lib/doing/plugins/import/doing_import.rb

@@ -15,11 +15,11 @@ module Doing
     end
 
     ##
-    ## @brief      Imports a Doing file
+    ## Imports a Doing file
     ##
-    ## @param      wwid     WWID object
-    ## @param      path     (String) Path to Doing file
-    ## @param      options  (Hash) Additional Options
+    ## @param      wwid     [WWID] WWID object
+    ## @param      path     [String] Path to Doing file
+    ## @param      options  [Hash] Additional Options
     ##
     ## @return     Nothing
     ##

data/lib/doing/plugins/import/timing_import.rb

@@ -15,10 +15,12 @@ module Doing
     end
 
     ##
-    ## @brief      Imports a Timing report
+    ## Imports a Timing report
     ##
-    ## @param      path     (String) Path to JSON report file
-    ## @param      options      (Hash) Additional Options
+    ## @param      wwid     [WWID] The wwid object
+    ## @param      path     [String] Path to JSON report
+    ##                      file
+    ## @param      options  [Hash] Additional Options
     ##
     def self.import(wwid, path, options: {})
       exit_now! 'Path to JSON report required' if path.nil?