null 0.1

data.tar.gz.sig

@@ -0,0 +1,2 @@
+�'a���"��X�b�!�qc�P{,���]�aR�Н���n����D�B��DKX�%�R��o�0�E�|�� N�~��?��|�"�������z�<��&q��(檦%�_ יK4���Ji��A*�<��Y*�M�dm�@�J>9��_����9W�8@��%�r�]�u-r�?(<HJ*��;y`�ƅ�"1�-��w�O,wa��DŽs
+6iP����i�d�\\�,6���\����4_��c�[f�����

data/lib/null.rb

@@ -0,0 +1,181 @@
+class Object
+	# +truthy?+ is +false+ iff we are +nil+, +false+, or an instance of NullClass.
+	def truthy?
+		true
+	end
+
+	# +falsy?+ is +true+ iff we are +nil+, +false+, or an instance of NullClass.
+	def falsy?
+		false
+	end
+
+	# This is an alias for +falsy?+.
+	def !()
+		falsy?
+	end
+
+	# Are we +null+?
+	def null?
+		false
+	end
+
+	# +null.to_nil?+ returns +nil+; everything else returns +self+.
+	def to_nil?()
+		self
+	end
+
+	# +obj.tap?()+ is equivalent to +obj.tap()+ unless +obj+ is an instance of
+	# NullClass, in which case a block must still be given, but will not be
+	# executed.
+	def tap? # yield: self
+		yield(self)
+		self
+	end
+end
+
+# Make falsy things tell you so.
+module Falsiness
+	def truthy? # :nodoc:
+		false
+	end
+
+	def falsy? # :nodoc:
+		true
+	end
+
+	def !() # :nodoc:
+		true
+	end
+end
+
+# Make boolean logic work with truthiness. Note that this makes these operators
+# asymmetric in that calling boolean operators on +null+ will return +null+.
+
+class NilClass
+	include Falsiness
+	def &(obj) false end
+	def |(obj) !!obj end
+	def ^(obj) !!obj end
+end
+
+class FalseClass
+	include Falsiness
+	def &(obj) false end
+	def |(obj) !!obj end
+	def ^(obj) !!obj end
+end
+
+class TrueClass
+	def &(obj) !!obj end
+	def |(obj)  true end
+	def ^(obj)  !obj end
+end
+
+# An object including us will convert like +nil+.
+module NillishConversions
+	# +[]+
+	def to_a() [] end
+	alias to_ary to_a
+
+	# +(0+0i)+
+	def to_c() to_i.to_c end
+
+	# +0.0+
+	def to_f() to_i.to_f end
+
+	# +0+
+	def to_i() 0 end
+
+	# +"null"+
+	def to_json() 'null' end
+
+	# +nil+
+	def to_nil?() nil end
+
+	# +nil+
+	def to_param() nil end
+
+	# +(0/1)+
+	def to_r() to_i.to_r end
+	alias rationalize to_r
+
+	# +""+
+	def to_s() '' end
+	alias to_str to_s
+
+	# +nil+
+	def =~(obj) nil end
+end
+
+# Define boolean operators based on truthiness.
+module TruthyBooleanOperators
+	def &(obj) truthy? & obj end
+	def |(obj) truthy? | obj end
+	def ^(obj) truthy? ^ obj end
+end
+
+# Define +method_missing+ to return +self+.
+module RecursiveMethodMissing
+	# We always return +self+.
+	def method_missing(meth, *args)
+		self
+	end
+end
+
+# We implement the Null Object Pattern, i.e. most methods called on us will
+# return +self+. Also, boolean logical operators for +true+, +false+, and +nil+
+# have been redefined so that they depend on the +falsy?+
+class NullClass
+	include Falsiness
+	include TruthyBooleanOperators
+	include RecursiveMethodMissing
+
+	def     to_s()    nil end # +""+
+	def     nil?()   true end # :nodoc:
+	def    null?()   true end # :nodoc:
+	def   empty?()   true end # :nodoc:
+	def  to_nil?()    nil end # :nodoc:
+	def  inspect() 'null' end # +"null"+
+	def present?()  false end # :nodoc:
+
+	# Require a block, but don't use it; then return +self+.
+	def tap? # :nodoc:
+		raise(LocalJumpError, 'no block given') unless block_given?
+		self
+	end
+
+	# Make Numeric operations involving +null+ return +null+.
+	def coerce(x)
+		[null, null]
+	end
+end
+
+# VoidClass instances act like NullClass instances except
+class VoidClass < NullClass
+	include NillishConversions
+
+	# Become 0 in mathematical operations.
+	def coerce(x) to_i.coerce(x) end
+	def +(x) x end
+	def -(x) -x end
+	def *(x) x*self end
+	def /(x) to_i/x end
+
+	# +"void"+
+	def inspect
+		'void'
+	end
+end
+
+NULL = NullClass.new
+# This is an alias for +NULL+, which is an instance of NullObject.
+def null
+	NULL
+end
+
+VOID = VoidClass.new
+# +void+ is an alias for +VOID+, which is like +null+, except that its +to_*+
+# methods are like +nil+'s.
+def void
+	VOID
+end

data/test/null.rb

@@ -0,0 +1,119 @@
+#!/usr/bin/env ruby
+require_relative '../lib/null'
+require 'test/unit'
+
+class NullTest < Test::Unit::TestCase
+	TRUTHY_TEST_OBJECTS = [1024, 4.20, 4, :twenty, Class.new, Object.new, true,
+	                       method(:method), Array.new, {}, 0, 0.0]
+	NULL_TEST_OBJECTS = [null, void, NullClass.new, VoidClass.new]
+
+	TRUTHY_BOOLEAN_OBJECTS = [true]
+	GENERATED_FALSIES = [false, nil]
+	RECURSOR_TEST_OBJECTS = []
+
+	[
+		[TruthyBooleanOperators, TRUTHY_BOOLEAN_OBJECTS],
+		[Falsiness, GENERATED_FALSIES],
+		[RecursiveMethodMissing, RECURSOR_TEST_OBJECTS]
+	].each do |mod, array|
+		array << Object.new.extend(mod)
+	end
+
+	ALL_FALSIES = GENERATED_FALSIES + NULL_TEST_OBJECTS
+	NON_NULL = TRUTHY_TEST_OBJECTS + TRUTHY_BOOLEAN_OBJECTS + GENERATED_FALSIES +
+	           RECURSOR_TEST_OBJECTS + [false, nil]
+
+	def test_truthiness
+		TRUTHY_TEST_OBJECTS.each do |truthy|
+			msg = "#{truthy} is false"
+			assert truthy.truthy?, msg
+			assert !truthy.falsy?, msg
+			assert !!truthy, msg
+		end
+
+		ALL_FALSIES.each do |falsy|
+			msg = "#{falsy} is false"
+			assert !falsy.truthy?, msg
+			assert falsy.falsy?, msg
+			assert !falsy, msg
+		end
+	end
+
+	def test_boolean_logic
+		TRUTHY_BOOLEAN_OBJECTS.product(ALL_FALSIES).each do |truthy, falsy|
+			if truthy.singleton_class.include?(TruthyBooleanOperators)
+				assert_equal(true, truthy ^ falsy, "#{truthy} ^ #{falsy} is true")
+				assert_equal(true, truthy | falsy, "#{truthy} | #{falsy} is false")
+				assert_equal(false, truthy & falsy, "#{truthy} & #{falsy} is false")
+			end
+
+			if falsy.singleton_class.include?(TruthyBooleanOperators)
+				assert_equal(true, falsy ^ truthy, "#{falsy} ^ #{truthy} is true")
+				assert_equal(true, falsy | truthy, "#{falsy} | #{truthy} is true")
+				assert_equal(false, falsy & truthy, "#{falsy} & #{truthy} is false")
+			end
+		end
+	end
+
+	def test_nil_checks
+		assert !nil.null?
+		assert nil.nil?
+		assert_equal nil, nil.to_nil?()
+
+		NON_NULL.each do |truthy|
+			assert !truthy.null?
+
+			tap_ran = false
+			truthy.tap? do |t|
+				tap_ran = true
+				assert_equal(truthy, t)
+			end
+			assert tap_ran
+
+			assert_equal truthy, truthy.to_nil?()
+		end
+
+		NULL_TEST_OBJECTS.each do |nto|
+			assert nto.nil?
+			assert nto.null?
+			nto.tap? { flunk }
+			assert_equal nil, nto.to_nil?()
+		end
+	end
+
+	def test_sink
+		NULL_TEST_OBJECTS.each do |nto|
+			%w{ijfdn edfksliwsauli rdwjsnxs vdsjkg_njdc3ese objectifd kill! doom? fcs
+				 noki i n self}.each do |func|
+				[[5], [1,2], [], Array.new(50, :o), {a: null}].each do |msg|
+					assert_equal(nto, nto.send(func, *msg))
+					assert_equal(nto, nto.send(func, *msg){flunk})
+				end
+			end
+		end
+
+		assert_equal null, (5*8+1/1.7)**null
+		assert_equal null, null + 5
+		assert_equal null, null/0
+		assert_equal null, (0 * null) + 5
+	end
+
+	def test_voidness
+		assert_equal 48, (void+8)*6
+		assert_equal 0, void + 0
+
+		{
+			void.to_a => [],
+			void.to_ary => [],
+			Array.new(void) => [],
+			void.to_c => 0,
+			void.to_param => nil,
+			void.to_nil? => nil,
+			(void =~ '') => nil,
+			"#{void}" => '',
+			void.rationalize => Rational(0, 1)
+		}.each do |real, expected|
+			assert_equal(expected, real)
+		end
+	end
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: 'null'
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- katmagic
+autorequire: 
+bindir: bin
+cert_chain:
+- ! '-----BEGIN CERTIFICATE-----
+
+  MIIDQDCCAiigAwIBAgIBADANBgkqhkiG9w0BAQUFADBGMRgwFgYDVQQDDA90aGUu
+
+  bWFnaWNhbC5rYXQxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixk
+
+  ARkWA2NvbTAeFw0xMTA4MjEyMjMyMDFaFw0xMjA4MjAyMjMyMDFaMEYxGDAWBgNV
+
+  BAMMD3RoZS5tYWdpY2FsLmthdDEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYK
+
+  CZImiZPyLGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA
+
+  pBt20nwjs5W03djpRN6FAbpiio286NHMTk6HhmjV6GZKOi5ZUX5onTnKUg2Vc35z
+
+  /nK+aIPReyRfBgIcfSjhoXh1A1Dp+2laNgTtU/3eMupruatgORAPCSaG9Ns+HSyR
+
+  vySbz1QUrwvlvF0qkhhApNQ6dsLl2LMOV3QcluY+Y3CVccOWOSHdQcnAbPuzM9Hf
+
+  4ChI4OGL7+DwLA5OK2S5uewRAa2iLkJSN0WugnQlJqMT59GRaqTDOtnYQpiyKEBy
+
+  QjVPO4LNk7iDsJP22YBrveIzm8/YYRBTU4LTHMEMOyCszrYqD2S1Lwp2rtCJzQCl
+
+  BA0LtBKrZl5mwZm7qyj+TwIDAQABozkwNzAJBgNVHRMEAjAAMB0GA1UdDgQWBBSm
+
+  s5arhjp61kmGl6wsmLYkqerdqDALBgNVHQ8EBAMCBLAwDQYJKoZIhvcNAQEFBQAD
+
+  ggEBAA6cQNQMOPRy4yrj7Nh5Mb9qq8t/8ho/JQvjzVof9qRd+kfKrOoOhXfEO+Rm
+
+  sWcaOnBCVC4DnZuNDSLygVhCDtMnHjg/JsfO/GBF/QlNTJOO1jkoQiS6w0KARlBm
+
+  cpXaWg/oMtXJ2PaUga6WkNeXYf9Mad36P4yuGQScjs+WkUUy7DNZvTGReIcCWOR8
+
+  jteSvvCMobQKGr2DfFOU9Jiddh2FPpz/KOM2ijzwsVNUMUr7R58LoCnQZrZ/YaRW
+
+  ob6QnVgwqu5SUAKQxlFJ/aKlPMj735z8EogaZC1ZHgg3vkgGGyu57N/8BDDG0TzC
+
+  Zn3u2leVae/fJ03zYGArhuJKPgc=
+
+  -----END CERTIFICATE-----
+
+'
+date: 2012-02-01 00:00:00.000000000 Z
+dependencies: []
+description: null is null.
+email: the.magical.kat@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/null.rb
+- test/null.rb
+homepage: https://github.com/katmagic/null
+licenses: []
+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
+signing_key: 
+specification_version: 3
+summary: null is a Null Object.
+test_files:
+- test/null.rb
+has_rdoc: