Lmzzz.TemplateEngine 0.0.1.4

Lmzzz

Lmzzz (Let me zzz) 是一个简单、轻量的辅助实现解析器的.NET 框架,

让大家可以类函数或Fluent形式贴近 ABNF 格式实现语法定义。

（PS：目前暂时只支持 string解析，大多实现参考于Parlot）

Getting Started

首先引入命名空间

using Lmzzz.Chars.Fluent;
using static Lmzzz.Chars.Fluent.Parsers;

然后就可以实现相关语法定义，如下是 一个完整的 json 解析器定义

using Lmzzz.Chars.Fluent;
using static Lmzzz.Chars.Fluent.Parsers;

namespace Samples.Json;

public class JsonParser
{
    public static readonly Parser<IJson> Json;

    static JsonParser()
    {
        var lBrace = IgnoreSeparator(Char('{'));
        var rBrace = IgnoreSeparator(Char('}'));
        var lBracket = IgnoreSeparator(Char('['));
        var rBracket = IgnoreSeparator(Char(']'));
        var colon = IgnoreSeparator(Char(':'));
        var comma = IgnoreSeparator(Char(','));
        var nullv = IgnoreSeparator(Text("null")).Then<IJson>(static s => JsonNull.Value);
        var boolv = IgnoreSeparator((Text("true", true)).Then<IJson>(static s => JsonBool.True))
                .Or(IgnoreSeparator(Text("false", true)).Then<IJson>(static s => JsonBool.False));

        var number = Decimal().Then<IJson>(static s => new JsonNumber(s));

        var str = String();

        var jsonString =
            str
                .Then<IJson>(static s => new JsonString(s.ToString()));

        var json = Deferred<IJson>();

        var jsonArray =
            Between(lBracket, Separated(comma, json), rBracket)
                .Then<IJson>(static els => new JsonArray(els));

        var jsonMember =
            str.And(colon).And(json)
                .Then(static member => new KeyValuePair<string, IJson>(member.Item1.ToString(), member.Item3));

        var jsonObject =
            Between(lBrace, Separated(comma, jsonMember), rBrace)
                .Then<IJson>(static kvps => new JsonObject(new Dictionary<string, IJson>(kvps)));

        Json = json.Parser = jsonString.Or(jsonArray).Or(jsonObject).Or(nullv).Or(boolv).Or(number);
        Json = Json.Eof();
    }

    public static IJson Parse(string input)
    {
        if (Json.TryParse(input, out var result, out _))
        {
            return result;
        }
        else
        {
            return null;
        }
    }
}

简单的模板引擎

为了展示解析器的方便，同时也实现了一个简单的模板引擎

对象取值

// data: {A: { Age : 15}, B: [ 2, 3, 4]}

// {{FieldName.FieldName}}
{{ A.Age }}  // result: 15

// index {{Array.Index}}
{{ B.0 }} // result: 2
{{ B.1 }} // result: 3
{{ B.99 }} // result: null

if

{{ if(4 == Int || 5 != 6) }}
xx 
{{ elseif( true && false) }}
yy
{{ else }}
zz
{{endif}}

for

{{  for(自定义值名,自定义索引名 in Array) }}

{{ 自定义值名 }}

{{endfor}}

简单性能展示

对于简单场景做了一些性能比较

模板引擎

BenchmarkDotNet v0.15.7, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley)
Intel Core i7-10700 CPU 2.90GHz, 1 CPU, 16 logical and 8 physical cores
.NET SDK 10.0.100
  [Host]     : .NET 10.0.0 (10.0.0, 10.0.25.52411), X64 RyuJIT x86-64-v3
  DefaultJob : .NET 10.0.0 (10.0.0, 10.0.25.52411), X64 RyuJIT x86-64-v3

json

BenchmarkDotNet v0.15.7, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley)
Intel Core i7-10700 CPU 2.90GHz, 1 CPU, 16 logical and 8 physical cores
.NET SDK 10.0.100
  [Host]   : .NET 10.0.0 (10.0.0, 10.0.25.52411), X64 RyuJIT x86-64-v3
  ShortRun : .NET 10.0.0 (10.0.0, 10.0.25.52411), X64 RyuJIT x86-64-v3

Job=ShortRun  IterationCount=3  LaunchCount=1  
WarmupCount=3