emerald-lang 1.0.0

data/lib/emerald/grammar/scopes.tt

@@ -0,0 +1,48 @@
+#
+# Context free grammar of tokens (terminal
+# nodes) for the Emerald language.
+#
+grammar Scopes
+  include Variables
+
+  rule scope_fn
+    (given / unless / each / with) "\n"
+    <ScopeFn>
+  end
+
+  rule given
+    "given" space* boolean_expr <Given>
+  end
+
+  rule unless
+    "unless" space* boolean_expr <Unless>
+  end
+
+  rule with
+    "with" space* variable_name <With>
+  end
+
+  rule each
+    "each" space* collection:variable_name
+    space* "as" space* val_name:variable_name
+    indexed:(',' space* key_name:variable_name)?
+    <Each>
+  end
+
+  rule boolean_expr
+    binary_expr / unary_expr
+  end
+
+  rule binary_expr
+    lhs:unary_expr
+    space+ op:("and" / "or") space*
+    rhs:boolean_expr
+    <BinaryExpr>
+  end
+
+  rule unary_expr
+    negated:("not" space+)?
+    (val:variable_name / '(' space* val:boolean_expr space* ')')
+    <UnaryExpr>
+  end
+end

data/lib/emerald/grammar/tokens.tt

@@ -0,0 +1,57 @@
+#
+# Context free grammar of tokens (terminal
+# nodes) for the Emerald language.
+#
+grammar Tokens
+  rule base_keyword
+    'images' / 'metas' / 'scripts' / 'styles'
+  end
+
+  rule special_keyword
+    'images' / 'scripts' / 'styles'
+  end
+
+  rule tag
+    [a-z] [a-z1-9]*
+  end
+
+  rule attr
+    [a-z\-_]+
+  end
+
+  rule event
+    'onabort' / 'onclick' / 'onhover' / 'onbeforeprint' / 'onbeforeunload'
+  end
+
+  rule equals
+    '='
+  end
+
+  rule comma
+    ','
+  end
+
+  rule lparen
+    '('
+  end
+
+  rule rparen
+    ')'
+  end
+
+  rule lbrace
+    "{"
+  end
+
+  rule rbrace
+    "}"
+  end
+
+  rule space
+    ' '
+  end
+
+  rule newline
+    [\n] <Node>
+  end
+end

data/lib/emerald/grammar/variables.tt

@@ -0,0 +1,10 @@
+# Variable support in Emerald
+grammar Variables
+  rule variable
+    '|' variable_name '|' <Variable>
+  end
+
+  rule variable_name
+    [a-zA-Z0-9_]+ ('.' variable_name)* <VariableName>
+  end
+end

data/lib/emerald/index.emr

@@ -0,0 +1,33 @@
+html
+  head
+    styles
+      "public/css/main.emr"
+
+    scripts
+      "public/js/main.js"
+
+  body
+    nav
+      a Emerald
+      a Docs
+      a Github
+
+    header
+      h1 Emerald!
+      h2 A templating engine for multiple languages.
+
+    main
+      section
+        h3 About
+        p Emerald is a templating engine designed for use in multiple languages.
+        p Emerald may be used as a templating engine for node, python, ruby, or go web applications.
+        h1 ->
+          this is some literal text, not an actual tag
+            with an indent
+          and multiple lines
+          and an e$cape character
+          p and a tag
+        p this is an actual tag now
+
+      footer
+        p Copyright Emerald Language 2016

data/lib/emerald/nodes/attribute_list.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'node'
+
+# elements[2] is the attributes
+# call to_html() on them.
+class AttributeList < Node
+  def to_html(context)
+    elements[4].to_html(context)
+  end
+end

data/lib/emerald/nodes/attributes.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'node'
+
+# The attributes hash for an element
+class Attributes < Node
+  def to_html(context)
+    output = ''
+    elements.each do |e|
+      output += " #{e.elements[0].text_value}=\"#{e.elements[2].to_html(context)}\""
+    end
+    output
+  end
+end

data/lib/emerald/nodes/base_scope_fn.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+
+# Base class for scope functions
+class BaseScopeFn < Treetop::Runtime::SyntaxNode
+  def to_html(_body, _context)
+    raise 'not implemented :('
+  end
+end

data/lib/emerald/nodes/binary_expr.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'boolean_expr'
+
+# A boolean expression with two children and an operator
+class BinaryExpr < BooleanExpr
+  def truthy?(context)
+    case op.text_value
+    when 'and'
+      lhs.truthy?(context) && rhs.truthy?(context)
+    when 'or'
+      lhs.truthy?(context) || rhs.truthy?(context)
+    end
+  end
+end

data/lib/emerald/nodes/boolean_expr.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+
+# The boolean condition for a logic statement
+class BooleanExpr < Treetop::Runtime::SyntaxNode
+  def truthy?(context)
+    elements.first.truthy?(context)
+  end
+end

data/lib/emerald/nodes/comment.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'node'
+
+# Prints out the value of the comment's text
+class Comment < Node
+  def to_html(context)
+    "<!-- #{text_content.to_html(context)} -->\n"
+  end
+end

data/lib/emerald/nodes/each.rb

@@ -0,0 +1,40 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'base_scope_fn'
+
+# Function to map over elements in the context
+class Each < BaseScopeFn
+  def to_html(body, context)
+    vars = collection.content(context)
+    key_name = indexed.text_value.length.positive? ? indexed.key_name : nil
+
+    # TODO: clean up somehow
+    if vars.is_a? Hash
+      vars
+        .map do |var, key|
+          new_ctx = context.clone
+          new_ctx[val_name.text_value] = var
+          new_ctx[key_name.text_value] = key if key_name
+
+          body.to_html(new_ctx)
+        end
+        .join("\n")
+    elsif vars.is_a? Array
+      vars
+        .map.with_index do |var, idx|
+          new_ctx = context.clone
+          new_ctx[val_name.text_value] = var
+          new_ctx[key_name.text_value] = idx if key_name
+
+          body.to_html(new_ctx)
+        end
+        .join("\n")
+    elsif vars.nil?
+      ''
+    else
+      raise 'bad variable type :('
+    end
+  end
+end

data/lib/emerald/nodes/given.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'base_scope_fn'
+
+# Renders if a condition is met
+class Given < BaseScopeFn
+  def to_html(body, context)
+    if boolean_expr.truthy?(context)
+      body.to_html(context)
+    else
+      ''
+    end
+  end
+end

data/lib/emerald/nodes/line.rb

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'node'
+
+# Either a tag or text
+class Line < Node
+  def to_html(context)
+    e = elements[0]
+    e.to_html(context)
+  end
+end

data/lib/emerald/nodes/nested.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'node'
+
+#
+# Appends compiled html for nested rule to the output.
+# elements[0] is the tag statement, elements[4] is any nested html.
+#
+class Nested < Node
+  def to_html(context)
+    elements[0].opening_tag(context) +
+      elements[4].to_html(context) +
+      elements[0].closing_tag(context)
+  end
+end

data/lib/emerald/nodes/node.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+
+# Base class for all Emerald syntax nodes
+class Node < Treetop::Runtime::SyntaxNode
+  def to_html(_context)
+    raise 'not implemented :('
+  end
+end

data/lib/emerald/nodes/pair_list.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'node'
+
+# Base rule for lists of images, metas, styles, and scripts
+class PairList < Node
+  def to_html(context)
+    list_items.elements.map do |e|
+      attrs = e.pairs.elements.map do |j|
+        "#{j.attr.text_value}=\"#{j.literal.to_html(context)}\""
+      end.join(' ')
+
+      case keyword.text_value
+      when 'images'  then "<img #{attrs}/>"
+      when 'metas'   then "<meta #{attrs}>"
+      when 'styles'  then "<link #{attrs}/>"
+      when 'scripts' then "<script #{attrs}></script>"
+      end
+    end.join("\n")
+  end
+end

data/lib/emerald/nodes/root.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'node'
+
+# A base piece of an Emerald file
+class Root < Node
+  def to_html(context)
+    elements
+      .map { |e| e.to_html(context) }
+      .join("\n")
+  end
+end

data/lib/emerald/nodes/scope.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'node'
+
+# Block that modifies the context
+class Scope < Node
+  def to_html(context)
+    fn.to_html(body, context)
+  end
+end

data/lib/emerald/nodes/scope_fn.rb

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'base_scope_fn'
+
+# Base class for scope functions
+class ScopeFn < BaseScopeFn
+  def to_html(body, context)
+    elements[0].to_html(body, context)
+  end
+end

data/lib/emerald/nodes/tag_statement.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'treetop'
+require_relative 'node'
+
+# A tag
+class TagStatement < Node
+  # http://w3c.github.io/html/syntax.html#void-elements
+  VOID_TAGS = (
+    "area base br col embed hr img input link " +
+    "menuitem meta param source track wbr"
+  ).split(/\s+/)
+
+  def to_html(context)
+    if void_tag?
+      opening_tag(context)
+    else
+      opening_tag(context) +
+        (
+          if !body.empty?
+            body.to_html(context)
+          else
+            ''
+          end
+        ) +
+        closing_tag(context)
+    end
+  end
+
+  def class_attribute
+    unless classes.empty?
+      class_names = classes
+        .elements
+        .map{ |c| c.name.text_value }
+        .join(' ')
+
+      " class=\"#{class_names}\""
+    else
+      ''
+    end
+  end
+
+  def id_attribute
+    unless identifier.empty?
+      " id=\"#{identifier.name.text_value}\""
+    else
+      ''
+    end
+  end
+
+  def opening_tag(context)
+    "<#{tag.text_value}" +
+      id_attribute +
+      class_attribute +
+      (
+        if !attributes.empty?
+          ' ' + attributes.to_html(context)
+        else
+          ''
+        end
+      ) + (
+        if void_tag?
+          ' />'
+        else
+          '>'
+        end
+      )
+  end
+
+  def void_tag?
+    VOID_TAGS.include? tag.text_value
+  end
+
+  def closing_tag(_context)
+    "</#{tag.text_value}>"
+  end
+end