filigree 0.3.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 178a6b1f4c1c7e4fa5572856e84f8e42e61ef423
-  data.tar.gz: 0b4d734851d85411da754286fbe7562dd894e8a7
+  metadata.gz: 7c7696d87311fb00c3506b41c1f8b50e944bb63b
+  data.tar.gz: eb00162a46ccfbb5742e56498233f44e36b5d760
 SHA512:
-  metadata.gz: 37ed52f1a1780895bfdb255625f9edd5a649c96595395851a1d99ae79ba695e7f45f4e5d443452342ce3aa77db665b24abf9a71c67579233bf806ce3177e41c0
-  data.tar.gz: 67ded0ee569137d4dd0b00d99e753af2db406beff41f8a6994b76bfff52521b4b7f08316c4d3ff3128f0180b7b1cea91aa2c1cbd1e7900278a2c46d5e7ae242b
+  metadata.gz: 783be7b5c305016fe61287d6c41c7f49f7e15b380cf199cfcf0633ef5e2b4cd073cae6608879655d65d134b69554bf3d9c24195fccc908d6b8dd4a14c1425e34
+  data.tar.gz: 98e5f988abc878f3f6da8e48faf8e29b547488a69f76bd3124d6541d0f321a87e7490c9a2f275068ca07dc91d35178cf090f91699ab4ab2ebcc5bc1f81f8b604

data/README.md

@@ -164,11 +164,7 @@ Filigree's implementation of the visitor pattern is built on the pattern matchin
 ```Ruby
 class Binary < Struct.new(:x, :y)
   extend  Filigree::Destructurable
-  include Filigree::Visitable
-
-  def children
-  	[x, y]
-  end
+  include Filigree::Visitor
 
   def destructure(_)
     [x, y]

data/Rakefile

@@ -1,15 +1,19 @@
-# Author:		Chris Wailes <chris.wailes@gmail.com>
-# Project: 	Filigree
-# Date:		2013/4/19
-# Description:	Filigree's Rakefile.
+# Author:      Chris Wailes <chris.wailes@gmail.com>
+# Project:     Filigree
+# Date:        2013/4/19
+# Description: Filigree's Rakefile.
 
 ############
 # Requires #
 ############
 
+# Add the Filigree source directory to the load path.
+lib_dir = File.expand_path("./lib/", File.dirname(__FILE__))
+$LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
 # Filigree
-require File.expand_path("../lib/filigree/request_file", __FILE__)
-require File.expand_path("../lib/filigree/version", __FILE__)
+require 'filigree/request_file'
+require 'filigree/version'
 
 ###########
 # Bundler #
@@ -36,12 +40,12 @@ end
 # Flog #
 ########
 
-request_file('flog_cli', 'Flog is not installed.') do
+request_file('flog_task', 'Flog is not installed.') do
 	desc 'Analyze code complexity with Flog'
-	task :flog do
-		whip = FlogCLI.new
-		whip.flog('lib')
-		whip.report
+	FlogTask.new do |t|
+		t.dirs    = ['lib']
+		t.method  = :max_method
+		t.verbose = true
 	end
 end
 
@@ -94,7 +98,7 @@ request_file('yard', 'Yard is not installed.') do
 			'-M',       'redcarpet',
 			'--private'
 		]
-		
+
 		t.files = Dir['lib/**/*.rb']
 	end
 end

data/lib/filigree.rb

@@ -1,4 +1,4 @@
-# Author:		Chris Wailes <chris.wailes@gmail.com>
+# Author:		Chris Wailes <chris.wailes+filigree@gmail.com>
 # Project: 	Filigree
 # Date:		2013/4/19
 # Description:	The root file for the Filigree project.

data/lib/filigree/abstract_class.rb

@@ -1,4 +1,4 @@
-# Author:      Chris Wailes <chris.wailes@gmail.com>
+# Author:      Chris Wailes <chris.wailes+filigree@gmail.com>
 # Project:     Filigree
 # Date:        2013/4/19
 # Description: An implementation of an AbstractClass module.
@@ -69,7 +69,7 @@ module Filigree
 		#
 		# @raise [AbstractClassError]
 		def new(*args)
-			if @abstract_class == self
+			if self.instance_variable_defined?(:'@abstract_class') and @abstract_class == self
 				raise AbstractClassError, self.name
 			else
 				super

data/lib/filigree/application.rb

@@ -1,7 +1,7 @@
-# Author:		Chris Wailes <chris.wailes@gmail.com>
-# Project: 	Filigree
-# Date:		2013/05/14
-# Description:	Simple application framework.
+# Author:      Chris Wailes <chris.wailes+filigree@gmail.com>
+# Project:     Filigree
+# Date:        2013/05/14
+# Description: Simple application framework.
 
 ############
 # Requires #
@@ -36,8 +36,6 @@ module Filigree
 		#############
 
 		REQUIRED_METHODS = [
-			:kill,
-			:pause,
 			:resume,
 			:run,
 			:stop
@@ -59,10 +57,7 @@ module Filigree
 			Signal.trap('QUIT') { self.stop }
 			Signal.trap('TERM') { self.stop }
 
-			Signal.trap('KILL') { self.kill }
-
 			Signal.trap('CONT') { self.resume }
-			Signal.trap('STOP') { self.pause  }
 		end
 
 		#################

data/lib/filigree/boolean.rb

@@ -1,7 +1,7 @@
-# Author:		Chris Wailes <chris.wailes@gmail.com>
-# Project: 	Filigree
-# Date:		2013/05/04
-# Description:	Class extensions for dealing with integers and booleans.
+# Author:      Chris Wailes <chris.wailes+filigree@gmail.com>
+# Project:     Filigree
+# Date:        2013/05/04
+# Description: Class extensions for dealing with integers and booleans.
 
 ############
 # Requires #
@@ -15,26 +15,29 @@
 # Classes and Modules #
 #######################
 
-# Extra boolean support for the Integer class.
-class Integer
-	# @return [Boolean] This Integer as a Boolean value.
-	def to_bool
-		self != 0
+module Filigree
+
+	# Extra boolean support for the Integer class.
+	refine Integer do
+		# @return [Boolean] This Integer as a Boolean value.
+		def to_bool
+			self != 0
+		end
 	end
-end
 
-# Extra boolean support for the TrueClass class.
-class TrueClass
-	# @return [1]
-	def to_i
-		1
+	# Extra boolean support for the TrueClass class.
+	refine TrueClass do
+		# @return [1]
+		def to_i
+			1
+		end
 	end
-end
 
-# Extra boolean support for the FalseClass class.
-class FalseClass
-	# @return [0]
-	def to_i
-		0
+	# Extra boolean support for the FalseClass class.
+	refine FalseClass do
+		# @return [0]
+		def to_i
+			0
+		end
 	end
 end

data/lib/filigree/class.rb

@@ -1,7 +1,7 @@
-# Author:		Chris Wailes <chris.wailes@gmail.com>
-# Project: 	Filigree
-# Date:		2013/05/04
-# Description:	Class extensions for the Class class.
+# Author:      Chris Wailes <chris.wailes+filigree@gmail.com>
+# Project:     Filigree
+# Date:        2013/05/04
+# Description: Class extensions for the Class class.
 
 ############
 # Requires #
@@ -16,33 +16,36 @@ require 'filigree/types'
 # Classes and Modules #
 #######################
 
-class Class
-	# Checks for module inclusion.
-	#
-	# @param [Module]  mod  Module to check the inclusion of.
-	#
-	# @return [Boolean]  If the module was included
-	def includes_module?(mod)
-		self.included_modules.include?(mod)
-	end
+module Filigree
 
-	# @return [String]  Name of class without the namespace.
-	def short_name
-		self.name.split('::').last
-	end
+	refine Class do
+		# Checks for module inclusion.
+		#
+		# @param [Module]  mod  Module to check the inclusion of.
+		#
+		# @return [Boolean]  If the module was included
+		def includes_module?(mod)
+			self.included_modules.include?(mod)
+		end
+
+		# @return [String]  Name of class without the namespace.
+		def short_name
+			self.name.split('::').last
+		end
 
-	# Checks to see if a Class object is a subclass of the given class.
-	#
-	# @param [Class]  klass  Class we are checking if this is a subclass of.
-	#
-	# @return [Boolean]  If self is a subclass of klass
-	def subclass_of?(klass)
-		check_type(klass, Class, 'klass')
-
-		if (superklass = self.superclass)
-			superklass == klass or superklass.subclass_of?(klass)
-		else
-			false
+		# Checks to see if a Class object is a subclass of the given class.
+		#
+		# @param [Class]  klass  Class we are checking if this is a subclass of.
+		#
+		# @return [Boolean]  If self is a subclass of klass
+		def subclass_of?(klass)
+			check_type(klass, Class, blame: 'klass')
+
+			if (superklass = self.superclass)
+				superklass == klass or superklass.subclass_of?(klass)
+			else
+				false
+			end
 		end
 	end
 end

data/lib/filigree/class_methods_module.rb

@@ -1,7 +1,7 @@
-# Author:		Chris Wailes <chris.wailes@gmail.com>
-# Project: 	Filigree
-# Date:		2013/05/15
-# Description:	A module to automatically extend classes with an inner module.
+# Author:      Chris Wailes <chris.wailes+filigree@gmail.com>
+# Project:     Filigree
+# Date:        2013/05/15
+# Description: A module to automatically extend classes with an inner module.
 
 ############
 # Requires #

data/lib/filigree/commands.rb

@@ -1,7 +1,7 @@
-# Author:		Chris Wailes <chris.wailes@gmail.com>
-# Project: 	Filigree
-# Date:		2013/05/14
-# Description:	Easy application configuration.
+# Author:      Chris Wailes <chris.wailes+filigree@gmail.com>
+# Project:     Filigree
+# Date:        2013/05/14
+# Description: Easy application configuration.
 
 ############
 # Requires #
@@ -12,12 +12,13 @@
 # Filigree
 require 'filigree/class_methods_module'
 require 'filigree/configuration'
+require 'filigree/string'
 
 ##########
 # Errors #
 ##########
 
-class CommandNotFoundError  < RuntimeError
+class CommandNotFoundError < RuntimeError
 	def initialize(line)
 		super "No command found for '#{line}'"
 	end
@@ -117,7 +118,7 @@ module Filigree
 			# @return [void]
 			def config(&block)
 				@config = Class.new { include Filigree::Configuration }
-				@config.instance_exec &block
+				@config.instance_exec(&block)
 			end
 
 			# Attaches the provided help string to the command that is
@@ -217,6 +218,7 @@ module Filigree
 		# The default help command.  This can be added to your class via
 		# add_command.
 		HELP_COMMAND = Command.new('help', 'Prints this help message.', [], nil, Proc.new do
+
 			puts 'Usage: <command> [options] <args>'
 			puts
 			puts 'Commands:'

data/lib/filigree/configuration.rb

@@ -1,4 +1,4 @@
-# Author:		Chris Wailes <chris.wailes@gmail.com>
+# Author:		Chris Wailes <chris.wailes+filigree@gmail.com>
 # Project: 	Filigree
 # Date:		2013/05/14
 # Description:	Easy application configuration.
@@ -137,7 +137,7 @@ module Filigree
 				break if str == '--'
 
 				if option = find_option(str)
-					args = argv.shift(option.arity == -1 ? argv.index { |str| str[0,1] == '-' } : option.arity)
+					args = argv.shift(option.arity == -1 ? argv.index { |sub_str| sub_str[0,1] == '-' } : option.arity)
 
 					case option.handler
 					when Array
@@ -165,7 +165,7 @@ module Filigree
 		def handle_serialized_options(overloaded, set_opts)
 			options =
 			if overloaded.is_a? String
-				if File.exists? overloaded
+				if File.exist? overloaded
 					YAML.load_file overloaded
 				else
 					YAML.load overloaded
@@ -267,8 +267,6 @@ module Filigree
 			# @return [void]
 			def option(long, short = nil, conversions: nil, &block)
 
-				attr_accessor long.to_sym
-
 				long  = long.to_s
 				short = short.to_s if short
 
@@ -352,7 +350,7 @@ module Filigree
 			# Print the option information out as a string.
 			#
 			# Layout:
-			# |       ||--`long`,|| ||-`short`|| - |
+			# |       ||--`long`,|| ||-`short`|| ~ |
 			# |_______||_________||_||________||___|
 			#   indent    max_l+3  1   max_s+1   3
 			#
@@ -366,9 +364,9 @@ module Filigree
 				segmented_help = self.help.segment(segment_indent)
 
 				if self.short
-					sprintf "#{' ' * indent}%-#{max_long + 3}s %-#{max_short + 1}s - %s", "--#{self.long},", '-' + self.short, segmented_help
+					sprintf "#{' ' * indent}%-#{max_long + 3}s %-#{max_short + 1}s ~ %s", "--#{self.long},", '-' + self.short, segmented_help
 				else
-					sprintf "#{' ' * indent}%-#{max_long + max_short + 5}s - %s", '--' + self.long, segmented_help
+					sprintf "#{' ' * indent}%-#{max_long + max_short + 5}s ~ %s", '--' + self.long, segmented_help
 				end
 			end
 

data/lib/filigree/match.rb

@@ -1,4 +1,4 @@
-# Author:      Chris Wailes <chris.wailes@gmail.com>
+# Author:      Chris Wailes <chris.wailes+filigree@gmail.com>
 # Project:     Filigree
 # Date:        2013/05/04
 # Description: Pattern matching for Ruby.
@@ -22,152 +22,158 @@ require 'filigree/class'
 # An error that indicates that no pattern matched a given object.
 class MatchError < RuntimeError; end
 
+###########
+# Methods #
+###########
+
+# This is an implementation of pattern matching.  The objects passed to match
+# are tested against the patterns defined inside the match block.  The return
+# value of `match` will be the result of evaluating the block given to `with`.
+
+# The most basic pattern is the literal.  Here, the object or objects being
+# matched will be tested for equality with value passed to `with`.  In the
+# example below, the call to `match` will return `:one`.  Similar to the
+# literal pattern is the wildcard pattern `_`.  This will match any object.
+
+# You may also match against variables.  This can sometimes conflict with the
+# next kind of pattern, which is a binding pattern.  Here, the pattern will
+# match any object, and then make the object it matched available to the with
+# block via an attribute reader.  This is accomplished using the method_missing
+# callback, so if there is a variable or function with that name you might
+# accidentally compare against a variable.  To bind to a name that is already
+# in scope you can use the {Filigree::MatchEnvironment#Bind} method.  In
+# addition, class and destructuring pattern results (see bellow) can be bound
+# to a variable by using the {Filigree::BasicPattern#as} method.
+
+# If you wish to match string patterns you may use regular expressions.  Any
+# object that isn't a string will fail to match against a regular expression.
+# If the object being matched is a string then the regular expressions `match?`
+# method is used.  The result of the regular expression match is available
+# inside the with block via the match_data accessor.
+
+# When a class is used in a pattern it will match any object that is an
+# instance of that class.  If you wish to compare one regular expression to
+# another, or one class to another, you can force the comparison using the
+# {Filigree::MatchEnvironment#Literal} method.
+#
+# Destructuring patterns allow you to match against an instance of a class,
+# while simultaneously binding values stored inside the object to variables
+# in the context of the with block.  A class that is destructurable must
+# include the {Filigree::Destructurable} module.  You can then destructure an
+# object as shown bellow.
+
+# Both `match` and `with` can take multiple arguments.  When this happens, each
+# object is paired up with the corresponding pattern.  If they all match, then
+# the `with` clause matches.  In this way you can match against tuples.
+
+# Any with clause can be given a guard clause by passing a lambda as the last
+# argument to `with`.  These are evaluated after the pattern is matched, and
+# any bindings made in the pattern are available to the guard clause.
+
+# If you wish to evaluate the same body on matching any of several patterns you
+# may list them in order and then specify the body for the last pattern in the
+# group.
+
+# Patterns are evaluated in the order in which they are defined and the first
+# pattern to match is the one chosen.  You may define helper methods inside the
+# match block.  They will be re-defined every time the match statement is
+# evaluated, so you should move any definitions outside any match calls that
+# are being evaluated often.
+
+# @example The literal pattern
+#   def foo(n)
+#     match 1 do
+#       with(1) { :one   }
+#       with(2) { :two   }
+#       with(_) { :other }
+#     end
+#   end
+#
+#   foo(1)
+
+# @example Matching against variables
+#   var = 42
+#   match 42 do
+#     with(var) { :hoopy }
+#     with(0)   { :zero  }
+#   end
+
+# @example Binding patterns
+#   # Returns 42
+#   match 42 do
+#     with(x) { x }
+#   end
+
+#   x = 3
+#   # Returns 42
+#   match 42 do
+#     with(Bind(:x)) { x      }
+#     with(42)       { :hoopy }
+#   end
+
+# @example Regular expression and class instance pattern
+#    def matcher(object)
+#      match object do
+#        with(/hoopy/) { 42      }
+#        with(Integer) { 'hoopy' }
+#      end
+#    end
+
+#    # Returns 42
+#    matcher('hoopy')
+#    # Returns 'hoopy'
+#    matcher(42)
+
+# @example Destructuring an object
+#    class Foo
+#      include Filigree::Destructurable
+#      def initialize(a, b)
+#        @a = a
+#        @b = b
+#      end
+#
+#      def destructure(_)
+#         [@a, @b]
+#      end
+#    end
+
+#    # Returns true
+#    match Foo.new(4, 2) do
+#      with(Foo.(4, 2)) { true  }
+#      with(_)          { false }
+#    end
+
+# @example Using guard clauses
+#    match o do
+#      with(n, -> { n < 0 }) { :NEG  }
+#      with(0)               { :ZERO }
+#      with(n, -> { n > 0 }) { :POS  }
+#    end
+#
+# @param [Object]  objects  Objects to be matched
+# @param [Proc]    block    Block containing with clauses.
+#
+# @return [Object]  Result of evaluating the matched pattern's block
+def match(*objects, &block)
+	me = Filigree::MatchEnvironment.new
+
+	me.instance_exec(&block)
+
+	me.find_match(objects)
+end
+
 #######################
 # Classes and Modules #
 #######################
 
 module Filigree
 
+	using Filigree
+
 	###########
 	# Methods #
 	###########
 
-	# This is an implementation of pattern matching.  The objects passed to match
-	# are tested against the patterns defined inside the match block.  The return
-	# value of `match` will be the result of evaluating the block given to `with`.
-
-	# The most basic pattern is the literal.  Here, the object or objects being
-	# matched will be tested for equality with value passed to `with`.  In the
-	# example below, the call to `match` will return `:one`.  Similar to the
-	# literal pattern is the wildcard pattern `_`.  This will match any object.
-
-	# You may also match against variables.  This can sometimes conflict with the
-	# next kind of pattern, which is a binding pattern.  Here, the pattern will
-	# match any object, and then make the object it matched available to the with
-	# block via an attribute reader.  This is accomplished using the method_missing
-	# callback, so if there is a variable or function with that name you might
-	# accidentally compare against a variable.  To bind to a name that is already
-	# in scope you can use the {Filigree::MatchEnvironment#Bind} method.  In
-	# addition, class and destructuring pattern results (see bellow) can be bound
-	# to a variable by using the {Filigree::BasicPattern#as} method.
-
-	# If you wish to match string patterns you may use regular expressions.  Any
-	# object that isn't a string will fail to match against a regular expression.
-	# If the object being matched is a string then the regular expressions `match?`
-	# method is used.  The result of the regular expression match is available
-	# inside the with block via the match_data accessor.
-
-	# When a class is used in a pattern it will match any object that is an
-	# instance of that class.  If you wish to compare one regular expression to
-	# another, or one class to another, you can force the comparison using the
-	# {Filigree::MatchEnvironment#Literal} method.
-	#
-	# Destructuring patterns allow you to match against an instance of a class,
-	# while simultaneously binding values stored inside the object to variables
-	# in the context of the with block.  A class that is destructurable must
-	# include the {Filigree::Destructurable} module.  You can then destructure an
-	# object as shown bellow.
-
-	# Both `match` and `with` can take multiple arguments.  When this happens, each
-	# object is paired up with the corresponding pattern.  If they all match, then
-	# the `with` clause matches.  In this way you can match against tuples.
-
-	# Any with clause can be given a guard clause by passing a lambda as the last
-	# argument to `with`.  These are evaluated after the pattern is matched, and
-	# any bindings made in the pattern are available to the guard clause.
-
-	# If you wish to evaluate the same body on matching any of several patterns you
-	# may list them in order and then specify the body for the last pattern in the
-	# group.
-
-	# Patterns are evaluated in the order in which they are defined and the first
-	# pattern to match is the one chosen.  You may define helper methods inside the
-	# match block.  They will be re-defined every time the match statement is
-	# evaluated, so you should move any definitions outside any match calls that
-	# are being evaluated often.
-
-	# @example The literal pattern
-	#   def foo(n)
-	#     match 1 do
-	#       with(1) { :one   }
-	#       with(2) { :two   }
-	#       with(_) { :other }
-	#     end
-	#   end
-	#
-	#   foo(1)
-
-	# @example Matching against variables
-	#   var = 42
-	#   match 42 do
-	#     with(var) { :hoopy }
-	#     with(0)   { :zero  }
-	#   end
-
-	# @example Binding patterns
-	#   # Returns 42
-	#   match 42 do
-	#     with(x) { x }
-	#   end
-
-	#   x = 3
-	#   # Returns 42
-	#   match 42 do
-	#     with(Bind(:x)) { x      }
-	#     with(42)       { :hoopy }
-	#   end
-
-	# @example Regular expression and class instance pattern
-	#    def matcher(object)
-	#      match object do
-	#        with(/hoopy/) { 42      }
-	#        with(Integer) { 'hoopy' }
-	#      end
-	#    end
-
-	#    # Returns 42
-	#    matcher('hoopy')
-	#    # Returns 'hoopy'
-	#    matcher(42)
-
-	# @example Destructuring an object
-	#    class Foo
-	#      include Filigree::Destructurable
-	#      def initialize(a, b)
-	#        @a = a
-	#        @b = b
-	#      end
-	#
-	#      def destructure(_)
-	#         [@a, @b]
-	#      end
-	#    end
-
-	#    # Returns true
-	#    match Foo.new(4, 2) do
-	#      with(Foo.(4, 2)) { true  }
-	#      with(_)          { false }
-	#    end
-
-	# @example Using guard clauses
-	#    match o do
-	#      with(n, -> { n < 0 }) { :NEG  }
-	#      with(0)               { :ZERO }
-	#      with(n, -> { n > 0 }) { :POS  }
-	#    end
-	#
-	# @param [Object]  objects  Objects to be matched
-	# @param [Proc]    block    Block containing with clauses.
-	#
-	# @return [Object]  Result of evaluating the matched pattern's block
-	def match(*objects, &block)
-		me = Filigree::MatchEnvironment.new
-
-		me.instance_exec &block
-
-		me.find_match(objects)
-	end
-
 	# Wrap non-pattern objects in pattern objects so they can all be treated
 	# in the same way during pattern sorting and matching.
 	#
@@ -263,7 +269,7 @@ module Filigree
 			@patterns << (mp = OuterPattern.new(pattern, guard, block))
 
 			if block
-				@deferred.each { |pattern| pattern.block = block }
+				@deferred.each { |deferred_pattern| deferred_pattern.block = block }
 				@deferred.clear
 
 			else
@@ -613,10 +619,11 @@ module Filigree
 	end
 end
 
-###################################
-# Standard Library Deconstructors #
-###################################
+################################
+# Standard Library Refinements #
+################################
 
+# TODO: Figure out how to put this into a refinement.
 class Array
 	extend Filigree::Destructurable
 
@@ -627,7 +634,7 @@ class Array
 	# second elements, and then an array containing the remainder of the
 	# values.
 	#
-	# @param [Fixnum]  num_elems  Number of sub-pattern elements
+	# @param [Integer]  num_elems  Number of sub-pattern elements
 	#
 	# @return [Array<Object>]
 	def destructure(num_elems)
@@ -635,30 +642,34 @@ class Array
 	end
 end
 
-class Class
-	# Causes an instance of a class to be bound the the given name.
-	#
-	# @param [BindingPattern]  binding_pattern  Name to bind the instance to
-	def as(binding_pattern)
-		binding_pattern.tap { |bp| bp.pattern_elem = Filigree::InstancePattern.new(self) }
+module Filigree
+
+	refine Class do
+		# Causes an instance of a class to be bound the the given name.
+		#
+		# @param [BindingPattern]  binding_pattern  Name to bind the instance to
+		def as(binding_pattern)
+			binding_pattern.tap { |bp| bp.pattern_elem = Filigree::InstancePattern.new(self) }
+		end
 	end
-end
 
-class Regexp
-	# Causes a string matching the regular expression to be bound the the
-	# given name.
-	#
-	# @param [BindingPattern]  binding_pattern  Name to bind the instance to
-	def as(binding_pattern)
-		binding_pattern.tap { |bp| bp.pattern_elem = Filigree::RegexpPattern.new(self) }
+	refine Regexp do
+		# Causes a string matching the regular expression to be bound the the
+		# given name.
+		#
+		# @param [BindingPattern]  binding_pattern  Name to bind the instance to
+		def as(binding_pattern)
+			binding_pattern.tap { |bp| bp.pattern_elem = Filigree::RegexpPattern.new(self) }
+		end
 	end
-end
 
-class Symbol
-	# Turns a symbol into a binding pattern.
-	#
-	# @return [Filigree::BindingPattern]
-	def ~
-		Filigree::BindingPattern.new(self)
+	refine Symbol do
+		# Turns a symbol into a binding pattern.
+		#
+		# @return [Filigree::BindingPattern]
+		def ~
+			Filigree::BindingPattern.new(self)
+		end
 	end
+
 end