walrus 0.2 → 0.3

data/lib/walrus/grammar/multiline_comment.rb

@@ -0,0 +1,70 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar/comment.rb'
+
+module Walrus
+  class Grammar
+    class MultilineComment < Comment
+      # Multiline comments may contain nested Comments/Multiline comments or
+      # normal text, so must compile recursively.
+      #
+      # TODO: anchor comments that appear immediately before #def and #block
+      # directives to their corresponding methods (for the timebeing should
+      # note in the documentation that if you want your comments to appear
+      # adjacent to the blocks which follow them then you must put your
+      # comments inside the blocks)
+      def compile options = {}
+        compiled = ''
+        if @content.respond_to? :each
+          @content.each do |item|
+            if item.kind_of? Comment
+              compiled << '# (nested) ' + item.compile
+            else
+              first = true
+              item.to_s.each do |line|
+                if first
+                  first = false
+                  compiled << '# MultilineComment:' + line.to_s.chomp + "\n"
+                else
+                  compiled << '# MultilineComment (continued):' + line.to_s.chomp + "\n"
+                end
+              end
+            end
+          end
+        else
+          # no nesting, just raw text, but still must check for multiple lines
+          first = true
+          @content.to_s.each do |line|
+            if first
+              first = false
+              compiled << '# MultilineComment:' + line.to_s.chomp + "\n"
+            else
+              compiled << '# MultilineComment (continued):' + line.to_s.chomp + "\n"
+            end
+          end
+        end
+        compiled
+      end
+    end
+  end # class Grammar
+end # Walrus

data/lib/walrus/grammar/placeholder.rb

@@ -0,0 +1,47 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar.rb'
+
+module Walrus
+  class Grammar
+    class Placeholder < Walrat::Node
+      def compile options = {}
+        if options[:nest_placeholders] == true
+          method_name = "lookup_and_return_placeholder"     # placeholder nested inside another placeholder
+        else
+          method_name = "lookup_and_accumulate_placeholder" # placeholder used in a literal text stream
+        end
+
+        if @params == []
+          "#{method_name}(#{@name.to_s.to_sym.inspect})\n"
+        else
+          options = options.clone
+          options[:nest_placeholders] = true
+          params      = (@params.kind_of? Array) ? @params : [@params]
+          param_list  = params.map { |param| param.compile(options) }.join(', ').chomp
+          "#{method_name}(#{@name.to_s.to_sym.inspect}, #{param_list})\n"
+        end
+      end
+    end # class Placeholder
+  end # class Grammar
+end # Walrus

data/lib/walrus/grammar/raw_directive.rb

@@ -0,0 +1,50 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar.rb'
+
+module Walrus
+  class Grammar
+    class RawDirective < Directive
+      # Returns a string containing the compiled (Ruby) version of receiver.
+      def compile options = {}
+        compiled  = []
+        first     = true
+        @content.to_s.to_source_string.each do |line|
+          newline = ''
+          if line =~ /(\r\n|\r|\n)\z/       # check for literal newline at end of line
+            line.chomp!                     # get rid of it
+            newline = ' + ' + $~[0].dump    # include non-literal newline instead
+          end
+
+          if first
+            compiled << "accumulate('%s'%s) # RawDirective\n" % [ line, newline ]
+            first = false
+          else
+            compiled << "accumulate('%s'%s) # RawDirective (continued)\n" % [ line, newline ]
+          end
+        end
+        compiled.join
+      end
+    end # class RawDirective
+  end # class Grammar
+end # Walrus

data/lib/walrus/grammar/raw_text.rb

@@ -0,0 +1,56 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar.rb'
+require 'walrus/additions/string'
+
+module Walrus
+  class Grammar
+    class RawText < Walrat::Node
+      # Returns a string containing the compiled (Ruby) version of receiver.
+      # If options[:slurping] is true, instructs the receiver to strip the
+      # leading carriage return/line feed from the @lexeme prior to emitting
+      # the compiled output.
+      def compile options = {}
+        lexeme = options[:slurping] ? @lexeme.to_s.sub(/\A(\r\n|\r|\n)/, '') : @lexeme.to_s
+
+        compiled  = ''
+        first     = true
+        lexeme.to_source_string.each do |line|
+          newline = ''
+          if line =~ /(\r\n|\r|\n)\z/       # check for literal newline at end of line
+            line.chomp!                     # get rid of it
+            newline = ' + ' + $~[0].dump    # include non-literal newline instead
+          end
+
+          if first
+            compiled << "accumulate('%s'%s) # RawText\n" % [ line, newline ]
+            first = false
+          else
+            compiled << "accumulate('%s'%s) # RawText (continued)\n" % [ line, newline ]
+          end
+        end
+        compiled
+      end
+    end # class RawText
+  end # class Grammar
+end # Walrus

data/lib/walrus/grammar/ruby_directive.rb

@@ -0,0 +1,41 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar.rb'
+
+module Walrus
+  class Grammar
+    class RubyDirective < Directive
+      # TODO: could make a #rubyecho method that did an "accumulate do" instead
+      # of instance_eval
+      def compile options = {}
+        # possible problem here is that the compiler will indent each line for
+        # us, possibly breaking here docs etc
+        # seeing as it is going to be indented anyway, I add some additional
+        # indenting here for pretty printing purposes
+        compiled = "instance_eval do # Ruby directive\n"
+        @content.to_s.each { |line| compiled << '  ' + line }
+        compiled << "end\n"
+      end
+    end # class RawDirective
+  end # class Grammar
+end # Walrus

data/lib/walrus/grammar/ruby_expression.rb

@@ -0,0 +1,42 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar.rb'
+
+module Walrus
+  class Grammar
+    class RubyExpression < Walrat::Node
+      # Rather than just compiling Ruby expressions back to text in a generic
+      # fashion it is desirable to compile the pieces separately (for an
+      # example, see the AssignmentExpression class) because this allows us to
+      # handle placeholders embedded inside Ruby expressions.
+      #
+      # Nevertheless, at an abstract level we here supply a default compilation
+      # method which just returns the source text, suitable for evaluation.
+      # Subclasses can then override this as new cases are discovered which
+      # require piece-by-piece compilation.
+      def compile options = {}
+        source_text
+      end
+    end # class RubyExpression
+  end # class Grammar
+end # Walrus

data/lib/walrus/grammar/set_directive.rb

@@ -0,0 +1,34 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar.rb'
+
+module Walrus
+  class Grammar
+    class SetDirective < Directive
+      def compile options = {}
+        "set_value(%s, instance_eval { %s }) # Set directive \n" %
+          [ @placeholder.to_s.dump, @expression.compile ]
+      end
+    end # class SetDirective
+  end # class Grammar
+end # Walrus

data/lib/walrus/grammar/silent_directive.rb

@@ -0,0 +1,51 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar.rb'
+
+module Walrus
+  class Grammar
+    class SilentDirective < Directive
+      def compile options = {}
+        if @expression.respond_to? :each
+          expression = @expression
+        else
+          expression = [@expression]
+        end
+
+        # TODO: potentially include line, col and file name info in the comments generated by the compiler
+
+        compiled  = ''
+        first     = true
+        expression.each do |expr| 
+          if first
+            compiled << "instance_eval { %s } # Silent directive\n" % expr.compile
+            first = false
+          else
+            compiled << "instance_eval { %s } # Silent directive (continued)\n" % expr.compile
+          end
+        end
+        compiled
+      end
+    end # class SilentDirective
+  end # class Grammar
+end # Walrus

data/lib/walrus/grammar/slurp_directive.rb

@@ -0,0 +1,36 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar.rb'
+
+module Walrus
+  class Grammar
+    class SlurpDirective < Directive
+      # The slurp directive produces no meaningful output; but we leave a
+      # comment in the compiled template so that the location of the directive
+      # is visible in the source.
+      def compile options = {}
+        "# Slurp directive\n"
+      end
+    end # class SlurpDirective
+  end # class Grammar
+end # Walrus

data/lib/walrus/grammar/super_directive.rb

@@ -0,0 +1,34 @@
+# Copyright 2007-2010 Wincent Colaiuta. All rights reserved.
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require 'walrus/grammar.rb'
+
+module Walrus
+  class Grammar
+    class SuperDirective < Directive
+      def compile options = {}
+        # basic case, no explicit parameters
+        "super # Super directive\n"
+      end
+    end # class SuperDirective
+  end # class Grammar
+end # Walrus