README.md

GQ

A filtering tool that meets your expectations 🦀✨

👉 Demo made using our GQ Playground

🚀 Overview

GQ is a blazing-fast, open-source filtering tool for JSON and YAML files that includes:

• Expressive language: Simple query syntax inspired by GraphQL.
• Data transformation: Easily filter, select and reshape your data.
• Versatile formats: Works with both JSON and YAML.
• Modern CLI: Perfect for developers, software infrastructure architects and automation.
• Rust-powered: Built for large-scale data processing.

📚 Docs

Find the full documentation, usage examples, and all features at the GQ Documentation.

⚡ Usage

There are two main ways to use GQ:

1. Online Tool: Directly in your browser using the fast, WASM-based GQ Playground.
2. CLI: From a command line interface for more demanding usage.

🛠️ CLI Installation

With Cargo:

cargo install gq-cli

Arch Linux (AUR):

yay -S gq

Requires Rust toolchain for Cargo installation.

From Source:

git clone https://github.com/jorgehermo9/gq
cd gq
cargo build --release
./target/release/gq --help

🤝 Community & Contributions

• Found a bug or have an idea? Open an issue
• Want to contribute? Pull requests are welcome!
• Join the discussion and help shape the future of GQ.

📄 License

This project is licensed under the MIT License.
See LICENSE for details.