object-let 0.1.0 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9d0d8bb1b58d8659a345743a265b42557cf002f8
+  data.tar.gz: a9864dfddc18e11a6c098c1925784fe23efcdced
+SHA512:
+  metadata.gz: 1133a8aa2c47074c937c7c24022ea332f77b159437db3a5b8b42d87f73468066dc8f56f0f26d3f1b0d1d5ca814b5407c243d8cc159fce774fc63d116ecf74d92
+  data.tar.gz: 8f4fbf51509869a5c79fc55a293d28e19043b717f07568e49e37b3ff8880c38c84f623357cb4978bcfb2ab4b3cd8e5e78c37f0bc6db5c9059235cf3a44f861f8

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.1.9
+  - 2.2.5
+  - 2.3.1

data/README.md

@@ -0,0 +1,74 @@
+# object-let
+
+[![Gem Version](https://badge.fury.io/rb/object-let.svg)](https://badge.fury.io/rb/object-let)
+[![Build Status](https://secure.travis-ci.org/ronen/object-let.png)](http://travis-ci.org/ronen/object-let)
+[![Dependency Status](https://gemnasium.com/ronen/object-let.png)](https://gemnasium.com/ronen/object-let)
+
+
+Defines `Object#let`, which simply yields the object and returns the result.
+This idiom, familiar to Lisp programmers, can be handy to eliminate the need
+for an intermediate variable when you need to use the result of a computation
+multiple times, or at the tail of a method chain.
+
+For example, without `let`, you might write:
+
+```ruby
+biggest = my_things.find_biggest
+bounds = Bound.new(:width => biggest.width, :height => biggest.height)
+```
+
+with `let`, this could be:
+
+```ruby
+bounds = my_things.find_biggest.let { |biggest|
+    Bound.new(:width => biggest.width, :height => biggest.height)
+}
+```
+
+Stylistically, as well in terms of lexical scoping, this idiom
+can make clear that the intermediate result is of no importance outside the
+block.
+
+You can also think of this as analogous to "map" in a method chain, but for a
+single value rather than for an enumerable.  Compare:
+
+```ruby
+array_of_items = thingy.item_names.map { |name| Item.new(:name => name) }
+just_one_item  = thingy.item_name.let  { |name| Item.new(:name => name) }
+```
+
+# See also
+
+Alternative implementation at http://ick.rubyforge.org/inside.html
+
+The "let" gem (https://rubygems.org/gems/let) provides a module that can be
+included in a class to define memoizing accessors.  That gem and this one are
+compatible.
+
+## Installation
+
+Install via:
+
+    % gem install object-let
+
+or in your Gemfile:
+
+    gem "object-let"
+    
+## Compatibility
+
+The gem is tested on ruby 2.1.9, 2.2.5, and 2.3.1
+
+## History
+
+* 1.0.0 - remove `Object#let_if`; on ruby >= 2.3 using `&.let` is cleaner and nearly equivalent (differ only in falsey vs nil).  Drop support for ruby <= 1.9
+
+* 0.1.0 - Add `Object#let_if`
+
+* 0.0.1 - Initial version
+
+## Copyright
+
+Released under the MIT License.  See LICENSE for details.
+
+

data/Rakefile

@@ -1,6 +1,8 @@
 #!/usr/bin/env rake
 require "bundler/gem_tasks"
 
+task :default => :spec
+
 require 'rspec/core/rake_task'
 RSpec::Core::RakeTask.new(:spec) do |spec|
   spec.rspec_opts = '-Ispec'

data/lib/object-let/object.rb

@@ -3,8 +3,5 @@ module ObjectLet
     def let
       yield self
     end
-    def let_if
-      yield self if self
-    end
   end
 end

data/lib/object-let/version.rb

@@ -1,3 +1,3 @@
 module ObjectLet
-  VERSION = "0.1.0"
+  VERSION = "1.0.0"
 end

data/object-let.gemspec

@@ -7,11 +7,6 @@ Gem::Specification.new do |gem|
   gem.description   = %q{Defines Object#let, which yields the object and returns the result}
   gem.summary       = %q{Defines Object#let, which yields the object and returns the result.  This idiom can be handy to eliminate the need for an intermediate variable when you need to use the result of a computation multiple times.}
   gem.homepage      = 'http://github.com/ronen/object-let'
-  gem.extra_rdoc_files = [
-    'LICENSE',
-    'README.rdoc',
-  ]
-
   gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   gem.files         = `git ls-files`.split("\n")
   gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
@@ -19,7 +14,8 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
   gem.version       = ObjectLet::VERSION
 
-  gem.add_development_dependency 'rspec'
-  gem.add_development_dependency 'simplecov'
-  gem.add_development_dependency 'simplecov-gem-adapter'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec', "~> 3.0"
+  gem.add_development_dependency 'simplecov', "~> 0.12"
+  gem.add_development_dependency 'simplecov-gem-profile'
 end

data/spec/object_spec.rb

@@ -1,58 +1,17 @@
 require "spec_helper"
 
-shared_examples "let" do
-
-  it "should be supported" do
-    obj = Object.new
-    obj.should be_respond_to method
-  end
+describe "Object" do
 
-  it "should yield the object" do
+  it "yields the object" do
     obj = Object.new
-    obj.send(method) { |arg|
-      arg.should equal obj
+    obj.let { |arg|
+      expect(arg).to eq obj
     }
   end
 
-  it "should return the block result" do
+  it "returns the block result" do
     obj = Object.new
-    obj.send(method) {|arg| 3}.should == 3
-  end
-end
-
-shared_examples "let_if" do
-  it "should not yield" do
-    expect { subject.let_if { raise "in block"} }.should_not raise_error
-  end
-
-  it "should return nil" do
-    subject.let_if { 12345 }.should be_nil
-  end
-end
-
-describe "Object" do
-
-  context "let" do
-    it_should_behave_like "let" do
-      let(:method) { :let }
-    end
-  end
-
-  context "let_if" do
-    it_should_behave_like "let" do
-      let(:method) { :let_if }
-    end
-
-    context "when object is nil" do
-      subject { nil }
-      it_should_behave_like "let_if"
-    end
-
-    context "when object is false" do
-      subject { false }
-      it_should_behave_like "let_if"
-    end
-
+    expect(obj.let {|arg| 3}).to eq 3
   end
 
 end

data/spec/spec_helper.rb

@@ -1,8 +1,6 @@
-if RUBY_VERSION > "1.9"
-  require 'simplecov'
-  require 'simplecov-gem-adapter'
-  SimpleCov.start 'gem'
-end
+require 'simplecov'
+require 'simplecov-gem-profile'
+SimpleCov.start 'gem'
 
 require 'rspec'
 require 'object-let'

metadata

@@ -1,62 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: object-let
 version: !ruby/object:Gem::Version
-  version: 0.1.0
-  prerelease: 
+  version: 1.0.0
 platform: ruby
 authors:
 - ronen barzel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-04 00:00:00.000000000 Z
+date: 2016-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: &70259253506940 !ruby/object:Gem::Requirement
-    none: false
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70259253506940
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &70259253506520 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.12'
   type: :development
   prerelease: false
-  version_requirements: *70259253506520
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
 - !ruby/object:Gem::Dependency
-  name: simplecov-gem-adapter
-  requirement: &70259253506060 !ruby/object:Gem::Requirement
-    none: false
+  name: simplecov-gem-profile
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70259253506060
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Defines Object#let, which yields the object and returns the result
 email:
 - ronen@barzel.org
 executables: []
 extensions: []
-extra_rdoc_files:
-- LICENSE
-- README.rdoc
+extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
+- ".travis.yml"
 - Gemfile
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - lib/object-let.rb
 - lib/object-let/object.rb
@@ -66,31 +87,29 @@ files:
 - spec/spec_helper.rb
 homepage: http://github.com/ronen/object-let
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 2.5.1
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Defines Object#let, which yields the object and returns the result.  This
   idiom can be handy to eliminate the need for an intermediate variable when you need
   to use the result of a computation multiple times.
 test_files:
 - spec/object_spec.rb
 - spec/spec_helper.rb
-has_rdoc: 

data/README.rdoc

@@ -1,71 +0,0 @@
-= object-let
-
-{<img src="https://gemnasium.com/ronen/object-let.png" alt="Dependency Status" />}[https://gemnasium.com/ronen/object-let]
-
-Defines <tt>Object#let</tt>, which simply yields the object and returns the result.
-This idiom, familiar to Lisp programmers, can be handy to eliminate the need
-for an intermediate variable when you need to use the result of a
-computation multiple times.
-
-For example, without +let+, you might write:
-
-  biggest = my_things.find_biggest
-  bounds = Bound.new(:width => biggest.width, :height => biggest.height)
-
-with +let+, this could be:
-
-  bounds = my_things.find_biggest.let { |biggest|
-    Bound.new(:width => biggest.width, :height => biggest.height)
-  }
-
-
-Stylistically, as well in terms of lexical scoping (for ruby 1.9), this
-idiom can make clear that the intermediate result is of no importance outside the
-block.
-
-You can also think of this as analogous to "map" in a method chain, but for a single value
-rather than for an enumerable.  Compare:
-
-        array_of_items = thingy.item_names.map{ |name| Item.new(:name => name) }
-        just_one_item  = thingy.item_name.let { |name| Item.new(:name => name) }
-
-
-<tt>Object#let_if</tt> behaves like <tt>Object#let</tt> except that it only yields if the
-object is truthy; otherwise it returns nil.  So, modifying the above
-example:
-
-    bounds = my_things.find_biggest.let_if { |biggest|
-      Bound.new(:width => biggest.width, :height => biggest.height)
-    }
-
-+bounds+ will be nil if +find_biggest+ returns nil.
-
-= See also
-
-Discussion at http://www.opensourcery.com/blog/zack-hobson/objectlet-ruby-0
-
-Alternative implementation at http://ick.rubyforge.org/inside.html
-
-The "let" gem (https://rubygems.org/gems/let) provides a module that can be
-included in a class to define memoizing accessors.  That gem and this one
-are compatible.
-
-== Installation
-
-Install via:
-
-   % gem install object-let
-
-or in your Gemfile:
-
-   gem "object-let"
-
-== History
-
-  * 0.1.0 - Add <tt>Object#left_if</tt>
-  * 0.0.1 - Initial version
-
-== Copyright
-
-Released under the MIT License.  See LICENSE for details.
-