finishing_moves 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 70d5165e29dbddcb1383c9216698d22a734e8394
-  data.tar.gz: 0a7bea820fa4b2a2423f20f43ab2ca9243393dd8
+  metadata.gz: 7edf17bb22f39f2a5ef98ff9a636605c0dfc0772
+  data.tar.gz: 9f60832e76dfa4d8738844398bfef705dc76a059
 SHA512:
-  metadata.gz: 823eb4ebc4605b5cad2e3dcfb1ed2609ffb789bd5169c8c9d59bce26733924f125844148a7478a555e8afe5da9556c106e8aa50c867c0e44862f720747a75f20
-  data.tar.gz: 308f6cc084cb11a58e110021e2dc73967cd4db7e51eeb3bb57ff41f7b95d8e0f86819a544f1e1fc94b6a7e7caff600aa65177bfe0344c49d0aa70f0ebf30c922
+  metadata.gz: 89e13ebcf8b735570055a2d1a3270989b9424f2c47947c1f1c59af6451c1c2fa6ebc6b2ac92d93160bc1154738db2891110e269143deaae90173eee0498a1cdb
+  data.tar.gz: 16e94f9abb4f914aaff7b37cacc9734ae07269a52d2eae05848648ab9e67e4833cc97a662cb24c629f541fcfd6b783db40f5eddb906f77772d05e53481ce442a

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    finishing_moves (0.1.0)
+    finishing_moves (0.1.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -8,17 +8,25 @@ In gamer terms, if standard Ruby methods are your default moves, `finishing_move
 
 ## Development approach
 
-- **Never** override default Ruby behavior, only add functionality. No hacks.
+- **Never** override default Ruby behavior, only add functionality.
 - Follow the Unix philosophy of *"Do one job really well."*
 - Minimize assumptions within the method, e.g. avoid formatting output, mutating values, and long conditional logic flows.
 - Test all the things.
 
 ## Installation
 
+Gemfile
 ```
-(Gemification coming soon!)
+gem 'finishing_moves'
 ```
 
+Command line
+```
+gem install 'finishing_moves'
+```
+
+[Here's the gem link](https://rubygems.org/gems/finishing_moves), if you like looking at that stuff.
+
 ## Current Finishers
 
 ### Extensions to `Object`
@@ -204,9 +212,6 @@ var = nil_chain(Geomancer.reset_ley_lines) { summon_fel_beast[:step_3].scry }
 
 `nil_chain` is aliased to `chain` for more brevity, and `method_chain` for alternative clarity.
 
-
----
-
 #### `Object#bool_chain`
 
 This is the same logic under the hood as `nil_chain`, however we forcibly return a boolean `false` instead of `nil` if the chain breaks.
@@ -225,8 +230,6 @@ nil_chain(false) { a.b.c.hello }
 # => false
 ```
 
----
-
 #### `Object#same_as`
 
 Comparison operator that normalizes both sides into strings, then runs them over `==`.
@@ -283,8 +286,6 @@ user.same_as 'FACELESS_ONE'
 # => false
 ```
 
----
-
 #### `Object#class_exists?`
 
 > *I just want to know if [insert class name] has been defined!*
@@ -329,8 +330,6 @@ class_exists? :DefinitelyFakeClass
 # => false (at least it better be; if you actually use this name, I will find you...)
 ```
 
----
-
 #### `Object#not_nil?`
 
 Because that dangling `!` on the front of a call to `nil?` is just oh so not-ruby-chic.
@@ -342,9 +341,7 @@ nil.not_nil?
 # => true
 ```
 
-There, much more legible. Now pass me my fedora and another PBR.
-
----
+Much better. Now pass me another PBR and my fedora.
 
 ### Extensions to `Hash`
 
@@ -373,8 +370,6 @@ power_rangers.delete! :radiant_orchid
 #    It probably would've triggered if I included Kimberly
 ```
 
----
-
 #### `Hash#delete_each`
 Deletes all records in a hash matching the keys passed in as an array. Returns a hash of deleted entries. Silently ignores any keys which are not found.
 
@@ -397,8 +392,6 @@ mega_man_bosses
 # => { :wood_man => 4 }
 ```
 
----
-
 #### `Hash#delete_each!`
 
 Same logic as `delete_each`, but return the modified hash, and discard the deleted values.
@@ -419,11 +412,9 @@ mega_man_bosses.delete_each! :crash_man, :quick_man
 # => { }
 ```
 
----
-
 ### `Fixnum#length` and `Bignum#length`
 
-Ruby doesn't provide a native way to see how many digits are in an integer, but that's exactly what we worry about anytime out database `INT` lengths collide with Ruby `Fixnum` or `Bignum` values.
+Ruby doesn't provide a native way to see how many digits are in an integer, but that's exactly what we worry about anytime database `INT` lengths collide with Ruby `Fixnum` or `Bignum` values.
 
 ```ruby
 1.length
@@ -459,17 +450,17 @@ For consistency, we added matching methods to `Float` and `BigDecimal` that simp
 # => ArgumentError: Cannot get length: "1.2654377184388666e+21" is not an integer
 ```
 
----
-
 ### Typecasting *to* `Boolean`
 
 Boolean values are frequently represented as strings and integers in databases and file storage. So we always thought it was a little odd that Ruby lacked a boolean typecasting method, given the proliferation of `to_*` methods for `String`, `Symbol`, `Integer`, `Float`, `Hash`, etc.
 
-So we made one for strings and integers.
+So we made one for strings, integers, and nil.
 
 #### `String#to_bool`
 
-Strings get analyzed and return true/false for a small set of potential values. These comparisons are case-insensitive.
+Strings get analyzed and return `true` or `false` for a small set of potential values.
+
+These comparisons are not case-sensitive.
 
 ```ruby
 ['1', 't', 'true', 'on', 'y', 'yes'].each do |true_string|
@@ -498,7 +489,7 @@ end
 A string with anything other than these matching values will throw an error.
 
 ```ruby
-["foo", "tru", "trueish", "druish", "000"].each do |bad_string|
+["foo", "tru", "trueish", "druish", "00", "000"].each do |bad_string|
   bad_string.to_bool
   # => ArgumentError: invalid value for Boolean
 end
@@ -506,7 +497,7 @@ end
 
 #### `Fixnum#to_bool`
 
-A zero is false, a one is true. That's it. Everything else throws `ArgumentError`
+A zero is false, a one is true. That's it. Everything else throws `ArgumentError`.
 
 ```ruby
 0.to_bool
@@ -542,7 +533,7 @@ nil.to_bool == false
 
 #### `TrueClass#to_bool` and `FalseClass#to_bool`
 
-They return what you expect, we added them simply for sake of consistency, in case your code calls `to_bool` on a variable of indeterminate type.
+In case your code calls `to_bool` on a variable of indeterminate type, they return what you expect.
 
 ```ruby
 true.to_bool
@@ -552,11 +543,9 @@ false.to_bool
 # => false
 ```
 
----
-
 ### Typecasting *from* `Boolean` and `Nil`
 
-Complementing the methods to typecast boolean values coming out of data storage, we have methods to convert booleans and `nil` into string and symbol representations.
+Complementing the methods to typecast boolean values coming out of data storage, we have methods to convert booleans and `nil` into integer and symbol representations.
 
 ```ruby
 true.to_i
@@ -570,33 +559,31 @@ false.to_sym
 # => :false
 
 nil.to_i
-# => 0 (follows same logic as `NilClass#to_bool`)
+# => 0 (following same logic as `NilClass#to_bool`)
 nil.to_sym
 # => :nil
 ```
 
-## Share your finishing moves!
-
-### Got an idea for another finisher?
+## Add your own finisher!
 
 1. Fork this repo
 2. Write your tests
 3. Add your finisher
-4. Repeat steps 2 and 3 until badass
+4. Repeat steps 2 and 3 until you see a brilliant luster
 5. Submit a pull request
-6. Everyone kicks even more ass!
 
 ###### Got a good nerdy reference for our code samples?
 We'll take pull requests on those too. Bonus karma points if you apply the reference to the specs too.
 
-## License
+## Credits
 
-Finishing Moves is distributed under MIT license.
+![forge software](http://www.forgecrafted.com/logo.png)
 
-Copyright (c) 2015 Forge Software, LLC
+Finishing Moves is maintained and funded by [Forge Software (forgecrafted.com)](http://www.forgecrafted.com)
 
-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:
+If you like our code, please give us a hollar if your company needs outside pro's who write damn-good code AND run servers at the same time!
 
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+## License
 
-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.
+Finishing Moves is Copyright 20XX (that means "forever") Forge Software, LLC. It is free software, and may be
+redistributed under the terms specified in the LICENSE file.

data/finishing_moves.gemspec

@@ -12,8 +12,6 @@ Gem::Specification.new do |s|
   s.summary     = %q{Small, focused, incredibly useful methods added to core Ruby classes.}
   s.description = <<-EOF
     Ruby includes a huge amount of default awesomeness that tackles most common development challenges. But every now and then, you find yourself in a situation where an elaborate-yet-precise coding maneuver wins the day. Finishing Moves is a collection of methods designed to assist in those just-typical-enough-to-be-annoying scenarios.
-
-    In gamer terms, if standard Ruby methods are your default actions, finishing_moves would be mana-consuming techniques. Your cooldown spells. Your grenades (there's never enough grenades). In the right situation, they kick serious cyclomatic butt.
   EOF
   s.homepage    = "https://github.com/forgecrafted/finishing_moves"
   s.license     = "MIT"

data/lib/finishing_moves/object.rb

@@ -10,7 +10,6 @@ class Object
       return ret_val
     end
   end
-  alias_method :chain, :nil_chain
   alias_method :method_chain, :nil_chain
 
   def bool_chain(&block)
@@ -38,5 +37,11 @@ class Object
     end
   end
 
+  def cascade(&block)
+    loop do
+      yield
+      break
+    end
+  end
 
 end

data/lib/finishing_moves/version.rb

@@ -1,3 +1,3 @@
 module FinishingMoves
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: finishing_moves
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Frank Koehl
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-17 00:00:00.000000000 Z
+date: 2014-12-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rb-readline
@@ -83,8 +83,6 @@ dependencies:
         version: '0'
 description: |2
       Ruby includes a huge amount of default awesomeness that tackles most common development challenges. But every now and then, you find yourself in a situation where an elaborate-yet-precise coding maneuver wins the day. Finishing Moves is a collection of methods designed to assist in those just-typical-enough-to-be-annoying scenarios.
-
-      In gamer terms, if standard Ruby methods are your default actions, finishing_moves would be mana-consuming techniques. Your cooldown spells. Your grenades (there's never enough grenades). In the right situation, they kick serious cyclomatic butt.
 email:
 - frank@forgecrafted.com
 - chris@forgecrafted.com