---
id: tree-sitter-groovy
version: "0.1.2"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# tree-sitter-groovy — Groovy grammar for tree-sitter

License: permissive · Maintenance: dormant · Downloads: 1.6M/mo

## What it is and what it does

tree-sitter-groovy is a language binding that provides a Groovy grammar for the tree-sitter parsing framework. Tree-sitter is an incremental parser generator; this package supplies the grammar rules specific to Groovy, allowing you to parse Groovy source files and extract their syntax trees programmatically.

The package is young—first and latest release on 2024-11-19—and the author describes it as a work-in-progress built quickly to test a concept. It has no runtime dependencies and is available as precompiled wheels for Python 3.9+ across macOS, Linux, and Windows architectures. Maintenance is dormant, with no commits or releases since its initial version.

Use it for:

- Build a Groovy code linter or formatter that needs to understand Groovy syntax structure.
- Extract metrics or patterns from Groovy codebases by traversing the parsed syntax tree.
- Analyze Groovy build scripts programmatically to audit or refactor them.
- Support Groovy language features in a Python-based development tool.

## Worth the install?

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

Provides a Groovy language grammar for tree-sitter, enabling incremental parsing and syntax analysis of Groovy code.

Yes, if you need tree-sitter-based Groovy parsing and accept the trade-offs: MIT license is clean, no runtime dependencies, and prebuilt wheels minimize friction. However, dormant maintenance (no activity since 2024-11-19) and the author's own caveat that it is unpolished mean you should verify the grammar covers your use case and be prepared to fork or patch if bugs emerge. Suitable for experimental or internal tooling; less suitable for production systems requiring active support.

## Install

pip install tree-sitter-groovy
uv add tree-sitter-groovy
poetry add tree-sitter-groovy

## Installing tree-sitter-groovy

Before you install: Medium install friction due to compiled wheels; prebuilt binaries available for common platforms (macOS x86/ARM, Linux x86/ARM, Windows). Dormant maintenance—last release and commit both 2024-11-19, with no activity since. Use only if you accept potential staleness.

License in practice: MIT license is permissive; you may use, modify, and distribute this package freely with minimal restrictions, making it safe for most projects.

Quickstart:

pip install tree-sitter-groovy

import tree_sitter_groovy

Requires Python >=3.9. The package provides a grammar binding; actual parsing requires external tree-sitter infrastructure not bundled here.

Verify before relying:

- Whether tree-sitter is automatically installed as a dependency or must be installed separately.
- Completeness and correctness of the Groovy grammar coverage relative to the full Groovy language specification.
- Whether the package is actively maintained or if dormancy signals abandonment.
- How to integrate this grammar with a parsing workflow in practice.

## Package facts

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

## Tags

groovy parser, tree-sitter groovy grammar, groovy syntax parsing, incremental groovy parsing, groovy code analysis, groovy ast generation, parsing, groovy, tree-sitter

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