Add: Ability To Allow Different Projectors To Be Used For Time Estimates

Why This Change Is Necessary
========================================================================

The current projector we've had in the code for over a decade now has
served us well, but there has been a desire to have some different types
of projectors (eg windowed by item count or by time).  This was
previously difficult to do but with this change we should be able to
allow the user to swap different ones out fairly easily.

What These Changes Do To Address the Issue
========================================================================

Add a new `Projector` class that manages all other projectors.

Side Effects Caused By This Change
========================================================================

None expected.

Author: jfelchner

lib/ruby-progressbar/base.rb

@@ -1,6 +1,5 @@
 require 'forwardable'
 
-require 'ruby-progressbar/calculators/smoothed_average'
 require 'ruby-progressbar/components/bar'
 require 'ruby-progressbar/components/percentage'
 require 'ruby-progressbar/components/rate'
@@ -11,6 +10,7 @@
 require 'ruby-progressbar/outputs/non_tty'
 require 'ruby-progressbar/outputs/tty'
 require 'ruby-progressbar/progress'
+require 'ruby-progressbar/projector'
 require 'ruby-progressbar/timer'
 
 class   ProgressBar
@@ -43,12 +43,14 @@ class   Base
                  :total
 
   def initialize(options = {}) # rubocop:disable Metrics/AbcSize
+    options[:projector] ||= {}
+
     self.autostart    = options.fetch(:autostart,  true)
     self.autofinish   = options.fetch(:autofinish, true)
     self.finished     = false
 
     self.timer        = Timer.new(options)
-    projector_opts    = if options[:projector]
+    projector_opts    = if options[:projector].any?
                           options[:projector]
                         elsif options[:smoothing]
                           warn SMOOTHING_DEPRECATION_WARNING
@@ -61,7 +63,9 @@ def initialize(options = {}) # rubocop:disable Metrics/AbcSize
                         else
                           {}
                         end
-    self.projector    = Calculators::SmoothedAverage.new(projector_opts)
+    self.projector    = Projector.
+                          from_type(options[:projector][:type]).
+                          new(projector_opts)
     self.progressable = Progress.new(options)
 
     options = options.merge(:progress  => progressable,

lib/ruby-progressbar/projector.rb

@@ -0,0 +1,14 @@
+require 'ruby-progressbar/calculators/smoothed_average'
+
+class   ProgressBar
+class   Projector
+  DEFAULT_PROJECTOR     = ProgressBar::Calculators::SmoothedAverage
+  NAME_TO_PROJECTOR_MAP = {
+    'smoothed' => ProgressBar::Calculators::SmoothedAverage
+  }.freeze
+
+  def self.from_type(name)
+    NAME_TO_PROJECTOR_MAP.fetch(name, DEFAULT_PROJECTOR)
+  end
+end
+end

spec/lib/ruby-progressbar/projector_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+require 'ruby-progressbar/projector'
+
+class    ProgressBar
+describe Projector do
+  describe '.from_type' do
+    it 'has a default projector' do
+      projector = Projector.from_type(nil)
+
+      expect(projector).to be ProgressBar::Calculators::SmoothedAverage
+    end
+
+    it 'can return a specific projector' do
+      projector = Projector.from_type('smoothed')
+
+      expect(projector).to be ProgressBar::Calculators::SmoothedAverage
+    end
+  end
+end
+end