procme 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MThlMjQxM2JhNmQ0YjZlMGFhNDQ4ZTZmODM0NDM4MDA2ZjMwYTM1ZA==
+  data.tar.gz: !binary |-
+    ZmExNWYyYzI0YjM3NmM3ZjliOTRlNWRlNjgwMDJiMzQ4YzI2ZWY1Zg==
+SHA512:
+  metadata.gz: !binary |-
+    YTJiZmVkZjFmMTFhN2UwODM2YWIyZjJjYTJiZDFjMDE3YTYyNzg1NjkzYzUy
+    NDZmYTJjYWYwOTYwNmJjYmFmYmE0MjZjYjhkZDdhZjg1NjlmZTFlZjNjNTQ2
+    MDMwMDdlNjNlZDQzMjMyYzAwNWE3MTZmNjc1OTY5ZWRhYmI3NzU=
+  data.tar.gz: !binary |-
+    NzYzMTZmNGM2M2VlZmVmZGZhOWNlM2M3NjEzNjkyZDdkOTY1ZDE5ZTJjNjk2
+    NjZjNDU4ZDBjNDM1YTNkN2M2MmZmZjUwZjBkMmRhYTA1MTJiYWFiYTZjZTVm
+    NjdmZTZlMTI0YzFlYTAzMzEwN2I1NWY1MTNmM2NhMzUyOGY0ODg=

data/README.md

@@ -0,0 +1,96 @@
+# ProcMe
+
+## Install
+With Bundler (brand new and yet unpublished to RubyGems):
+
+```
+gem 'procme', git: 'git://github.com/zverok/procme.git'
+```
+
+## Usage
+
+```ruby
+# Giving you have
+class Person < Struct.new(:name, :age, :gender)
+  def greet(who)
+    puts "#{name}: Hello, #{who}!"
+  end
+
+  def inspect
+    "#<#{name}, #{gender}, #{age}>"
+  end
+end
+
+people = [
+  Person.new('John', 30, 'male'),
+  Person.new('Jane', 23, 'female'),
+  Person.new('Jake', 48, 'male'),
+  Person.new('Judith', 16, 'female')
+]
+
+# With ProcMe you can:
+include ProcMe
+
+# ProcMe::fltr(method: match) - filter by attribute values/method calls:
+p people.select(&fltr(gender: 'female', age: 18...30))
+# => [#<Jane, female, 23>]
+
+# ProcMe::get(:method1, :method2) - bulk get attributes
+p people.map(&get(:gender, :age))
+# => [["male", 30], ["female", 23], ["male", 48], ["female", 16]]
+
+# ...which is really useful when sorting:
+p people.sort_by(&get(:gender, :age))
+# => [#<Judith, female, 16>, #<Jane, female, 23>, #<John, male, 30>, #<Jake, male, 48>]
+
+# ProcMe::set(attr: value) - bulk set value:
+p people.map(&set(gender: 'female'))
+# => [#<John, female, 30>, #<Jane, female, 23>, #<Jake, female, 48>, #<Judith, female, 16>]
+
+# ProcMe::call(method: args) - bulk call method with arguments:
+people.each(&call(greet: 'Ellis'))
+# Output:
+#   John: Hello, Ellis!
+#   Jane: Hello, Ellis!
+#   Jake: Hello, Ellis!
+#   Judith: Hello, Ellis!
+```
+
+## Rationale
+
+Look at symple example
+
+```ruby
+people.select{|p| p.gender == 'female'}
+people.select(&fltr(gender: 'female'))
+```
+
+At a first glance, there's not a very big difference,
+even in symbols count (ok, ProcMe version 1 symbol shorter :)
+
+Yet there's one important difference: ProcMe version is
+[DRY](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself). It's not
+DRY for the sake of DRY, it's for better, cleaner and error-prone code.
+
+Assume you are copying the code while rewriting it:
+
+```ruby
+aliens.select{|a| p.gender == 'female'}
+#                 ^ bang! It was not DRY enough!
+
+# With ProcMe
+aliens.select(&fltr(gender: 'female'))
+# just no repeating - no place for errors
+```
+
+In fact, the rationale it the same, as it was for inventing `Symbol#to_proc`.
+
+ProcMe is very small and simple, without any monkey-patching of core classes.
+Only four methods (`fltr`, `get`, `set`, `call`), which you can include
+in any namespace or use without inclusion, for ex:
+
+```ruby
+P = ProcMe # to be short
+
+people.select(&P.fltr(gender: 'female'))
+```

data/examples/example.rb

@@ -0,0 +1,47 @@
+# encoding: utf-8
+require_relative '../lib/procme'
+
+# Giving you have
+class Person < Struct.new(:name, :age, :gender)
+  def greet(who)
+    puts "#{name}: Hello, #{who}!"
+  end
+
+  def inspect
+    "#<#{name}, #{gender}, #{age}>"
+  end
+end
+
+people = [
+  Person.new('John', 30, 'male'),
+  Person.new('Jane', 23, 'female'),
+  Person.new('Jake', 48, 'male'),
+  Person.new('Judith', 16, 'female')
+]
+
+# With ProcMe you can:
+include ProcMe
+
+# ProcMe::fltr(method: match) - filter by attribute values/method calls:
+p people.select(&fltr(gender: 'female', age: 18...30))
+# => [#<Jane, female, 23>]
+
+# ProcMe::get(:method1, :method2) - bulk get attributes
+p people.map(&get(:gender, :age))
+# => [["male", 30], ["female", 23], ["male", 48], ["female", 16]]
+
+# ...which is really useful when sorting:
+p people.sort_by(&get(:gender, :age))
+# => [#<Judith, female, 16>, #<Jane, female, 23>, #<John, male, 30>, #<Jake, male, 48>]
+
+# ProcMe::set(attr: value) - bulk set value:
+p people.map(&set(gender: 'female'))
+# => [#<John, female, 30>, #<Jane, female, 23>, #<Jake, female, 48>, #<Judith, female, 16>]
+
+# ProcMe::call(method: [args]) - bulk call method with arguments:
+people.each(&call(greet: 'Ellis'))
+# Output:
+#   John: Hello, Ellis!
+#   Jane: Hello, Ellis!
+#   Jake: Hello, Ellis!
+#   Judith: Hello, Ellis!

data/lib/procme.rb

@@ -0,0 +1,34 @@
+# encoding: utf-8
+# ProcMe: DRY and clean blocks for your code
+module ProcMe
+  def filter(hash)
+    lambda do |o|
+      hash.all?{|k, v| v === o.send(k)} # rubocop:disable Style/CaseEquality
+    end
+  end
+
+  alias_method :fltr, :filter
+
+  def set(hash)
+    lambda do |o|
+      hash.each{|k, v| o.send("#{k}=", v)}
+      o
+    end
+  end
+
+  def call(hash)
+    lambda do |o|
+      hash.each{|k, v| o.send(k, *v)}
+      o
+    end
+  end
+
+  def get(*array)
+    lambda do |o|
+      array.map{|v| o.send(*v)}
+    end
+  end
+
+  # now we can use both include ProcMe & no include approach
+  extend self # rubocop:disable Style/ModuleFunction
+end

data/procme.gemspec

@@ -0,0 +1,29 @@
+Gem::Specification.new do |s|
+  s.name     = 'procme'
+  s.version  = '0.0.1'
+  s.authors  = ['Victor Shepelev']
+  s.email    = 'zverok.offline@gmail.com'
+  s.homepage = 'https://github.com/zverok/procme'
+
+  s.summary = 'Useful DRY proc-s for Ruby'
+  s.description = <<-EOF
+    ProcMe provides you with methods for DRY and clean processing of
+    enumerables.
+  EOF
+  s.licenses = ['MIT']
+
+  s.files = `git ls-files`.split($RS).reject do |file|
+    file =~ /^(?:
+    spec\/.*
+    |Gemfile
+    |Rakefile
+    |\.rspec
+    |\.gitignore
+    |\.rubocop.yml
+    |\.travis.yml
+    )$/x
+  end
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency 'rubocop', '~> 0.30'
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: procme
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Victor Shepelev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.30'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.30'
+description: ! "    ProcMe provides you with methods for DRY and clean processing
+  of\n    enumerables.\n"
+email: zverok.offline@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- examples/example.rb
+- lib/procme.rb
+- procme.gemspec
+homepage: https://github.com/zverok/procme
+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.4.6
+signing_key: 
+specification_version: 4
+summary: Useful DRY proc-s for Ruby
+test_files: []