jinja

Jinja server-side template engine port for Dart 2. Variables, expressions, control structures and template inheritance.

0.4.0 version is breaking

See CHANGELOG.md.

Documentation

Mostly same as Jinja template documentation. work in progress.

Differences with Python version

• BigInt and complex numbers are not supported.
• The default filter compares values with null, no boolean parameter.
• The defined and undefined tests compares values with null.
• The map filter compares values with null. Use attribute for fields and item for items. Nested attributes and items are not supported.
• If Environment({getAttribute}) is not passed, getItem will be used. This allows you to use {{ map.key }} as {{ map['key'] }} expression.
• work in progress

Dynamically invoked members

• [], +, -, *, /, ~/, % operators
• object.length getter
• object.call getter
• work in progress
• also Function.apply(function, ...)

Example

import 'package:jinja/jinja.dart';

// ...

var environment = Environment(blockStart: '...', blockEnd: '...');
var template = environment.fromString('...source...');
print(template.render({'key': value}));
// or write directly to StringSink (IOSink, HttpResponse, ...)
template.renderTo(stringSink, {'key': value});

See also examples with conduit and reflectable.

Status:

TODO:

• Environment
  • constructor
    • extensions
    • selectAutoescape
  • addExtension
  • compileExpression
  • policies
• List of Control Structures
  • Macros
  • Call
  • Import
• Loaders
  • PackageLoader (VM)
  • ...
• Extensions
  • i18n
  • Expression Statement
  • Loop Controls
  • Debug Statement
• Template compiler
• ...

Done:

• Variables
• Filters
• Tests
• Comments
• Whitespace Control
• Escaping
• Line Statements
  • Comments
  • Blocks
• Template Inheritance
  • Base Template
  • Child Template
  • Super Blocks
  • Nesting extends
  • Named Block End-Tags
  • Block Nesting and Scope
• HTML Escaping
  • Manual
  • Automatic
• List of Control Structures
  • For
  • If
  • Filters
  • Assignments
  • Block Assignments
  • Extends
  • Blocks
  • Include
• Import Context Behavior
• Expressions with filters (not all) and tests
• List of Global Functions
  • list
  • namespace
  • print
  • range
• Loaders
  • FileSystemLoader
  • MapLoader (DictLoader)
• Extensions
  • Do Statement
  • With Statement
• Autoescape Overrides

Contributing

If you found a bug, typo or you have better description or comment for documentation, just create a new issue or even better fork and issue a pull request with your fix.