its-it 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0940411f44c31b8869ba17e8efa1505c63c01c97
-  data.tar.gz: 3a0b78717605b167e8017b4d9108f6cb08a3b680
+  metadata.gz: 01864b89d966bb4cd9bbeea11caa15072e77890f
+  data.tar.gz: 24f7526c94e6a0b4d103581647f18fbd42f32583
 SHA512:
-  metadata.gz: f0a011722987ec5ac5a566c23e54c869a9faadec3a036cf3f207e9b92a32078527a25a06409668941706e490dfdfa011a5d2d8111603fe385bde91b7e2b3a4d0
-  data.tar.gz: a386fe0ed1440033d01c5a794ff447892225bcdf98e610c66d14a7324085e42458741809107f7d00c6b7a1d6bd116363c11a1c94c9d483bbd454767f6639501d
+  metadata.gz: fabb650c7deb98f7d2b5dcc62897c36a5eec8f27bca33265ec307a624f4b1266f2c25e42aff209382658452a471986895c5952465c5749df2c57f0323d4915c0
+  data.tar.gz: d58f503c0ac24465d3aa61bf8385082b958f0765aa533f49127abf004c71a5f55127d8be505c16a2747c38d823268e7fe6f6455ced79052b6c510a318e0c0de1

data/.travis.yml

@@ -3,3 +3,5 @@ rvm:
   - 1.9.3
   - 2.0.0
   - 2.2.3
+
+before_install: gem install bundler -v ">= 1.10.0" --conservative

data/README.md

@@ -15,80 +15,80 @@ calls. This is handy for list comprehension and case statements.
 `its` and `it` extend the Symbol#to_proc idiom to support chaining multiple
 methods.
 
-The pure Ruby way to chain methods when iterating through a list would be:
+When performing a list comprehension ruby, you can use a block argument:
+
 
 ```ruby
-users.map{|user| user.contact}.map{|contact| contact.last_name}.map{|name| name.capitalize}
+users.map{ |user| user.contact }
 ```
 
-Using `Symbol#to_proc`, this becomes simpler (at the cost of generating intermediate arrays):
+Or, to avoid needing the block and and extra parameter, you can use the `Symbol#to_proc` shortcut:
 
 ```ruby
-users.map(&:contact).map(&:last_name).map(&:capitalize)
+users.map &:contact
 ```
 
-And using `its`, this becomes becomes simpler still:
+But if you want to chain several methods, such as:
 
 ```ruby
-users.map(&its.contact.last_name.capitalize)
+users.map{ |user| user.contact.last_name.capitalize }
 ```
 
-Note that `its` captures arguments and blocks, allowing you to do things like
+The `Symbol#to_proc` shortcut doesn't help much.  At best, if you're willing to accept intermediate arrays, you can do:
 
 ```ruby
-users.map(&its.contact.last_name[0,3].capitalize)
+users.map(&:contact).map(&:last_name).map(&:capitalize)
 ```
 
-or
+To improve the situation, this gem provides a Kernel method `its`, which lets you get the same shortcut advantages as `Symbol#to_proc` but supports chaining:
 
 ```ruby
-users.select(&its.addresses.any? { |address| airline.flies_to address.city })
+users.map &its.contact.last_name.capitalize
 ```
 
+Also, `its` supports arguments and blocks, allowing you to do things like
+
+```ruby
+users.map &its.contact.last_name[0,3].capitalize
+users.select &its.contact.last_name.length > 10
+users.select(&its.addresses.any? { |address| airline.flies_to address.city })
+```
 
-`it` is an alias for `its`, to use with methods that describe actions rather
-than posessives. For example:
+As a syntactic sugar, `it` is an alias for `its`, to use with methods that describe actions rather than posessives. For example:
 
 ```ruby
-items.map(&it.to_s.capitalize)
+items.map &it.to_s.capitalize
 ```
 
+### Hash comprehensions
+
 When used with hash comprehensions, the `|key, val|` pair of arguments are presented to `its` as an array.  E.g.
 
 ```ruby
-{dogs: 1, cats: 2, goats:3}.select &it[1].even? # => {cats: 2}
+{dogs: 1, cats: 2, goats:3}.select &its[1].even? # => {cats: 2}
 ```
 
 ## Case statements
 
-`its` and `it` likewise extend Ruby's `case` statement to support testing
-arbitrary methods, minimizing the need to create temporary variables and use
-`if-elsif` constructs.
-
-In pure Ruby, doing comparisons on computed values would be done something
-like this:
+`its` and `it` similarly extend Ruby's `case` mechanism to support testing
+arbitrary methods, minimizing the need to create temporary variables.  That is, instead of:
 
 ```ruby
 maxlen = arrays.map(&size).max
-if maxlen > 10000
-    "too big"
-elsif maxlen < 10
-    "too small"
-else
-    "okay"
+case
+when maxlen > 10000 then "too big"
+when maxlen < 10    then "too small"
+else                     "okay"
 end
 ```
 
-But using `it` this becomes:
+You can use `it`:
 
 ```ruby
 case arrays.map(&size).max
-when it > 1000
-    "too big"
-when it < 10
-    "too small"
-else
-    "okay"
+when it > 1000 then "too big"
+when it < 10   then "too small"
+else                "okay"
 end
 ```
 
@@ -104,8 +104,8 @@ end
 
 ## Under the hood
 
-The `ItsIt::It` class uses `method_missing` to capture and queue up all
-methods and their arguments, with the exception of `:to_proc` and `:===` (and
+The `it` method creates an instance of the `ItsIt::It` class, which uses `method_missing` to capture and queue up all
+methods and their arguments except for `:to_proc` and `:===` (and
 also excepting `:respond_to? :to_proc` and `:respond_to? :===`).
 
 `:to_proc` returns a proc that will evaluate the method queue on a given
@@ -136,6 +136,7 @@ Tested on MRI ruby 1.9.3, 2.0.0 and 2.2.3
 
 Release Notes
 
+* 1.2.1 Don't leak all of ItsIt into main, just ItsIt::Kernel.  Thanks to [klg](https://github.com/kjg)
 * 1.2.0 Add support for Hash comprehensions; drop support for ruby 1.8.7
 * 1.1.1 Remove dependency on BlankSlate
 

data/lib/its-it.rb

@@ -4,5 +4,4 @@ require 'its-it/it'
 require 'its-it/kernel'
 require 'its-it/version'
 
-include ItsIt
 include ItsIt::Kernel

data/lib/its-it/version.rb

@@ -1,3 +1,3 @@
 module ItsIt
-  VERSION = "1.2.0"
+  VERSION = "1.2.1"
 end

data/spec/main_spec.rb

@@ -0,0 +1,11 @@
+require File.dirname(__FILE__) + "/spec_helper"
+
+describe Object do
+  it "doesn't get ItsIt's version" do
+    expect(defined?(::VERSION)).to be_nil
+  end
+
+  it "does't get the It class" do
+    expect(defined?(::It)).to be_nil
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: its-it
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Ronen Barzel
@@ -125,6 +125,7 @@ files:
 - lib/its-it/kernel.rb
 - lib/its-it/version.rb
 - spec/it_spec.rb
+- spec/main_spec.rb
 - spec/rspec_compatibility_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/ronen/its-it
@@ -146,11 +147,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.7
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5.1
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 3
 summary: Defines its() and it() method-chain proxies.
 test_files:
 - spec/it_spec.rb
+- spec/main_spec.rb
 - spec/rspec_compatibility_spec.rb
 - spec/spec_helper.rb