Supported Languages¶

t-linter supports syntax highlighting and validation for the following embedded languages in Python template strings.

Language Detection¶

Languages are detected through type annotations:

from typing import Annotated
from string.templatelib import Template

# Direct annotation
template: Annotated[Template, "html"] = t"<p>{content}</p>"

# Type alias
type html = Annotated[Template, "html"]
page: html = t"<div>{content}</div>"

Supported Languages¶

Language	Annotation	Highlighting	Validation
HTML	`"html"`	Tree-sitter	Tree-sitter
SQL	`"sql"`	Tree-sitter	Tree-sitter
JavaScript	`"javascript"`	Tree-sitter	Tree-sitter
CSS	`"css"`	Tree-sitter	Tree-sitter
JSON	`"json"`	Tree-sitter	`tstring-json` backend
YAML	`"yaml"`	Tree-sitter	`tstring-yaml` backend
TOML	`"toml"`	Tree-sitter	`tstring-toml` backend

JSON, YAML, and TOML¶

For structured data formats (JSON, YAML, TOML), t-linter splits responsibilities:

semanticTokens: Tree-sitter only, for low-latency highlighting
check: Strict parsing through the dedicated Rust backends (tstring-json, tstring-yaml, tstring-toml)
formatting: Canonical formatting through the same Rust backends

Examples¶

from typing import Annotated
from string.templatelib import Template

# HTML
page: Annotated[Template, "html"] = t"""
<html>
    <body><h1>{title}</h1></body>
</html>
"""

# SQL
query: Annotated[Template, "sql"] = t"""
SELECT * FROM users WHERE id = {user_id}
"""

# JavaScript
script: Annotated[Template, "javascript"] = t"""
console.log({message});
"""

# CSS
styles: Annotated[Template, "css"] = t"""
.container { max-width: {width}px; }
"""

# JSON
data: Annotated[Template, "json"] = t"""
{"name": {name}, "age": {age}}
"""

# YAML
config: Annotated[Template, "yaml"] = t"""
app:
  name: {app_name}
  debug: true
"""

# TOML
settings: Annotated[Template, "toml"] = t"""
[project]
name = "{project_name}"
version = "{version}"
"""