sleeping_king_studios-ext 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a577560ebfa76eda2fb92e99731fd660d46ef67c
+  data.tar.gz: 08f133c3c52f49a36b977e42da1fd293d24dbaec
+SHA512:
+  metadata.gz: 1abefaf6b82006133c1820a32f38939ca43836fa9a06aa3804ccae2f9f001a37f98f63f8e1292d256512007d7bbec32f3cf21e6b9a447d907bed914d068e1a03
+  data.tar.gz: 77753ec2b8bea81cc240e45d5c011f2f62e3a396925acd5c8b4e1ef4bba3a5f58318e37f1537e67ee430a1c6bbd6050bf83c5a3be80db17e539166d667364f75

data/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 0.1.0
+
+Initial release version.
+
+### Array
+
+- Added Array#fold method.
+
+### Object
+
+- Added Object#metaclass method.

data/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2013 Rob Smith
+
+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,47 @@
+# SleepingKingStudios::Ext
+
+A collection of extensions to core classes.
+
+## The Extensions
+
+### Array\#fold
+
+    require 'sleeping_king_studios/ext/array/fold'
+
+Loops through the items in the array and counts the number of times each item
+appears. If a block is provided, each item is passed into the block, and the
+result of yielding the block is counted instead.
+
+_Example:_ Find the number of times each item appears in the array.
+
+    items  = %w(foo foo foo bar bar baz wibble wobble)
+    items.fold
+    #=> { 'foo' => 3, 'bar' => 2, 'baz' => 1, 'wibble' => 1, 'wobble' => 1 }
+
+_Example:_ Count the items in the array with each status value.
+
+    class SampleItem < Struct.new(:status); end
+    items = [
+      SampleItem.new :approved,
+      SampleItem.new :rejected,
+      SampleItem.new :approved,
+      SampleItem.new :approved,
+      SampleItem.new :error,
+      SampleItem.new nil,
+      SampleItem.new :rejected,
+    ] # end array
+    items.fold { |item| item.status }
+    #=> { :approved => 3, :rejected => 2, :error => 1, nil => 1 }
+
+### Object\#metaclass
+
+    require 'sleeping_king_studios/ext/object/metaclass'
+
+Returns the object's metaclass, a Class that holds any functionality specific
+to that object instance, e.g. a method defined using
+`Object#define_singleton_method`, or a module that the instance extends.
+
+## License
+
+SleepingKingStudios::Ext is released under the
+[MIT License](http://www.opensource.org/licenses/MIT).

data/lib/sleeping_king_studios/ext/array/fold.rb

@@ -0,0 +1,40 @@
+# lib/sleeping_king_studios/ext/array/fold.rb
+
+class Array
+  # Loops through the items in the array and counts the number of times each
+  # item appears. If a block is provided, each item is passed into the block,
+  # and the result of yielding the block is counted instead.
+  # 
+  # @return [Hash] A hash whose keys are the items in the
+  #   array or the results of yielding the block, and whose values are the
+  #   number of times each item appeared in the array.
+  # 
+  # @example Find the number of times each item appears in the array.
+  #   
+  #   items  = %w(foo foo foo bar bar baz wibble wobble)
+  #   items.fold
+  #   #=> { 'foo' => 3, 'bar' => 2, 'baz' => 1, 'wibble' => 1, 'wobble' => 1 }
+  # 
+  # @example Count the items in the array with each status value.
+  # 
+  #   class SampleItem < Struct.new(:status); end
+  #   items = [
+  #     SampleItem.new :approved,
+  #     SampleItem.new :rejected,
+  #     SampleItem.new :approved,
+  #     SampleItem.new :approved,
+  #     SampleItem.new :error,
+  #     SampleItem.new nil,
+  #     SampleItem.new :rejected,
+  #   ] # end array
+  #   items.fold { |item| item.status }
+  #   #=> { :approved => 3, :rejected => 2, :error => 1, nil => 1 }
+  # 
+  # @since 0.1.0
+  def fold
+    each.with_object({}) do |item, hsh|
+      value = block_given? ? yield(item) : item
+      hsh[value] = hsh.fetch(value, 0) + 1
+    end # each with object
+  end # method fold
+end # class

data/lib/sleeping_king_studios/ext/object/metaclass.rb

@@ -0,0 +1,14 @@
+# lib/sleeping_king_studios/ext/object/metaclass.rb
+
+class Object
+  # Returns the object's metaclass, a Class that holds any functionality
+  # specific to that object instance, e.g. a method defined using
+  # Object#define_singleton_method, or a module that the instance extends.
+  # 
+  # @return [Class] The object's metaclass.
+  # 
+  # @since 0.1.0
+  def metaclass
+    class << self; self; end
+  end # method metaclass
+end # class

data/lib/sleeping_king_studios/ext/version.rb

@@ -0,0 +1,7 @@
+# lib/sleeping_king_studios/ext/version.rb
+
+module SleepingKingStudios
+  module Ext
+    VERSION = '0.1.0'
+  end # module
+end # module

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: sleeping_king_studios-ext
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Rob "Merlin" Smith
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: fuubar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+description: |2
+      A collection of extensions to core classes, gemified to prevent a
+      maintenance nightmare if multiple library or application projects require
+      general extensions.
+email:
+- merlin@sleepingkingstudios.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/sleeping_king_studios/ext/array/fold.rb
+- lib/sleeping_king_studios/ext/object/metaclass.rb
+- lib/sleeping_king_studios/ext/version.rb
+- LICENSE
+- CHANGELOG.md
+- README.md
+homepage: http://sleepingkingstudios.com
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.6
+signing_key: 
+specification_version: 4
+summary: Extensions to core classes.
+test_files: []
+has_rdoc: