doing 2.1.30 → 2.1.34

data/lib/doing/wwid.rb

@@ -14,7 +14,7 @@ module Doing
   class WWID
     attr_reader   :additional_configs, :current_section, :doing_file, :content
 
-    attr_accessor :config, :config_file, :auto_tag, :default_option
+    attr_accessor :config, :config_file, :default_option
 
     include Color
     # include Util
@@ -26,7 +26,12 @@ module Doing
       @timers = {}
       @recorded_items = []
       @content = Items.new
-      @auto_tag = true
+      Doing.auto_tag = true
+    end
+
+    # For backwards compatibility where @wwid.config was accessed instead of Doing.config.settings
+    def config
+      Doing.config.settings
     end
 
     ##
@@ -48,7 +53,7 @@ module Doing
     ## @param      path  [String] Override path to a doing file, optional
     ##
     def init_doing_file(path = nil)
-      @doing_file =  File.expand_path(@config['doing_file'])
+      @doing_file =  File.expand_path(Doing.setting('doing_file'))
 
       if path.nil?
         create(@doing_file) unless File.exist?(@doing_file)
@@ -77,7 +82,7 @@ module Doing
       lines.each do |line|
         next if line =~ /^\s*$/
 
-        if line =~ /^(\S[\S ]+):( .*)?$/
+        if line =~ /^(\S[\S ]+):\s*(@\S+\s*)*$/
           section = Regexp.last_match(1)
           @content.add_section(Section.new(section, original: line), log: false)
         elsif line =~ /^\s*- (\d{4}-\d\d-\d\d \d\d:\d\d) \| (.*)/
@@ -117,7 +122,7 @@ module Doing
       FileUtils.mkdir_p(File.dirname(filename)) unless File.directory?(File.dirname(filename))
 
       File.open(filename, 'w+') do |f|
-        f.puts "#{@config['current_section']}:"
+        f.puts "#{Doing.setting('current_section')}:"
       end
     end
 
@@ -189,7 +194,7 @@ module Doing
 
       raise EmptyInput, 'No content' if title.sub(/^.*?\| */, '').strip.empty?
 
-      title.expand_date_tags(@config['date_tags'])
+      title.expand_date_tags(Doing.setting('date_tags'))
 
       if title =~ date_rx
         m = title.match(date_rx)
@@ -236,7 +241,7 @@ module Doing
     ##
     def guess_section(frag, guessed: false, suggest: false)
       return 'All' if frag =~ /^all$/i
-      frag ||= @config['current_section']
+      frag ||= Doing.setting('current_section')
 
       return frag.cap_first if @content.section?(frag)
 
@@ -342,7 +347,7 @@ module Doing
     ##
     def add_item(title, section = nil, opt)
       opt ||= {}
-      section ||= @config['current_section']
+      section ||= Doing.setting('current_section')
       @content.add_section(section, log: false)
       opt[:back] ||= opt[:date] ? opt[:date] : Time.now
       opt[:date] ||= Time.now
@@ -354,9 +359,9 @@ module Doing
       title = [title.strip.cap_first]
       title = title.join(' ')
 
-      if @auto_tag
+      if Doing.auto_tag
         title = autotag(title)
-        title.add_tags!(@config['default_tags']) unless @config['default_tags'].empty?
+        title.add_tags!(Doing.setting('default_tags')) if Doing.setting('default_tags').good?
       end
 
       title.compress!
@@ -499,7 +504,7 @@ module Doing
       # Remove @done tag
       title = item.title.sub(/\s*@done(\(.*?\))?/, '').chomp
       section = opt[:in].nil? ? item.section : guess_section(opt[:in])
-      @auto_tag = false
+      Doing.auto_tag = false
 
       note = opt[:note] || Note.new
 
@@ -553,7 +558,7 @@ module Doing
     def last_entry(opt)
       opt ||= {}
       opt[:tag_bool] ||= :and
-      opt[:section] ||= @config['current_section']
+      opt[:section] ||= Doing.setting('current_section')
 
       items = filter_items(Items.new, opt: opt)
 
@@ -667,12 +672,14 @@ module Doing
         items = section =~ /^all$/i ? @content.clone : @content.in_section(section)
       end
 
-      opt[:time_filter] = [nil, nil]
-      if opt[:from] && !opt[:date_filter]
-        if opt[:from][0].is_a?(String) && opt[:from][0] =~ time_rx
-          opt[:time_filter] = opt[:from]
-        elsif opt[:from][0].is_a?(Time)
-          opt[:date_filter] = opt[:from]
+      if !opt[:time_filter]
+        opt[:time_filter] = [nil, nil]
+        if opt[:from] && !opt[:date_filter]
+          if opt[:from][0].is_a?(String) && opt[:from][0] =~ time_rx
+            opt[:time_filter] = opt[:from]
+          elsif opt[:from][0].is_a?(Time)
+            opt[:date_filter] = opt[:from]
+          end
         end
       end
 
@@ -1076,7 +1083,7 @@ module Doing
       end
 
       if opt[:flag]
-        tag = @config['marker_tag'] || 'flagged'
+        tag = Doing.setting('marker_tag', 'flagged')
         items.map! do |i|
           old_item = i.clone
           i.tag(tag, date: false, remove: opt[:remove], single: single)
@@ -1117,7 +1124,7 @@ module Doing
         items.map! do |i|
           old_item = i.clone
           i.tag(tag, date: false, remove: opt[:remove], single: single)
-          i.expand_date_tags(@config['date_tags'])
+          i.expand_date_tags(Doing.setting('date_tags'))
           Hooks.trigger :post_entry_updated, self, i, old_item
         end
       end
@@ -1176,7 +1183,7 @@ module Doing
     end
 
     def verify_duration(date, finish_date, title: nil)
-      max_elapsed = @config.dig('interaction', 'confirm_longer_than') || 0
+      max_elapsed = Doing.setting('interaction.confirm_longer_than', 0)
       max_elapsed = max_elapsed.chronify_qty if max_elapsed.is_a?(String)
       date = date.chronify(guess: :end, context: :today) if finish_date.is_a?(String)
 
@@ -1255,7 +1262,7 @@ module Doing
         removed = []
 
         if opt[:autotag]
-          new_title = autotag(item.title) if @auto_tag
+          new_title = autotag(item.title) if Doing.auto_tag
           if new_title == item.title
             logger.count(:skipped, level: :debug, message: '%count unchaged %items')
             # logger.debug('Autotag:', 'No changes')
@@ -1289,7 +1296,7 @@ module Doing
             tag = tag.strip
 
             if tag =~ /^done$/ && opt[:date] && item.should_time?
-              max_elapsed = @config.dig('interaction', 'confirm_longer_than') || 0
+              max_elapsed = Doing.setting('interaction.confirm_longer_than', 0)
               max_elapsed = max_elapsed.chronify_qty if max_elapsed.is_a?(String)
               elapsed = done_date - item.date
 
@@ -1344,7 +1351,7 @@ module Doing
           logger.warn('Skipped:', 'Archiving is skipped when operating on all entries')
         end
 
-        item.expand_date_tags(@config['date_tags'])
+        item.expand_date_tags(Doing.setting('date_tags'))
         Hooks.trigger :post_entry_updated, self, item, old_item
       end
 
@@ -1424,7 +1431,7 @@ module Doing
     def stop_start(target_tag, opt)
       opt ||= {}
       tag = target_tag.dup
-      opt[:section] ||= @config['current_section']
+      opt[:section] ||= Doing.setting('current_section')
       opt[:archive] ||= false
       opt[:back] ||= Time.now
       opt[:new_item] ||= false
@@ -1485,7 +1492,7 @@ module Doing
         $stdout.puts output
       else
         Util.write_to_file(file, output, backup: backup)
-        run_after if @config.key?('run_after')
+        run_after if Doing.setting('run_after')
       end
     end
 
@@ -1593,7 +1600,7 @@ module Doing
     ## @return     [Array] View names
     ##
     def views
-      @config.has_key?('views') ? @config['views'].keys : []
+      Doing.setting('views') ? Doing.setting('views').keys : []
     end
 
     ##
@@ -1612,7 +1619,7 @@ module Doing
     ## @param      title  [String] The title of the view to retrieve
     ##
     def get_view(title)
-      return @config['views'][title] if @config['views'].has_key?(title)
+      return Doing.setting(['views', title], nil)
 
       false
     end
@@ -1626,21 +1633,21 @@ module Doing
       logger.benchmark(:list_section, :start)
       opt[:config_template] ||= 'default'
 
-      tpl_cfg = @config.dig('templates', opt[:config_template])
+      tpl_cfg = Doing.setting(['templates', opt[:config_template]])
 
       cfg = if opt[:view_template]
-              @config.dig('views', opt[:view_template]).deep_merge(tpl_cfg, { extend_existing_arrays: true, sort_merged_arrays: true })
+              Doing.setting(['views', opt[:view_template]]).deep_merge(tpl_cfg, { extend_existing_arrays: true, sort_merged_arrays: true })
             else
               tpl_cfg
             end
 
       cfg.deep_merge({
-                       'wrap_width' => @config['wrap_width'] || 0,
-                       'date_format' => @config['default_date_format'],
-                       'order' => @config['order'] || :asc,
-                       'tags_color' => @config['tags_color'],
-                       'duration' => @config['duration'],
-                       'interval_format' => @config['interval_format']
+                       'wrap_width' => Doing.setting('wrap_width') || 0,
+                       'date_format' => Doing.setting('default_date_format'),
+                       'order' => Doing.setting('order') || :asc,
+                       'tags_color' => Doing.setting('tags_color'),
+                       'duration' => Doing.setting('duration'),
+                       'interval_format' => Doing.setting('interval_format')
                      }, { extend_existing_arrays: true, sort_merged_arrays: true })
 
       opt[:duration] ||= cfg['duration'] || false
@@ -1653,6 +1660,7 @@ module Doing
       opt[:tag_order] ||= :asc
       opt[:tags_color] = cfg['tags_color'] || false if opt[:tags_color].nil?
       opt[:template] ||= cfg['template']
+      opt[:sort_tags] ||= opt[:tag_sort]
 
       # opt[:highlight] ||= true
       title = ''
@@ -1697,7 +1705,7 @@ module Doing
       end
 
       opt[:output] ||= 'template'
-      opt[:wrap_width] ||= @config['templates']['default']['wrap_width'] || 0
+      opt[:wrap_width] ||= Doing.setting('templates.default.wrap_width', 0)
 
       logger.benchmark(:list_section, :finish)
       output(items, title, is_single, opt)
@@ -1710,7 +1718,7 @@ module Doing
     ## @param      section      [String] The source section
     ## @param      options      [Hash] Options
     ##
-    def archive(section = @config['current_section'], options)
+    def archive(section = Doing.setting('current_section'), options)
       options ||= {}
       count       = options[:keep] || 0
       destination = options[:destination] || 'Archive'
@@ -1746,13 +1754,13 @@ module Doing
       opt[:totals] ||= false
       opt[:sort_tags] ||= false
 
-      cfg = @config['templates'][opt[:config_template]].deep_merge(@config['templates']['default'], { extend_existing_arrays: true, sort_merged_arrays: true }).deep_merge({
-        'wrap_width' => @config['wrap_width'] || 0,
-        'date_format' => @config['default_date_format'],
-        'order' => @config['order'] || :asc,
-        'tags_color' => @config['tags_color'],
-        'duration' => @config['duration'],
-        'interval_format' => @config['interval_format']
+      cfg = Doing.setting('templates').deep_merge(Doing.setting('templates.default'), { extend_existing_arrays: true, sort_merged_arrays: true }).deep_merge({
+        'wrap_width' => Doing.setting('wrap_width') || 0,
+        'date_format' => Doing.setting('default_date_format'),
+        'order' => Doing.setting('order') || :asc,
+        'tags_color' => Doing.setting('tags_color'),
+        'duration' => Doing.setting('duration'),
+        'interval_format' => Doing.setting('interval_format')
       }, { extend_existing_arrays: true, sort_merged_arrays: true })
 
       template = opt[:template] || cfg['template']
@@ -1768,6 +1776,7 @@ module Doing
         from: opt[:from],
         format: cfg['date_format'],
         interval_format: opt[:interval_format],
+        only_timed: opt[:only_timed],
         order: cfg['order'] || :asc,
         output: output,
         section: opt[:section],
@@ -1800,19 +1809,19 @@ module Doing
       # :date_filter expects an array with start and end date
       dates = dates.split_date_range if dates.instance_of?(String)
 
-      list_section({
-                     section: section,
-                     count: 0,
-                     order: :asc,
-                     date_filter: dates,
-                     times: times,
-                     output: output,
-                     totals: opt[:totals],
-                     duration: opt[:duration],
-                     sort_tags: opt[:sort_tags],
-                     template: opt[:template],
-                     config_template: opt[:config_template]
-                   })
+      opt[:section] = section
+      opt[:count] = 0
+      opt[:order] = :asc
+      opt[:date_filter] = dates
+      opt[:times] = times
+      opt[:output] = output
+
+      time_rx = /^(\d{1,2}+(:\d{1,2}+)?( *(am|pm))?|midnight|noon)$/
+      if opt[:from] && opt[:from][0].is_a?(String) && opt[:from][0] =~ time_rx
+        opt[:time_filter] = opt[:from]
+      end
+
+      list_section(opt)
     end
 
     ##
@@ -1827,30 +1836,20 @@ module Doing
       opt ||= {}
       opt[:totals] ||= false
       opt[:sort_tags] ||= false
+      opt[:config_template] ||= 'today'
+      opt[:yesterday] = true
+
       section = guess_section(section)
       y = (Time.now - (60 * 60 * 24)).strftime('%Y-%m-%d')
       opt[:after] = "#{y} #{opt[:after]}" if opt[:after]
       opt[:before] = "#{y} #{opt[:before]}" if opt[:before]
 
-      options = {
-        after: opt[:after],
-        before: opt[:before],
-        count: 0,
-        duration: opt[:duration],
-        from: opt[:from],
-        order: opt[:order],
-        output: output,
-        section: section,
-        sort_tags: opt[:sort_tags],
-        tag_order: opt[:tag_order],
-        times: times,
-        totals: opt[:totals],
-        yesterday: true,
-        config_template: opt[:config_template] || 'today',
-        template: opt[:template]
-      }
+      opt[:output] = output
+      opt[:section] = section
+      opt[:times] = times
+      opt[:count] = 0
 
-      list_section(options)
+      list_section(opt)
     end
 
     ##
@@ -1866,18 +1865,18 @@ module Doing
       opt[:totals] ||= false
       opt[:sort_tags] ||= false
 
-      cfg = @config['templates'][opt[:config_template]].deep_merge(@config['templates']['default'], { extend_existing_arrays: true, sort_merged_arrays: true }).deep_merge({
-        'wrap_width' => @config['wrap_width'] || 0,
-        'date_format' => @config['default_date_format'],
-        'order' => @config['order'] || :asc,
-        'tags_color' => @config['tags_color'],
-        'duration' => @config['duration'],
-        'interval_format' => @config['interval_format']
+      cfg = Doing.setting('templates.recent').deep_merge(Doing.setting('templates.default'), { extend_existing_arrays: true, sort_merged_arrays: true }).deep_merge({
+        'wrap_width' => Doing.setting('wrap_width') || 0,
+        'date_format' => Doing.setting('default_date_format'),
+        'order' => Doing.setting('order') || :asc,
+        'tags_color' => Doing.setting('tags_color'),
+        'duration' => Doing.setting('duration'),
+        'interval_format' => Doing.setting('interval_format')
       }, { extend_existing_arrays: true, sort_merged_arrays: true })
       opt[:duration] ||= cfg['duration'] || false
       opt[:interval_format] ||= cfg['interval_format'] || 'text'
 
-      section ||= @config['current_section']
+      section ||= Doing.setting('current_section')
       section = guess_section(section)
 
       opt[:section] = section
@@ -1899,13 +1898,13 @@ module Doing
     ##
     def last(times: true, section: nil, options: {})
       section = section.nil? || section =~ /all/i ? 'All' : guess_section(section)
-      cfg = @config['templates'][options[:config_template]].deep_merge(@config['templates']['default'], { extend_existing_arrays: true, sort_merged_arrays: true }).deep_merge({
-        'wrap_width' => @config['wrap_width'] || 0,
-        'date_format' => @config['default_date_format'],
-        'order' => @config['order'] || :asc,
-        'tags_color' => @config['tags_color'],
-        'duration' => @config['duration'],
-        'interval_format' => @config['interval_format']
+      cfg = Doing.setting(['templates', options[:config_template]]).deep_merge(Doing.setting('templates.default'), { extend_existing_arrays: true, sort_merged_arrays: true }).deep_merge({
+        'wrap_width' => Doing.setting('wrap_width', 0),
+        'date_format' => Doing.setting('default_date_format'),
+        'order' => Doing.setting('order', :asc),
+        'tags_color' => Doing.setting('tags_color'),
+        'duration' => Doing.setting('duration'),
+        'interval_format' => Doing.setting('interval_format')
       }, { extend_existing_arrays: true, sort_merged_arrays: true })
       options[:duration] ||= cfg['duration'] || false
       options[:interval_format] ||= cfg['interval_format'] || 'text'
@@ -1947,7 +1946,7 @@ module Doing
     ##
     def autotag(string)
       return unless string
-      return string unless @auto_tag
+      return string unless Doing.auto_tag
 
       original = string.dup
       text = string.dup
@@ -1960,7 +1959,7 @@ module Doing
         replaced: []
       }
 
-      @config['autotag']['whitelist'].each do |tag|
+      Doing.setting('autotag.whitelist').each do |tag|
         next if text =~ /@#{tag}\b/i
 
         text.sub!(/(?<= |\A)(#{tag.strip})(?= |\Z)/i) do |m|
@@ -1970,7 +1969,7 @@ module Doing
         end
       end
 
-      @config['autotag']['synonyms'].each do |tag, v|
+      Doing.setting('autotag.synonyms').each do |tag, v|
         v.each do |word|
           word = word.wildcard_to_rx
           next unless text =~ /\b#{word}\b/i
@@ -1982,8 +1981,8 @@ module Doing
         end
       end
 
-      if @config['autotag'].key? 'transform'
-        @config['autotag']['transform'].each do |tag|
+      if Doing.setting('autotag.transform')
+        Doing.setting('autotag.transform').each do |tag|
           next unless tag =~ /\S+:\S+/
 
           if tag =~ /::/
@@ -2055,11 +2054,11 @@ module Doing
     def tag_times(format: :text, sort_by: :time, sort_order: :asc)
       return '' if @timers.empty?
 
-      max = @timers.keys.sort_by { |k| k.length }.reverse[0].length + 1
+      max = @timers.keys.sort_by(&:length).reverse[0].length + 1
 
       total = @timers.delete('All')
 
-      tags_data = @timers.delete_if { |_k, v| v == 0 }
+      tags_data = @timers.delete_if { |_k, v| v.zero? }
       sorted_tags_data = if sort_by.normalize_tag_sort == :name
                            tags_data.sort_by { |k, _v| k }
                          else
@@ -2070,7 +2069,7 @@ module Doing
       case format
       when :html
 
-        output = <<EOS
+        output = <<EOHEAD
           <table>
           <caption id="tagtotals">Tag Totals</caption>
           <colgroup>
@@ -2084,13 +2083,13 @@ module Doing
           </tr>
           </thead>
           <tbody>
-EOS
+EOHEAD
         sorted_tags_data.reverse.each do |k, v|
-          if v > 0
+          if v.positive?
             output += "<tr><td style='text-align:left;'>#{k}</td><td style='text-align:left;'>#{v.time_string(format: :clock)}</td></tr>\n"
           end
         end
-        tail = <<EOS
+        tail = <<EOTAIL
         <tr>
           <td style="text-align:left;" colspan="2"></td>
         </tr>
@@ -2102,21 +2101,21 @@ EOS
         </tr>
         </tfoot>
         </table>
-EOS
+EOTAIL
         output + tail
       when :markdown
-        pad = sorted_tags_data.map {|k, v| k }.group_by(&:size).max.last[0].length
+        pad = sorted_tags_data.map { |k, _| k }.group_by(&:size).max.last[0].length
         pad = 7 if pad < 7
-        output = <<~EOS
-  | #{' ' * (pad - 7) }project | time     |
+        output = <<~EOHEADER
+  | #{' ' * (pad - 7)}project | time     |
   | #{'-' * (pad - 1)}: | :------- |
-        EOS
+        EOHEADER
         sorted_tags_data.reverse.each do |k, v|
-          if v > 0
+          if v.positive?
             output += "| #{' ' * (pad - k.length)}#{k} | #{v.time_string(format: :clock)} |\n"
           end
         end
-        tail = "[Tag Totals]"
+        tail = '[Tag Totals]'
         output + tail
       when :json
         output = []
@@ -2203,38 +2202,37 @@ EOS
     end
 
     ##
-    ## Load configuration files and updated the @config
+    ## Load configuration files and updated the @settings
     ## attribute with a Doing::Configuration object
     ##
     ## @param      filename  [String] (optional) path to
     ##                       alternative config file
     ##
     def configure(filename = nil)
+      logger.benchmark(:configure, :start)
+
       if filename
         Doing.config_with(filename, { ignore_local: true })
       elsif ENV['DOING_CONFIG']
         Doing.config_with(ENV['DOING_CONFIG'], { ignore_local: true })
       end
 
-      logger.benchmark(:configure, :start)
-      config = Doing.config
       logger.benchmark(:configure, :finish)
 
-      config.settings['backup_dir'] = ENV['DOING_BACKUP_DIR'] if ENV['DOING_BACKUP_DIR']
-      @config = config.settings
+      Doing.set('backup_dir', ENV['DOING_BACKUP_DIR']) if ENV['DOING_BACKUP_DIR']
     end
 
     def get_diff(filename = nil)
-      configure if @config.nil?
+      configure if Doing.settings.nil?
 
-      filename ||= @config['doing_file']
+      filename ||= Doing.setting('doing_file')
       init_doing_file(filename)
       current_content = @content.clone
       backup_file = Util::Backup.last_backup(filename, count: 1)
       raise DoingRuntimeError, 'No undo history to diff' if backup_file.nil?
 
       backup = WWID.new
-      backup.config = @config
+      backup.config = Doing.settings
       backup.init_doing_file(backup_file)
       current_content.diff(backup.content)
     end
@@ -2251,6 +2249,7 @@ EOS
       output = @other_content_top ? "#{@other_content_top.join("\n")}\n" : ''
       was_color = Color.coloring?
       Color.coloring = false
+      @content.dedup!(match_section: true)
       output += @content.to_s
       output += @other_content_bottom.join("\n") unless @other_content_bottom.nil?
       # Just strip all ANSI colors from the content before writing to doing file
@@ -2378,12 +2377,12 @@ EOS
     end
 
     def run_after
-      return unless @config.key?('run_after')
+      return unless Doing.setting('run_after')
 
-      _, stderr, status = Open3.capture3(@config['run_after'])
+      _, stderr, status = Open3.capture3(Doing.setting('run_after'))
       return unless status.exitstatus.positive?
 
-      logger.log_now(:error, 'Script error:', "Error running #{@config['run_after']}")
+      logger.log_now(:error, 'Script error:', "Error running #{Doing.setting('run_after')}")
       logger.log_now(:error, 'STDERR output:', stderr)
     end
   end

data/lib/doing.rb

@@ -42,7 +42,7 @@ require_relative 'doing/items'
 require_relative 'doing/note'
 require_relative 'doing/item'
 require_relative 'doing/wwid'
-require_relative 'doing/log_adapter'
+require_relative 'doing/logger'
 require_relative 'doing/prompt'
 require_relative 'doing/errors'
 require_relative 'doing/hooks'
@@ -57,19 +57,77 @@ require_relative 'doing/chronify/chronify'
 # Main doing module
 module Doing
   class << self
+    attr_accessor :auto_tag
     #
     # Fetch the logger
     #
-    # @return     the LogAdapter instance.
+    # @return     the Logger instance.
     #
     def logger
-      @logger ||= LogAdapter.new((ENV['DOING_LOG_LEVEL'] || :info).to_sym)
+      @logger ||= Logger.new((ENV['DOING_LOG_LEVEL'] || :info).to_sym)
     end
 
+    ##
+    ## Holds a Configuration object with methods and a @settings hash
+    ##
+    ## @return     [Configuration] Configuration object
+    ##
     def config
       @config ||= Configuration.new
     end
 
+    ##
+    ## Shortcut for Doing.config.settings
+    ##
+    ## @return     [Hash] Settings hash
+    ##
+    def settings
+      config.settings
+    end
+
+    ##
+    ## Fetch a config setting using a dot-separated keypath
+    ## or array of keys
+    ##
+    ## @param      keypath  [String|Array] Either a
+    ##                      dot-separated key path
+    ##                      (search.case) or array of keys
+    ##                      (['search', 'case'])
+    ## @param      default  A default value to return if the
+    ##                      provided path returns nil result
+    ##
+    def setting(keypath, default = nil)
+      cfg = config.settings
+      case keypath
+      when Array
+        cfg.dig(*keypath) || default
+      when String
+        unless keypath =~ /^[.*]?$/
+          real_path = config.resolve_key_path(keypath, create: false)
+          return default unless real_path&.count&.positive?
+
+          cfg = cfg.dig(*real_path)
+        end
+
+        cfg.nil? ? default : cfg
+      end
+    end
+
+    def set(keypath, value)
+      real_path = config.resolve_key_path(keypath, create: false)
+      return nil unless real_path&.count&.positive?
+
+      config.settings.deep_set(real_path, value)
+    end
+
+    ##
+    ## Update configuration from specified file
+    ##
+    ## @param      file     [String] Path to new config file
+    ## @param      options  [Hash] options
+    ##
+    ## @option options :ignore_local Ignore local configuration files
+    ##
     def config_with(file, options = {})
       @config = Configuration.new(file, options: options)
     end