named_proc 1.0 → 1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cbf28423889dfba4dbbdcb64f38cd3c83dfb9922
+  data.tar.gz: 52119a8217037574c2e8fc755e57d9655737306c
+SHA512:
+  metadata.gz: e303b748dbd73e992f7bbc54ce167abaeb9805cca83fa0f7ecb0c25f83312e9d6ac84b8835fb8b5b3f23627ce9f121b541586f0e4d4b8dd3cd60a52b3250645f
+  data.tar.gz: 346258671dd9f5ceac348d2271e20b2f9fcf0f3cbd64a33f8e9edec7b729f82bfe9a1b64ad3bf695d55f17e58917c3155e4d4e3f6fdb31742d1f27b805fb9229

data/.travis.yml

@@ -0,0 +1,17 @@
+language: ruby
+
+rvm:
+- ruby-head
+- 2.2.1
+- 2.2.0
+- 2.1.5
+- 2.1.4
+- 2.1.3
+- 2.1.2
+- 2.1.1
+- 2.1.0
+- 2.0.0
+- rbx-2
+- jruby-head
+- jruby-9000
+

data/CHANGELOG.rdoc

@@ -0,0 +1,7 @@
+== 1.1.0 (master)
+* Updates for 2015 Rubies, drop support for Ruby 1
+* Fix method to lambdafy a proc
+* Add proc name to NamedProc#inspect
+
+== 1.0.0
+* Initial Release

data/{LICENSE.txt → MIT-LICENSE.txt}

@@ -1,6 +1,6 @@
 The MIT LICENSE
 
-Copyright (c) 2011 Jan Lelis
+Copyright (c) 2011, 2015 Jan Lelis
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.rdoc

@@ -1,15 +1,18 @@
-= MultiBlock
+= Named Proc {<img src="https://badge.fury.io/rb/named_proc.svg" />}[http://badge.fury.io/rb/named_proc] {<img src="https://travis-ci.org/janlelis/named_proc.png" />}[https://travis-ci.org/janlelis/named_proc]
 
-MultiBlock is a mini framework for passing multiple blocks to methods. It uses "named procs" to accomplish this in a nice way. The receiving method can either yield all blocks, or just call specific ones, identified by order or name.
+When working with a lot of procs, naming them might become handy. It makes identifying them later easier, which can be utilized by your code. For example, it enables improves the usefulness of {multi_block}[https:/github.com/janlelis/multi_block], a gem that allows you to pass multiple procs to methods.
 
-These gem was build during a codebrawl contest. You might also take a look at the other entries: http://codebrawl.com/contests/methods-taking-multiple-blocks
 
 == Setup
 
-    gem install multi_block
+Add to Gemfile:
+
+    gem 'named_proc'
+
 
 == Named Procs
-A named proc acts like a normal proc, but has got a name attribute. You can create it by calling a method with the desired name on +proc+:
+
+A named proc acts like a normal proc, but it has a name attribute. You create it by calling a method with the desired name on +proc+:
 
     >> a = proc.even?{ |e| e.even? }
     => #<NamedProc:0x00000001ffc340@(irb):1>
@@ -29,67 +32,5 @@ In the same way, you can create lambdas:
     >> b.lambda?
     => true
 
-== MultiBlock Usage
-=== Defining methods that use multiple blocks
-
-The first argument given to yield always defines the desired block(s). The other arguments get directly passed to the block(s). So these are example calls to the block:
-
-    yield                                            # calls all given procs without args
-    yield :success                                   # calls :success proc without args
-    yield :success, "Code Brawl!"                    # calls :success proc with message
-    yield 1                                          # calls first proc (:success in this case)
-    yield [:success, :bonus]                         # calls :success and :bonus without args
-    yield [:success, :bonus], "Code Brawl!"          # calls both procs with same arg
-    yield success: "Code Brawl!",                    # calls each keyed proc,
-          error:   [500, "Internal Brawl Error"]     #       values are the args
-
-Consider these two example methods:
-
-    def ajax
-      yield rand(6) != 0 ? :success : :error # calls the :success block if everything worked well
-    end
-
-    def dice
-      random_number = rand(6)
-      yield random_number, random_number + 1 # calls the n-th block
-    end
-
-=== Calling methods with multiple blocks
-
-It's done by calling the +blocks+ helper method:
-
-    ajax &blocks[
-      proc.success do puts "Yeah!" end,
-      proc.error   do puts "Error..." end,
-    ]
-
-The dice method could, for example, be called in this way:
-
-    dice &blocks[
-      proc{ ":(" },
-      proc{ ":/" },
-      proc{ ":O" },
-      proc{ ":b" },
-      proc{ ":P" },
-      proc{ rand(42) != 0 ? ":)"  : ":D"},
-    ]
-
-== Bonus sugar: Array extension
-
-If you like the slim <tt>&to_proc</tt> operator, you can further optimize the syntax by calling:
-
-    Array.send :include, MultiBlock::Array
-
-Now, it's getting real hot:
-
-    do_something, some_argument, &[
-      proc.easy_way do
-        # do it the easy way
-      end,
-      
-      proc.complex_way do
-        # use complex heuristics, etc.
-      end,
-    ]
-
-== J-_-L
+== MIT License
+The original gist: https://gist.github.com/4b2f5fd0b45118e46d0f

data/lib/named_proc.rb

@@ -1,54 +1,3 @@
-# encoding: utf-8
-
-# Class for a proc that's got a name
-class NamedProc < Proc
-  attr_reader :name
-
-  def initialize(name)
-    @name = name
-    super
-  end
-  
-  # create one from a given proc/lambda object
-  def self.create(name, block, lambda = false)
-    name = name.to_sym
-    # sorry for this ugly hack, is there a better way to lambdafy?
-    block = Module.new.send(:define_method, name.to_sym, &block) if lambda
-    
-    new(name, &block)
-  end
-  
-  # Proxy object to ease named proc initialization
-  module Proxy
-    Proc = BasicObject.new
-    def Proc.method_missing(name, &block)   NamedProc.create(name, block) end
-
-    Lambda = BasicObject.new
-    def Lambda.method_missing(name, &block) NamedProc.create(name, block, true) end
-  end
-  
-  # Mixing in low level method "links"
-  module Object
-    private
-  
-    # create a proc with name if given
-    def proc
-      if block_given?
-        super
-      else
-        NamedProc::Proxy::Proc
-      end
-    end
-    
-    # same for lambda
-    def lambda
-      if block_given?
-        super
-      else
-        NamedProc::Proxy::Lambda
-      end
-    end
-  end
-  
-  ::Object.send :include, NamedProc::Object
-end
+require_relative 'named_proc/version'
+require_relative 'named_proc/implementation'
+require_relative 'named_proc/core_ext'

data/lib/named_proc/core_ext.rb

@@ -0,0 +1,3 @@
+class Object
+  include NamedProc::Object
+end

data/lib/named_proc/implementation.rb

@@ -0,0 +1,55 @@
+# Class for a proc that's got a name
+class NamedProc < Proc
+  attr_reader :name
+
+  def initialize(name)
+    @name = name
+    super()
+  end
+
+  def inspect
+    super.sub /^#<#{self.class}/, "#<#{self.class}[#{name}]"
+  end
+  
+  # Create a named proc from a given proc/lambda object
+  def self.create(name, block, create_lambda = false)
+    if create_lambda
+      lambdafyer = Module.new
+      lambdafyer.singleton_class.send(:define_method, :lambdafy, &block)
+      block = lambdafyer.method(:lambdafy).to_proc
+    end
+    new(name.to_sym, &block)
+  end
+  
+  # Proxy object to ease named proc initialization
+  module Proxy
+    Proc = BasicObject.new
+    def Proc.method_missing(name, &block)   NamedProc.create(name, block) end
+
+    Lambda = BasicObject.new
+    def Lambda.method_missing(name, &block) NamedProc.create(name, block, true) end
+  end
+  
+  # Mixing in low level method "links"
+  module Object
+    private
+  
+    # Create a proc with name if given
+    def proc
+      if block_given?
+        super
+      else
+        NamedProc::Proxy::Proc
+      end
+    end
+    
+    # Same for lambda
+    def lambda
+      if block_given?
+        super
+      else
+        NamedProc::Proxy::Lambda
+      end
+    end
+  end
+end

data/lib/named_proc/version.rb

@@ -0,0 +1,3 @@
+class NamedProc < Proc
+  VERSION = "1.1".freeze
+end

data/named_proc.gemspec

@@ -1,18 +1,19 @@
 # -*- encoding: utf-8 -*-
-require 'rubygems' unless defined? Gem
- 
+
+require File.expand_path('../lib/named_proc/version', __FILE__)
+
 Gem::Specification.new do |s|
   s.name        = "named_proc"
-  s.version     = 1.0
+  s.version     = NamedProc::VERSION
   s.authors     = ["Jan Lelis"]
   s.email       = "mail@janlelis.de"
-  s.homepage    = "https://gist.github.com/4b2f5fd0b45118e46d0f"
+  s.homepage    = "https://github.com/janlelis/named_proc"
   s.summary     = "NamedProc: Like anonymous procs, but have a name."
   s.description = "NamedProc: Like anonymous procs, but have a name. Example: lambda.codebrawl {} # creates an empty lambda with the name :codebrawl"
-  s.required_ruby_version     = '>= 1.9.2'
-  s.files = Dir.glob %w{named_proc.gemspec lib/named_proc.rb spec/named_proc_spec.rb}
-  s.extra_rdoc_files = ["README.rdoc", "LICENSE.txt"]
+  s.files = Dir.glob %w{named_proc.gemspec lib/named_proc.rb lib/named_proc/version.rb lib/named_proc/implementation.rb lib/named_proc/core_ext.rb spec/named_proc_spec.rb}
+  s.extra_rdoc_files = ["README.rdoc", "MIT-LICENSE.txt", "CHANGELOG.rdoc", ".travis.yml"]
   s.license = 'MIT'
-  s.add_development_dependency 'rspec'
-  s.add_development_dependency 'rspec-core'
+  s.required_ruby_version = '>= 1.9.3'
+  s.add_development_dependency 'rspec', '~> 3.2'
+  s.add_development_dependency 'rake', '~> 10.4'
 end

data/spec/named_proc_spec.rb

@@ -1,34 +1,33 @@
-# encoding: utf-8
 require_relative '../lib/named_proc'
 
 describe "proc" do
   it "creates a new proc as usual when called with a block" do
     a = proc{}
-    a.should be_instance_of Proc
-    a.lambda?.should == false
+    expect( a ).to be_instance_of Proc
+    expect( a ).not_to be_lambda
   end
   
   it "creates a named proc when a method gets called on it" do
     a = proc.brawl{}
-    a.should be_a Proc
-    a.should be_instance_of NamedProc
-    a.lambda?.should == false
-    a.name == :brawl
+    expect( a ).to be_a Proc
+    expect( a ).to be_instance_of NamedProc
+    expect( a ).not_to be_lambda
+    expect( a.name ).to eq :brawl
   end
 end
 
 describe "lambda" do
   it "creates a new lambda as usual when called with a block" do
     a = lambda{}
-    a.should be_instance_of Proc
-    a.lambda?.should == true
+    expect( a ).to be_instance_of Proc
+    expect( a ).to be_lambda
   end
   
   it "creates a named lambda when a method gets called on it" do
     a = lambda.brawl{}
-    a.should be_a Proc
-    a.should be_instance_of NamedProc
-    a.lambda?.should == true
-    a.name == :brawl
+    expect( a ).to be_a Proc
+    expect( a ).to be_instance_of NamedProc
+    expect( a ).to be_lambda
+    expect( a.name ).to eq :brawl
   end
 end

metadata

@@ -1,75 +1,86 @@
 --- !ruby/object:Gem::Specification
 name: named_proc
 version: !ruby/object:Gem::Version
-  version: '1.0'
-  prerelease: 
+  version: '1.1'
 platform: ruby
 authors:
 - Jan Lelis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-10-24 00:00:00.000000000Z
+date: 2015-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &9105880 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.2'
   type: :development
   prerelease: false
-  version_requirements: *9105880
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
 - !ruby/object:Gem::Dependency
-  name: rspec-core
-  requirement: &9105320 !ruby/object:Gem::Requirement
-    none: false
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '10.4'
   type: :development
   prerelease: false
-  version_requirements: *9105320
-description: ! 'NamedProc: Like anonymous procs, but have a name. Example: lambda.codebrawl
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+description: 'NamedProc: Like anonymous procs, but have a name. Example: lambda.codebrawl
   {} # creates an empty lambda with the name :codebrawl'
 email: mail@janlelis.de
 executables: []
 extensions: []
 extra_rdoc_files:
 - README.rdoc
-- LICENSE.txt
+- MIT-LICENSE.txt
+- CHANGELOG.rdoc
+- ".travis.yml"
 files:
-- named_proc.gemspec
+- ".travis.yml"
+- CHANGELOG.rdoc
+- MIT-LICENSE.txt
+- README.rdoc
 - lib/named_proc.rb
+- lib/named_proc/core_ext.rb
+- lib/named_proc/implementation.rb
+- lib/named_proc/version.rb
+- named_proc.gemspec
 - spec/named_proc_spec.rb
-- README.rdoc
-- LICENSE.txt
-homepage: https://gist.github.com/4b2f5fd0b45118e46d0f
+homepage: https://github.com/janlelis/named_proc
 licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.2
+      version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.11
+rubygems_version: 2.4.6
 signing_key: 
-specification_version: 3
-summary: ! 'NamedProc: Like anonymous procs, but have a name.'
+specification_version: 4
+summary: 'NamedProc: Like anonymous procs, but have a name.'
 test_files: []