Repository navigation
Releases
v0.3.0
What's Changed
- fix: accurate classification, hardened diff/CI handling, release 0.3.0 by @harkaranbrar7 in #5
Full Changelog: v0.2.1...v0.3.0
v0.2.1
What's Changed
- Fix/bugfixes and code quality by @harkaranbrar7 in #3
- fix: bump version to 0.2.1 and fix release workflow by @harkaranbrar7 in #4
Full Changelog: v0.2.0...v0.2.1
v0.2.0
PureCode v0.2.0 Release Notes
Overview
PureCode v0.2.0 represents a major evolution of the tool, transforming it from a simple git diff analyzer into a comprehensive code analysis platform. This release introduces snapshot analysis, configuration management, and enhanced CI integration while maintaining full backward compatibility for existing diff analysis workflows.
Highlights
🚀 New Capabilities
- Dual Analysis Modes: Diff mode (existing) + Files mode (new snapshot analysis)
- Configuration System: Project-specific settings via
.purecode.toml - Review Complexity Scoring: Quantifies PR review effort based on code changes
- Enhanced CI Integration: Machine-readable outputs and flexible threshold checking
- Per-File Reporting: Detailed statistics breakdown by individual files
🔧 Technical Improvements
- Robust Language Support: Improved classifiers for HTML/Vue, C-style languages, and multi-line comments
- Better Error Handling: Warnings for context lines, binary file detection, and malformed diffs
- Structured Output: Redesigned reports with JSON serialization and CI-friendly formats
- Code Quality: Added Rust formatting and linting to CI pipeline
What's New
Core Features
- Snapshot Mode (
purecode files): Analyze entire codebases or specific directories - Configuration File:
.purecode.tomlfor project defaults and team settings - Subcommand Architecture: Organized CLI with
diffandfilescommands - Complexity Metrics: Algorithm-based scoring for review difficulty assessment
- Token Estimation: Improved calculation for LLM token usage
CLI Enhancements
- Per-File Stats:
--per-fileflag for detailed file-by-file breakdown - CI Mode:
--ciflag for automation-friendly output with summary lines - Flexible Thresholds: Enhanced validation with
--warn-onlyoption - Configuration Override: CLI flags take precedence over config file settings
Language & Parsing
- HTML/Vue Improvements: Better handling of multi-line comments and mixed content
- C-Style Refinements: More accurate inline comment detection
- Binary File Support: Automatic skipping of binary diffs
- Context Line Warnings: Alerts when using diffs without
--unified=0
Changes
Added
- New dependencies:
serde,serde_json,toml,walkdir,glob config.rs: Configuration loading and managementfiles.rs: Directory scanning and file analysislanguage.rs: Centralized language detection enum- Complexity calculation and token estimation functions
- JSON output format with structured data models
- CI summary lines for automation
Changed
- CLI Structure: Root command defaults to diff mode; explicit subcommands for clarity
- Output Format: Redesigned human reports with language breakdown and complexity scores
- Classifier Logic: Improved state management for multi-line constructs
- GitHub Actions: Enhanced release workflow with duplicate detection and generated notes
- README: Complete rewrite with architecture docs and usage examples
Fixed
- HTML comment parsing edge cases
- C-style block comment handling in mixed lines
- Language detection consistency
- Diff parsing robustness
Removed
- Manual release notes generation (now uses GitHub's generated notes)
- Some redundant classifier code paths
Compatibility
Breaking Changes
- CLI Defaults: Some flags now pull from config file; use explicit flags to override
- Output Structure: JSON format includes new fields; existing parsers may need updates
- Module Structure: Internal reorganization may affect custom integrations
Backward Compatibility
- ✅ Existing
purecodecommand continues to work (diff mode) - ✅ All existing CLI flags supported
- ✅ Diff analysis behavior unchanged
- ✅ Core API functions preserved
Migration Guide
For Users
- No Action Required: Existing scripts continue working
- Optional: Add
.purecode.tomlto your repository root for team defaults - New Features: Try
purecode filesfor codebase analysis - CI Updates: Add
--ciflag for machine-readable output
For CI/CD
# Before
- run: purecode --format json
# After (recommended)
- run: purecode --ci --format jsonConfiguration Example
[purecode]
base = "origin/main"
format = "human"
max_noise_ratio = 0.6
min_pure_lines = 5
fail_on_decrease = true
warn_only = false
ci = false
include = ["src/**"]
exclude = ["**/*.lock", "dist/**", "target/**", "node_modules/**"]Installation
From Source (Recommended)
cargo install --path .Pre-built Binaries
Available via GitHub releases with automated installation scripts.
Performance
- Memory Usage: Minimal increase due to new data structures
- Execution Speed: Maintained for diff mode; snapshot mode scales with codebase size
- Binary Size: ~15% increase due to additional dependencies
Testing
- All existing tests pass
- New test coverage for classifiers, parsing, and configuration
- Manual validation across multiple languages and project types
- CI pipeline includes formatting and linting checks
Acknowledgments
This release represents significant community-driven improvements and internal refactoring to position PureCode for future growth. Special thanks to contributors who provided feedback on the v0.1.0 release.
Future Roadmap
- History analysis mode (scaffolding included)
- Custom language rule definitions
- Integration with popular code review platforms
- Performance optimizations for large codebases
Full Changelog: See commit history and PR #2 for complete details.
Documentation: Updated README.md and inline help (purecode --help)
Support: File issues on GitHub for bugs or feature requests.
v0.1.0
PureCode v0.1.0 (Initial Public Release)
Overview
PureCode v0.1.0 marks the first public release of the PureCode CLI — a tool focused on noise-aware diff analysis. It helps teams measure meaningful code changes by separating real logic from comments, formatting, and other non-functional noise.
Key Features
- Noise-aware diff analysis for more accurate change measurement.
- Inline block comments no longer hide surrounding code in JS/TS and other C-style languages, improving pure vs. noise detection.
- HTML and Vue support with proper handling of
<!-- -->comments. - CSS comment detection aligned with C-style syntax for consistent noise counting.
--min-pure-linesfiltering based on total pure lines added or removed, ensuring cleanup-only PRs aren’t unfairly blocked.
Compatibility
- No breaking changes.
- Minimum supported Rust version: stable.
Install
macOS / Linux
curl -LsSf https://raw.githubusercontent.com/isupervillain/purecode/main/install.sh | shWindows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/isupervillain/purecode/main/install.ps1 | iex"