with_last 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aacef2632f84cec36d0a06dd1fb1dbb2eaa8a944fef4114223f66b454b975e1d
-  data.tar.gz: 45c8b3edd27a8d6d63669b3ce20a908b962a0f898dd9261cbe7eba3b9614219f
+  metadata.gz: 685c2bbb6dc0932893fabad565230bec602f31a6842a2bdd77b5ff2acce3579e
+  data.tar.gz: 10f1062f9ac05b8b53077a424f5e6b0aea012fbefbcff7b52167e0a33e107565
 SHA512:
-  metadata.gz: 176e1a03ba751cbc4b989cc77898a7e171baa3d9ecdf5b0581fb62f14490ed1c426114774088699ab1ea2c1c025fcc00cd6618b011c67be91864ffd72417d676
-  data.tar.gz: ebcd453a6a21b88a668bc5feb53d5f838d2d70c71e1931e6e5ea697da3475aded45fc3e19a6ac66b3aa84a68d27a496707a7b624cd93278047ae7ba49a5d40d6
+  metadata.gz: be50db532602bf55613740211ed8361b17bd7978e9c30e256c2ca8d3152b128efce35271cc7f38ebda32520f2bd771025875cfff96ffff1dc399ba82c9876602
+  data.tar.gz: 64997c4794f6d2ca09594abffcf6d5085b5e0ee3f9b9cf4c29671171a61daeea724339f62f3f1f852b207035493e5e67fb9f80d8fc445c4eb505fa3df1c5db26

data/.rubocop.yml

@@ -16,3 +16,7 @@ Style/HashTransformKeys:
 Style/HashTransformValues:
   Enabled: true
 
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*_spec.rb'
+

data/README.md

@@ -3,7 +3,9 @@
 
 # with_last.rb
 
-Add `with_last` method to `Enumerator` class and `each_with_last` to `Enumerable` module.
+- Add `with_last` method to `Enumerator` class.
+- Add `last?` method to `Enumerator` class.
+- Add `each_with_last` to `Enumerable` module.
 
 ## Installation
 
@@ -17,27 +19,51 @@ And then execute:
 
 ## Usage
 
+### `Enumerable#each_with_last`
+
 ```ruby
 [1,2,3].each_with_last { |item, last|
-  print item
-  print last ? 'done!' : '->'
+  print "#{item}#{last ? '!' : ' => '}"
 }
+```
+
+it prints `1 => 2 => 3!`
+
+### `Enumerator#with_last`
+
+```ruby
 
-# "1->2->3done!"
+[1,2,3]
+  .map
+  .with_last { |item, last| "#{item * item}#{last ? '.' : ''}" }
+  .join(',')
+```
+
+it returns `"1,4,9."`
 
-[1,2,3].map.with_last { |item, last| "#{item * item}#{last ? '.' : ''}" }.join(',')
+### `Enumerator#last?`
 
-# => "1,4,9."
+```ruby
+e = [1,2].to_enum
+e.last? # => false
+e.next  # => 1
+e.last? # => false
+e.next  # => 2
+e.last? # => true
 ```
 
+### in ERB
+
 ```erb
 <% %w[hoge fuga piyo].each_with_last do |item, is_last| %>
   <%= item %><%= is_last ? '.' : ', ' %>
 <% end %>
+```
+
+it renders;
 
-<!--
+```html
 hoge, fuga, piyo.
--->
 ```
 
 ## License

data/lib/with_last/core_ext.rb

@@ -7,24 +7,37 @@ class Enumerator
   #   [1,2].each.with_last { |item, is_last| puts [item, is_last] }
   #   # => [1, false] [2, true]
   #
+  #
   #   [1,2].map.with_last { |item, is_last| "#{item}#{is_last ? '.' : ', '}" }.join
   #   # => "1, 2."
   #
+  #
   #   %w[hoge fuga].map.with_index.with_last { |item, index, is_last| "#{index}: #{item}#{is_last ? '.' : ', '}" }.join
   #   # => "0:hoge, 1:fuga."
   def with_last
     return to_enum :with_last unless block_given?
 
     each do |*args|
-      begin
-        self.next
-        peek
-        yield(*args, false)
-      rescue StopIteration => _e
-        yield(*args, true)
-      end
+      self.next
+      yield(*args, last?)
     end
   end
+
+  # Returns whether the enumerator is last.
+  #
+  #   e = [1,2].to_enum
+  #   e.last? # => false
+  #   e.next  # => 1
+  #   e.last? # => false
+  #   e.next  # => 2
+  #   e.last? # => true
+  #
+  def last?
+    peek
+    false
+  rescue StopIteration => _e
+    true
+  end
 end
 
 # open core class

data/lib/with_last/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module WithLast
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/with_last.gemspec

@@ -17,6 +17,7 @@ Gem::Specification.new do |spec|
   spec.metadata['homepage_uri'] = spec.homepage
   spec.metadata['source_code_uri'] = 'https://github.com/oieioi/with_last.rb'
   spec.metadata['changelog_uri'] = 'https://github.com/oieioi/with_last.rb/releases'
+  spec.metadata['documentation_uri'] = 'https://www.rubydoc.info/gems/with_last'
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: with_last
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - oieioi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-28 00:00:00.000000000 Z
+date: 2020-03-04 00:00:00.000000000 Z
 dependencies: []
 description: Add `with_last` to Enumerator and `each_with_last` to Enumerable
 email:
@@ -39,6 +39,7 @@ metadata:
   homepage_uri: https://github.com/oieioi/with_last.rb
   source_code_uri: https://github.com/oieioi/with_last.rb
   changelog_uri: https://github.com/oieioi/with_last.rb/releases
+  documentation_uri: https://www.rubydoc.info/gems/with_last
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -54,7 +55,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Add `with_last` to Enumerator and `each_with_last` to Enumerable