Flutter模板生成插件templater_atreeon的使用

templater_atreeon 是一个文本模板转换工具，可以用于源代码生成。它通过替换文件中的标记来实现这一功能，并支持简单的标记替换、子模板、子子模板和迭代模板。

使用规则

• <code>%%%keyName%%%</code> 类型必须是 String
• <code>###keyName|subTemplateName###</code> 类型必须是 Map<String, dynamic>
• <code>~~~keyName|repeatableTemplateName~~~</code> 类型必须是 List<Map<String, dynamic>>

var t = templateAtreeon(starterTemplate, [templateResources]);
var replaces = {"tableName":"employees", "columns":[{"name":"id", "dbType":"int64", "dartType":"int"}]};
var output = templateAtreeon.replace();

注释必须在模板文件的开头，且不包含空行，以两个连字符（--）开始。

配置模板

有两种配置模板的方法：

1. 将模板作为 String 传递给构造函数的 templateMain 参数，并将其他模板名称列表传递给 templatesOther 构造参数。
2. 设置模板目录，并加载模板列表（文件名减去 .txt 扩展名）。主模板应命名为 main.txt。

示例用法

简单的标记替换

var template = """
this is my test %%%value1%%% to see
if these tokens %%%value2%%% are
replaced %%%value3%%%
""";

var input = {
  "value1": "hello",
  "value2": "howdy",
  "value3": "gday",
};

var templater = Templater(input, templateMain: template);
var result = await templater.replace();

支持子模板

var template = """
this is my test to see
if a sub template of a pet ###pet|templatePet### and
another sub template of a person
###person|templatePerson###
has been replaced
so %%%value3%%%
""";

var otherTemplates = {
  "templatePet": "Here is my pet %%%name%%% and it is a %%%type%%%",
  "templatePerson": "Hello %%%name%%% you have %%%eyeColour%%% eyes",
};

var input = {
  "value3": "gday",
  "pet": {
    "name": "Sandy",
    "type": "cat",
  },
  "person": {
    "name": "Mel",
    "eyeColour": "green",
  },
};

var templater = Templater(
  input,
  templateMain: template,
  templatesOther: otherTemplates,
);
var result = await templater.replace();

子子模板

var template = """
this is my test to see
owner
###person|templatePerson###
so %%%value3%%%
""";

var otherTemplates = {
  "templatePet": "Here is my pet %%%name%%% and it is a %%%type%%%",
  "templatePerson": """Hello %%%name%%% you have %%%eyeColour%%% eyes
has a pet of
###pet|templatePet###
and thats all from %%%name%%%""",
};

var input = {
  "value3": "gday",
  "person": {
    "name": "Mel",
    "eyeColour": "green",
    "pet": {
      "name": "Sandy",
      "type": "cat",
    },
  },
};

可重复使用的模板

var template = """
Yo! %%%value1%%% to you all
Here are my favourite pet types
~~~pets|petTemplate~~~
so %%%value2%%%
""";

var otherTemplates = {
  "petTemplate": """I had %%%name%%% and it was a %%%type%%%
""";

var input = {
  "value1": "howdy",
  "value2": "gday",
  "pets": [
    {
      "name": "Sandy",
      "type": "cat",
    },
    {
      "name": "Simon",
      "type": "fish",
    },
    {
      "name": "Tommy",
      "type": "tortoise",
    },
  ]
};

var expected = """
Yo! howdy to you all
Here are my favourite pet types
I had Sandy and it was a cat
I had Simon and it was a fish
I had Tommy and it was a tortoise

so gday
""";