tree-sitter-toml
TOML grammar for tree-sitter
Decision gist · record as of 2026-08-14
Yes, if you are building a tool that requires fine-grained TOML syntax analysis via tree-sitter. Install only if you already use or plan to use tree-sitter's Python API; this package alone does not parse TOML. The MIT license and zero security vulnerabilities are favorable. The aging maintenance status (619 days since release) is a minor concern but not a blocker given the grammar's stability and the repository's active status.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later and the tree-sitter Python bindings library to actually parse files.
- Medium install friction due to compiled wheels; prebuilt binaries are available for common platforms (macOS x86_64/arm64, Linux x86_64/aarch64, Windows x64/arm64), but requires Python 3.9+.
- Repository is aging (619 days since last release) but not archived and receives occasional updates.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and proprietary projects.
last release 2024-12-03 (619 days) · last repo commit 2025-07-10 · 17 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,210,011 downloads/mo, #3,207 on PyPI
Alternatives
Verify before relying
pip install tree-sitter-toml
import tree_sitter_toml
# Use with tree-sitter Python bindings to parse TOML- How to integrate this grammar with the tree-sitter Python API for actual parsing workflows
- Whether this package is actively maintained or if the 619-day release gap indicates stalled development
What it is and what it does
tree-sitter-toml is a grammar module for the tree-sitter incremental parsing framework, specifically targeting TOML (Tom's Obvious, Minimal Language) configuration files. It provides the syntax rules needed to parse TOML v1.0.0 documents into an abstract syntax tree. The package ships as precompiled wheels for multiple architectures, requiring Python 3.9+.
This is a low-level parsing component, not a standalone TOML reader. It is designed to be used alongside tree-sitter's Python bindings to enable syntax-aware analysis, transformation, or linting of TOML files. It has no runtime dependencies and is primarily useful for developers building tools that need fine-grained access to TOML structure rather than simple key-value extraction.
Use it for
- Build a TOML linter or formatter that needs to understand and preserve document structure
- Implement a TOML editor with syntax highlighting and error detection via incremental parsing
- Analyze TOML configuration files programmatically to extract or validate specific sections
- Create refactoring tools that modify TOML files while maintaining formatting and comments
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a tool that requires fine-grained TOML syntax analysis via tree-sitter.
Install only if you already use or plan to use tree-sitter's Python API; this package alone does not parse TOML. The MIT license and zero security vulnerabilities are favorable. The aging maintenance status (619 days since release) is a minor concern but not a blocker given the grammar's stability and the repository's active status.
Install
tree-sitter-toml on PyPI
Before you install
Medium install friction due to compiled wheels; prebuilt binaries are available for common platforms (macOS x86_64/arm64, Linux x86_64/aarch64, Windows x64/arm64), but requires Python 3.9+. Repository is aging (619 days since last release) but not archived and receives occasional updates.
Requires Python 3.9 or later and the tree-sitter Python bindings library to actually parse files.
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and proprietary projects.
Quickstart
pip install tree-sitter-toml
import tree_sitter_toml
# Use with tree-sitter Python bindings to parse TOMLVerify before relying
- How to integrate this grammar with the tree-sitter Python API for actual parsing workflows
- Whether this package is actively maintained or if the 619-day release gap indicates stalled development
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Aging 619 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,210,011 / month, #3,207 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersTopic :: Software Development :: CompilersTopic :: Text Processing :: LinguisticTyping :: Typed |
Evidence: tree_sitter_toml-0.7.0-cp39-abi3-macosx_10_9_x86_64.whl; tree_sitter_toml-0.7.0-cp39-abi3-macosx_11_0_arm64.whl; tree_sitter_toml-0.7.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; tree_sitter_toml-0.7.0-cp39-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl; tree_sitter_toml-0.7.0-cp39-abi3-musllinux_1_2_x86_64.whl; tree_sitter_toml-0.7.0-cp39-abi3-win_amd64.whl; tree_sitter_toml-0.7.0-cp39-abi3-win_arm64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “toml parser tree-sitter”
- tree-sitter-tomlProvides a tree-sitter parser grammar for TOML files, enabling…
- tree-sitter-markdownProvides a tree-sitter grammar for parsing Markdown documents,…
- tree-sitter-xmlProvides a tree-sitter parser grammar for XML and DTD files, enabling…
Give your agent the search over MCP, or paste the wish link into any chat.
More Linguistic packages
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
tiktoken is a fast BPE tokenizer that converts text into token sequences compatible with OpenAI models, supporting multiple encoding schemes including o200k_base and model-specific encodings.
Install it if you work with OpenAI APIs or need to understand token boundaries in GPT-family models.
Detects character encoding and language in byte sequences with high accuracy, supporting 99 encodings and returning confidence scores, language tags, and MIME types.
Install it if you need to detect character encoding or language in byte data; the rewrite makes it substantially faster and more accurate than its predecessors.
Converts Unicode text to ASCII by transliterating non-ASCII characters into their closest ASCII equivalents, with no runtime dependencies.
However, if transliteration quality or ongoing maintenance matters, consider unidecode instead despite its GPL-only license.
Lark is a parsing library that builds abstract syntax trees from context-free grammars, supporting multiple parsing algorithms (Earley, LALR(1), CYK) with automatic line and column tracking.
Python bindings to the tree-sitter parsing library, enabling incremental parsing and syntax tree analysis for source code.
See also tree-sitter-markdown · tree-sitter-xml · tree-sitter-yaml · tree-sitter-json · tree-sitter-html · tree-sitter-kotlin · tree-sitter-java · tree-sitter-go · tree-sitter-embedded-template · taplo