mug 0.0.3 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f3ad7fb03114e7062b93539759918f1ebbe542a9
-  data.tar.gz: 35ffe2f0573509eced89ea9e2b73efb991cbd619
+  metadata.gz: 5c132b6a79488019536300de12dc918fe41191b9
+  data.tar.gz: 94c1e037fe68407949e3c3bcd0d4274c5cf8eb5d
 SHA512:
-  metadata.gz: be694ddef15890b59a471dcea87d24f1b9df9da15c89d0d69c4c1c3786bd3f3c0bff56b876b06ecad0e4c439552610c81d2be46cd527a494b16749ffb7ff7510
-  data.tar.gz: 524a47ce38c90eabea52a6659154cbe08869a5f59b1ba6230f0b17d48c0fd9e1f6ccb5739d95fd6e8edd5f0227365644a07647039691fc072c01a311077c7ba8
+  metadata.gz: dfc72b0fa90e4b518499912838f5619ae95380a8a7b18194e00a44bf788b0f24ed3cc08ce3ae218b3943a18616a5e2d9f82db15247cfab7abd44ccc12da13111
+  data.tar.gz: 1b0c0f63d50b07197f1db75ee2f849f08c1264bc7add2a02056b4ecd1bae619f95680051b254093ae45fb2de3f1a475e1ed204490ad581edf5c1a674a3bb260b

data/lib/mug.rb

@@ -1,10 +1,12 @@
 
 require_relative 'mug/bool'
-require_relative 'mug/hashmap'
 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'
 

data/lib/mug/hashop.rb

@@ -0,0 +1,39 @@
+
+class Hash
+
+	#
+	# Returns a new Hash, whose value is the same as this
+	# one, with any extras in +o+ added in.
+	#
+	# Useful for default options.
+	#
+	# Example:
+	#     opts = {:a => 1, :b => 2 }
+	#     dflt = {:a => 0, :x => 9 }
+	#     opts |= dflt # => opts = {:a=>1, :b=>2, :x=>9}
+	#
+	def | o
+		o.merge self
+	end
+
+	#
+	# Appends stuff to the hash.
+	#
+	# If +o+ is a Hash, this is identical to calling #merge!
+	# If +o+ is an Array with two elements, it is interpreted as [key,value]
+	# If +o+ can be converted to a hash with #to_h, this is identical to calling #merge!
+	# Otherwise an ArgumentError is raised.
+	#
+	def << o
+		if o.respond_to? :to_hash
+			merge! o.to_hash
+		elsif o.respond_to?(:to_a) && (a = o.to_a) && a.length == 2
+			store a[0], a[1]
+		elsif o.respond_to? :to_h
+			merge! o.to_h
+		else
+			raise ArgumentError, "#{o.class.name} is not a Hash"
+		end
+	end
+end
+

data/lib/mug/tau.rb

@@ -0,0 +1,44 @@
+
+module Math
+  # The true circle constant.
+  # The ratio of a circle's circumference to its radius.
+  TAU = PI * 2.0
+end
+
+module BigMath
+  ##
+  # Computes the value of tau to the specific number of digits of precision.
+  #
+  # @param [Integer] prec the number of decimal digits of precision in the computed value.
+  # @return [BigDecimal] the computed value
+  # @raise [ArgumentError] if +prec+ is not positive
+  #
+  # @example
+  #   require 'bigdecimal'
+  #   require 'bigdecimal/math'
+  #   include BigMath
+  #
+  #   puts TAU(150)
+  #
+  def TAU(prec)
+    raise ArgumentError, 'Zero or negative argument for TAU' if prec <= 0
+    PI(prec) * BigDecimal('2')
+  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/test/test-hashop.rb

@@ -0,0 +1,50 @@
+require 'test/unit'
+$VERBOSE = true
+
+$coercable = Object.new
+def $coercable.to_h
+	{:a=>0, :z=>99}
+end
+
+require_relative '../lib/mug/hashop'
+class Test_hashop < Test::Unit::TestCase
+	def test_hash_or
+		h = { :a => 1, :b => 2 }
+		[
+			[{}, h, h],
+			[{:c=>3}, h, {:a=>1, :b=>2, :c=>3}],
+			[{:a=>0, :b=>0}, h, {:a=>0, :b=>0}],
+			[{:a=>0, :c=>3}, h, {:a=>0, :b=>2, :c=>3}],
+			[h, {}, h],
+		].each do |a, b, x|
+			assert_equal( a|b, x )
+		end
+	end
+	def test_hash_poke
+		h = {}
+
+		# Regular Hash poking
+		assert_nothing_raised { h << {:a=>1} }
+		assert_equal h, {:a=>1}
+		assert_nothing_raised { h << {:b=>2} }
+		assert_equal h, {:a=>1,:b=>2}
+		assert_nothing_raised { h << {:a=>3} }
+		assert_equal h, {:a=>3,:b=>2}
+		assert_nothing_raised { h << {:a=>1,:c=>3} }
+		assert_equal h, {:a=>1,:b=>2,:c=>3}
+
+		# Two-element Array poking
+		assert_nothing_raised { h << [:d,1] }
+		assert_equal h, {:a=>1,:b=>2,:c=>3,:d=>1}
+		assert_nothing_raised { h << [:d,4] }
+		assert_equal h, {:a=>1,:b=>2,:c=>3,:d=>4}
+
+		# Objects with .to_h
+		assert_nothing_raised { h << $coercable }
+		assert_equal h, {:a=>0,:b=>2,:c=>3,:d=>4,:z=>99}
+
+		# Failure
+		assert_raise(ArgumentError) { h << Object.new }
+	end
+end
+

data/test/test-tau.rb

@@ -0,0 +1,22 @@
+require 'test/unit'
+require 'bigdecimal'
+require 'bigdecimal/math'
+
+$VERBOSE = true
+require_relative '../lib/mug/tau'
+class Test_tau < Test::Unit::TestCase
+	def test_math_tau
+		# 6.283185307179586..
+		assert_equal(Math::TAU, Math::PI*2.0)
+	end
+
+	include BigMath
+	def test_TAU
+		assert_equal(TAU(1).round(1).to_s('F'), '6.3')
+		assert_equal(TAU(100).truncate(100).to_s('F'), '6.2831853071795864769252867665590057683943387987502116419498891846156328125724179972560696506842341359')
+		assert_raise(ArgumentError) { TAU(0) }
+		assert_raise(ArgumentError) { TAU(-3) }
+		assert_raise(ArgumentError) { TAU('barf') }
+	end
+end
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mug
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.5
 platform: ruby
 authors:
 - Matthew Kerwin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-25 00:00:00.000000000 Z
+date: 2013-08-15 00:00:00.000000000 Z
 dependencies: []
 description: |
   == MUG: Matty's Ultimate Gem
@@ -22,15 +22,18 @@ extra_rdoc_files: []
 files:
 - lib/mug.rb
 - lib/mug/hashmap.rb
+- lib/mug/tau.rb
 - lib/mug/to_h.rb
 - lib/mug/fragile-method-chain.rb
 - lib/mug/self.rb
 - lib/mug/iterator.rb
+- lib/mug/hashop.rb
 - lib/mug/iterator/for.rb
 - lib/mug/iterator/method.rb
 - lib/mug/maybe.rb
 - lib/mug/iterator_c.rb
 - lib/mug/bool.rb
+- test/test-tau.rb
 - test/test-self.rb
 - test/test-bool.rb
 - test/test-to_h.rb
@@ -39,6 +42,7 @@ files:
 - test/test-iterator-for.rb
 - test/test-maybe.rb
 - test/test-hashmap.rb
+- test/test-hashop.rb
 homepage: http://phluid61.github.com/mug
 licenses:
 - ISC License
@@ -59,11 +63,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.2
+rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
 summary: 'MUG: Matty''s Ultimate Gem'
 test_files:
+- test/test-tau.rb
 - test/test-self.rb
 - test/test-bool.rb
 - test/test-to_h.rb
@@ -72,3 +77,4 @@ test_files:
 - test/test-iterator-for.rb
 - test/test-maybe.rb
 - test/test-hashmap.rb
+- test/test-hashop.rb