---
id: gritql
version: "0.2.0"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# gritql — Python bindings for GritQL

License: permissive · Maintenance: dormant · Downloads: 114.8K/mo

## What it is and what it does

GritQL is a Python binding for a code query and transformation language built in Rust. It lets you write declarative patterns to find and modify code across JavaScript, TypeScript, Python, JSON, Java, Terraform, Solidity, CSS, Markdown, YAML, Rust, Go, and SQL without needing to understand AST details—any code snippet can serve as a starting pattern. The language is designed to scale to large repositories and includes a module system with reusable patterns.

You install it as a Python package, but it acts as a bridge to the underlying Rust engine. Since the package is dormant (last release 657 days ago), it is no longer actively maintained, so you should expect no updates or bug fixes. It has no Python runtime dependencies, making installation lightweight.

Use it for:

- Search and refactor a large codebase across multiple languages using a single query syntax.
- Automate code migrations or standardization tasks across JavaScript, Python, and other supported languages.
- Build custom linting or code-quality rules that apply pattern-based fixes automatically.
- Query and modify infrastructure-as-code files (Terraform, YAML) alongside application code.
- Reuse or share code transformation patterns via Grit's module system across teams.

## Worth the install?

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

GritQL is a Python binding for a declarative query language that searches and modifies source code across multiple programming languages using pattern matching.

Yes, if you need multi-language code search and transformation at scale and can tolerate a dormant package. The MIT license and zero runtime dependencies make it low-friction to try. However, be aware that no active maintenance means you will not receive updates, bug fixes, or support for new language versions. Suitable for one-off migrations or stable, self-contained use cases; not recommended if you need ongoing support or frequent updates.

## Install

pip install gritql
uv add gritql
poetry add gritql

## Installing gritql

Before you install: Installation is straightforward with no runtime dependencies. The package is dormant (657 days since last release), so expect no active maintenance or bug fixes going forward.

License in practice: MIT license is permissive, allowing commercial and private use with minimal restrictions—you may use, modify, and distribute this package freely as long as you include the license notice.

Quickstart:

pip install gritql
import gritql
# Use gritql module to construct and run queries on source code

The package is a Python binding to a Rust-based tool; the underlying GritQL engine must be available in your environment for queries to execute.

Verify before relying:

- Whether the Rust-based GritQL engine is bundled with the wheel or must be installed separately.
- What Python version is actually required (classifiers list 2.7 through 3.12, but requires_python is unspecified).
- Whether dormant status means the binding is stable or no longer maintained alongside upstream GritQL.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 114.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

code search and refactoring, source code pattern matching, multi-language code transformation, automated code modification, codebase query language, AST-free code rewriting, large repository code search, code-search, refactoring, multi-language

[View on SkillFed](https://skillfed.io/packages/gritql) · [View on PyPI](https://pypi.org/project/gritql/)