SimpleTextTemplate.Generator 3.2.0

SimpleTextTemplate

SimpleTextTemplateは、変数の埋め込みのみに対応したテキストテンプレートエンジンです。

説明

• 文字列をUTF-8バイト列としてIBufferWriter<byte>に出力します。
• {{ <変数>:<format>:<culture> }}で変数を埋め込みます。（formatとcultureは省略可能）
• {{と}}内の先頭と末尾の空白（U+0020）は無視されます。
• {{と}}で囲まれた範囲以外の文字は、そのまま出力されます。

インストール

NuGet（正式リリース版）

dotnet add package SimpleTextTemplate.Generator

Azure Artifacts（開発用ビルド）

dotnet add package SimpleTextTemplate.Generator -s https://pkgs.dev.azure.com/finphie/Main/_packaging/DotNet/nuget/v3/index.json

使い方

サンプルプロジェクト

SimpleTextTemplate.Generator

using System;
using System.Buffers;
using System.Globalization;
using System.Text;
using SimpleTextTemplate;

var bufferWriter = new ArrayBufferWriter<byte>();
var context = new SampleContext("Hello, World", 1000, new(2000, 1, 1, 0, 0, 0, TimeSpan.Zero));

var writer = TemplateWriter.Create(bufferWriter);
TemplateRenderer.Render(ref writer, "{{ DateTimeOffsetValue:o }}_{{ StringValue }}!", in context);
TemplateRenderer.Render(ref writer, "_{{ ConstantString }}_{{ ConstantInt:N3:ja-JP }}_{{ IntValue }}", in context, CultureInfo.InvariantCulture);
writer.Flush();

// 2000-01-01T00:00:00.0000000+00:00_Hello, World!_Hello_999.000_1000
Console.WriteLine(Encoding.UTF8.GetString(bufferWriter.WrittenSpan));

readonly record struct SampleContext(
    string StringValue,
    int IntValue,
    DateTimeOffset DateTimeOffsetValue)
{
    public const string ConstantString = "Hello";
    public const int ConstantInt = 999;
}

生成コード

file static class Intercept
{
    [global::System.Runtime.CompilerServices.InterceptsLocation(1, "...")]
    public static void Render0(ref global::SimpleTextTemplate.TemplateWriter<global::System.Buffers.ArrayBufferWriter<byte>> writer, string text, in global::SampleContext context, global::System.IFormatProvider provider = null)
    {
        writer.WriteValue(global::System.Runtime.CompilerServices.Unsafe.AsRef(in context).@DateTimeOffsetValue, "o", global::System.Globalization.CultureInfo.InvariantCulture);
        writer.Grow(2
            + global::System.Text.Encoding.UTF8.GetMaxByteCount(
                global::System.Runtime.CompilerServices.Unsafe.AsRef(in context).@StringValue.Length));
        writer.DangerousWriteConstantLiteral("_"u8);
        writer.DangerousWriteString(global::System.Runtime.CompilerServices.Unsafe.AsRef(in context).@StringValue);
        writer.DangerousWriteConstantLiteral("!"u8);
    }

    [global::System.Runtime.CompilerServices.InterceptsLocation(1, "...")]
    public static void Render1(ref global::SimpleTextTemplate.TemplateWriter<global::System.Buffers.ArrayBufferWriter<byte>> writer, string text, in global::SampleContext context, global::System.IFormatProvider provider = null)
    {
        writer.Grow(15);
        writer.DangerousWriteConstantLiteral("_Hello_999.000_"u8);
        writer.WriteValue(global::System.Runtime.CompilerServices.Unsafe.AsRef(in context).@IntValue, default, global::System.Globalization.CultureInfo.InvariantCulture);
    }
}

SimpleTextTemplate

using System;
using System.Buffers;
using System.Text;
using SimpleTextTemplate;

var symbols = Context.Create();
symbols.Add("Identifier"u8.ToArray(), "Hello, World!"u8.ToArray());

var bufferWriter = new ArrayBufferWriter<byte>();
var source = "{{ Identifier }}"u8.ToArray();
var template = Template.Parse(source);
template.Render(bufferWriter, symbols);

// Hello, World!
Console.WriteLine(Encoding.UTF8.GetString(bufferWriter.WrittenSpan));

ベンチマーク

定数（string）

定数（int）

string

int

ベンチマークプロジェクト

サポートフレームワーク

• .NET 11
• .NET 10

作者

finphie

ライセンス

MIT

クレジット

このプロジェクトでは、次のパッケージ等を使用しています。

ライブラリ

• Microsoft.CodeAnalysis.CSharp
• System.IO.Hashing

テスト

• Microsoft.CodeAnalysis.CSharp.Workspaces
• TUnit

アナライザー

• DocumentationAnalyzers
• IDisposableAnalyzers
• Microsoft.CodeAnalysis.Analyzers
• Microsoft.VisualStudio.Threading.Analyzers
• Roslynator.Analyzers
• Roslynator.Formatting.Analyzers
• StyleCop.Analyzers

ベンチマーク

• BenchmarkDotNet
• Scriban