module Calcula

@author Paul T.

This module contains the lexer and the parser for Calcula. In the future, the runtime aspect will be included also.

@author Paul T.

Constants

VERSION

Public Class Methods

compile(src) click to toggle source

Combines the essential declarations with the compiled Calcula code together

@param src [String] The Calcula source code @return [String] The complete executable ruby code

# File lib/calcula.rb, line 83
  def Calcula::compile(src)
    <<-EOS
#{Calcula::stdRubyHeader}
# CALCULA SOURCE CODE STARTS HERE
#{Calcula::parse(Calcula::lex(src)).collect{ |e| e.to_s(form: :ruby) }.join("\n")}
    EOS
  end

lex(txt) click to toggle source

Short hand for calling `Calcula::Lexer.new(txt).lex`

@see Calcula::Lexer#lex @param txt [String] The Calcula source code @return [Array<Calcula::Token>] Generated based on the source code

# File lib/calcula.rb, line 27
def Calcula::lex(txt)
  Lexer.new(txt).lex
end

parse(toks) click to toggle source

Short hand for calling `Calcula::Parser.new(toks).parse` repetitively.

@see Calcula::Parser#parse @param toks [Array<Calcula::Token>] This should be supplied by `Calcula::lex`. @return [Array<Calcula::Expr>] Multiple parse trees

# File lib/calcula.rb, line 36
def Calcula::parse(toks)
  rst = []
  parser = Parser.new(toks)
  while (r = parser.parse) != nil do
    rst << r
  end
  return rst
end

stdRubyHeader() click to toggle source

Essential declarations so the Calcula to Ruby option will work

@return [String] The declarations

# File lib/calcula.rb, line 48
  def Calcula::stdRubyHeader
    txt = <<-EOT
class Numeric
  def call(x)   # Allowing 10.(20) to work (becomes 200)
    self * x
  end
end
class Proc
  def +(g)
    ->(*args){ self.(*args) + g.(*args) }
  end
  def -(g)
    ->(*args){ self.(*args) - g.(*args) }
  end
  def *(g)
    ->(*args){ self.(*args) * g.(*args) }
  end
  def /(g)
    ->(*args){ self.(*args) / g.(*args) }
  end
  def %(g)
    ->(*args){ self.(*args) % g.(*args) }
  end
  def **(g)
    ->(*args){ self.(*args) ** g.(*args) }
  end
end
    EOT
    return txt
  end