Siren

🌟 Project Overview

Siren is your stylish companion for maintaining impeccable code quality across multiple languages. Inspired by mythological sirens, it draws developers in with vibrant, intuitive interfaces, smart defaults, and delightful user experiences—making code quality irresistible.

🚀 Key Features

• 🌈 Multi-language Magic: Seamlessly supports Rust, Python, JavaScript, TypeScript, and HTML/Templates.
• 🔍 Smart Detection: Automatically identifies project languages and frameworks.
• 🧙‍♀️ Intelligent Tooling: Picks the perfect linters and formatters tailored to your project.
• 💅 Gorgeous Output: Vibrant, colorful terminal experiences that make linting delightful.
• ⚡ Blazing Performance: Built with Rust for lightning-fast execution.
• 🔧 Auto-fixing Spells: Automatically resolves common issues, saving you precious time.
• 🔄 Git Integration: Focuses on recently modified files for efficient workflows.
• 📊 Interactive Progress: Live-updating spinners and stylish progress indicators.

🛠️ Technical Stack & Architecture

Siren is crafted with Rust, leveraging Cargo for dependency management and Clippy for linting. It integrates seamlessly with popular tools across multiple languages:

Language

Formatting

Linting

Type Checking

Fixing

🦀 Rust

rustfmt

clippy

clippy --fix

🐍 Python

black, ruff format

pylint, ruff check

mypy

ruff --fix

🌐 JavaScript

prettier

eslint

eslint --fix

📘 TypeScript

prettier

eslint

eslint --fix

🖥️ HTML/Templates

djlint

djlint

djlint --reformat

📈 Development Status & Roadmap

Siren is actively evolving, with core features already enchanting developers:

• ✅ Core Architecture & CLI: Fully operational and intuitive.
• ✅ Tool Registry & Plugin System: Robust and extensible.
• ✅ Language Support: Rust, Python, HTML fully supported; JavaScript/TypeScript nearly complete.
• 🔄 Advanced Reporting & Output: Enhanced HTML reports and GitHub annotations in progress.
• 🔄 Configuration Management: Smart defaults implemented; advanced configuration merging underway.
• 🔄 Performance Optimizations: Parallel execution implemented; caching and incremental checking coming soon.

Upcoming priorities include comprehensive documentation, enhanced testing, and expanded language support (CSS, Go, Ruby, Markdown). A GitHub actions is coming soon to make it trivial to use Siren in your CI workflows.