Travis Vasceannie
9cf5baafb4
- Added a new QualityConfig class to manage test quality check configurations. - Implemented test quality checks for specific rules in test files, including prevention of conditionals, loops, and generic exceptions. - Integrated external context providers (Context7 and Firecrawl) for additional guidance on test quality violations. - Enhanced error messaging to provide detailed, actionable guidance for detected issues. - Updated README_HOOKS.md to document new test quality features and configuration options. - Added unit tests to verify the functionality of test quality checks and their integration with the pretooluse_hook.
Claude Scripts - Code Quality Analysis Toolkit
A comprehensive Python code quality analysis toolkit for detecting duplicates, complexity metrics, and modernization opportunities.
Features
- Duplicate Detection: Find similar code patterns across your codebase using advanced similarity algorithms
- Complexity Analysis: Calculate cyclomatic complexity, maintainability index, and other code metrics
- Modernization Analysis: Identify opportunities to modernize Python code patterns and syntax
- Code Smells Detection: Detect common code smells and anti-patterns
- Multiple Output Formats: Support for JSON, console, and CSV output formats
- Comprehensive Reports: Full analysis reports with quality scores and recommendations
Installation
pip install claude-scripts
Usage
Command Line Interface
The package provides a claude-quality command with several subcommands:
Duplicate Detection
claude-quality duplicates src/ --threshold 0.8 --format console
Complexity Analysis
claude-quality complexity src/ --threshold 10 --format json
Modernization Analysis
claude-quality modernization src/ --include-type-hints --format console
Full Analysis
claude-quality full-analysis src/ --format json --output report.json
Configuration
Create a configuration file to customize analysis parameters:
claude-quality create-exceptions-template --output-path .quality-exceptions.yaml
Use the configuration file:
claude-quality --config config.yaml --exceptions-file .quality-exceptions.yaml duplicates src/
Command Reference
Global Options
--config, -c: Path to configuration file--exceptions-file, -e: Path to exceptions configuration file--verbose, -v: Enable verbose output
Duplicates Command
claude-quality duplicates [OPTIONS] PATHS...
Options:
--threshold, -t: Similarity threshold (0.0-1.0, default: 0.8)--min-lines: Minimum lines for duplicate detection (default: 5)--min-tokens: Minimum tokens for duplicate detection (default: 50)--output, -o: Output file for results--format: Output format (json/console/csv, default: json)
Complexity Command
claude-quality complexity [OPTIONS] PATHS...
Options:
--threshold: Complexity threshold (default: 10)--output, -o: Output file for results--format: Output format (json/console, default: json)
Modernization Command
claude-quality modernization [OPTIONS] PATHS...
Options:
--include-type-hints: Include missing type hint analysis--pydantic-only: Only analyze Pydantic patterns--output, -o: Output file for results--format: Output format (json/console, default: json)
Full Analysis Command
claude-quality full-analysis [OPTIONS] PATHS...
Options:
--output, -o: Output file for results--format: Output format (json/console, default: json)
Requirements
- Python ≥ 3.12
- Dependencies: click, pyyaml, pydantic, radon
Development
Install development dependencies:
pip install claude-scripts[dev]
License
MIT License - see LICENSE file for details.
Contributing
This is a personal project. Please report issues or suggestions through the repository's issue tracker.