SushiScript 1.0.1

Sushi

Library for converting .NET models to different script languages.

Developed by: Jeroen Vorsselman @ 2018<br> GitHub LinkedIn

Main features

Main framework for generating script files.

• Write inline code documentation to script
• Customize templates and formatting
• Extend by implementing your own script-language
• Write to file (asynchronous)
• Detect models to convert in assembly
  • By Interface or Attribute <br> <br>

Sushi.JavaScript

Implementation for generating JavaScript (EcmaScript) models.

• EcmaScript V5 and V6
• Isolated function-block
• Complete JsDoc support
• object parsing & validation
• Class inheritance <br> <br>

Sushi.JavaScript

Implementation for generating TypeScript models.

• Able to generate the latest TypeScript specification
• Able to generate DefinitelyTyped declaration files
  • Use to improve autocomplete for Visual Studio Intellisense
• Class inheritance <br> <br>

How to use

1. Create an instance of the ConversionKernel and pass the assembly with the models to convert.
   • Invoke the LoadXmlDocumentation method to try and load the "PROJECT_NAMESPACE".xml file generated by the VS project.
2. Create the ModelConverter instance for the requested script-language.
   • Default script-languages have a static method for doing this that are named as follows CreateConverterFor + script-language depending on what Sushi implementation is referenced.
3. Invoke the Convert() method on the created ModelConverter instance.
   • Iterates through each found DataModel and compiles them.
   • The generated script string will be set on the DataModel.Script property.

Reading the generated script as a string:<br> Simply invoke the ModelConverter.MergeModelsToString method and pass the converted IEnumerable<DataModel>. This will iterate through the populated DataModel(s) and join its Script contents to one string. <br> <br> Writing the generated script to a file:<br> The ModelConverter.FlushToFile'Async' can be used to write the script contents to a file with a given name and path. This method uses the ModelConverter.MergeModelsToString method internally to join the generated script(s) to one string. <br>

PLEASE NOTE: The fileName argument does not include its extension. This is defined in the language-specification.

Minifying the generated script:<br> Basic script minification is supported. This only removes return-newline(s), tabs, comments and leading-whitespaces. This can be done in the ModelConverter.MergeModelsToString and ModelConverter.FlushToFile'Async' methods. Both have a minify:boolean argument. <br> <br>

Creating or modifing a script-language

Sushi contains two base-classes for defining a language, the LanguageSpecification and StatementPipeline.<br> Directly linked to how certain placeholders in the template are generated so it can best be explained with including the placeholders.