ifelse 0.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c7d4796475dd02819829cd329f5dcdc739a0a114
+  data.tar.gz: 0b22f61f3a82a23ad5909fb746db0a7a3d4f6310
+SHA512:
+  metadata.gz: 748f230f79de2900a8f3f8e4ac5344513537671a5dcb7f33899ad4cd8af73f9366ef49b80c49c988c7e78a651e891d6adf9f19a3c46ebc66231ea29dd745e228
+  data.tar.gz: eca45115ca0d77196bec9ee28b463d108fd726ab616c5f74b23b755f504a0af89d32d73b12b13030454c6469da8c34b9d1957620946e08c944459129ed629a97

data/.autotest

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+# Autotest.add_hook :initialize do |at|
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/History.txt

@@ -0,0 +1,4 @@
+=== 0.6.0 / 2013-12-17
+
+* Initial release
+

data/Manifest.txt

@@ -0,0 +1,8 @@
+.autotest
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+bin/ifelse
+lib/ifelse.rb
+test/test_ifelse.rb

data/README.rdoc

@@ -0,0 +1,171 @@
+= ifelse
+
+https://github.com/jimwise/ifelse
+
+Author::    Jim Wise  (mailto:jwise@draga.com)
+Copyright:: Copyright (c) 2013 Jim Wise
+License::   2-clause BSD-Style (see LICENSE.txt)
+
+== DESCRIPTION:
+
+IfElse is an implementation of the pure object-oriented conditional syntax
+found in languages of the SmallTalk family, including Self.  Those languages
+distinguish themselves by taking the "everything is an object / everything
+is a method" approach to a further extreme than Ruby, and getting rid of
+almost all cases of special syntax other than object definition and method
+call.
+
+Ruby, of course, already works this way for some purposes -- thus most Ruby
+developers prefer to write
+
+  [1, 17, 39].each {|x| puts x}
+
+rather than
+
+  for x in [1, 17, 39]
+    puts x
+  end
+
+and
+
+  3.times {|n| puts n}
+
+instead of
+
+  i = 1
+  while i <= 3
+    puts i
+    i += 1
+  end
+
+This module extends that same preference to conditional statements,
+providing replacements for the Ruby keywords +if+, and +unless+:
+
+  x = 1
+  (x >= 0).if {puts 'positive'}
+  (x < 0).unless {puts 'positive'}
+
+Note that as with the built-in special forms these methods replace, these
+methods are available on any Ruby Object, and obey the usual rules of which
+values are considered "Truthy" and "Falsey".
+
+<b>Note that the primary purpose of this gem is to demonstrate that the
+built-in (special form) versions of conditionals provided with Ruby are
+mostly syntactic sugar -- as with the +for+ keyword, there is no real need
+for these to be built into the language.  With that said, the gem is
+fully tested, has no particular performance penalty (beyond the usual cost
+of method dispatch), and should be fully useable in general purpose
+code.</b>
+
+<b>Note also that while Smalltalk-family languages also provide an
+equivalent to the Ruby +else+ keyword, this depends on the more general
+block/lambda capability of those languages, which allow a method to take
+multiple blocks as arguments.  This could be imitated with a syntax like:</b>
+
+  # NOT A REAL EXAMPLE
+  (x > 42).if then: lambda {|x| :big }, else: lambda {|x| :small}
+
+<b>which is true to the SmallTalk original, but feels less Ruby-ish to me, so I
+didn't implement this -- perhaps in a later version.</b>
+
+== REQUIREMENTS:
+
+IfElse has been tested on Ruby 1.9.3 and above (including 2.0.0), though it
+should work fine on earlier versions (drop me an email[mailto:jwise@draga.com]
+if you try it out there).  IfElse has no other dependencies.
+
+== DETAILS:
+
+=== Basic Usage
+
+This class provides two methods, implemented on every ruby Object (but see
+NOTES, below):
+
++#if+:: This method takes a block, which will be executed only if the object
+        it is called on has a "Truthy" value (neither +false+ nor +nil+ --
+        but see	 below).  The block may take one argument, which will be
+        passed the value which was tested, if present.  The return value of
+        this method is the value of the block, if it is invoked, or the
+        original (Falsey) value the method was called on otherwise. For
+        example:
+        
+          h[:foo].if {|x| puts x}       # outputs the value of h[:foo], if present
+
++#unless+:: This method takes a block, which will be executed only if the
+            object it is called on has a "Falsey" value (either +false+ or +nil+
+            -- but see below).  The block may take one argument, which will be
+            passed the value which was tested, if present.  The return value of
+            this method is the value of the block, if it is invoked, or the
+            original (Truthy) value the method was called on otherwise. For
+            example:
+            
+              h[:bar].unless {|x| puts 'missing'} # outputs 'missing' if key :bar
+                                      # is not present in h
+
+=== Advanced Usage
+
+As a demonstration of the added flexibility provided by replacing special
+syntax with an object-oriented approach, this gem provides one additional
+feature:  <b>when defining a class, you may decide for yourself whether values
+of that class should be considered "Truthy" or "Falsey"</b>.
+
+This is done by including the Modules +IfElse::TrueIfBehavior+ or
++IfElse::FalseIfBehavior+ in your class (of course, values other than
+'false' and 'nil' are true by default, so you will normally only need to use
+the latter.  For example, after:
+
+  class List
+     ...
+  end
+
+  class Empty List < List
+    include IfElse::FalseIfBehavior
+
+    ...
+  end 
+
+Values of class +EmptyList+ are now Falsey for the purposes of #if and
+#unless, while values of type +List+ remain Truthy.
+
+=== NOTES:
+
+[*] That is, any subclass of Object -- these forms are not available on
+    classes which only subclass BasicObject, to ease implementation.
+
+== INSTALL:
+
+  $ gem install ifelse
+
+== DEVELOPERS:
+
+After checking out the source, run:
+
+  $ rake newb
+
+This task will install any missing dependencies, run the tests/specs,
+and generate the RDoc.
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2013 FIX
+
+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/Rakefile

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+# Hoe.plugin :compiler
+# Hoe.plugin :gem_prelude_sucks
+# Hoe.plugin :inline
+# Hoe.plugin :minitest
+# Hoe.plugin :racc
+# Hoe.plugin :rcov
+# Hoe.plugin :rubyforge
+
+Hoe.spec 'ifelse' do
+  developer 'Jim Wise', 'jwise@draga.com'
+  license 'BSD'
+  self.readme_file = 'README.rdoc'
+end
+
+# vim: syntax=ruby

data/bin/ifelse

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+abort "you need to write me"

data/lib/ifelse.rb

@@ -0,0 +1,40 @@
+module IfElse
+  VERSION = '0.6.0'
+
+  module TrueIfBehavior
+    def if
+      raise "Syntax Error: if without block" unless block_given?
+      yield self
+    end
+
+    def unless
+      raise "Syntax Error: unless without block" unless block_given?
+      false
+    end
+  end
+
+  module FalseIfBehavior
+    def if
+      raise "Syntax Error: if without block" unless block_given?
+      self
+    end
+
+    def unless
+      raise "Syntax Error: unless without block" unless block_given?
+      yield self
+    end
+  end
+end
+
+
+class Object
+  include IfElse::TrueIfBehavior
+end
+
+class FalseClass
+  include IfElse::FalseIfBehavior
+end
+
+class NilClass
+  include IfElse::FalseIfBehavior
+end

data/test/test_ifelse.rb

@@ -0,0 +1,32 @@
+require "test/unit"
+require "ifelse"
+
+class TestIfElse < Test::Unit::TestCase
+
+  def test_if
+    assert_equal 42, true.if {42}
+    assert_equal 42, 3.if {42}
+    assert_false false.if {42}
+  end
+
+  def test_unless
+    assert_false true.unless {42}
+    assert_false 3.unless {42}
+    assert_equal 42, false.unless {42}
+  end
+
+  def test_errors
+    assert_raise { true.if }
+    assert_raise { false.if }
+  end
+
+  def test_readme
+    x = 1
+    assert_equal 'positive', (x >= 0).if {'positive'}
+    assert_equal 'positive', (x < 0).unless {'positive'}
+
+    h = {a: 42}
+    assert_equal 42, h[:a].if {|n| n}
+    assert_equal 'missing', h[:b].unless {'missing'}
+  end
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification
+name: ifelse
+version: !ruby/object:Gem::Version
+  version: 0.6.0
+platform: ruby
+authors:
+- Jim Wise
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+description: |-
+  IfElse is an implementation of the pure object-oriented conditional syntax
+  found in languages of the SmallTalk family, including Self.  Those languages
+  distinguish themselves by taking the "everything is an object / everything
+  is a method" approach to a further extreme than Ruby, and getting rid of
+  almost all cases of special syntax other than object definition and method
+  call.
+
+  Ruby, of course, already works this way for some purposes -- thus most Ruby
+  developers prefer to write
+
+    [1, 17, 39].each {|x| puts x}
+
+  rather than
+
+    for x in [1, 17, 39]
+      puts x
+    end
+
+  and
+
+    3.times {|n| puts n}
+
+  instead of
+
+    i = 1
+    while i <= 3
+      puts i
+      i += 1
+    end
+
+  This module extends that same preference to conditional statements,
+  providing replacements for the Ruby keywords +if+, and +unless+:
+
+    x = 1
+    (x >= 0).if {puts 'positive'}
+    (x < 0).unless {puts 'positive'}
+
+  Note that as with the built-in special forms these methods replace, these
+  methods are available on any Ruby Object, and obey the usual rules of which
+  values are considered "Truthy" and "Falsey".
+
+  <b>Note that the primary purpose of this gem is to demonstrate that the
+  built-in (special form) versions of conditionals provided with Ruby are
+  mostly syntactic sugar -- as with the +for+ keyword, there is no real need
+  for these to be built into the language.  With that said, the gem is
+  fully tested, has no particular performance penalty (beyond the usual cost
+  of method dispatch), and should be fully useable in general purpose
+  code.</b>
+
+  <b>Note also that while Smalltalk-family languages also provide an
+  equivalent to the Ruby +else+ keyword, this depends on the more general
+  block/lambda capability of those languages, which allow a method to take
+  multiple blocks as arguments.  This could be imitated with a syntax like:</b>
+
+    # NOT A REAL EXAMPLE
+    (x > 42).if then: lambda {|x| :big }, else: lambda {|x| :small}
+
+  <b>which is true to the SmallTalk original, but feels less Ruby-ish to me, so I
+  didn't implement this -- perhaps in a later version.</b>
+email:
+- jwise@draga.com
+executables:
+- ifelse
+extensions: []
+extra_rdoc_files:
+- History.txt
+- Manifest.txt
+- README.rdoc
+files:
+- ".autotest"
+- History.txt
+- Manifest.txt
+- README.rdoc
+- Rakefile
+- bin/ifelse
+- lib/ifelse.rb
+- test/test_ifelse.rb
+- ".gemtest"
+homepage: https://github.com/jimwise/ifelse
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.rdoc
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: ifelse
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: IfElse is an implementation of the pure object-oriented conditional syntax
+  found in languages of the SmallTalk family, including Self
+test_files:
+- test/test_ifelse.rb