mug 0.1.0 → 0.2.0

data/lib/mug.rb

@@ -1,13 +1,14 @@
-
-require_relative 'mug/apply'
-require_relative 'mug/bool'
-require_relative 'mug/fragile-method-chain'
-require_relative 'mug/hashmap'
-require_relative 'mug/hashop'
-require_relative 'mug/iterator/for'
-require_relative 'mug/iterator/method'
-require_relative 'mug/maybe'
-require_relative 'mug/self'
-require_relative 'mug/tau'
-require_relative 'mug/to_h'
-
+
+require_relative 'mug/apply'
+require_relative 'mug/array/extend'
+require_relative 'mug/bool'
+require_relative 'mug/fragile-method-chain'
+require_relative 'mug/hash/map'
+require_relative 'mug/hash/operations'
+require_relative 'mug/iterator/for'
+require_relative 'mug/iterator/method'
+require_relative 'mug/maybe'
+require_relative 'mug/self'
+require_relative 'mug/tau'
+require_relative 'mug/to_h'
+

data/lib/mug/and-or.rb

@@ -1,48 +1,48 @@
-
-class Object
-
-	#
-	# Returns either +obj+ or +default+, depending on the falsiness of +obj+.
-	#
-	# If a block is given, +obj+ is yielded to it; if it returns truthy,
-	# +default+ is returned, otherwise +obj+ is returned.
-	#
-	def and default
-		if block_given?
-			yield(self) ? default : self
-		else
-			self && default
-		end
-	end
-
-	#
-	# Returns either +obj+ or +default+, depending on the truthiness of +obj+.
-	#
-	# If a block is given, +obj+ is yielded to it; if it returns truthy,
-	# +obj+ is returned, otherwise +default+ is returned.
-	#
-	def or default
-		if block_given?
-			yield(self) ? self : default
-		else
-			self || default
-		end
-	end
-end
-
-=begin
-Copyright (c) 2013, Matthew Kerwin <matthew@kerwin.net.au>
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-=end
-
+
+class Object
+
+	#
+	# Returns either +obj+ or +default+, depending on the falsiness of +obj+.
+	#
+	# If a block is given, +obj+ is yielded to it; if it returns truthy,
+	# +default+ is returned, otherwise +obj+ is returned.
+	#
+	def and default
+		if block_given?
+			yield(self) ? default : self
+		else
+			self && default
+		end
+	end
+
+	#
+	# Returns either +obj+ or +default+, depending on the truthiness of +obj+.
+	#
+	# If a block is given, +obj+ is yielded to it; if it returns truthy,
+	# +obj+ is returned, otherwise +default+ is returned.
+	#
+	def or default
+		if block_given?
+			yield(self) ? self : default
+		else
+			self || default
+		end
+	end
+end
+
+=begin
+Copyright (c) 2013, Matthew Kerwin <matthew@kerwin.net.au>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+=end
+

data/lib/mug/apply.rb

@@ -1,58 +1,58 @@
-
-class Proc
-	#
-	# Curries this Proc and partially applies parameters.
-	# If a sufficient number of arguments are supplied, it passes the
-	# supplied arguments to the original proc and returns the result.
-	# Otherwise, returns another curried proc that takes the rest of
-	# arguments.
-	#
-	def apply(*args)
-		curry.call(*args)
-	end
-end
-
-class Method
-	#
-	# Returns a curried proc. If the optional arity argument is given,
-	# it determines the number of arguments. A curried proc receives
-	# some arguments. If a sufficient number of arguments are supplied,
-	# it passes the supplied arguments to the original proc and returns
-	# the result. Otherwise, returns another curried proc that takes the
-	# rest of arguments.
-	#
-	def curry(n=nil)
-		if n
-			to_proc.curry n
-		else
-			to_proc.curry
-		end
-	end
-
-	#
-	# Curries this Method and partially applies parameters.
-	# If a sufficient number of arguments are supplied, it passes the
-	# supplied arguments to the original proc and returns the result.
-	# Otherwise, returns another curried proc that takes the rest of
-	# arguments.
-	#
-	def apply(*args)
-		curry.call(*args)
-	end
-end
-
-=begin
-Copyright (c) 2014, Matthew Kerwin <matthew@kerwin.net.au>
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-=end
+
+class Proc
+	#
+	# Curries this Proc and partially applies parameters.
+	# If a sufficient number of arguments are supplied, it passes the
+	# supplied arguments to the original proc and returns the result.
+	# Otherwise, returns another curried proc that takes the rest of
+	# arguments.
+	#
+	def apply(*args)
+		curry.call(*args)
+	end
+end
+
+class Method
+	#
+	# Returns a curried proc. If the optional arity argument is given,
+	# it determines the number of arguments. A curried proc receives
+	# some arguments. If a sufficient number of arguments are supplied,
+	# it passes the supplied arguments to the original proc and returns
+	# the result. Otherwise, returns another curried proc that takes the
+	# rest of arguments.
+	#
+	def curry(n=nil)
+		if n
+			to_proc.curry n
+		else
+			to_proc.curry
+		end
+	end
+
+	#
+	# Curries this Method and partially applies parameters.
+	# If a sufficient number of arguments are supplied, it passes the
+	# supplied arguments to the original proc and returns the result.
+	# Otherwise, returns another curried proc that takes the rest of
+	# arguments.
+	#
+	def apply(*args)
+		curry.call(*args)
+	end
+end
+
+=begin
+Copyright (c) 2014, Matthew Kerwin <matthew@kerwin.net.au>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+=end

data/lib/mug/array.rb

@@ -0,0 +1 @@
+require_relative 'array/extend'

data/lib/mug/array/extend.rb

@@ -0,0 +1,69 @@
+
+class Array
+
+	##
+	# Extend this Array.
+	#
+	# In the first form, when a +size+ and an optional +obj+ are sent,
+	# the array is extended with +size+ copies of +obj+. Take notice that
+	# all elements will reference the same object +obj+.
+	#
+	# The second form appends a copy of the array passed as a parameter
+	# (the array is generated by calling #to_ary on the parameter).
+	# @see #concat
+	# @see #+
+	#
+	# In the last form, the array is extended by the given size. Each new
+	# element in the array is created by passing the element's index to the
+	# given block and storing the return value.
+	#
+	# @call-seq extend!(size=0, obj=nil)
+	# @call-seq extend!(array)
+	# @call-seq extend!(size) {|index| block }
+	#
+	def extend! size, *rest
+		raise ArgumentError, "wrong number of arguments (#{rest.length+1} for 1..2)" if rest.length > 1
+
+		# Same logic as array.c/rb_ary_initialize
+		if rest.empty? && !size.is_a?(Fixnum)
+			warn 'warning: given block not used' if block_given?
+			concat size.to_ary
+			return self
+		end
+
+		raise ArgumentError, 'negative size' if size < 0
+
+		a = length
+		b = a+size
+		if block_given?
+			warn 'warning: block supersedes default value argument' if !rest.empty?
+			fill(a...b) {|i| yield i }
+		else
+			obj = rest[0]
+			fill(a...b) { obj }
+		end
+	end
+
+	# @see #extend!
+	def extend *args, &block
+		dup.extend! *args, &block
+	end
+
+end
+
+=begin
+Copyright (c) 2014, Matthew Kerwin <matthew@kerwin.net.au>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+=end
+

data/lib/mug/bool.rb

@@ -1,128 +1,128 @@
-
-#
-# 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
-
-=begin
-Copyright (c) 2013, Matthew Kerwin <matthew@kerwin.net.au>
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-=end
-
+
+#
+# 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
+
+=begin
+Copyright (c) 2013, Matthew Kerwin <matthew@kerwin.net.au>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+=end
+