livetext 0.9.23 → 0.9.26

data/plugin/pyggish.rb

@@ -34,139 +34,139 @@ def self.pyg_finalize(code, lexer=:elixir)
   code.sub!(/<pre>/, "<pre>\n")
   code.gsub!(/<span class="[np]">/, "")
   code.gsub!(/<\/span>/, "")
-  color = _codebar_color(lexer)
-  code.sub!(/<td class="linenos"/, "<td width=2%></td><td width=5% bgcolor=#{color}")
-  code.gsub!(/<td/, "<td valign=top ")
-  code.gsub!(/ class="[^"]*?"/, "")    # Get rid of remaining Pygments CSS
-  lines = code.split("\n")
-  n1 = lines.index {|x| x =~ /<pre>/ }
-  n2 = lines.index {|x| x =~ /<\/pre>/ }
-  # FIXME ?
-  n1 ||= 0
-  n2 ||= -1
-  lines[n1].sub!(/ 1$/, "  1 ")
-  (n1+1).upto(n2) {|n| lines[n].replace(" " + lines[n] + " ") }
-  code = lines.join("\n")
-  code
-end
+    color = _codebar_color(lexer)
+    code.sub!(/<td class="linenos"/, "<td width=2%></td><td width=5% bgcolor=#{color}")
+    code.gsub!(/<td/, "<td valign=top ")
+    code.gsub!(/ class="[^"]*?"/, "")    # Get rid of remaining Pygments CSS
+    lines = code.split("\n")
+    n1 = lines.index {|x| x =~ /<pre>/ }
+    n2 = lines.index {|x| x =~ /<\/pre>/ }
+    # FIXME ?
+    n1 ||= 0
+    n2 ||= -1
+    lines[n1].sub!(/ 1$/, "  1 ")
+    (n1+1).upto(n2) {|n| lines[n].replace(" " + lines[n] + " ") }
+    code = lines.join("\n")
+    code
+  end
 
-def _process_code(text)
-  lines = text.split("\n")
-  lines = lines.select {|x| x !~ /##~ omit/ }
-  @refs = {}
-  lines.each.with_index do |line, i|
-    if line =~ /##~ ref/
-      frag, name = line.split(/ *##~ ref/)
-      @refs[name.strip] = i
-      line.replace(frag)
+  def _process_code(text)
+    lines = text.split("\n")
+    lines = lines.select {|x| x !~ /##~ omit/ }
+    @refs = {}
+    lines.each.with_index do |line, i|
+      if line =~ /##~ ref/
+        frag, name = line.split(/ *##~ ref/)
+        @refs[name.strip] = i
+        line.replace(frag)
+      end
     end
+    lines.map! {|line| "  " + line }
+    text2 = lines.join("\n")
+    text.replace(text2)
   end
-  lines.map! {|line| "  " + line }
-  text2 = lines.join("\n")
-  text.replace(text2)
-end
 
-def _colorize(code, lexer=:elixir)
-  text = ::Pygments.highlight(code, lexer: lexer, options: {linenos: "table"})
-  _debug "--- in _colorize: text = #{text.inspect}"
-  text2 = PygmentFix.pyg_finalize(text, lexer)
-  result = "<!-- colorized code -->\n" + text2
-  result
-end
-
-def _colorize!(code, lexer=:elixir)
-  text = ::Pygments.highlight(code, lexer: lexer, options: {})
-  _debug "--- in _colorize!: text = #{text.inspect}"
-  text2 = PygmentFix.pyg_finalize(text, lexer)
-  result = "<!-- colorized code -->\n" + text2
-  result
-end
+  def _colorize(code, lexer=:elixir)
+    text = ::Pygments.highlight(code, lexer: lexer, options: {linenos: "table"})
+    _debug "--- in _colorize: text = #{text.inspect}"
+    text2 = PygmentFix.pyg_finalize(text, lexer)
+    result = "<!-- colorized code -->\n" + text2
+    result
+  end
 
-def fragment
-  lang = @_args.empty? ? :elixir : @_args.first.to_sym   # ruby or elixir
-  @_args = []
-# TTY.puts "\n#{self.inspect}"
-  send(lang)
-  _out "\n"
-end
+  def _colorize!(code, lexer=:elixir)
+    text = ::Pygments.highlight(code, lexer: lexer, options: {})
+    _debug "--- in _colorize!: text = #{text.inspect}"
+    text2 = PygmentFix.pyg_finalize(text, lexer)
+    result = "<!-- colorized code -->\n" + text2
+    result
+  end
 
-def code       # FIXME ?
-  text = ""   
-  _body {|line| _out "    " + line }
-end
+  def fragment
+    lang = api.args.empty? ? :elixir : api.args.first.to_sym   # ruby or elixir
+    api.args = []
+  # TTY.puts "\n#{self.inspect}"
+    send(lang)
+    api.out "\n"
+  end
 
-def mono
-  _out "<pre>"
-  _body {|line| _out "    " + line }
-  _out "</pre>"
-end
+  def code       # FIXME ?
+    text = ""   
+    api.body {|line| api.out "    " + line }
+  end
 
-def create_code_styles
-  dir = @_outdir || "."
-  theme, back = "Github", "white"
-  css = Rouge::Themes.const_get(theme).render(scope: '.rb_highlight')
-  added = <<~CSS
-    .rb_highlight { 
-    font-family: 'Monaco', 'Andale Mono', 'Lucida Grande', 'Courier', 'Lucida Console', 'Courier New', monospace;
-    white-space: pre; 
-    background-color: #{back} 
-    }
-  CSS
-
-  css.gsub!(/{\n/, "{\n  font-family: courier;")
-  css = added + "\n" + css
-  # STDERR.puts "Writing #{theme} theme to ruby.css"
-  File.write("#{dir}/ruby.css", css)
-
-  css = Rouge::Themes.const_get(theme).render(scope: '.ex_highlight')
-  added = added.sub(/rb/, "ex")
-  css.gsub!(/{\n/, "{\n  font-family: courier;")
-  css = added + "\n" + css 
-  # STDERR.puts "Writing #{theme} theme to elixir.css"
-  File.write("#{dir}/elixir.css", css)
-end
+  def mono
+    api.out "<pre>"
+    api.body {|line| api.out "    " + line }
+    api.out "</pre>"
+  end
 
+  def create_code_styles
+    dir = @_outdir || "."
+    theme, back = "Github", "white"
+    css = Rouge::Themes.const_get(theme).render(scope: '.rb_highlight')
+    added = <<~CSS
+      .rb_highlight { 
+      font-family: 'Monaco', 'Andale Mono', 'Lucida Grande', 'Courier', 'Lucida Console', 'Courier New', monospace;
+      white-space: pre; 
+      background-color: #{back} 
+      }
+    CSS
+
+    css.gsub!(/{\n/, "{\n  font-family: courier;")
+    css = added + "\n" + css
+    # STDERR.puts "Writing #{theme} theme to ruby.css"
+    File.write("#{dir}/ruby.css", css)
+
+    css = Rouge::Themes.const_get(theme).render(scope: '.ex_highlight')
+    added = added.sub(/rb/, "ex")
+    css.gsub!(/{\n/, "{\n  font-family: courier;")
+    css = added + "\n" + css 
+    # STDERR.puts "Writing #{theme} theme to elixir.css"
+    File.write("#{dir}/elixir.css", css)
+  end
 
-def format_ruby(source, theme = "Github", back = "black")
-  # theme/back not used now
-  formatter = Rouge::Formatters::HTML.new
-  lexer = Rouge::Lexers::Ruby.new
-  body = formatter.format(lexer.lex(source))
-  text = "<div class=rb_highlight>#{body}</div>"
-  text
-end
 
-def format_elixir(source, theme = "Github", back = "black")
-  # theme/back not used now
-  formatter = Rouge::Formatters::HTML.new
-  lexer = Rouge::Lexers::Elixir.new
-  body = formatter.format(lexer.lex(source))
-  text = "<div class=ex_highlight>#{body}</div>"
-  text
-end
+  def format_ruby(source, theme = "Github", back = "black")
+    # theme/back not used now
+    formatter = Rouge::Formatters::HTML.new
+    lexer = Rouge::Lexers::Ruby.new
+    body = formatter.format(lexer.lex(source))
+    text = "<div class=rb_highlight>#{body}</div>"
+    text
+  end
 
-def ruby
-  file = @_args.first 
-  if file.nil?
-    code = "  # Ruby code\n\n"
-    _body {|line| code << "  " + line + "\n" }
-  else
-    code = "# Ruby code\n\n" + ::File.read(file)
+  def format_elixir(source, theme = "Github", back = "black")
+    # theme/back not used now
+    formatter = Rouge::Formatters::HTML.new
+    lexer = Rouge::Lexers::Elixir.new
+    body = formatter.format(lexer.lex(source))
+    text = "<div class=ex_highlight>#{body}</div>"
+    text
   end
 
-  html = format_ruby(code)
-  _out html
-end
+  def ruby
+    file = api.args.first 
+    if file.nil?
+      code = "  # Ruby code\n\n"
+      api.body {|line| code << "  " + line + "\n" }
+    else
+      code = "# Ruby code\n\n" + ::File.read(file)
+    end
 
-def elixir
-  file = @_args.first 
-  if file.nil?
-    code = ""
-    _body {|line| code << "  " + line + "\n" }
-  else
-    code = ::File.read(file)
+    html = format_ruby(code)
+    api.out html
   end
 
-  html = format_elixir(code)
-  _out html
+  def elixir
+    file = api.args.first 
+    if file.nil?
+      code = ""
+      api.body {|line| code << "  " + line + "\n" }
+    else
+      code = ::File.read(file)
+    end
+
+    html = format_elixir(code)
+    api.out html
 end

data/plugin/tutorial.rb

@@ -2,22 +2,22 @@ require 'cgi'
 
 def title(args = nil, body = nil)
   h1
-  _optional_blank_line
+  api.optional_blank_line
 end
 
 def section(args = nil, body = nil)
   h3
-  _optional_blank_line
+  api.optional_blank_line
 end
 
 def code(args = nil, body = nil)
   first = true  # dumb hack! fixes blank space
-  _body do |line| 
+  api.body do |line| 
     tag, first = "<pre>", false if first
-    _out "#{tag}   #{::CGI.escape_html(line)}"   # indentation
+    api.out "#{tag}   #{::CGI.escape_html(line)}"   # indentation
   end
-  _out "</pre>"
-  _optional_blank_line
+  api.out "</pre>"
+  api.optional_blank_line
 end
 
 def rx(str)
@@ -25,14 +25,14 @@ def rx(str)
 end
 
 def inout(args = nil, body = nil)
-  src, out = _args
+  src, out = api.args
   t1 = ::File.readlines(src) rescue (abort "t1 = #{src}")
   t2 = ::File.readlines(out) rescue (abort "t2 = #{out}")
   # To pacify markdown for README (FIXME later)
   t1 = t1.map {|x| " " + x.sub(/ +$/,"").gsub(/_/, "\\_") }.join
   t2 = t2.map {|x| " " + x.sub(/ +$/,"").gsub(/_/, "\\_") }.join
 
-  _out <<-HTML
+  api.out <<-HTML
     <table width=80% cellpadding=4>
     <tr>
       <td width=50%><b>Input</b></td>
@@ -48,7 +48,7 @@ def inout(args = nil, body = nil)
     </tr>
     </table>
   HTML
-  _optional_blank_line
+  api.optional_blank_line
 end
 
 def put_table(src, exp)
@@ -57,7 +57,7 @@ def put_table(src, exp)
   t1 = t1.map {|x| " " + x.sub(/ +$/,"").gsub(/_/, "\\_") }.join
   t2 = t2.map {|x| " " + x.sub(/ +$/,"").gsub(/_/, "\\_") }.join
 
-  _out <<-HTML
+  api.out <<-HTML
     <font size=+1>
     <table width=80% cellpadding=4>
     <tr>
@@ -78,11 +78,11 @@ def put_table(src, exp)
 end
 
 def testcase(args = nil, body = nil)
-  name = _args.first
-  _out "\n<font size=+1><b>Test: </font><font size=+2><tt>#{name}</tt></font></b></h3><br>"
+  name = api.args.first
+  api.out "\n<font size=+1><b>Test: </font><font size=+2><tt>#{name}</tt></font></b></h3><br>"
   src, exp = "test/snapshots/#{name}/source.lt3", "test/snapshots/#{name}/expected-output.txt"
-  @_args = [src, exp]   # Better way to do this??
+  api.args = [src, exp]   # Better way to do this??
   put_table(src, exp)
-  _out "<br>"
-  _optional_blank_line
+  api.out "<br>"
+  api.optional_blank_line
 end

data/test/all.rb

@@ -1,3 +1,9 @@
+require 'simplecov'            # These two lines must go first
+SimpleCov.start  do
+  puts "SimpleCov: Snapshots"
+  enable_coverage :branch
+  add_filter "/test/"
+end
 
 require_relative 'unit/all'
 require_relative 'snapshots'             # snapshots

data/test/snapshots/basic_formatting/actual-output.txt

@@ -0,0 +1,13 @@
+Here are examples of <b>boldface</b>
+and <i>italics</i>
+and <font size=+1><tt>code</tt></font>
+as well as <b>ore complex</b>*examples 
+of <i>talicized text</i>
+and <font size=+1><tt>ode font</tt></font>
+<p>
+
+Here are some random punctuation marks:
+; # . * * ` ` @ % ^ & $
+<p>
+
+No need to escape these:  * * `

data/test/snapshots/basic_formatting/err-sdiff.txt

@@ -0,0 +1 @@
+ACTUAL                                                      | EXPECTED                                                    

data/test/snapshots/basic_formatting/out-sdiff.txt

@@ -0,0 +1,14 @@
+ACTUAL                                                      | EXPECTED                                                    
+Here are examples of <b>boldface</b>                        | Here are examples of <b>boldface</b> 
+and <i>italics</i>                                            and <i>italics</i>
+and <font size=+1><tt>code</tt></font>                        and <font size=+1><tt>code</tt></font>
+as well as <b>ore complex</b>*examples                      | as well as <b>more complex</b> examples 
+of <i>talicized text</i>                                    | of <i>italicized text</i>
+and <font size=+1><tt>ode font</tt></font>                  | and <font size=+1><tt>code font</tt></font>.
+<p>                                                           <p>
+
+Here are some random punctuation marks:                       Here are some random punctuation marks:
+; # . * * ` ` @ % ^ & $                                     | ; # . * _ ` : @ % ^ & $
+<p>                                                           <p>
+
+No need to escape these:  * * `                             | No need to escape these:  * _ `

data/test/snapshots/def_method/expected-output.txt

@@ -1,5 +1,7 @@
 abc
 123
 xyz
+<p>
+
 xyzzy
 123

data/test/snapshots/def_method/source.lt3

@@ -2,10 +2,12 @@
 abc
 123
 .def foobar     # yet another experimental comment
-::STDERR.puts "This is the"
-::STDERR.puts "foobar method"
+  ::STDERR.puts "This is the"
+  ::STDERR.puts "foobar method"
+  true
 .end
 xyz
 .foobar     # and still another
+
 xyzzy
 123

data/test/snapshots/error_inc_line_num/{OUT → README.txt}

@@ -1,17 +1,20 @@
+---- File: source.lt3
+
 This is my 
 source file
 which includes file2 here:
+.include file2.lt3
+
+And here we are
+back in the
+original file.
+
+--- File: file2.lt3
+
   This is file2
   which has an error
   about an unknown command
   in line 5
-This is my 
-source file
-which includes file2 here:
-  This is file2
-  which has an error
-  about an unknown command
-  in line 5
-<p>
+.foobar
 
   And this is file2 line 7.

data/test/snapshots/error_inc_line_num/expected-output.txt

@@ -5,9 +5,3 @@ which includes file2 here:
   which has an error
   about an unknown command
   in line 5
-<p>
-
-  And this is file2 line 7.
-And here we are
-back in the
-original file.

data/test/snapshots/error_inc_line_num/match-error.txt

@@ -1 +1 @@
-1 /Name 'foobar' is unknown/
+1 /Error: name 'foobar' is unknown/

data/test/snapshots/error_invalid_name/foo

@@ -0,0 +1,5 @@
+T
+a
+t
+<p>
+

data/test/snapshots/error_line_num/match-error.txt

@@ -1 +1 @@
-1 /Name 'foobar' is unknown/
+1 /Error: name 'foobar' is unknown/

data/test/snapshots/error_missing_end/expected-output.txt

@@ -2,4 +2,3 @@ Blah
 blah
 <p>
 
-

data/test/snapshots/error_name_not_permitted/expected-output.txt

@@ -0,0 +1,4 @@
+Names such as 'class'
+are not permitted here...
+<p>
+

data/test/snapshots/error_name_not_permitted/match-error.txt

@@ -1 +1 @@
- 1  /Disallowed/
+ 1  /name 'class' is invalid/

data/test/snapshots/error_no_such_copy/expected-output.txt

@@ -2,3 +2,4 @@ Make sure a
 nonexistent file with .copy
 gives an error.
 <p>
+

data/test/snapshots/error_no_such_mixin/expected-output.txt

@@ -3,3 +3,4 @@ we give an error
 when a mixin does not
 exist:
 <p>
+

data/test/snapshots/error_no_such_mixin/match-error.txt

@@ -1 +1 @@
-1 /No such mixin 'nosuchthing'/
+1 /file 'nosuchthing' not found/

data/test/snapshots/error_no_such_mixin/source.lt3

@@ -1,4 +1,4 @@
-Test that 
+Test that
 we give an error
 when a mixin does not
 exist:

data/test/snapshots/example_alpha/source.lt3

@@ -1,7 +1,7 @@
 .def alpha
-   text = _body.to_a.join(" ")
+   text = api.body.to_a.join(" ")
    words = text.split.sort
-   words.each {|w| _out "    #{w}" }
+   words.each {|w| api.out "    #{w}" }
 .end
 Here is an alphabetized list:
 

data/test/snapshots/example_alpha2/expected-output.txt

@@ -7,6 +7,4 @@ fishmonger     fusillade      glyph
 gryphon        halcyon        manicotti      
 mataeotechny   pareidolia     quark          
 zootrope       zymurgy        
-<p>
-
 And that is all.

data/test/snapshots/example_alpha2/source.lt3

@@ -1,15 +1,16 @@
 .def alpha
-   cols = _args.first
+   cols = api.args.first
    cols = "1" if cols == ""
    cols = cols.to_i
    raise "Columns must be 1-5" unless cols.between?(1,5)
-   text = _body.join("\n")
+   text = api.body.join("\n")
    text.gsub!(/\n/, " ")
    words = text.split.sort
    words.each_slice(cols) do |row| 
-     row.each {|w| _out! '%-15s' % w }
-     _out
+     row.each {|w| api.out! '%-15s' % w }
+     api.out
    end
+   api.optional_blank_line
 .end
 Here is an alphabetized list:
 

data/test/snapshots/import/expected-output.txt

@@ -1,5 +1,6 @@
-Test fake command .icanhaz:
+Test .import:
 we give an error
 when a .rb does not
 exist:
 <p>
+

data/test/snapshots/import/match-error.txt

@@ -1 +1 @@
-1 /No such mixin 'nonexistent'/
+1 /file 'nonexistent' not found/

data/test/snapshots/import/simple_import.rb

@@ -1,5 +1,5 @@
 module SimpleImport
   def hello_world
-    _out "Hello, world."
+    api.out "Hello, world."
   end
 end

data/test/snapshots/import2/simple_import.rb

@@ -1,5 +1,5 @@
 module SimpleImport
   def hello_world
-    _out "Hello, world."
+    api.out "Hello, world."
   end
 end

data/test/snapshots/import_bookish/expected-output.txt

@@ -1,10 +1,10 @@
 <table cellpadding=2>
 <tr>
-  <td width=[0, 0]% valign=top>this</td>
-  <td width=[0, 0]% valign=top>that</td>
+  <td width=0% valign=top>this</td>
+  <td width=0% valign=top>that</td>
 </tr>
 <tr>
-  <td width=[0, 0]% valign=top>foo</td>
-  <td width=[0, 0]% valign=top>bar</td>
+  <td width=0% valign=top>foo</td>
+  <td width=0% valign=top>bar</td>
 </tr>
 </table>

data/test/snapshots/more_functions/actual-output.txt

@@ -0,0 +1,37 @@
+Testing some more functions here...
+<p>
+
+Here I am calling a function  with 
+a colon parameter...
+<p>
+
+<p>
+
+Next let's <b>do</b>*something with our parameter:
+<p>
+
+I'll call these variants...
+<p>
+
+"Motel" spelled backwards is letom :)
+<p>
+
+"lamina" reversed is animal
+<p>
+
+I can also use the erutaef tekcarb here.
+<p>
+
+If I don't use a parameter for [Error evaluating $$reverse()] - it gives
+me an error. (Bug or feature??)
+<p>
+
+What if a function doesn't use parameters at all, but
+we pass them? Hmm...
+<p>
+
+Now we succeed and succeed some more
+and finally we succeed in life.
+<p>
+
+But can we succeed, when our beds are burning?

data/test/snapshots/more_functions/err-sdiff.txt

@@ -0,0 +1 @@
+ACTUAL                                                      | EXPECTED                                                    

data/test/snapshots/more_functions/expected-output.txt

@@ -7,7 +7,7 @@ a colon parameter...
 
 <p>
 
-Next let's <b>do*</b> something with our parameter:
+Next let's <b>do</b> something with our parameter:
 <p>
 
 I'll call these variants...