Popularity
7.0
Growing
Activity
9.0
-
1,341
54
186

Description

Scriban is a fast, powerful, safe and lightweight text templating language and engine for .NET, with a compatibility mode for parsing liquid templates.

Programming language: C#
License: BSD 2-clause "Simplified" License
Latest version: v3.0.4

scriban alternatives and similar packages

Based on the "Template Engine" category.
Alternatively, view scriban alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of scriban or a related project?

Add another 'Template Engine' Package

README

scriban Build Status Coverage Status NuGet

Scriban is a fast, powerful, safe and lightweight scripting language and engine for .NET, which was primarily developed for text templating with a compatibility mode for parsing liquid templates.

// Parse a scriban template
var template = Template.Parse("Hello {{name}}!");
var result = template.Render(new { Name = "World" }); // => "Hello World!" 

Parse a Liquid template using the Liquid language:

// Parse a liquid template
var template = Template.ParseLiquid("Hello {{name}}!");
var result = template.Render(new { Name = "World" }); // => "Hello World!" 

The language is very versatile, easy to read and use, similar to liquid templates:

var template = Template.Parse(@"
<ul id='products'>
  {{ for product in products }}
    <li>
      <h2>{{ product.name }}</h2>
           Price: {{ product.price }}
           {{ product.description | string.truncate 15 }}
    </li>
  {{ end }}
</ul>
");
var result = template.Render(new { Products = this.ProductList });

Scriban can also be used in pure scripting context without templating ({{ and }}) and can help you to create your own small DSL.

NOTICE

By default, Properties and methods of .NET objects are automatically exposed with lowercase and _ names. It means that a property like MyMethodIsNice will be exposed as my_method_is_nice. This is the default convention, originally to match the behavior of liquid templates. If you want to change this behavior, you need to use a [MemberRenamer](doc/runtime.md#member-renamer) delegate

New in 3.0+

  • AST is now fully visitable with ScriptVisitor. You can now access Parent on any ScriptNode object and navigate the AST.
    • Improve AST round-trip by preserving whitespaces around template enter{{ and exit}}
  • Several new language features:
    • Hexadecimal/binary numbers: 0x1ef or 0b101010
    • Support for large integers
    • [New parametric functions](doc/language.md#72-parametric-functions): func sub(x,y = 1, z...); ret x - y - z[0]; end
    • [New inline functions](doc/language.md#73-inline-functions): sub(x,y) = x - y
    • Optional member access with ?. instead of regular . (e.g a?.b?.c)
    • Conditional expressions: cond ? a : b
  • Separate language mode (via ScriptLang enum) from template/scripting parsing mode (ScriptMode).
  • New language parsing mode Scientific, in addition to default Scriban and Liquid language mode.
  • More fine-grained options on the TemplateContext to define scripting behaviors (EnableRelaxedTargetAccess, EnableRelaxedMemberAccess, EnableRelaxedFunctionAccess, EnableRelaxedIndexerAccess, EnableNullIndexer)
  • New object.eval and object.eval_template function to evaluate Scriban expressions/templates at runtime.
  • Better support for IFormattable objects.

Features

  • Very efficient, fast parser and a lightweight runtime. CPU and Garbage Collector friendly. Check the [benchmarks](doc/benchmarks.md) for more details.
  • Powered by a Lexer/Parser providing a full Abstract Syntax Tree, fast, versatile and robust, more efficient than regex based parsers.
    • Precise source code location (path, column and line) for error reporting
    • Write an AST to a script textual representation, with [Template.ToText](doc/runtime.md#ast-to-text), allowing to manipulate scripts in memory and re-save them to the disk, useful for roundtrip script update scenarios
  • Compatible with liquid by using the Template.ParseLiquid method
    • While the liquid language is less powerful than scriban, this mode allows to migrate from liquid to scriban language easily
    • With the [AST to text](doc/runtime.md#ast-to-text) mode, you can convert a liquid script to a scriban script using Template.ToText on a template parsed with Template.ParseLiquid
    • As the liquid language is not strictly defined and there are in fact various versions of liquid syntax, there are restrictions while using liquid templates with scriban, see the document [liquid support in scriban](doc/liquid-support.md) for more details.
  • Extensible runtime providing many extensibility points
  • Support for async/await evaluation of scripts (e.g Template.RenderAsync)
  • [Precise control of whitespace text output](doc/language.md#14-whitespace-control)
  • [Full featured language](doc/language.md) including if/else/for/while, [expressions](doc/language.md#8-expressions) (x = 1 + 2), conditions... etc.
  • [Function calls and pipes](doc/language.md#89-function-call-expression) (myvar | string.capitalize)
    • [Custom functions](doc/language.md#7-functions) directly into the language via func statement and allow function pointers/delegates via the alias @ directive
    • Bind [.NET custom functions](doc/runtime.md#imports-functions-from-a-net-class) from the runtime API with [many options](doc/runtime.md#the-scriptobject) for interfacing with .NET objects.
  • [Complex objects](doc/language.md#5-objects) (javascript/json like objects x = {mymember: 1}) and [arrays](doc/language.md#6-arrays) (e.g x = [1,2,3,4])
  • Allow to pass [a block of statements](doc/language.md#98-wrap-function-arg1argn--end) to a function, typically used by the wrap statement
  • Several [built-in functions](doc/builtins.md):
    • [arrays functions](doc/builtins.md#array-functions)
    • [date](doc/builtins.md#date-functions)
    • [html](doc/builtins.md#html-functions)
    • [maths functions](doc/builtins.md#math-functions)
    • [object](doc/builtins.md#object-functions)
    • [regex functions](doc/builtins.md#regex-functions)
    • [string functions](doc/builtins.md#string-functions)
    • [timespan](doc/builtins.md#timespan-functions)
  • [Multi-line statements](doc/language.md#11-code-block) without having to embrace each line by {{...}}
  • [Safe parser](doc/runtime.md#the-lexer-and-parser) and [safe runtime](doc/runtime.md#safe-runtime), allowing you to control what objects and functions are exposed

Syntax Coloring

You can install the Scriban Extension for Visual Studio Code to get syntax coloring for scriban scripts (without HTML) and scriban html files.

Documentation

  • See the [Language](doc/language.md) document for a description of the language syntax.
  • See the [Built-in functions](doc/builtins.md) document for the list of the built-in functions.
  • See the [Runtime](doc/runtime.md) document for a description of the .NET runtime API to compile and run templates.
  • See the [Liquid support](doc/liquid-support.md) document for more details about the support of liquid templates.
  • See my blog post "Implementing a Text Templating Engine for .NET" for some behind the scene details.

Binaries

Scriban is available as a NuGet package: NuGet

Compatible with the following .NET Standard 2.0+ (New in 3.0)

For support for older framework (.NET 3.5, 4.0, 4.5, .NET Standard 1.1, 1.3, they are only provided in older Scriban 2.x, which is no longer supported.

Also the Scriban.Signed NuGet package provides signed assemblies.

Benchmarks

Scriban is blazing fast! For more details, you can check the [benchmarks document](doc/benchmarks.md).

License

This software is released under the BSD-Clause 2 license.

Online Demo

Credits

Adapted logo Puzzle by Andrew Doane from the Noun Project

Author

Alexandre Mutel aka xoofx.


*Note that all licence references and agreements mentioned in the scriban README section above are relevant to that project's source code only.