walrus 0.2 → 0.3

data/lib/walrus/walrus_grammar/multiline_comment.rb

@@ -1,60 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that RawText class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class MultilineComment
-      
-      # Multiline comments may containing 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 WalrusGrammar
-end # Walrus
-

data/lib/walrus/walrus_grammar/placeholder.rb

@@ -1,46 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that RawText class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class Placeholder
-      
-      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.collect { |param| param.compile(options) }.join(', ').chomp
-          "#{method_name}(#{@name.to_s.to_sym.inspect}, #{param_list})\n"
-        end
-        
-      end
-      
-    end # class Placeholder
-    
-  end # class WalrusGrammar
-end # Walrus
-

data/lib/walrus/walrus_grammar/raw_directive.rb

@@ -1,48 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that RawText class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class RawDirective
-      
-      # 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 WalrusGrammar
-end # Walrus
-

data/lib/walrus/walrus_grammar/raw_text.rb

@@ -1,51 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that RawText class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class RawText
-      
-      # 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 WalrusGrammar
-end # Walrus
-

data/lib/walrus/walrus_grammar/ruby_directive.rb

@@ -1,35 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that RawText class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class RubyDirective
-      
-      # 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 WalrusGrammar
-end # Walrus
-

data/lib/walrus/walrus_grammar/ruby_expression.rb

@@ -1,37 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that RawText class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class RubyExpression
-      
-      # 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 AssignmentExpression
-    
-  end # class WalrusGrammar
-end # Walrus
-

data/lib/walrus/walrus_grammar/set_directive.rb

@@ -1,30 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that RawText class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class SetDirective
-      
-      def compile(options = {})
-        "set_value(%s, instance_eval { %s }) # Set directive \n" % [ @placeholder.to_s.dump, @expression.compile ]
-      end
-      
-    end # class SetDirective
-    
-  end # class WalrusGrammar
-end # Walrus
-

data/lib/walrus/walrus_grammar/silent_directive.rb

@@ -1,50 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that RawText class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class SilentDirective
-      
-      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 WalrusGrammar
-end # Walrus
-

data/lib/walrus/walrus_grammar/slurp_directive.rb

@@ -1,31 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that the class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class SlurpDirective
-      
-      # 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 WalrusGrammar
-end # Walrus
-

data/lib/walrus/walrus_grammar/super_directive.rb

@@ -1,33 +0,0 @@
-# Copyright 2007 Wincent Colaiuta
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require 'walrus/parser.rb' # make sure that the class has been defined prior to extending it
-
-module Walrus
-  class WalrusGrammar
-    
-    class SuperDirective
-      
-      def compile(options = {})
-        
-        # basic case, no explicit parameters
-        "super # Super directive\n"
-        
-      end
-      
-    end # class SuperDirective
-    
-  end # class WalrusGrammar
-end # Walrus
-