sloth 0.1

data.tar.gz.sig

@@ -0,0 +1 @@
+b�3�/�e�0�H�y��g@$�X�C֬=|E��PX�9���t�,#�<4?�o�Vݪ-Va*NA�eRE�	
jz[��ۙT��'�l놙�ݶO�6���슌ߛ�� ��3bz�VO	����7U�!
�����1�p�^jK���UԐ���^_0�9uGۣS�����e��V�+��Tr��7n�g��w:鞝D/��fE�l ���)�cm=�NkX�*��V q�

data/README.md

@@ -0,0 +1,66 @@
+Sloth
+=====
+
+Sloth is a Ruby gem that implements the `lazy()` function as robustly as
+possible.
+
+Installation
+------------
+
+	gem install sloth
+
+Usage
+-----
+
+	require 'sloth'
+	obj = lazy{:sloth}
+	obj.to_s # => 'sloth'
+
+Hunting Sloths
+--------------
+
+Sloths can only (easily) be detected by the `sloth?` method.
+
+	sloth = lazy{:sloth}
+
+	sloth.sloth?       # => true
+	sloth.class        # => Symbol
+	:sloth.sloth?      # => false
+	sloth.is_a?(Sloth) # => false
+	Sloth === sloth    # => false
+
+The `evaluated?` method can tell whether a Sloth has been evaluated.
+
+	sloth = lazy{'sloth'}
+
+	sloth.evaluated? # => false
+	"lazy #{sloth}s"
+	sloth.evaluated? # => true
+
+nil and false
+-------------
+
+Unfortunately, Ruby doesn't provide any easy way to override the behavior of if,
+so
+
+	if lazy{false}
+		puts('fail')
+	else
+		puts('success')
+	end
+
+will `puts('fail')`. A workaround has been implemented via the `self()` method,
+which has been defined on `Object`. Therefore,
+
+	if lazy{false}.self
+		puts('fail')
+	else
+		puts('success')
+	end
+
+will `puts('success')`.
+
+License
+-------
+
+Sloth is in the public domain.

data/lib/sloth.rb

@@ -0,0 +1,82 @@
+# A Sloth is just a wrapper to lazily evaluate an object. A Sloth will behave
+# just like the result of the given block except in the case of if statements,
+# where a Sloth object will always evaluate to true, and when the initialize()
+# function is called.
+class Sloth < BasicObject
+	def initialize(&block)
+		raise(LocalJumpError, 'no block given') unless block
+		@block = block
+	end
+
+	def method_missing(name, *args, &block)
+		unless defined?(@object)
+			@object = @block.call()
+			@block = nil
+		end
+
+		begin
+			begin
+				@object.public_send(name, *args, &block)
+			rescue ::NoMethodError => _ex_
+				if _ex_.backtrace[0].start_with?(__FILE__)
+					# If @object doesn't respond to public_send(), try using __send__().
+					@object.__send__(name, *args, &block)
+				else
+					::Kernel.raise(_ex_)
+				end
+			end
+		rescue ::Exception => _ex_
+			# Remove evidence of ourself from the traceback.
+			_ex_.backtrace.reject!{|line| line.start_with?(__FILE__)}
+			::Kernel.raise(_ex_)
+		end
+	end
+
+	instance_methods.each do |method_name|
+		next if [:method_missing, :initialize].include?(method_name)
+
+		define_method(method_name) do |*args, &block|
+			method_missing(method_name, *args, &block)
+		end
+	end
+
+	# sloth? will return true for Sloth instances and false for everything else.
+	# This is basically the only way to tell if something is a Sloth.
+	def sloth?
+		true
+	end
+
+	# This is true iff we have already been evaluated.
+	def evaluated?
+		defined?(@object)
+	end
+end
+
+class Object
+	# Return self.
+	def self
+		self
+	end
+
+	# sloth? will return true for Sloth instances and false for everything else.
+	# This is basically the only way to tell if something is a Sloth.
+	def sloth?
+		false
+	end
+end
+
+class Class
+	alias :__original_equals_equals_equals, :===
+
+	# Redefine ===() so that it will operate properly on Sloth instances.
+	def ===(obj)
+		__original_equals_equals_equals(obj.instance_eval{self})
+	end
+end
+
+module Kernel
+	# Return a Sloth initialized with the given block.
+	def lazy(&block)
+		Sloth.new(&block)
+	end
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: sloth
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- katmagic
+autorequire: 
+bindir: bin
+cert_chain:
+- !binary |-
+  LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURRRENDQWlpZ0F3SUJB
+  Z0lCQURBTkJna3Foa2lHOXcwQkFRVUZBREJHTVJnd0ZnWURWUVFEREE5MGFH
+  VXUKYldGbmFXTmhiQzVyWVhReEZUQVRCZ29Ka2lhSmsvSXNaQUVaRmdWbmJX
+  RnBiREVUTUJFR0NnbVNKb21UOGl4awpBUmtXQTJOdmJUQWVGdzB4TVRBNE1q
+  RXlNak15TURGYUZ3MHhNakE0TWpBeU1qTXlNREZhTUVZeEdEQVdCZ05WCkJB
+  TU1EM1JvWlM1dFlXZHBZMkZzTG10aGRERVZNQk1HQ2dtU0pvbVQ4aXhrQVJr
+  V0JXZHRZV2xzTVJNd0VRWUsKQ1pJbWlaUHlMR1FCR1JZRFkyOXRNSUlCSWpB
+  TkJna3Foa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQQpwQnQyMG53
+  anM1VzAzZGpwUk42RkFicGlpbzI4Nk5ITVRrNkhobWpWNkdaS09pNVpVWDVv
+  blRuS1VnMlZjMzV6Ci9uSythSVBSZXlSZkJnSWNmU2pob1hoMUExRHArMmxh
+  TmdUdFUvM2VNdXBydWF0Z09SQVBDU2FHOU5zK0hTeVIKdnlTYnoxUVVyd3Zs
+  dkYwcWtoaEFwTlE2ZHNMbDJMTU9WM1FjbHVZK1kzQ1ZjY09XT1NIZFFjbkFi
+  UHV6TTlIZgo0Q2hJNE9HTDcrRHdMQTVPSzJTNXVld1JBYTJpTGtKU04wV3Vn
+  blFsSnFNVDU5R1JhcVRET3RuWVFwaXlLRUJ5ClFqVlBPNExOazdpRHNKUDIy
+  WUJydmVJem04L1lZUkJUVTRMVEhNRU1PeUNzenJZcUQyUzFMd3AycnRDSnpR
+  Q2wKQkEwTHRCS3JabDVtd1ptN3F5aitUd0lEQVFBQm96a3dOekFKQmdOVkhS
+  TUVBakFBTUIwR0ExVWREZ1FXQkJTbQpzNWFyaGpwNjFrbUdsNndzbUxZa3Fl
+  cmRxREFMQmdOVkhROEVCQU1DQkxBd0RRWUpLb1pJaHZjTkFRRUZCUUFECmdn
+  RUJBQTZjUU5RTU9QUnk0eXJqN05oNU1iOXFxOHQvOGhvL0pRdmp6Vm9mOXFS
+  ZCtrZktyT29PaFhmRU8rUm0Kc1djYU9uQkNWQzREblp1TkRTTHlnVmhDRHRN
+  bkhqZy9Kc2ZPL0dCRi9RbE5USk9PMWprb1FpUzZ3MEtBUmxCbQpjcFhhV2cv
+  b010WEoyUGFVZ2E2V2tOZVhZZjlNYWQzNlA0eXVHUVNjanMrV2tVVXk3RE5a
+  dlRHUmVJY0NXT1I4Cmp0ZVN2dkNNb2JRS0dyMkRmRk9VOUppZGRoMkZQcHov
+  S09NMmlqendzVk5VTVVyN1I1OExvQ25RWnJaL1lhUlcKb2I2UW5WZ3dxdTVT
+  VUFLUXhsRkovYUtsUE1qNzM1ejhFb2dhWkMxWkhnZzN2a2dHR3l1NTdOLzhC
+  RERHMFR6QwpabjN1MmxlVmFlL2ZKMDN6WUdBcmh1SktQZ2M9Ci0tLS0tRU5E
+  IENFUlRJRklDQVRFLS0tLS0K
+date: 2012-05-08 00:00:00.000000000 Z
+dependencies: []
+description: Sloth makes laziness easy.
+email: the.magical.kat@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/sloth.rb
+- README.md
+homepage: https://github.com/chloe/sloth
+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: Lazily evaluate things.
+test_files: []
+has_rdoc: