---
id: tree-sitter-embedded-template
version: "0.25.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# tree-sitter-embedded-template — Embedded Template (ERB, EJS) grammar for tree-sitter

License: permissive · Maintenance: aging · Downloads: 3.4M/mo

## What it is and what it does

tree-sitter-embedded-template is a language grammar module for the tree-sitter incremental parser, specialized in parsing templating languages where scripting code is embedded within text using `<%` and `%>` delimiters. It supports ERB, EJS, ETLua, and ETA syntax patterns. The package provides precompiled binaries for multiple platforms and architectures, making it straightforward to integrate into Python applications that need to analyze or transform embedded-template source code.

This is a low-level parsing tool intended for developers building linters, formatters, code analyzers, or IDE features that work with embedded-template files. It does not execute templates or provide a rendering engine—it only parses the syntax tree. You would use it when you need programmatic access to the structure of template code, not when you need to render templates.

Use it for:

- Build a linter or formatter for ERB/EJS files by traversing the parsed syntax tree.
- Analyze embedded-template code in an IDE plugin to provide syntax highlighting or code completion.
- Extract and validate embedded scripting code from template files for security auditing.
- Implement a code refactoring tool that transforms template syntax while preserving structure.
- Generate documentation or metrics from template codebases by parsing and analyzing the tree.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a tree-sitter parser for embedded template languages like ERB and EJS, enabling syntactic analysis of code embedded within text using `<%` and `%>` delimiters.

Yes, if you are building developer tools or analysis pipelines that need to parse ERB, EJS, or related embedded-template languages. The prebuilt wheels and active repository make installation straightforward. Not necessary if you only need to render templates—use a template engine instead. Maintenance is slowing but the package remains stable with no known vulnerabilities.

## Install

pip install tree-sitter-embedded-template
uv add tree-sitter-embedded-template
poetry add tree-sitter-embedded-template

## Installing tree-sitter-embedded-template

Before you install: Medium friction: prebuilt wheels cover common platforms (x86_64, ARM, Windows), but requires Python 3.10+. Last release 350 days ago; repository remains active but maintenance pace is slowing.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for both open-source and proprietary projects.

Quickstart:

pip install tree-sitter-embedded-template

from tree_sitter import Language, Parser
parser = Parser()
parser.set_language(Language('tree_sitter_embedded_template'))

Requires Python 3.10 or later; tree-sitter core library must be installed separately.

Verify before relying:

- Whether tree-sitter core is automatically installed as a dependency or must be managed separately.
- Performance characteristics and parse speed for large embedded-template documents.
- Exact scope of template syntax variants supported beyond ERB, EJS, ETLua, and ETA.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: aging
- Downloads: 3.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tree-sitter parser embedded templates, ERB EJS syntax parsing, template language tree-sitter, embedded code parsing, incremental template parsing, tree-sitter grammar erb ejs, parsing, tree-sitter, template-languages

[View on SkillFed](https://skillfed.io/packages/tree-sitter-embedded-template) · [View on PyPI](https://pypi.org/project/tree-sitter-embedded-template/)