iteraptor 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cd67b42a75a6ed56774d77033653de940cfb1093
-  data.tar.gz: 05ca53034c8fce538aecd7e74e4826eae4154285
+  metadata.gz: f9bae4e784ecbd35da45f7418b910a4d64707894
+  data.tar.gz: e594b3c0bd12351eb78b18c1dc9a84514e943360
 SHA512:
-  metadata.gz: 9fc5336e833688e059b0b28459e55580a7158e0261dc7bea381dc965845d0831d7ff58f7ffb7ed923084091be3da8e8e9bdda8304060e797876bb195e87588ca
-  data.tar.gz: 48ed7af274e24d80022b600853b7efa60083af54052343eb60e4b388cbb6ab876477cf80475c1226e0f0c4c6268024edc92dbfd8b8340ce462d4ff356a2c3be0
+  metadata.gz: b78f8e2885ebb7d2d66adf851c90a0a1aa4511d4ae616169d9a9af2b3f55f07c4cc6d5a3c9c68f486d4bc73ab19645f4307ab49b3c2f27b0aede0a2ba9b93134
+  data.tar.gz: 579f7f3a0904d54a8b56ca8e722b970676c01d0c3e3aad2625e778d0e772f61712c1d54991ec448553177c39b0400fea3cca1c6950923e20faaf818a268c890e

data/README.md

@@ -16,6 +16,8 @@ large objects.
 require 'iteraptor'
 ```
 
+**[Blog post](http://rocket-science.ru/hacking/2018/03/29/iteraptor-for-the-rescue) with detailed API documentation.**
+
 `Iteraptor` is intended to be used for iteration of complex nested structures.
 The yielder is being called with two parameters: “current key” and “current value.”
 The key is an index (converted to string for convenience) of an element for any
@@ -27,6 +29,22 @@ latter is just a dot in current release.
 
 ## Features
 
+### Boring (for users who are too conservative)
+
+```ruby
+enum = [{foo: {bar: [:baz, 42]}}, [:foo, {bar: {baz: 42}}]].random
+
+* `hash.iteraptor.each(**params, ->(full_key, value))`
+* `hash.iteraptor.map(**params, ->(full_key, (key, value)))`
+* `hash.iteraptor.select(*filters, **params, ->(full_key, value)`
+* `hash.iteraptor.reject(*filters, **params, ->(full_key, value)`
+* `hash.iteraptor.flat_map(**params, ->(full_key, value))`
+* `hash.iteraptor.flatten(**params, ->(full_key, value))`
+* `hash.iteraptor.collect(**params, ->(full_key, value))`
+```
+
+### Direct 🐒 patching in 🇪🇸
+
 * `cada` (_sp._ `each`) iterates through all the levels of the nested `Enumerable`,
 yielding `parent, element` tuple; parent is returned as a delimiter-joined string
 * `mapa` (_sp._ `map`) iterates all the elements, yielding `parent, (key, value)`;

data/lib/iteraptor.rb

@@ -8,6 +8,10 @@ module Iteraptor
     raise "This module might be included into Enumerables only" unless base.ancestors.include? Enumerable
   end
 
+  def iteraptor
+    @__iteraptor__ ||= Iteraptor::Delegator.new(self)
+  end
+
   %i[cada mapa].each do |m|
     define_method m do |key = nil, value = nil, **params, &λ|
       return enum_for(m, key, value, **params) unless λ
@@ -201,9 +205,11 @@ module Iteraptor
       def safe_symbolize key
         key.respond_to?(:to_sym) ? key.to_sym : key
       end
+
       def iteraptor_delimiter(params)
         params[:delimiter] || DELIMITER
       end
+
       def push_flatten_compact array, tail
         case array
         when NilClass then [tail]
@@ -211,6 +217,7 @@ module Iteraptor
         else [array, tail]
         end.compact
       end
+
       def enumerable_parent?(receiver)
         [Hash, Array, Enumerable].detect(&receiver.method(:is_a?))
       end
@@ -219,3 +226,4 @@ module Iteraptor
 end
 
 require 'iteraptor/greedy'
+require 'iteraptor/delegator'

data/lib/iteraptor/delegator.rb

@@ -0,0 +1,25 @@
+module Iteraptor
+  class Delegator
+    MAPPING = {
+      each: :cada,
+      map: :mapa,
+
+      select: :escoger,
+      reject: :rechazar,
+
+      flatten: :aplanar,
+      collect: :recoger,
+      flat_map: :plana_mapa
+    }
+
+    def initialize(receiver)
+      @receiver = receiver
+    end
+
+    MAPPING.each do |m, delegate_to|
+      define_method m do |*args, **kw, &λ|
+        @receiver.send(delegate_to, *args, **kw, &λ)
+      end
+    end
+  end
+end

data/lib/iteraptor/version.rb

@@ -1,3 +1,3 @@
 module Iteraptor
-  VERSION = '0.6.1'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iteraptor
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Aleksei Matiushkin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-03-30 00:00:00.000000000 Z
+date: 2018-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -105,6 +105,7 @@ files:
 - bin/setup
 - iteraptor.gemspec
 - lib/iteraptor.rb
+- lib/iteraptor/delegator.rb
 - lib/iteraptor/greedy.rb
 - lib/iteraptor/version.rb
 homepage: https://kantox.com
@@ -127,7 +128,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.8
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: 'Iterator on steroids: allows thorough iteration through nested Enumerables'