README
- ::equalAttribute::equal
- ::not_equalAttribute::not_equal
- ::outputAttribute::output
- ::to_jsonAttribute::to_json
- ::to_reprAttribute::to_repr
- ::to_stringAttribute::to_string
- ::renderCompiledTemplate::render
- ::render_with_optionsCompiledTemplate::render_with_options
- ::iterDocument::iter
- ::newDocument::new
- ::outputDocument::output
- ::pushDocument::push
- ::renderDocument::render
- ::render_with_localsDocument::render_with_locals
- ::render_with_registryDocument::render_with_registry
- ::to_htmlDocument::to_html
- ::to_jsonDocument::to_json
- ::to_pretty_htmlDocument::to_pretty_html
- ::to_reprDocument::to_repr
- ::to_stringDocument::to_string
- ::newLexer::new
- ::tokenizeLexer::tokenize
- ::tokenize_lineLexer::tokenize_line
- ::getLocals::get
- ::newLocals::new
- ::setLocals::set
- ::set_arrayLocals::set_array
- ::set_nested_arrayLocals::set_nested_array
- ::set_objectLocals::set_object
- ::equalNode::equal
- ::not_equalNode::not_equal
- ::outputNode::output
- ::to_jsonNode::to_json
- ::to_reprNode::to_repr
- ::to_stringNode::to_string
- ::newParser::new
- ::parseParser::parse
- ::defaultRenderOptions::default
- ::prettyRenderOptions::pretty
- ::containsTemplateRegistry::contains
- ::ensure_loadedTemplateRegistry::ensure_loaded
- ::getTemplateRegistry::get
- ::load_fileTemplateRegistry::load_file
- ::newTemplateRegistry::new
- ::registerTemplateRegistry::register
- ::equalToken::equal
- ::not_equalToken::not_equal
- ::outputToken::output
- ::to_reprToken::to_repr
- ::to_stringToken::to_string
V
apply_filter
V
compile
V
eval_expression
V
eval_js_expression
V
exec_js_statement
V
get_doctype
V
locals_to_json
V
parse
V
parse_with_registry
V
render
V
render_file
V
render_file_with_locals
V
render_pretty
V
render_with_locals
V
render_with_registry
V
tokenize

pug

A Pug template engine implementation in MoonBit.

pug

jade

Download zip

Author

Milky2018

Version

0.1.2

License

Apache-2.0

Repository

github.com/moonbit-community/pug-mbt.git

Last updated

22 hours ago

Downloads

moonbitlang/x0.5.7

#pug

A Pug template engine implementation in MoonBit.

#Features

Basic HTML tag generation
ID and class shorthand syntax (div#id.class)
Attributes (a(href="url"))
Nested elements via indentation
Doctype declaration
HTML comments
Pretty printing
Interpolation (#{variable})
Compile API for reusable templates with locals

#Usage

///|
test "usage example" {
  let pug =
    #|doctype html
    #|html
    #|  head
    #|    title Hello Pug
    #|  body
    #|    h1#greeting.title Hello, World!
    #|    p This is rendered from Pug.

  // Render to compact HTML
  let html = @pug.render(pug)
  inspect(
    html,
    content="<!DOCTYPE html><html><head><title>Hello Pug</title></head><body><h1 class=\"title\" id=\"greeting\">Hello, World!</h1><p>This is rendered from Pug.</p></body></html>",
  )

  // Render to pretty-printed HTML
  let _pretty_html = @pug.render_pretty(pug)
}

#Pug Syntax

#Tags

div
p Hello World
span.highlight Text

#IDs and Classes

div#main
div.container
div#app.container.active

#Implicit div

#main
.container

#Attributes

a(href="https://example.com") Click me
input(type="text", name="username", placeholder="Enter name")
img(src="photo.jpg", alt="A photo")

#Nesting

html
  head
    title My Page
  body
    h1 Welcome
    p This is content.

#Comments

// This is a rendered comment
//- This is not rendered

#Doctype

doctype html

#Interpolation

p Hello #{name}!
p Welcome to #{place}

#Compile API

For reusable templates, use the compile API:

///|
test "compile api" {
  // Compile template once
  let template = @pug.compile("p Hello #{name}!")

  // Render with different locals
  let locals1 = @pug.Locals::new()
  locals1.set("name", "Alice")
  inspect(template.render(locals1), content="<p>Hello Alice!</p>")
  let locals2 = @pug.Locals::new()
  locals2.set("name", "Bob")
  inspect(template.render(locals2), content="<p>Hello Bob!</p>")
}

Or render directly with locals:

///|
test "render with locals" {
  let locals = @pug.Locals::new()
  locals.set("name", "World")
  let html = @pug.render_with_locals("p Hello #{name}!", locals)
  inspect(html, content="<p>Hello World!</p>")
}

#License

Apache-2.0

Attribute

source

pub struct Attribute {
  name : String
  value : String?
  unescaped : Bool
} derive(Eq, @moonbitlang/core/debug.Debug
Debug, @moonbitlang/core/json.ToJson
ToJson)

Represents an attribute in a Pug element

impl Show for Attribute

Attribute::equal

source

fn Attribute::equal(Attribute, Attribute) -> Bool

Attribute::not_equal

source

fn Attribute::not_equal(x : Attribute, y : Attribute) -> Bool

Attribute::output

source

fn Attribute::output(self : Attribute, logger : &Logger) -> Unit

Attribute::to_json

source

fn Attribute::to_json(Attribute) -> @moonbitlang/core/json.Json
Json

Attribute::to_repr

source

fn Attribute::to_repr(Attribute) -> @moonbitlang/core/debug.Repr
Repr

Attribute::to_string

source

fn Attribute::to_string(self : Attribute) -> String

CompiledTemplate

source

pub struct CompiledTemplate {
  doc : Document
}

Compiled template - holds parsed document for repeated rendering

CompiledTemplate::render

source

fn CompiledTemplate::render(self : CompiledTemplate, locals : Locals) -> String

Render a compiled template with locals

CompiledTemplate::render_with_options

source

fn CompiledTemplate::render_with_options(self : CompiledTemplate, locals : Locals, options : RenderOptions) -> String

Render a compiled template with locals and options

Document

source

pub struct Document {
  nodes : Array[Node]
} derive(@moonbitlang/core/debug.Debug
Debug, @moonbitlang/core/json.ToJson
ToJson)

A Pug document is a list of nodes

impl Show for Document

Document::iter

source

fn Document::iter(self : Document) -> Iter[Node]

Document::new

source

fn Document::new() -> Document

Document::output

source

fn Document::output(self : Document, logger : &Logger) -> Unit

Document::push

source

fn Document::push(self : Document, node : Node) -> Unit

Document::render

source

fn Document::render(self : Document, options~ : RenderOptions) -> String

Render a document to HTML string (without locals)

Document::render_with_locals

source

fn Document::render_with_locals(self : Document, locals : Locals, options~ : RenderOptions) -> String

Render a document to HTML string with locals

Document::render_with_registry

source

fn Document::render_with_registry(self : Document, locals : Locals, registry : TemplateRegistry, options~ : RenderOptions) -> String

Render a document with registry support for extends and includes

Document::to_html

source

fn Document::to_html(self : Document) -> String

Render a document to HTML string with default options

Document::to_json

source

fn Document::to_json(Document) -> @moonbitlang/core/json.Json
Json

Document::to_pretty_html

source

fn Document::to_pretty_html(self : Document) -> String

Render a document to pretty-printed HTML string

Document::to_repr

source

fn Document::to_repr(Document) -> @moonbitlang/core/debug.Repr
Repr

Document::to_string

source

fn Document::to_string(self : Document) -> String

Lexer

source

type Lexer

Lexer state - uses Iter[Char] for character iteration

Lexer::new

source

fn Lexer::new(input : String) -> Lexer

Lexer::tokenize

source

fn Lexer::tokenize(self : Lexer) -> Array[Token]

Tokenize entire input

Lexer::tokenize_line

source

fn Lexer::tokenize_line(self : Lexer) -> Array[Token]

Tokenize a single line, returning tokens

Locals

source

pub struct Locals(Map[String, String])

Locals map for template interpolation

Locals::get

source

fn Locals::get(self : Locals, key : String) -> String?

Locals::new

source

fn Locals::new() -> Locals

Locals::set

source

fn Locals::set(self : Locals, key : String, value : String) -> Unit

Locals::set_array

source

fn Locals::set_array(self : Locals, key : String, values : Array[String]) -> Unit

Set an array value (stub for future implementation)

Locals::set_nested_array

source

fn Locals::set_nested_array(self : Locals, key : String, rows : Array[Array[String]]) -> Unit

Set a nested array value (stub for future implementation)

Locals::set_object

source

fn Locals::set_object(self : Locals, key : String, obj : Map[String, String]) -> Unit

Set an object value (stub for future implementation)

Node

source

pub enum Node {
  Element(tag~ : String, id~ : String, classes~ : Array[String], attributes~ : Array[Attribute], children~ : Array[Node], self_closing~ : Bool)
  Text(String)
  Interpolation(String)
  UnescapedInterpolation(String)
  Comment(text~ : String, render~ : Bool)
  Doctype(String)
  Conditional(condition~ : String, if_true~ : Array[Node], if_false~ : Array[Node], is_unless~ : Bool)
  Each(item_var~ : String, index_var~ : String, collection~ : String, body~ : Array[Node], else_body~ : Array[Node])
  Case(expr~ : String, cases~ : Array[(String, Array[Node])], default~ : Array[Node])
  When(value~ : String, body~ : Array[Node])
  Default(body~ : Array[Node])
  MixinDef(name~ : String, params~ : Array[(String, String)], body~ : Array[Node])
  MixinCall(name~ : String, args~ : Array[String], block~ : Array[Node], attrs~ : Array[(String, String)])
  Block
  VarAssign(name~ : String, value~ : String)
  While(condition~ : String, body~ : Array[Node])
  NamedBlock(name~ : String, body~ : Array[Node], mode~ : String)
  Include(path~ : String)
  IncludeFiltered(filter~ : String, path~ : String)
  Extends(path~ : String)
  Filter(name~ : String, content~ : String)
} derive(Eq, @moonbitlang/core/debug.Debug
Debug, @moonbitlang/core/json.ToJson
ToJson)

Represents a node in the Pug AST

impl Show for Node

Node::equal

source

fn Node::equal(Node, Node) -> Bool

Node::not_equal

source

fn Node::not_equal(x : Node, y : Node) -> Bool

Node::output

source

fn Node::output(self : Node, logger : &Logger) -> Unit

Node::to_json

source

fn Node::to_json(Node) -> @moonbitlang/core/json.Json
Json

Node::to_repr

source

fn Node::to_repr(Node) -> @moonbitlang/core/debug.Repr
Repr

Node::to_string

source

fn Node::to_string(self : Node) -> String

Parser

source

type Parser

Parser state

Parser::new

source

fn Parser::new(tokens : Array[Token]) -> Parser

Parser::parse

source

fn Parser::parse(self : Parser) -> Document

Parse tokens into a Document

RenderOptions

source

pub struct RenderOptions {
  pretty : Bool
  indent_str : String
}

Render options

RenderOptions::default

source

fn RenderOptions::default() -> RenderOptions

RenderOptions::pretty

source

fn RenderOptions::pretty() -> RenderOptions

TemplateRegistry

source

pub struct TemplateRegistry {
  templates : Map[String, String]
}

Template registry for storing and resolving templates Used for extends and include functionality

TemplateRegistry::contains

source

fn TemplateRegistry::contains(self : TemplateRegistry, path : String) -> Bool

Check if a template exists

TemplateRegistry::ensure_loaded

source

fn TemplateRegistry::ensure_loaded(self : TemplateRegistry, path : String) -> Unit raise @moonbitlang/x/fs.IOError
IOError

Load a template from file if not already loaded

TemplateRegistry::get

source

fn TemplateRegistry::get(self : TemplateRegistry, path : String) -> String?

Get a template by path

TemplateRegistry::load_file

source

fn TemplateRegistry::load_file(self : TemplateRegistry, path : String) -> Unit raise @moonbitlang/x/fs.IOError
IOError

Load a template from file and register it

TemplateRegistry::new

source

fn TemplateRegistry::new() -> TemplateRegistry

TemplateRegistry::register

source

fn TemplateRegistry::register(self : TemplateRegistry, path : String, source : String) -> Unit

Token

source

pub enum Token {
  Indent(Int)
  Tag(String)
  Id(String)
  Class(String)
  AttrName(String)
  AttrValue(String)
  Text(String)
  Interpolation(String)
  UnescapedInterpolation(String)
  TagInterpolation(String)
  LParen
  RParen
  Equals
  UnescapedEquals
  Newline
  Comment(String)
  UnbufferedComment(String)
  Doctype(String)
  BlockExpand
  PipedText(String)
  BlockTextMarker
  BlockText(String)
  If(String)
  ElseIf(String)
  Else
  Unless(String)
  Each(String, String, String)
  Case(String)
  When(String)
  Default
  Block
  MixinDef(String, Array[(String, String)])
  MixinCall(String, Array[String], Array[(String, String)])
  BufferedOutput(String)
  UnescapedBufferedOutput(String)
  VarAssign(String, String)
  While(String)
  NamedBlock(String)
  AppendBlock(String)
  PrependBlock(String)
  Include(String)
  IncludeFiltered(String, String)
  Extends(String)
  Filter(String, String)
  SelfClose
  EOF
} derive(Eq, @moonbitlang/core/debug.Debug
Debug)

Token types for Pug lexer

impl Show for Token

Token::equal

source

fn Token::equal(Token, Token) -> Bool

Token::not_equal

source

fn Token::not_equal(x : Token, y : Token) -> Bool

Token::output

source

fn Token::output(self : Token, logger : &Logger) -> Unit

Token::to_repr

source

fn Token::to_repr(Token) -> @moonbitlang/core/debug.Repr
Repr

Token::to_string

source

fn Token::to_string(self : Token) -> String

apply_filter

source

fn apply_filter(filter : String, content : String) -> String

Apply a filter to content Supports: plain (as-is), markdown (simple conversion)

compile

source

fn compile(input : String) -> CompiledTemplate

Compile a Pug template string into a reusable template

eval_expression

source

fn eval_expression(expr : String, locals : Locals) -> String

Evaluate a simple expression with locals Supports: variable lookup, string concat (+), string literals, ternary (? :) Example: baseUrl + '/path' with {baseUrl: "http://example.com"} Example: active ? 'on' : 'off' with {active: "true"}

eval_js_expression

source

fn eval_js_expression(expr : String, locals : Locals) -> String

Evaluate an expression - stub implementation for non-JS backends Falls back to simple variable lookup from eval_expression in spec.mbt

exec_js_statement

source

fn exec_js_statement(stmt : String, locals : Locals) -> Unit

Execute a statement - stub implementation for non-JS backends Handles simple "var name = value" patterns only

get_doctype

source

fn get_doctype(name : String) -> String

Get doctype string for various doctype names Supports: html, xml, transitional, strict, frameset, 1.1, basic, mobile

locals_to_json

source

fn locals_to_json(locals : Locals) -> String

Convert Locals to JSON string (stub - same implementation) Converts "true"/"false" to boolean values for proper JS semantics

parse

source

fn parse(input : String) -> Document

Convenience function to parse a Pug string

parse_with_registry

source

fn parse_with_registry(input : String, registry : TemplateRegistry) -> Document

Parse Pug and resolve all includes using registry Returns a Document with Include nodes replaced by actual content

render

source

fn render(input : String) -> String

Convenience function: parse Pug and render to HTML

render_file

source

fn render_file(path : String) -> String raise @moonbitlang/x/fs.IOError
IOError

Render a Pug file - automatically loads includes/extends This is the simple API similar to pug.renderFile()

render_file_with_locals

source

fn render_file_with_locals(path : String, locals : Locals) -> String raise @moonbitlang/x/fs.IOError
IOError

Render a Pug file with locals

render_pretty

source

fn render_pretty(input : String) -> String

Convenience function: parse Pug and render to pretty HTML

render_with_locals

source

fn render_with_locals(input : String, locals : Locals) -> String

Convenience function: parse Pug and render to HTML with locals

render_with_registry

source

fn render_with_registry(input : String, locals : Locals, registry : TemplateRegistry) -> String

Convenience function: render with registry

tokenize

source

fn tokenize(input : String) -> Array[Token]

Convenience function to tokenize a string

Source Files

Install

Download zip

A Pug template engine implementation in MoonBit.

pugjade

Milky2018

Apache-2.0

github.com/moonbit-community/pug-mbt.git

Updated 22 hours ago

61 downloads

Site source Report issue Modules Skills CLI Build queue Statistics

pug

#pug

#Features

#Usage

#Pug Syntax

#Tags

#IDs and Classes

#Implicit div

#Attributes

#Nesting

#Comments

#Doctype

#Interpolation

#Compile API

#License

#Attribute

#Attribute::equal

#Attribute::not_equal

#Attribute::output

#Attribute::to_json

#Attribute::to_repr

#Attribute::to_string

#CompiledTemplate

#CompiledTemplate::render

#CompiledTemplate::render_with_options

#Document

#Document::iter

#Document::new

#Document::output

#Document::push

#Document::render

#Document::render_with_locals

#Document::render_with_registry

#Document::to_html

#Document::to_json

#Document::to_pretty_html

#Document::to_repr

#Document::to_string

#Lexer

#Lexer::new

#Lexer::tokenize

#Lexer::tokenize_line

#Locals

#Locals::get

#Locals::new

#Locals::set

#Locals::set_array

#Locals::set_nested_array

#Locals::set_object

#Node

#Node::equal

#Node::not_equal

#Node::output

#Node::to_json

#Node::to_repr

#Node::to_string

#Parser

#Parser::new

#Parser::parse

#RenderOptions

#RenderOptions::default

#RenderOptions::pretty

#TemplateRegistry

#TemplateRegistry::contains

#TemplateRegistry::ensure_loaded

#TemplateRegistry::get

#TemplateRegistry::load_file

#TemplateRegistry::new

#TemplateRegistry::register

#Token

#Token::equal

#Token::not_equal

#Token::output

#Token::to_repr

#Token::to_string

#apply_filter

#compile

#eval_expression

#eval_js_expression

#exec_js_statement

Attribute

Attribute::equal

Attribute::not_equal

Attribute::output

Attribute::to_json

Attribute::to_repr

Attribute::to_string

CompiledTemplate

CompiledTemplate::render

CompiledTemplate::render_with_options

Document

Document::iter

Document::new

Document::output

Document::push

Document::render

Document::render_with_locals

Document::render_with_registry

Document::to_html

Document::to_json

Document::to_pretty_html

Document::to_repr

Document::to_string

Lexer

Lexer::new

Lexer::tokenize

Lexer::tokenize_line

Locals

Locals::get

Locals::new

Locals::set

Locals::set_array

Locals::set_nested_array

Locals::set_object

Node

Node::equal

Node::not_equal

Node::output

Node::to_json

Node::to_repr

Node::to_string

Parser

Parser::new

Parser::parse

RenderOptions

RenderOptions::default

RenderOptions::pretty

TemplateRegistry

TemplateRegistry::contains

TemplateRegistry::ensure_loaded

TemplateRegistry::get

TemplateRegistry::load_file

TemplateRegistry::new

TemplateRegistry::register

Token

Token::equal

Token::not_equal

Token::output

Token::to_repr

Token::to_string

apply_filter

compile

eval_expression

eval_js_expression

exec_js_statement

get_doctype

locals_to_json

parse

parse_with_registry

render

render_file

render_file_with_locals

render_pretty

render_with_locals

render_with_registry

tokenize