TLang.Formatting

Creating a Formatter

Formatting.create returns a new formatter with default settings.

      let fmt = Formatting.create()
    

Configuration

Set the indent string (default: four spaces).

      let fmt = Formatting.with_indent_text(fmt, "  ")    // two spaces
      let fmt = Formatting.with_indent_text(fmt, "\t")    // tabs
    

Control spacing between token types.

      let fmt = Formatting.space_between(fmt, "keyword", "name")
      let fmt = Formatting.newline_after(fmt, "statement")
      let fmt = Formatting.indent_after(fmt, "open_brace")
      let fmt = Formatting.outdent_before(fmt, "close_brace")
    

Rendering

Formatting.render converts a token list to a formatted string.

      let result = Formatting.render(fmt, tokens)
    

Formatting.render_list renders a list of token lists with separators.

      let result = Formatting.render_list(fmt, tokenLists, "\n")
    

Working with Tokens

TLang.Token creates the token values that TLang.Formatting consumes.

      use TLang.Token

      let kw   = Token.keyword("func")
      let name = Token.name("myFunction")
      let list = Token.list(List.of(kw, name))
    

Example — Simple Code Formatter

      use TLang.Formatting
      use TLang.Token

      func formatFunc(name: String, body: String): String {
          let fmt  = Formatting.create()
          let fmt  = Formatting.with_indent_text(fmt, "    ")

          let toks = List.of(
              Token.keyword("func"),
              Token.name(name),
              Token.value("() {"),
              Token.value(body),
              Token.value("}")
          )

          return Formatting.render(fmt, toks)
      }

      func main(): String {
          let code = formatFunc("hello", "return \"world\"")
          Terminal.println(code)
          return "done"
      }