Command-Line Tools for Text Templates

By transforming a text template, you can generate text output such as code, HTML, and reports from a model. For more information, see Generating Artifacts By Using Text Templates.

Domain-Specific Language Tools provide two command-line tools that you can use to transform text templates:

  • TextTransform.exe

  • DslTextTransform.cmd

TextTransform.exe

TextTransform.exe is a command-line tool that you can use to transform a text template. When you call TextTransform.exe, you specify the name of a text template file as an argument. TextTransform.exe calls the text transformation engine and processes the text template. For more information, see TextTransform.

TextTransform.exe is located in the following directory:

<root>\Program Files\Common Files\Microsoft Shared\Text Templating\1.2

DslTextTransform.cmd

DslTextTransform.cmd is a script that calls TextTransform.exe and runs it with common options. You can use DslTextTransformation.cmd to automate a nightly build of your Domain-Specific Language Tools projects.

DslTextTransform.cmd is located at:

<Visual Studio SDK Installation Path>\VisualStudioIntegration\Tools\Bin

You can specify the following arguments as input to DslTextTransform.cmd:

  • The output directory of the domain model project.

  • The output directory of the designer definition project.

  • The location of the text template file.

DslTextTransform.cmd processes the specified text template file using the default directive processors and assemblies (that is, those used with .dsldd, .dsldm, or .dslsetup). If you create custom directive processors, you can create your own batch file that calls TextTransform.exe (for example, CustomTextTransform.bat). In this batch file, you can specify your assemblies and the associated custom directive processors.

Security

For more information, see Security of Text Templates.

See Also

Reference

TextTransform

Other Resources

Generating Artifacts By Using Text Templates

Working with Domain-Specific Language Solutions