pluckit 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 7587bb8c7e758bd2badc023cf95087b397386c67
-  data.tar.gz: 0e230a36351043c05e174d0971ab28b259fca86f
+SHA256:
+  metadata.gz: f0c8e686fd9ed75effb4ce6813bfa337ae81675547b5acacd5c40b2a6596cb69
+  data.tar.gz: 4dd1015875c89e0a4542e495316e82688cfa0ae64d1f1a67bcc9a040bc41586d
 SHA512:
-  metadata.gz: 1c0fd9d9d4e9dfaf4ffbf4699ba33105e027392b9f7a484519aacf3c065482adf6ab4e2e3979e5dfa0b6f3f2906f7890eb46ed8a5194f3301343a5a923d2a699
-  data.tar.gz: 7989512d5bb2373eacdef52c87c011c7953a9350472e795fee65a5f7f61c04c1155efd71b9bbdbed760635fc07d98515813ccf70072baefaa958dd58aaffc3ab
+  metadata.gz: f190970663dce56184c3fdd91169899cb4a0db126d4fe543414ea41427d3061169bd131b860c23d617f0b99bd76af5617dcc8d513cb3cdfecc12d25a848c8b93
+  data.tar.gz: 8eb335b2b94d83a000ab27bc9198dd911736465005cee80134fd8752228b3c6e57ae355170a43f8e0c4be77b8529249ba5d8e2ebcceaf802511fbe09295b43de

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+###  1.2.0  (2026-04-11)
+  - ruby and gem updates
+

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,71 @@
+PATH
+  remote: .
+  specs:
+    pluckit (1.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    date (3.5.1)
+    debug (1.11.1)
+      irb (~> 1.10)
+      reline (>= 0.3.8)
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    erb (6.0.2)
+    io-console (0.8.2)
+    irb (1.17.0)
+      pp (>= 0.6.0)
+      prism (>= 1.3.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    pp (0.6.3)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.9.0)
+    psych (5.3.1)
+      date
+      stringio
+    rdoc (7.2.0)
+      erb
+      psych (>= 4.0.0)
+      tsort
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-debugging (0.0.4)
+      rspec-expectations (>= 3)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    stringio (3.2.0)
+    tsort (0.2.0)
+
+PLATFORMS
+  arm64-darwin-25
+  ruby
+
+DEPENDENCIES
+  debug (>= 1)
+  pluckit!
+  rspec (>= 3.10)
+  rspec-debugging
+  simplecov (>= 0.22)
+
+BUNDLED WITH
+  4.0.10

data/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Daniel Pepper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,37 @@
+PluckIt
+======
+![Gem](https://img.shields.io/gem/dt/pluckit?style=plastic)
+[![codecov](https://codecov.io/gh/dpep/pluckit_rb/branch/main/graph/badge.svg?token=Z6W48XUEQD)](https://codecov.io/gh/dpep/pluckit_rb)
+
+Extract values from Enumerables
+
+#### Install
+```gem install pluckit```
+
+
+#### Usage
+```ruby
+require 'pluckit'
+
+
+# extract a field from a list of records
+[
+  { id: 1, name: 'alice', age: 30},
+  { id: 2, name: 'bob', age: 24},
+  { id: 3, name: 'charlie', age: 88},
+].pluck :name
+=> [ 'alice', 'bob', 'charlie' ]
+
+
+# find max temp for each month
+{
+  june: [ 78, 82, 80 ],
+  july: [ 80, 83, 86 ],
+  august: [ 80, 76, 79 ],
+}.pluck :max
+=> {
+  june: 82,
+  july: 86,
+  august: 80,
+}
+```

data/lib/pluckit/pluck.rb

@@ -1,30 +1,66 @@
 module PluckIt
-  class << self
+  extend self
 
-    def pluck v, *handles
-      if handles.count > 1
-        handles.map {|h| pluck_single v, h }
-      else
-        pluck_single v, handles.first
-      end
+  refine Array do
+    def pluck *handles
+      PluckIt.pluck self, *handles
+    end
+  end
+
+  refine Hash do
+    def pluck *handles
+      PluckIt.pluck self, *handles
     end
+  end
 
+  refine Set do
+    def pluck *handles
+      PluckIt.pluck self, *handles
+    end
+  end
 
-    private
+  def pluck enumerable, *handles
+    items = enumerable.each_with_object(
+      enumerable.clone.clear
+    )
+    # TODO: if no clone / clear, use new
 
-    def pluck_single v, handle
-      if v.is_a? Hash
-        v[handle]
-      elsif ([Symbol, String].include? handle.class) and v.respond_to? handle
-        v.send handle
-      elsif handle.is_a? Regexp and v.respond_to? :grep
-        v.grep handle
-      elsif v.respond_to? :[]
-        v[handle]
-      else
-        raise ArgumentError.new "invalid handle: #{handle}, for value #{v}"
+    if enumerable.is_a?(Hash)
+      items.each do |(key, val), res|
+        res[key] = pluckit(val, *handles)
+      end
+    elsif enumerable.is_a?(Set)
+      items.each do |val, res|
+        res.add pluckit(val, *handles)
+      end
+    else
+      items.each do |val, res|
+        res << pluckit(val, *handles)
       end
     end
+  end
 
+  def pluckit v, *handles
+    if handles.count > 1
+      handles.map {|h| pluckit_single v, h }
+    else
+      pluckit_single v, handles.first
+    end
+  end
+
+  private
+
+  def pluckit_single v, handle
+    if v.is_a? Hash
+      v[handle]
+    elsif ([Symbol, String].include? handle.class) && v.respond_to?(handle)
+      v.send handle
+    elsif handle.is_a?(Regexp) && v.respond_to?(:grep)
+      v.grep handle
+    elsif v.respond_to?(:[])
+      v[handle]
+    else
+      raise ArgumentError.new "invalid handle: #{handle}, for value #{v}"
+    end
   end
 end

data/lib/pluckit/version.rb

@@ -0,0 +1,3 @@
+module PluckIt
+  VERSION = '1.2.0'
+end

data/lib/pluckit.rb

@@ -1,33 +1,21 @@
-require_relative 'pluckit/pluck.rb'
-
-module PluckIt
-  VERSION = '1.0.0'
-end
-
-
+require 'set'
+require_relative 'pluckit/version'
+require_relative 'pluckit/pluck'
 
 class Array
   def pluck *handles
-    each_with_object(clone.clear) do |val, res|
-      res << PluckIt.pluck(val, *handles)
-    end
+    PluckIt.pluck self, *handles
   end
 end
 
-
 class Hash
   def pluck *handles
-    each_with_object(clone.clear) do |(key, val), res|
-      res[key] = PluckIt.pluck(val, *handles)
-    end
+    PluckIt.pluck self, *handles
   end
 end
 
-
 class Set
   def pluck *handles
-    each_with_object(clone.clear) do |val, res|
-      res.add PluckIt.pluck(val, *handles)
-    end
+    PluckIt.pluck self, *handles
   end
 end

data/pluckit.gemspec

@@ -0,0 +1,21 @@
+package_name = File.basename(__FILE__, '.gemspec')
+require_relative File.join('lib', package_name, 'version')
+package = PluckIt
+
+Gem::Specification.new do |s|
+  s.description = 'Extract values from Enumerables'
+  s.authors     = ['Daniel Pepper']
+  s.files       = `git ls-files * ':!:spec'`.split("\n")
+  s.homepage    = "https://github.com/dpep/rb_#{package_name}"
+  s.license     = 'MIT'
+  s.name        = package_name
+  s.summary     = 'PluckIt'
+  s.version     = package.const_get('VERSION')
+
+  s.required_ruby_version = '>= 3'
+
+  s.add_development_dependency 'debug', '>= 1'
+  s.add_development_dependency 'rspec', '>= 3.10'
+  s.add_development_dependency 'rspec-debugging'
+  s.add_development_dependency 'simplecov', '>= 0.22'
+end

metadata

@@ -1,60 +1,88 @@
 --- !ruby/object:Gem::Specification
 name: pluckit
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Daniel Pepper
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-04-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: debug
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5'
+        version: '1'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10'
+        version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10'
+        version: '3.10'
+- !ruby/object:Gem::Dependency
+  name: rspec-debugging
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.22'
 description: Extract values from Enumerables
-email: 
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
 - lib/pluckit.rb
 - lib/pluckit/pluck.rb
-- test/test_array.rb
-- test/test_hash.rb
-- test/test_pluck.rb
-- test/test_set.rb
+- lib/pluckit/version.rb
+- pluckit.gemspec
 homepage: https://github.com/dpep/rb_pluckit
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -62,20 +90,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: PluckIt
-test_files:
-- test/test_array.rb
-- test/test_hash.rb
-- test/test_pluck.rb
-- test/test_set.rb
+test_files: []

data/test/test_array.rb

@@ -1,109 +0,0 @@
-require 'minitest/autorun'
-require 'pluckit'
-
-
-class PluckItArrayTest < Minitest::Test
-
-
-  def test_basic
-    data = [
-      [ 1, 2, 3 ],
-      [ 4, 5, 6 ],
-      [ 7, 8, 9 ],
-    ]
-
-    assert_equal(
-      [ 1, 4, 7 ],
-      data.pluck(0)
-    )
-
-    assert_equal(
-      [ 3, 6, 9 ],
-      data.pluck(:last)
-    )
-
-    assert_equal(
-      [
-        [ 1, 2 ],
-        [ 4, 5 ],
-        [ 7, 8 ],
-      ],
-      data.pluck(0, 1)
-    )
-  end
-
-
-  def test_empty
-    assert_equal(
-      [],
-      [].pluck(nil)
-    )
-
-    assert_equal(
-      [],
-      [].pluck(0)
-    )
-  end
-
-
-  def test_hashes
-    data = [
-      { k: 1, v: 2 },
-      { k: 2, v: 4 },
-      { k: 3, v: 6 },
-    ]
-
-    assert_equal(
-      [ 1, 2, 3 ],
-      data.pluck(:k)
-    )
-
-    assert_equal(
-      [ 2, 4, 6 ],
-      data.pluck(:v)
-    )
-  end
-
-
-  def test_missing
-    assert_equal(
-      [ nil, 2 ],
-      [{ a: 1 }, { k: 2 }].pluck(:k)
-    )
-  end
-
-
-  class ABC
-    attr_accessor :val
-    def initialize(v) self.val = v end
-  end
-
-  def test_obj
-    assert_equal(
-      [ 1, 2, 3 ],
-      [
-        ABC.new(1),
-        ABC.new(2),
-        ABC.new(3),
-      ].pluck(:val)
-    )
-  end
-
-
-  class MyArray < Array; end
-  def test_clone
-    data = MyArray.new [ 1, 2, 3 ]
-
-    assert_equal(
-      [ 1, 2, 3 ],
-      data.pluck(:itself)
-    )
-
-    assert_equal(
-      self.class.const_get(:MyArray),
-      data.pluck(:itself).class
-    )
-  end
-
-
-end

data/test/test_hash.rb

@@ -1,93 +0,0 @@
-require 'minitest/autorun'
-require 'pluckit'
-
-
-class PluckItHashTest < Minitest::Test
-
-
-  def test_basic
-    assert_equal(
-      {
-        a: 1,
-        b: 4,
-        c: 7,
-      },
-      {
-        a: [ 1, 2, 3 ],
-        b: [ 4, 5, 6 ],
-        c: [ 7, 8, 9 ],
-      }.pluck(0)
-    )
-
-    assert_equal(
-      {
-        a: 1,
-        b: 2,
-        c: 3,
-      },
-      {
-        a: { x: 1, y: 2 },
-        b: { x: 2, y: 4 },
-        c: { x: 3, y: 6 },
-      }.pluck(:x)
-    )
-
-    assert_equal(
-      {
-        a: [ 1, 2 ],
-        b: [ 2, 4 ],
-        c: [ 3, 6 ],
-      },
-      {
-        a: { x: 1, y: 2 },
-        b: { x: 2, y: 4 },
-        c: { x: 3, y: 6 },
-      }.pluck(:x, :y)
-    )
-  end
-
-
-  class ABC
-    attr_accessor :val
-    def initialize(v) self.val = v end
-  end
-
-  def test_obj
-    assert_equal(
-      {
-        a: 1,
-        b: 2,
-        c: 3,
-      },
-      {
-        a: ABC.new(1),
-        b: ABC.new(2),
-        c: ABC.new(3),
-      }.pluck(:val)
-    )
-  end
-
-
-  class MyHash < Hash; end
-  def test_clone
-    data = MyHash.new 'abc'
-    data.update a: 1
-
-    assert_equal(
-      { a: 1 },
-      data.pluck(:itself)
-    )
-
-    assert_equal(
-      'abc',
-      data.pluck(:itself)[:missing]
-    )
-
-    assert_equal(
-      self.class.const_get(:MyHash),
-      data.pluck(:itself).class
-    )
-  end
-
-
-end

data/test/test_pluck.rb

@@ -1,147 +0,0 @@
-require 'minitest/autorun'
-require 'set'
-
-$LOAD_PATH.unshift 'lib'
-require 'pluckit/pluck'
-
-
-class PluckItTest < Minitest::Test
-
-  def test_array
-    data = [ 1, 2, 3 ]
-
-    assert_equal(
-      1,
-      PluckIt.pluck(data, 0)
-    )
-
-    assert_equal(
-      2,
-      PluckIt.pluck(data, 1)
-    )
-
-    assert_equal(
-      3,
-      PluckIt.pluck(data, :last)
-    )
-
-    assert_equal(
-      3,
-      PluckIt.pluck(data, :count)
-    )
-
-    assert_equal(
-      [ 1, 2 ],
-      PluckIt.pluck(data, 0..1)
-    )
-
-    assert_equal(
-      [ 'a', 'ba', 'ca' ],
-      PluckIt.pluck(
-        [ 'a', 'ba', 'bb', 'bc', 'ca' ],
-        /a/
-      )
-    )
-
-    assert_equal(
-      [ 1, 2 ],
-      PluckIt.pluck(data, 0, 1)
-    )
-  end
-
-
-  def test_hash
-    data = {
-      a: 1,
-      b: 2,
-      c: 3,
-    }
-
-    assert_equal(
-      2,
-      PluckIt.pluck(data, :b)
-    )
-
-    assert_nil(
-      PluckIt.pluck(data, :z)
-    )
-
-    assert_nil(
-      PluckIt.pluck(data, :count)
-    )
-
-    assert_equal(
-      [ 1, 2 ],
-      PluckIt.pluck(data, :a, :b)
-    )
-  end
-
-
-  class ABC
-    def foo() 123 end
-    def bar() 456 end
-  end
-
-  def test_obj
-    assert_equal(
-      123,
-      PluckIt.pluck(ABC.new, :foo)
-    )
-
-    assert_equal(
-      self.class.const_get(:ABC),
-      PluckIt.pluck(ABC.new, :class)
-    )
-
-    assert_equal(
-      [ 123, 456 ],
-      PluckIt.pluck(ABC.new, :foo, :bar)
-    )
-  end
-
-
-  def test_set
-    data = Set.new [ 1, 2, 3 ]
-
-    assert_equal(
-      1,
-      PluckIt.pluck(data, :first)
-    )
-
-    assert_equal(
-      3,
-      PluckIt.pluck(data, :count)
-    )
-
-    assert_equal(
-      [ 1, 3 ],
-      PluckIt.pluck(data, :first, :count)
-    )
-  end
-
-
-  def test_not_installed
-    if defined? PluckIt::VERSION
-      # entire library was loaded, so these tests are invalid.
-      # this happens when run through `rake`
-      return
-    end
-
-    # `require 'pluckit/pluck'` should load PluckIt
-    # but not monkey patch
-    assert_raises NoMethodError do
-      [ 1, 2, 3 ].pluck 0
-    end
-
-    assert_raises NoMethodError do
-      { a: 1 }.pluck 0
-    end
-
-    assert_raises NoMethodError do
-      Set.new([ 1, 2, 3 ]).pluck 0
-    end
-
-    puts 'no monkey patching'
-  end
-
-end

data/test/test_set.rb

@@ -1,52 +0,0 @@
-require 'minitest/autorun'
-require 'pluckit'
-
-
-class PluckItSetTest < Minitest::Test
-
-
-  def test_basic
-    data = Set.new [
-      [ 1, 2, 3 ],
-      [ 4, 5, 6 ],
-      [ 7, 8, 9 ],
-    ]
-
-    assert_equal(
-      Set.new([ 1, 4, 7 ]),
-      data.pluck(0)
-    )
-
-    assert_equal(
-      Set.new([ 3, 6, 9 ]),
-      data.pluck(:last)
-    )
-
-    assert_equal(
-      Set.new([
-        [ 1, 3 ],
-        [ 4, 6 ],
-        [ 7, 9 ],
-      ]),
-      data.pluck(:first, :max)
-    )
-  end
-
-
-  class MySet < Set; end
-  def test_clone
-    data = MySet.new [ 1, 2, 3 ]
-
-    assert_equal(
-      Set.new([ 1, 2, 3 ]),
-      data.pluck(:itself)
-    )
-
-    assert_equal(
-      self.class.const_get(:MySet),
-      data.pluck(:itself).class
-    )
-  end
-
-
-end