popro 0.1.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce1a842c500f314f3ed8ba0e7e9deb5a4ece7cbf81ea11563664336cf35ddcd1
-  data.tar.gz: 3d313f96ff1b5dda33e51ec994ee592447e957201ebf059b86caef3d0d830c53
+  metadata.gz: a790befdf497a693172bb0faf40561c1d7fd6e287a3b5c379f7ddd9496f33509
+  data.tar.gz: a015de37abef0c5769a5d786182319fb891e874124daa5503a7feb9b411438fe
 SHA512:
-  metadata.gz: d68080c7a53d74a50e15fdb252f7aacbc57616a9de4aeb12bff133f715c347f07cdb6c9e2643d769a48babf01c6eb127e9e2dd6bdcd3d028d460efda34068d3b
-  data.tar.gz: f699ce90d06692c3ccfa71a342e1eceda39456c0599891c535f024ff0b64cec5eb8c8a56d5d91f83d96f300d5009c8098a7f73cdcb62ccf778fbc0a7feb0b96b
+  metadata.gz: 0a2b3c066fe0a666537e40a2d63b81442e463c4b421a29d67722ad364453695fe17ea247a66c8d2e695e389b1482b56788dc03efff8836821a63f61d0592a5dd
+  data.tar.gz: 87151aae4f7c3ac0650960e5fdf646d4a373742dec759e3872fb8ea3be96c5b64b585401e6b6897c57ed7c86ed23987f1d33f426ffafbabf8e50558348046d3f

data/CHANGELOG

@@ -1 +1,4 @@
+0.2.2 add gonna and each_gonna, add Callback Indicator
+0.2.1 add support for estimation and re-use of default indicator with added concatted formatters
+0.2.0 various fixes and added unit tests
 0.0.1 initial version

data/README.md

@@ -1,13 +1,20 @@
 # Po'Pro: The Poor-Man's Progress Indicator
 
+[![Version](https://badge.fury.io/rb/popro.svg)](https://badge.fury.io/rb/popro) 
+[![Tests](https://github.com/MikeSmithEU/PoPro/workflows/Code%20quality%20&%20unit%20tests/badge.svg)](https://github.com/MikeSmithEU/PoPro/actions?query=workflow%3A%22Code+quality+%26+unit+tests%22)
+
+## Current TODOs
+
+ - [ ] properly update documentation
+ - [ ] simplify some stuff (each0?)
+ - [ ] 100% code coverage
+
 ## Why?
 
 Easier and cleaner progress indication.
 
 ## How?
 
-TODO: properly update documentation, simplify some stuff. 100% code coverage
-
 ### Basic usage
 
 The invocation `Popro#did(yielded)` is used to signify that one step in progress has been finished.
@@ -263,11 +270,11 @@ end
 ## Formatters
 
 You can set your own formatters using `Popro#formatter(&block)`. Each formatter can be a `Proc`, `block` or
-class implementing the `call` method (e.g. the `PoproFormatter::*` classes).
+class implementing the `call` method (e.g. the `Popro::Formatter::*` classes).
 
 The formatter will be invoked with 2 arguments:
 
-  1. `info`, an instance of `PoproInfo` containing e.g. `current` and `total`.
+  1. `info`, an instance of `Popro::Info` containing e.g. `current` and `total`.
   2. `yielded`, whatever was passed to the `Popro#did` method.
 
 It can also be used inside blocks.
@@ -315,7 +322,7 @@ would output:
 
 Indicator classes are responsible for communicating the progress (or not, as the case may be).
 
-It is possible to provide your own "indicators" or use one of the provided ones (see `PoproIndicator` module).
+It is possible to provide your own "indicators" or use one of the provided ones (see `Popro::Indicator` module).
 
-The default `PoproIndicator` class is `PoproIndicator.default` (which returns an instance of `PoproIndicator::Stream`), which outputs the progress to STDOUT each time `Popro#did` or `Popro#will` is called.
+The default `Popro::Indicator` class is `Popro::Indicator.default` (which returns an instance of `Popro::Indicator::Stream`), which outputs the progress to STDOUT each time `Popro#did` or `Popro#will` is called.
 

data/lib/popro.rb

@@ -7,7 +7,7 @@ module Popro
 
   require_relative 'popro/progress'
 
-  def self.new(total, **options, &block)
+  def self.new(total = 0, **options, &block)
     raise ConfigError, 'using :total is not supported in new' if options.key?(:total) && (options[:total] != total)
 
     options[:total] = total
@@ -15,7 +15,6 @@ module Popro
   end
 
   def self.each(obj, total = nil, **options, &block)
-    options[:step] = 0 unless options.key? :step
     new(0, **options).each(obj, total, &block).done
   end
 
@@ -23,6 +22,10 @@ module Popro
     new(0, **options).each_will(obj, titler, total, &block).done
   end
 
+  def self.each_gonna(obj, titler, total = nil, **options, &block)
+    new(0, **options).each_gonna(obj, titler, total, &block).done
+  end
+
   def self.command_line(*_args)
     raise 'TODO: implement a `ps` style progress indicator for command line'
   end

data/lib/popro/context.rb

@@ -54,7 +54,7 @@ module Popro
     def did(yielded = nil, amount = nil)
       @info.start unless @info.running?
       amount = @step if amount.nil?
-      raise TypeError('amount: expected an integer') unless amount.is_a? Integer
+      raise TypeError, "amount: expected an integer, got #{amount.class}" unless amount.is_a? Integer
 
       @info.current += amount unless amount.zero?
       @indicator.call(@info, yielded)
@@ -62,8 +62,20 @@ module Popro
       self
     end
 
+    def gonna(title)
+      @indicator.call(@info, title)
+      self
+    end
+
+    def each_gonna(obj, titler, total = nil, &block)
+      _each(obj, total) do |*args|
+        gonna(titler.call(*args))
+        block.call(*args, progress: @info) if block_given?
+      end
+    end
+
     def will(title = nil, step = nil, &block)
-      did "#{WILL_CHECK_MARKS[0]} #{title}", 0
+      gonna "#{WILL_CHECK_MARKS[0]} #{title}"
 
       return self unless block_given?
 
@@ -81,7 +93,7 @@ module Popro
 
     def _each(obj, total = nil, &block)
       total = obj.size if total.nil?
-      raise TypeError('total: expected an integer') unless total.is_a?(Integer) || total.nil?
+      raise TypeError, "total: expected an integer got #{total.class}" unless total.is_a?(Integer) || total.nil?
 
       @info.total += total if total.positive?
       # block = proc { |d| d } unless block_given?

data/lib/popro/formatter.rb

@@ -30,7 +30,7 @@ module Popro
       def call(info, *args)
         result = @formatter.call(info, *args)
         @longest = [@longest, result.size].max
-        "\r" + result.ljust(@longest, ' ')
+        "\r#{result.ljust(@longest, ' ')}"
       end
     end
 
@@ -43,6 +43,53 @@ module Popro
       end
     end
 
+    class Estimate
+      # TODO: cleaner implementation/formatstring
+      attr_reader :info
+
+      def initialize
+        @start_time = current_time
+        @info = nil
+      end
+
+      def call(info, *_args)
+        @info = info
+
+        [
+          "estimated time left: #{format_duration(estimated_left)}",
+          "[#{format_duration(elapsed)}/#{format_duration(estimated_total)}]"
+        ].join(', ')
+      end
+
+      private
+
+      def elapsed
+        current_time - @start_time
+      end
+
+      def estimated_total
+        return nil if info.current.zero? || info.total.zero?
+
+        elapsed + (info.total / info.current) * elapsed
+      end
+
+      def estimated_left
+        return nil if info.current.zero? || info.total.zero?
+
+        (info.total / info.current) * elapsed
+      end
+
+      def format_duration(secs)
+        return '??d??h??m??s' if secs.nil?
+
+        format('%02dd%02dh%02dm%02ds', secs / 86_400, secs / 3600 % 24, secs / 60 % 60, secs % 60)
+      end
+
+      def current_time
+        Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      end
+    end
+
     class Sprintf
       def initialize(format_string = nil)
         @format_string = format_string

data/lib/popro/indicator.rb

@@ -27,7 +27,7 @@ module Popro
         formatter = self.class.default_formatter(formatter) if formatter.nil? || formatter.is_a?(String)
 
         @formatter = formatter
-        @stream = stream || STDOUT
+        @stream = stream || $stdout
       end
 
       def call(*args)
@@ -45,11 +45,27 @@ module Popro
       end
     end
 
-    def self.default_formatter
+    class Callback
+      def initialize(finish = nil, &block)
+        @finish = finish
+        @callback = block
+      end
+
+      def call(*args)
+        @callback.call(*args)
+      end
+
+      def finish
+        @finish&.call
+      end
+    end
+
+    def self.default_formatter(*extra_formatters)
       ::Popro::Formatter::RewriteLine.new(
         ::Popro::Formatter::Concat.new(
           ::Popro::Formatter::Spinner.new(:dots, bounce: true),
           ::Popro::Formatter::Sprintf.new,
+          *extra_formatters,
           (proc do |_, yielded = nil|
             yielded if yielded.is_a?(String) || yielded.is_a?(Numeric)
           end),
@@ -58,8 +74,8 @@ module Popro
       )
     end
 
-    def self.default
-      Stream.new(formatter: default_formatter)
+    def self.default(*extra_formatters)
+      Stream.new(formatter: default_formatter(*extra_formatters))
     end
   end
 end

data/lib/popro/progress.rb

@@ -6,17 +6,24 @@ module Popro
     require_relative 'info'
     require_relative 'indicator'
 
+    DEFAULT_OPTIONS ||= {
+      total: 0,
+      current: 0,
+      indicator: Indicator.default
+    }.freeze
+
     attr_reader :context
 
     def initialize(**options)
       @started = false
-      @info = Info.new(total: options.delete(:total), current: options.delete(:current))
 
-      options[:step] ||= (block_given? ? 0 : 1)
-      options[:progress] = self
-      options[:info] = @info
-      options[:indicator] = Indicator.default unless options.key? :indicator
+      options = DEFAULT_OPTIONS
+                .merge(step: block_given? ? 0 : 1)
+                .merge(options)
 
+      @info = Info.new(total: options.delete(:total), current: options.delete(:current))
+
+      options.merge!(progress: self, info: @info)
       @context = Context.new(**options)
 
       register_aliases
@@ -26,15 +33,27 @@ module Popro
       done
     end
 
+    # increase the total
+    def add(amount)
+      @info.total += amount
+      self
+    end
+
     private
 
     def register_aliases
       class << self
-        %i[each each_will to_proc did will formatter start done].each do |method_name|
+        %i[each each_will each_gonna to_proc gonna will did formatter start done].each do |method_name|
           define_method method_name do |*args, &block|
             @context.public_send(method_name, *args, &block)
           end
         end
+
+        %i[current total].each do |method_name|
+          define_method method_name do
+            @info.public_send(method_name)
+          end
+        end
       end
     end
   end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: popro
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.2
 platform: ruby
 authors:
 - MikeSmithEU
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-06-01 00:00:00.000000000 Z
+date: 2020-09-16 00:00:00.000000000 Z
 dependencies: []
 description: The Poor-Man's Progress Indicator
-email: 
+email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -31,7 +31,7 @@ homepage: https://rubygems.org/gems/popro
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -39,7 +39,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -47,7 +47,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.1.2
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Po'Pro
 test_files: []