no_conditionals 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b7c19ed19ce85ee0c791b543837920b743d92378
+  data.tar.gz: 5cdd188d84ae5b8a93d31869a943bb84e9bc7d14
+SHA512:
+  metadata.gz: 71ee521865241d45d263de67a227199bede9c5ffff9091dea4fe86a265b1da227bd459ab060222e717e6f327bdc197dc59e90a1af83c3315b3228484df57dbfc
+  data.tar.gz: 881be1d1e812634f9a79e49641c9c8059dc4bf708ffab8b449690defa64ed7aa28ab0e2520f7883bb1cd2be44f3723e805295f3492145a7024400af57ecb671d

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 2.3.0
+  - 2.2.4
+  - 2.1.8
+  - 2.1.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in no_conditionals.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2016 Ritchie Paul Buitre
+
+MIT License
+
+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:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+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.

data/README.md

@@ -0,0 +1,188 @@
+# NoConditionals
+
+Because conditional statements, such as 'if-then-else', belong to lower levels of abstraction (ie. libraries or frameworks), and not in higher level domains like your application. This gem provides extentions for "Truthy" and "Falsey" classes with expressive yet Ruby idiomatic operations.
+
+## Getting started
+
+Make sure you have Ruby 2.1 or above, and then add this line to your application's Gemfile:
+
+```ruby
+gem 'no_conditionals'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install no_conditionals
+
+
+## Monkey patching Rails application
+This library uses refinement to extend objects. Alternatively, you may also do the following:
+
+Save this code to the Rails application folder as 'config/initializers/no_conditionals.rb'.
+```ruby
+# config/initializers/no_conditionals.rb
+
+Object.class_eval do
+  include NoConditionals::Truthiness
+end
+
+NilClass.class_eval do
+  include NoConditionals::Falseyness
+end
+
+FalseClass.class_eval do
+  include NoConditionals::Falseyness
+end
+```
+And then restart the server.
+
+## Usage
+
+### #hence method
+Evaluates block if "Truthy" otherwise returns "Falsey"
+```ruby
+using NoConditionals
+
+true.hence { "Yes" }
+# => "Yes"
+
+false.hence { "Yes" }
+# => false
+
+nil.hence { "Yes" }
+# => nil
+
+[1,2,3,4,5].find {|n| n.odd? }.hence {|odd| "found #{odd}" }
+# => "found 1"
+
+names = ["", "Ruby", "Smalltalk", nil ]
+names.first.hence(&:empty?)
+# => true
+```
+### #otherwise method
+Returns self if "Truthy" otherwise evaluates block.
+```ruby
+using NoConditionals
+
+true.otherwise { "No" }
+# => true
+
+false.otherwise { "No" }
+# => "No"
+
+nil.otherwise { "No" }
+# => "No"
+```
+### #maybe method
+Returns first argument if "Truthy". If "Falsey" it either returns second argument or returns "Falsey" when only one argument.
+```ruby
+using NoConditionals
+
+(3 > 2).maybe "Yes", maybe: "No"
+# => "Yes"
+
+(1 > 2).maybe "Yes", maybe: "No"
+# => "No"
+
+true.maybe "Yes"
+# => "Yes"
+
+false.maybe "Yes"
+# => false
+
+nil.maybe "Yes"
+# => nil
+```
+
+### #maybe! method
+Calls first argument if "Truthy". If "Falsey" it either calls second argument or calls nothing when only one argument.
+```ruby
+using NoConditionals
+
+(3 > 2).maybe! -> { puts "True"  }, maybe: -> { puts "False"  }
+# True
+# => nil
+
+(1 > 2).maybe! -> { puts "True"  }, maybe: -> { puts "False"  }
+# False
+# => nil
+
+true.maybe! -> { puts "True"  }
+# True
+# => nil
+
+false.maybe! -> { puts "True"  }
+# => nil
+
+nil.maybe! -> { puts "True"  }
+# => nil
+```
+
+## Sample codes
+
+### Replacing if-else conditions in controllers
+```ruby
+class SessionsController
+  # ...
+  using NoConditionals
+
+  def create
+    user = User.find_by_email params[:email]
+    user
+      .authenticate(params[:password])
+      .hence { logged_in(user) }
+      .otherwise { unauthenticated }
+  end
+  # ...
+end
+```
+
+### Extending models and null objects
+```ruby
+class User
+  include NoConditionals::Truthiness
+  # ...
+end
+
+class MissingUser
+  include NoConditionals::Falseyness
+  # ...
+end
+```
+
+### Replacing Object#try() in Rails application views
+```erb
+<%= @article.author.hence(&:name).otherwise {  "Anonymous"  } %>
+
+<%= current_user
+      .hence(&:admin?)
+      .hence { link_to 'Edit, edit_article_path(@article) }
+      .otherwise { 'Read Only' } %>
+```
+### Chaining methods
+```ruby
+class WeatherService
+  using NoConditionals
+
+  def weather_for(report)
+     report
+       .hence( &:source )
+       .hence( &:location )
+       .hence( &:city )
+       .hence( &:weather )
+       .otherwise { 'unknown weather' }
+  end
+end
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/RichOrElse/no-conditionals/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+end
+
+task :default => :test
+

data/lib/no_conditionals/version.rb

@@ -0,0 +1,3 @@
+module NoConditionals
+  VERSION = "1.0.0"
+end

data/lib/no_conditionals.rb

@@ -0,0 +1,65 @@
+require "no_conditionals/version"
+
+# Refines truthy and falsey types
+module NoConditionals
+
+  # Mixin for truthy behavior
+  module Truthiness
+
+    # evaluates a block, passes object
+    def hence
+      yield self
+    end
+
+    # just returns object, ignores block
+    def otherwise
+      self
+    end
+
+    # just returns first parameter (so), ignores optional second parameter (maybe)
+    def maybe so, maybe: self
+      so
+    end
+
+    # calls first parameter (so)
+    def maybe! so, maybe: -> {}
+      so.call
+    end
+  end
+
+  # Mixin for falsey behavior
+  module Falseyness
+
+    # just returns object, ignores block
+    def hence
+      self
+    end
+
+    # evaluates a block
+    def otherwise
+      yield self
+    end
+
+    # ignores first parameter (so), returns either object or keyword argument (maybe)
+    def maybe so, maybe: self
+      maybe
+    end
+
+    # calls keyword argument (maybe) or nothing
+    def maybe! so, maybe: -> {}
+      maybe.call
+    end
+  end
+
+  refine Object do
+    include Truthiness
+  end
+
+  refine NilClass do
+    include Falseyness
+  end
+
+  refine FalseClass do
+    include Falseyness
+  end
+end

data/no_conditionals.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'no_conditionals/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "no_conditionals"
+  spec.version       = NoConditionals::VERSION
+  spec.authors       = ["Ritchie Paul Buitre"]
+  spec.email         = ["ritchie@richorelse.com"]
+  spec.summary       = %q{A support library, to aid in eliminating conditionals from application code, for Ruby 2.1 and above.}
+  spec.description   = %q{Because conditional statements, such as 'if-then-else', belong to lower levels of abstraction (ie. libraries or frameworks), and not in higher level domains like your application. This gem provides extentions for "Truthy" and "Falsey" classes with expressive yet Ruby idiomatic operations.}
+  spec.homepage      = "https://github.com/RichOrElse/no-conditionals"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+  spec.required_ruby_version = ">= 2.1"
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+end

data/test/minitest_helper.rb

@@ -0,0 +1,5 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'no_conditionals'
+
+require 'minitest/spec'
+require 'minitest/autorun'

data/test/test_no_conditionals.rb

@@ -0,0 +1,31 @@
+require 'minitest_helper'
+
+class TestNoConditionals < Minitest::Test
+  def test_that_it_has_a_version_number
+    refute_nil ::NoConditionals::VERSION
+  end
+
+  using NoConditionals
+
+  def test_it_refines_truthy_types
+    [ [], {}, "", 100, 0.5, 1..20, true, (3 > 2) ].each do |truthy|
+      assert_equal 'Yes', truthy.maybe!(-> {'Yes'})
+      assert_equal 'Yes', truthy.maybe!(-> {'Yes'}, maybe: -> {'No'})
+      assert_equal 'Yes', truthy.maybe('Yes')
+      assert_equal 'Yes', truthy.maybe('Yes', maybe: 'No')
+      assert_equal 'Yes', truthy.hence { 'Yes' }
+      assert_equal truthy, truthy.otherwise { 'No' }
+    end
+  end
+
+  def test_it_refines_falsey_types
+    [ nil, false, (1 > 2)].each do |flsy|
+      assert_equal nil, flsy.maybe!(-> {'Yes'})
+      assert_equal 'No', flsy.maybe!(-> {'Yes'}, maybe: -> {'No'})
+      assert_equal flsy, flsy.maybe('Yes')
+      assert_equal 'No', flsy.maybe('Yes', maybe: 'No')
+      assert_equal flsy, flsy.hence { 'Yes' }
+      assert_equal 'No', flsy.otherwise { 'No' }
+    end
+  end
+end

data/test/test_no_conditionals_falseyness.rb

@@ -0,0 +1,53 @@
+require 'minitest_helper'
+
+describe NoConditionals::Falseyness do
+  before do
+    @falsey = Object.new.extend NoConditionals::Falseyness
+  end
+
+  describe "#hence" do
+    it "just returns itself" do
+      @falsey.hence { :yes }.must_be_same_as @falsey
+      @falsey.hence { |falsey| :yes }.must_be_same_as @falsey
+    end
+  end
+
+  describe "#otherwise" do
+    it "evaluates block" do
+      @falsey.otherwise { :no }.must_be_same_as :no
+      @falsey.otherwise { |falsey| falsey }.must_be_same_as @falsey
+    end
+  end
+
+  describe "#maybe with one argument" do
+    it "returns itself" do
+      @falsey.maybe(:yes).must_be_same_as @falsey
+    end
+  end
+
+  describe "#maybe with two arguments" do
+    it "returns last argument" do
+      @falsey.maybe(:yes, maybe: :no).must_be_same_as :no
+    end
+
+    it "raises error for wrong keyword argument" do
+      -> { @falsey.maybe :yes, otherwise: :no }.must_raise ArgumentError
+    end
+  end
+
+  describe "#maybe! with one argument" do
+    it "calls nothing" do
+      @falsey.maybe!(-> { :yes }).must_be_same_as nil
+    end
+  end
+
+  describe "#maybe! with two arguments" do
+    it "calls last argument" do
+      @falsey.maybe!(-> { :yes }, maybe: -> { :no }).must_be_same_as :no
+    end
+
+    it "raises error for wrong keyword argument" do
+      -> { @falsey.maybe! -> { :yes }, otherwise: -> { :no } }.must_raise ArgumentError
+    end
+  end
+end

data/test/test_no_conditionals_truthiness.rb

@@ -0,0 +1,43 @@
+require 'minitest_helper'
+
+describe NoConditionals::Truthiness do
+  before do
+    @truthy = Object.new.extend NoConditionals::Truthiness
+  end
+
+  describe "#hence" do
+    it "evaluates a block" do
+      @truthy.hence { :yes }.must_be_same_as :yes
+      @truthy.hence { |truthy| truthy }.must_be_same_as @truthy
+    end
+  end
+
+  describe "#otherwise" do
+    it "just returns itself" do
+      @truthy.otherwise { :no }.must_be_same_as @truthy
+      @truthy.otherwise { |truthy| :no }.must_be_same_as @truthy
+    end
+  end
+
+  describe "#maybe" do
+    it "just returns first argument" do
+      @truthy.maybe(:yes).must_be_same_as :yes
+      @truthy.maybe(:yes, maybe: :no).must_be_same_as :yes
+    end
+
+    it "raises error for wrong keyword argument" do
+      -> { @truthy.maybe :yes, otherwise: :no }.must_raise ArgumentError
+    end
+  end
+
+  describe "#maybe!" do
+    it "calls first argument" do
+      @truthy.maybe!(-> { :yes }).must_be_same_as :yes
+      @truthy.maybe!(-> { :yes }, maybe: -> { :no }).must_be_same_as :yes
+    end
+
+    it "raises error for wrong keyword argument" do
+      -> { @truthy.maybe! -> { :yes }, otherwise: -> { :no } }.must_raise ArgumentError
+    end
+  end
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: no_conditionals
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Ritchie Paul Buitre
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Because conditional statements, such as 'if-then-else', belong to lower
+  levels of abstraction (ie. libraries or frameworks), and not in higher level domains
+  like your application. This gem provides extentions for "Truthy" and "Falsey" classes
+  with expressive yet Ruby idiomatic operations.
+email:
+- ritchie@richorelse.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/no_conditionals.rb
+- lib/no_conditionals/version.rb
+- no_conditionals.gemspec
+- test/minitest_helper.rb
+- test/test_no_conditionals.rb
+- test/test_no_conditionals_falseyness.rb
+- test/test_no_conditionals_truthiness.rb
+homepage: https://github.com/RichOrElse/no-conditionals
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.3
+signing_key: 
+specification_version: 4
+summary: A support library, to aid in eliminating conditionals from application code,
+  for Ruby 2.1 and above.
+test_files:
+- test/minitest_helper.rb
+- test/test_no_conditionals.rb
+- test/test_no_conditionals_falseyness.rb
+- test/test_no_conditionals_truthiness.rb