mug 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7892b05f508f2c796669e30d404d1b637976479e
+  data.tar.gz: 8b88ce7c7d3ebbc082045b96a3058ce74d648c63
+SHA512:
+  metadata.gz: a59cd47d21e27a63fb2b3b6315e5c0fd64fbc4add1372763c3ecdfb95349f05c6550c7d75fd2233f3a8a0159395014ce829625dfc3b5cde34b3341cd3a934bf3
+  data.tar.gz: 683a341d4bdd574f225abf5911a7dc18a5011ccc5e6d41ea40595b7418c86fe9f16961da9c03a201d916bdcc443ad4eec52a29fc73efe3a55317aca18400595e

data/lib/mug.rb

@@ -0,0 +1,8 @@
+
+require_relative 'mug/bool'
+require_relative 'mug/fragile-method-chain'
+require_relative 'mug/iterator'
+require_relative 'mug/iterator/for'
+require_relative 'mug/iterator/method'
+require_relative 'mug/maybe'
+require_relative 'mug/self'

data/lib/mug/bool.rb

@@ -0,0 +1,112 @@
+
+#
+# Converts arg to a boolean (true or false).
+#
+def Bool(arg)
+	!!arg
+end
+
+class Object
+	#
+	# Converts obj to a boolean.
+	#
+	def to_bool
+		true
+	end
+
+	#
+	# Converts obj to a boolean.
+	#
+	def to_b
+		true
+	end
+end
+
+def nil.to_bool; false; end
+def nil.to_b; false; end
+def false.to_bool; false; end
+def false.to_b; false; end
+
+class Numeric
+	#
+	# Converts num to a boolean.
+	# Returns true if not zero.
+	#
+	def to_b
+		self != 0
+	end
+end
+
+class Float
+	#
+	# Converts num to a boolean.
+	# Returns true if not zero or NaN.
+	# Note: -0.0 is false, and +/-infinity are true.
+	#
+	def to_b
+		!(self.zero? || self.nan?)
+	end
+end
+
+class String
+	#
+	# Converts str to a boolean.
+	# Returns true if not empty.
+	#
+	def to_b
+		!empty?
+	end
+end
+
+class Array
+	#
+	# Converts ary to a boolean.
+	# Returns true if not empty.
+	#
+	def to_b
+		!empty?
+	end
+end
+
+class Hash
+	#
+	# Converts hsh to a boolean.
+	# Returns true if not empty.
+	#
+	def to_b
+		!empty?
+	end
+end
+
+module Enumerable
+	#
+	# Converts enum to a boolean.
+	# Returns true if there are any elements.
+	#
+	def to_b
+		any?{ true }
+	end
+end
+
+if RUBY_VERSION.to_i >= 2
+class Enumerator
+	#
+	# Converts enum to a boolean.
+	# Returns true if there are any elements.
+	#
+	def to_b
+		size.to_b
+	end
+end
+end
+
+class Exception
+	#
+	# Converts ex to a boolean.
+	# All Exceptions are considered false.
+	#
+	def to_b
+		false
+	end
+end
+

data/lib/mug/fragile-method-chain.rb

@@ -0,0 +1,53 @@
+
+#
+# Invokes a method chain until one method returns a falsy value.
+#
+# For example:
+#
+#     a._?.b.c.d._!
+#     nested_hash._?[:a][:b][:c]._!
+#
+class FragileMethodChain
+	#
+	# Creates a FragileMethodChain which will send its first method to +o+
+	#
+	def initialize o
+		@o = o
+		@chain = []
+	end
+
+	#
+	# Finalises the FragileMethodChain.
+	#
+	# The final result will be the first +nil+ or +false+ value
+	# returned in the chain, or its end result.
+	#
+	def _!
+		@chain.inject(@o) do |o,x|
+			a,b = x
+			break o unless o
+			o.__send__(*a, &b)
+		end
+	end
+
+	# Record the method args/block
+	def method_missing *a, &b #:nodoc:
+		@chain << [a,b]
+		self
+	end
+
+	# Explicitly record :_? as a method in the chain.
+	def _? #:nodoc:
+		@chain << [[ :_? ],nil]
+		self
+	end
+end
+
+class Object
+	#
+	# Begins a FragileMethodChain.
+	#
+	def _?
+		FragileMethodChain.new(self)
+	end
+end

data/lib/mug/iterator.rb

@@ -0,0 +1,27 @@
+
+#
+# A special class of Enumerator that repeatedly invokes a method.
+#
+# Initially the method is send to the given +obj+, but subsequent
+# invocations are sent to the result of the previous invocation.
+#
+# Example:
+#
+#     0.iter_for(:next).take(5) #=> [0,1,2,3,4]
+#
+class Iterator < Enumerator
+	#
+	# Creates a new Iterator for method +meth+, to be
+	# called initially on object +obj+.
+	#
+	# All method calls will have +args+ as parameters.
+	#
+	def initialize obj, meth, *args
+		super() do |y|
+			loop do
+				y << obj
+				obj = obj.send(meth, *args)
+			end
+		end
+	end
+end

data/lib/mug/iterator/for.rb

@@ -0,0 +1,12 @@
+
+require_relative '../iterator'
+
+class Object
+	#
+	# Creates a new Iterator for the method named +meth+
+	#
+	def iter_for meth, *args
+		Iterator.new self, meth, *args
+	end
+	alias :to_iter :iter_for
+end

data/lib/mug/iterator/method.rb

@@ -0,0 +1,12 @@
+
+require_relative '../iterator'
+
+class Method
+	#
+	# Creates a new Iterator for this method, initially invoked
+	# on this method's receiver.
+	#
+	def to_iter *args
+		Iterator.new receiver, name, *args
+	end
+end

data/lib/mug/maybe.rb

@@ -0,0 +1,42 @@
+
+#
+# Invokes methods on a wrapped object, if that object is truthy.
+#
+class MaybeDelegator
+	#
+	# Creates a new MaybeDelegator, wrapping +o+
+	#
+	def initialize o
+		@o = o
+	end
+
+	#
+	# Returns this MaybeDelegator object.
+	#
+	def maybe
+		self
+	end
+
+	# Calls the method on +@o+ if it's truthy.
+	def method_missing *a, &b #:nodoc:
+		@o && @o.send(*a, &b)
+	end
+end
+
+class Object
+	#
+	# Do something if this object is truthy.
+	#
+	# If a block is given, it is executed in the context of this
+	# object, iff this object is neither +nil+ nor +false+.
+	#
+	# If no block is given, returns a MaybeDelegator object.
+	#
+	def maybe &b
+		if b
+			self && instance_eval(&b)
+		else
+			MaybeDelegator.new(self)
+		end
+	end
+end

data/lib/mug/self.rb

@@ -0,0 +1,16 @@
+
+class Object
+	#
+	# Returns this object.
+	#
+	# If a block is given, this object is yielded to it, and the result
+	# is returned.
+	#
+	def self(&block)
+		if block_given?
+			yield self
+		else
+			self
+		end
+	end
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: mug
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Matthew Kerwin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-24 00:00:00.000000000 Z
+dependencies: []
+description: |
+  == MUG: Matty's Ultimate Gem
+
+  A collection of wonders to astound the mind!!
+email:
+- matthew@kerwin.net.au
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/mug.rb
+- lib/mug/fragile-method-chain.rb
+- lib/mug/self.rb
+- lib/mug/iterator.rb
+- lib/mug/iterator/for.rb
+- lib/mug/iterator/method.rb
+- lib/mug/maybe.rb
+- lib/mug/bool.rb
+homepage: http://phluid61.github.com/mug
+licenses:
+- ISC License
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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: 
+rubygems_version: 2.0.2
+signing_key: 
+specification_version: 4
+summary: 'MUG: Matty''s Ultimate Gem'
+test_files: []