tbpgr_utils 0.0.141 → 0.0.142

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 117dbd6a2063545d0db523fe4f88926b0a08501a
-  data.tar.gz: aff26d7cd373acc6057c714471d5a179e430658a
+  metadata.gz: 3f02aa3b5339ad6969dba481978c51fb0c0efb15
+  data.tar.gz: 7f092ea5e5f8bdf00f2ae2423fc7a330191bcc8b
 SHA512:
-  metadata.gz: 836802fb1e8b97e07928ca03ce7decf3a5fe3fd1a32f3fd6eab089d21ec9df9107e8d55a58abee1d019c3671b07ee7be1963ee6b3c448e88cc81f171e97623b6
-  data.tar.gz: c9a334cf30567cfa2af433f0567df99e5669f6696e026cc3b8565572ac0cb6b948e119c6d15609e3b5cdd353ad6ffbbd7ef682e626382104ecd90edc4d0e6162
+  metadata.gz: 86ccbf864373a8a8f4568cfcf9c5846e0e9b36bbaf19a59fd85cee57b0d6abb617e8c635fe7faaef7d90f380f3513acfe2618d0b123852113b5e070dc18d286d
+  data.tar.gz: 477723d8c0d8894e41e7e4a013c325a619c9aa1ccb32a05ca3134c55a9b0ea9a30d685df2789db9a5e81f4887cf744971aef92c0ad9a172a9629879f004fcf73

data/README.md

@@ -64,6 +64,7 @@ Or install it yourself as:
 |[AttrEnumerable.compact_attr](#attrenumerablecompact_attr)                                                         |define compact_xxx. it returns Class attributes(collection)'s that exclude nil elements.                             |
 |[AttrEnumerable.concat_attr](#attrenumerableconcat_attr)                                                           |define concat_xxx. it returns Class attributes(collection) and argument array                                        |
 |[AttrEnumerable.delete_attr](#attrenumerabledelete_attr)                                                           |define delete_xxx. it delete Class attributes(collection) that match delete condition                                |
+|[AttrEnumerable.first_attr](#attrenumerablefirst_attr)                                                             |define first_xxx. it returns Class attributes(collection) first N elementthat                                        |
 |[AttrEnumerable.each_attr](#attrenumerableeach_attr)                                                               |define each_xxx. it call Class attributes(collection)'s attribute iterator                                           |
 |[AttrEnumerable.each_attr_with_index](#attrenumerableeach_attr_with_index)                                         |define each_xxx_with_index. it call Class attributes(collection)'s attribute iterator with index                     |
 |[AttrEnumerable.reverse_attr](#attrenumerablereverse_attr)                                                         |define reverse_xxx. it returns Class attributes(collection)'s reverse Array                                          |
@@ -1304,6 +1305,40 @@ end
 
 [back to list](#list)
 
+### AttrEnumerable.first_attr
+~~~ruby
+require 'attr_enumerable'
+
+class Person
+  attr_reader :name, :age
+  def initialize(name, age)
+    @name, @age = name, age
+  end
+end
+
+class Persons
+  attr_reader :persons
+  include AttrEnumerable
+  def initialize(persons = [])
+    @persons = persons
+  end
+
+  def <<(person)
+    @persons << person
+  end
+end
+
+persons = Persons.new([Person.new("tanaka", 84), Person.new("tanaka", 20), Person.new("suzuki", 20)])
+print persons.first_name # => 'tanaka'
+print persons.first_name(2) # => ['tanaka', 'tanaka']
+print persons.first_age(4) # => [84, 20, 20]
+
+persons = Persons.new([])
+print persons.first_age(4) # => []
+~~~
+
+[back to list](#list)
+
 ### AttrEnumerable.reverse_attr
 ~~~ruby
 require 'attr_enumerable'
@@ -4037,6 +4072,7 @@ if you are Sublime Text2 user, you can use snippet for TbpgrUtils.
 https://github.com/tbpgr/tbpgr_utils_snippets
 
 ## History
+* version 0.0.142 : add AttrEnumerable.first_attr
 * version 0.0.141 : add AttrEnumerable.delete_attr
 * version 0.0.140 : add AttrEnumerable.concat_attr
 * version 0.0.139 : add AttrEnumerable.compact_attr

data/lib/attr_enumerable/attr_enumerable_helper.rb

@@ -1,39 +1,44 @@
-# encoding: utf-8
-require 'active_support/inflector'
-
-# AttrEnumerable
-module AttrEnumerable
-  TARGET_METHOD_FILES = Dir.glob("#{File.dirname(__FILE__)}/*_attr*.rb").map { |file|File.basename(file, '.rb') }
-  TARGET_METHODS = TARGET_METHOD_FILES.map do |v|
-    regexp = v.gsub('attr', '(.*)')
-    { regexp: /^#{regexp}$/, call_method: v.to_sym }
-  end.reverse
-
-  # call attr enumerable method.
-  def method_missing(method_name, *args, &block)
-    target_method = detect(method_name)
-    send(target_method[:call_method], target_method[:attribute], method_name, *args, &block)
-  rescue
-   super(method_name, *args, &block)
-  end
-
-  private
-  def detect(method_name)
-    TARGET_METHODS.each do |target_method|
-      regexp = target_method[:regexp]
-      if method_name.to_s =~ regexp
-        attribute = method_name.to_s.scan(regexp).first.first
-        return { call_method: target_method[:call_method], attribute: attribute }
-      end
-    end
-    fail NoMethodError, "method is not exists #{method_name}"
-  end
-
-  def include_attr?(element, attribute)
-    element.instance_variables.include? :"@#{attribute}"
-  end
-
-  def collection
-    instance_variable_get("@#{self.class.name.underscore}")
-  end
-end
+# encoding: utf-8
+require 'active_support/inflector'
+
+# AttrEnumerable
+module AttrEnumerable
+  ATTR_METHODS = [
+    { regexp: /^each_(.*)_with_index$/, call_method: :each_attr_with_index },
+    { regexp: /^each_(.*)$/, call_method: :each_attr },
+    { regexp: /^reverse_(.*)$/, call_method: :reverse_attr },
+    { regexp: /^at_(.*)$/, call_method: :at_attr },
+    { regexp: /^compact_(.*)$/, call_method: :compact_attr },
+    { regexp: /^concat_(.*)$/, call_method: :concat_attr },
+    { regexp: /^delete_(.*)$/, call_method: :delete_attr },
+    { regexp: /^first_(.*)$/, call_method: :first_attr }
+  ]
+
+  # call attr enumerable method.
+  def method_missing(method_name, *args, &block)
+    target_method = detect(method_name)
+    send(target_method[:call_method], target_method[:attribute], method_name, *args, &block)
+  rescue
+   raise
+  end
+
+  private
+  def detect(method_name)
+    ATTR_METHODS.each do |target_method|
+      regexp = target_method[:regexp]
+      if method_name.to_s =~ regexp
+        attribute = method_name.to_s.scan(regexp).first.first
+        return { call_method: target_method[:call_method], attribute: attribute }
+      end
+    end
+    fail NoMethodError, "method is not exists #{method_name}"
+  end
+
+  def include_attr?(element, attribute)
+    element.instance_variables.include? :"@#{attribute}"
+  end
+
+  def collection
+    instance_variable_get("@#{self.class.name.underscore}")
+  end
+end

data/lib/attr_enumerable/first_attr.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+require 'attr_enumerable/attr_enumerable_helper'
+
+# AttrEnumerable
+module AttrEnumerable
+  private
+    def first_attr(attribute, method_name, *args, &block)
+      col = collection
+      return [] if col.empty?
+      first_size = args.size == 0 ? nil : Integer(args.first)
+      fail ArgumentError, "invalid attribute #{attribute}" unless include_attr?(col.first, attribute)
+      attrs = col.map { |v|v.send(attribute) }
+      first_size.nil? ? attrs.first : attrs.first(first_size)
+    end
+end

data/lib/attr_enumerable.rb

@@ -1,7 +1,7 @@
-# encoding: utf-8
-
-# AttrEnumerable
-module AttrEnumerable
-  REQUIRES = Dir.glob("#{File.dirname(__FILE__)}/attr_enumerable/*_attr*.rb").map { |file|File.basename(file, '.rb') }
-  REQUIRES.each { |require_lib|require "attr_enumerable/#{require_lib}" }
-end
+# encoding: utf-8
+
+# AttrEnumerable
+module AttrEnumerable
+  REQUIRES = Dir.glob("#{File.dirname(__FILE__)}/attr_enumerable/*_attr*.rb").map { |file|File.basename(file, '.rb') }
+  REQUIRES.each { |require_lib|require "attr_enumerable/#{require_lib}" }
+end

data/lib/tbpgr_utils/version.rb

@@ -2,5 +2,5 @@
 
 # Tbpgr Utilities
 module TbpgrUtils
-  VERSION = '0.0.141'
+  VERSION = '0.0.142'
 end

data/spec/attr_enumerable/first_attr_spec.rb

@@ -0,0 +1,107 @@
+# encoding: utf-8
+require 'spec_helper'
+require 'attr_enumerable'
+
+describe AttrEnumerable do
+  context :first_attr do
+    class AttrEnumerablePerson
+      attr_reader :name, :age
+      def initialize(name, age)
+        @name, @age = name, age
+      end
+    end
+
+    class AttrEnumerablePersons
+      attr_reader :attr_enumerable_persons
+      include AttrEnumerable
+      def initialize(attr_enumerable_persons = [])
+        @attr_enumerable_persons = attr_enumerable_persons
+      end
+
+      def <<(person)
+        @attr_enumerable_persons << attr_enumerable_persons
+      end
+    end
+
+    cases = [
+      {
+        case_no: 1,
+        case_title: 'name case',
+        klass: AttrEnumerablePersons.new(
+          [
+            AttrEnumerablePerson.new('tanaka', 84),
+            AttrEnumerablePerson.new('tanaka', 20),
+            AttrEnumerablePerson.new('suzuki', 20)
+          ]
+        ),
+        method: :first_name,
+        first: nil,
+        expected: ['tanaka'],
+      },
+      {
+        case_no: 2,
+        case_title: 'age case',
+        klass: AttrEnumerablePersons.new(
+          [
+            AttrEnumerablePerson.new('tanaka', 84),
+            AttrEnumerablePerson.new('tanaka', 20),
+            AttrEnumerablePerson.new('suzuki', 20)
+          ]
+        ),
+        method: :first_age,
+        first: 2,
+        expected: [84, 20],
+      },
+      {
+        case_no: 3,
+        case_title: 'over index case',
+        klass: AttrEnumerablePersons.new(
+          [
+            AttrEnumerablePerson.new('tanaka', 84),
+            AttrEnumerablePerson.new('tanaka', 20),
+            AttrEnumerablePerson.new('suzuki', 20)
+          ]
+        ),
+        method: :first_age,
+        first: 4,
+        expected: [84, 20, 20],
+      },
+      {
+        case_no: 4,
+        case_title: 'empty case',
+        klass: AttrEnumerablePersons.new([]),
+        method: :first_name,
+        first: nil,
+        expected: [],
+      }
+    ]
+
+    cases.each do |c|
+      it "|case_no=#{c[:case_no]}|case_title=#{c[:case_title]}" do
+        begin
+          case_before c
+
+          # -- given --
+          # nothing
+          ary = c[:klass]
+
+          # -- when --
+          actual = c[:first] ? ary.send(c[:method], c[:first]) : ary.send(c[:method])
+
+          # -- then --
+          expect(Array(actual)).to match_array(c[:expected])
+        ensure
+          case_after c
+        end
+      end
+
+      def case_before(c)
+        # implement each case before
+      end
+
+      def case_after(c)
+        # implement each case after
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tbpgr_utils
 version: !ruby/object:Gem::Version
-  version: 0.0.141
+  version: 0.0.142
 platform: ruby
 authors:
 - tbpgr
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-29 00:00:00.000000000 Z
+date: 2014-05-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -104,6 +104,7 @@ files:
 - lib/attr_enumerable/delete_attr.rb
 - lib/attr_enumerable/each_attr.rb
 - lib/attr_enumerable/each_attr_with_index.rb
+- lib/attr_enumerable/first_attr.rb
 - lib/attr_enumerable/reverse_attr.rb
 - lib/attributes_hashable.rb
 - lib/attributes_initializable.rb
@@ -267,6 +268,7 @@ files:
 - spec/attr_enumerable/delete_attr_spec.rb
 - spec/attr_enumerable/each_attr_spec.rb
 - spec/attr_enumerable/each_attr_with_index_spec.rb
+- spec/attr_enumerable/first_attr_spec.rb
 - spec/attr_enumerable/reverse_attr_spec.rb
 - spec/attributes_hashable_spec.rb
 - spec/attributes_initializable_spec.rb
@@ -437,6 +439,7 @@ test_files:
 - spec/attr_enumerable/delete_attr_spec.rb
 - spec/attr_enumerable/each_attr_spec.rb
 - spec/attr_enumerable/each_attr_with_index_spec.rb
+- spec/attr_enumerable/first_attr_spec.rb
 - spec/attr_enumerable/reverse_attr_spec.rb
 - spec/attributes_hashable_spec.rb
 - spec/attributes_initializable_spec.rb