textparser 🚀

A lightning-fast, multi-language Abstract Syntax Tree (AST) generator and syntax highlighter. Architected with a high-performance C core engine powered by PCRE2 and JSON-C, textparser provides native, zero-overhead bindings and ports for Rust, Python, Java, and WebAssembly (WASM).

It serves as a robust foundation for building linters, static analysis tools, compilers, and terminal utilities like the built-in ccat clone.

---

✨ Features

• 🌐 Massive Language Support: Built-in regex-based grammars for modern and classic languages.
• ⚡ High Performance: Core tokenization and AST construction written in highly optimized C.
• 🧬 Multi-Language Ecosystem: Native language ports (Rust, Python, Java) manage underlying C memory safely.
• 🌐 WebAssembly Ready: Compile to WASM for client-side code analysis directly in the browser.
• 🎨 Built-in ccat Utility: A colorized alternative to the standard cat command for terminal code viewing.

---

📚 Supported Languages

textparser features rich tokenization and syntax parsing rules for:

• System & General: C, C++, C#, Java, Go, Rust, Swift, Zig, C3, V, Ada, Assembly (x86/ARM)
• Web & Data: HTML, CSS, JavaScript, TypeScript, JSON, XML, SQL, Markdown
• Scripting: Python, PHP, Bash/Shell

---

🚀 Installation

📦 Linux Packages

Arch Linux (AUR)

yay -S textparser
# Or build from the latest git commit
yay -S textparser-git

Ubuntu / Debian (PPA)

sudo add-apt-repository ppa:bbarbulovski-gmail/textparser
sudo apt-get update
sudo apt-get install textparser

🐳 Docker

Pull and run the pre-configured container instantly:

docker pull bokic78/textparser
docker run --rm -v \$(pwd):/workspace bokic78/textparser --file /workspace/main.c

---

🛠️ Building from Source

Prerequisites

Ensure you have cmake, ninja (optional but recommended), libpcre2, and libjson-c installed on your system.

Compiling the C Core & CLI

git clone https://github.com
cd textparser
mkdir build && cd build
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ..
ninja
sudo ninja install

---

💡 Quick Usage Examples

💻 CLI Usage (AST Generation)

Generate a clean, structured JSON representation of a source file's AST:

textparser --lang c --file main.c --format json

🎨 Colorized Cat (ccat)

View your code with automatic, high-performance syntax highlighting in the terminal:

textparser --ccat main.rs

---

🤝 Contributing

Contributions are what make the open-source community an amazing place to learn, inspire, and create.

1. Fork the project.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📄 License

This project is licensed under the GNU Lesser General Public License v3.0 (LGPL-3.0) - see the LICENSE file for details.

Developed with ❤️ by Boris Barbulovski (bokic).