rfmt 1.3.0-x86_64-darwin

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fd70aac98015165544a9d21abe215106d7d8a16de2a0dea7804d60be95b3b510
+  data.tar.gz: be17e19d5af7e2e8ab14515a9021cc619bd914eeb8e1f67d6ac517eb91261fa5
+SHA512:
+  metadata.gz: 3c6c2b9233cb7876fb31d7e9a936ae7967f5866142229fc9165e37b597f2dc85bd6800fe74bfa2393dabc1e5d68187348e690169afb8a868c82ab00b91a7f450
+  data.tar.gz: 358b27ec2c8fe9e16ef30552cad61be8eac24c9f606ef8b15a24cdf65c99c6bb38fb0913f2b48712af7600ea073e7437575edb6d22d573dbe756b3c5c7d99cfb

data/CHANGELOG.md

@@ -0,0 +1,223 @@
+## [Unreleased]
+
+## [1.3.0] - 2026-01-07
+
+### Added
+- Precompiled native gem support for multiple platforms:
+  - Linux x86_64 (glibc and musl)
+  - Linux aarch64 (glibc and musl)
+  - macOS x86_64 (Intel) and arm64 (Apple Silicon)
+  - Windows x64
+- Users no longer need Rust toolchain (cargo) to install rfmt
+- GitHub issue and PR templates
+
+### Changed
+- Release workflow now uses `oxidize-rb/actions/cross-gem` for cross-compilation
+- gemspec updated to exclude compiled artifacts from source gem
+
+### Fixed
+- CI cross-compile compatibility: Downgrade Cargo.lock to version 3 for older Cargo
+- Remove `.ruby-version` from repository to avoid rbenv errors in CI containers
+
+## [1.2.7] - 2026-01-04
+
+### Changed
+- Remove OpenSSL dependency: Use mtime instead of SHA256 hash for cache invalidation
+
+## [1.2.6] - 2026-01-04
+
+### Changed
+- Version bump
+
+## [1.2.5] - 2026-01-04
+
+### Fixed
+- Fix trailing comments on `end` keyword (e.g., `end # rubocop:disable`)
+- Fix block internal comments being moved outside the block
+- Fix blank line preservation between code and comments inside blocks
+- Fix leading blank line being added to comment-only files
+
+## [1.2.4] - 2026-01-04
+
+### Fixed
+- Fix comment indent space handling
+
+## [1.2.3] - 2026-01-04
+
+### Fixed
+- Fix migration file formatting (`emit_rescue` handling for rescue blocks)
+
+## [1.2.2] - 2026-01-04
+
+### Fixed
+- Ruby 3.4.1 compatibility: Use `OpenSSL::Digest::SHA256` instead of `Digest::SHA2` to avoid `metadata is not initialized properly` error in Ruby 3.4.1
+
+## [1.2.1] - 2026-01-04
+
+### Fixed
+- Ruby 3.4 compatibility: Fix `Digest::SHA256::metadata is not initialized properly` error by using `Digest::SHA2.new(256)` instead of `Digest::SHA256`
+
+## [1.2.0] - 2026-01-04
+
+### Added
+- Loop node types support (`for`, `while`, `until`)
+- Case/When statement support
+- Ensure and Lambda node support
+- Begin/End block handling for explicit `begin...end` blocks
+- High-priority node types support
+- Medium-priority node types support
+- Prism supported node viewer task
+
+### Changed
+- Consolidated and simplified test suite
+
+### Fixed
+- Exclude `.DS_Store` from Git tracking (@topi0247)
+- Repository URL changed from `fujitanisora` to `fs0414` (@topi0247)
+- End line space handling
+- Comment location fix
+- End expression indent fix
+- Begin formatting fix
+
+## [1.1.0] - 2025-12-12
+
+### Added
+- Editor integration (Ruby LSP support)
+- Required/Optional keyword parameter node type support
+
+### Fixed
+- Migration file superclass corruption (ActiveRecord::Migration[8.1] etc.)
+
+### Changed
+- Removed unused scripts and test files (reduced Ruby code by ~38%)
+
+## [1.0.0] - 2025-12-11
+
+### Breaking Changes
+- First stable release (v1.0.0)
+
+### Added
+- Neovim integration: format-on-save support with autocmd configuration
+
+### Changed
+- Set JSON as default output format
+- Updated Japanese documentation
+- Code formatting improvements
+
+### Fixed
+- TOML configuration parsing fix
+- Logger initialization fix
+
+## [0.5.0] - 2025-12-07
+
+### Changed
+- Synchronized markdown command documentation
+- Added project logo
+
+### Fixed
+- Removed unnecessary exec command
+
+## [0.4.1] - 2025-11-28
+
+### Fixed
+- CLI exec message output optimization for better user experience
+- RuboCop compliance issues resolved
+
+### Changed
+- Improved output formatting with colored success/failure messages
+- Debug logs now only shown with `--verbose` flag or debug environment variables
+- Enhanced progress indicators during file processing
+
+## [0.4.0] - 2025-11-26
+
+### Added
+- Verbose mode option (`--verbose` flag) for detailed output during formatting
+- Git commit hook configuration with Lefthook integration for automatic formatting
+- RubyGems badge and installation instructions in README
+
+### Changed
+- Improved documentation structure and readability in user guides (English and Japanese)
+- Enhanced logging system with verbose output support
+- Updated benchmark documentation in README
+
+### Fixed
+- Command formatting to execution conversion issues
+- Documentation version command display
+- Various code quality improvements based on Clippy suggestions
+
+## [0.3.0] - 2025-11-25
+
+### Changed
+- **BREAKING**: Default configuration file name changed from `rfmt.yml` to `.rfmt.yml`
+  - `rfmt init` now creates `.rfmt.yml` instead of `rfmt.yml`
+  - Configuration file search order updated: `.rfmt.yml` > `.rfmt.yaml` > `rfmt.yml` > `rfmt.yaml`
+  - This follows Ruby community conventions for hidden configuration files
+  - Backward compatibility maintained: `rfmt.yml` is still supported
+- Updated README.md to use `.rfmt.yml` in all examples and documentation
+- Updated benchmark data with latest accurate measurements (3,241 lines, more realistic performance ratios)
+- Removed exaggerated performance claims from README and documentation
+- Simplified feature descriptions in README (removed Error Handling and Logging from Features section)
+
+### Documentation
+- Updated user guides (English and Japanese) to reflect `.rfmt.yml` as default
+- Updated version information in documentation to 0.2.4 → 0.3.0
+- Updated benchmark documentation with accurate data from latest measurements
+- Added configuration verification examples in examples/ directory
+- Improved Ruby API examples with clearer input/output distinction
+
+## [0.2.4] - 2025-11-25
+
+### Fixed
+- Fixed if-else expression formatting
+
+## [0.2.3] - 2025-01-25
+
+### Added
+- Configuration file (rfmt.yml) is now automatically loaded and applied during formatting
+- Automatic config file discovery in current directory, parent directories, and home directory
+- Support for custom indent_width and other formatting options via rfmt.yml
+
+### Changed
+- Default config file name changed from .rfmt.yml to rfmt.yml (hidden file to regular file)
+- Backward compatibility maintained: .rfmt.yml is still supported with lower priority
+- Config file search order: rfmt.yml > rfmt.yaml > .rfmt.yml > .rfmt.yaml
+- README updated to remove exaggerated expressions and focus on factual, data-driven descriptions
+
+## [0.2.2] - 2025-01-25
+
+### Fixed
+- Fixed blank line formatting to output single blank line instead of double blank lines
+
+## [0.2.1] - 2025-01-25
+
+### Fixed
+- Fixed GitHub Actions release workflow bundler installation issue
+- Resolved clippy warnings in Rust codebase
+- Improved enum Default trait implementations using derive macros
+- Added `#[cfg(test)]` attributes to test-only code
+
+### Changed
+- Updated release workflow to use `bundler-cache: true` for better dependency management
+
+## [0.2.0] - 2025-01-25
+
+### Added
+- Security policy implementation with input validation and resource limits
+- File size validation (default: 10MB max)
+- Source code encoding validation
+- Comprehensive error handling with sanitized error messages
+
+### Changed
+- Simplified RSpec test suite (reduced from ~200 to 7 essential tests)
+- Removed redundant and duplicate tests
+- Improved code organization and removed unnecessary comments
+- Disabled Windows CI temporarily due to rb-sys compatibility issues
+
+### Fixed
+- Rust code formatting issues
+- Removed phase-related comments and code noise
+- Fixed import order and formatting inconsistencies
+
+## [0.1.0] - 2025-09-08
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 fujitani sora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,397 @@
+# rfmt
+
+<div align="center">
+
+A Ruby code formatter written in Rust
+
+[![Gem Version](https://badge.fury.io/rb/rfmt.svg)](https://rubygems.org/gems/rfmt)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[Installation](#installation) •
+[Usage](#usage) •
+[Features](#features) •
+[Editor Integration](#editor-integration) •
+[Documentation](#documentation) •
+[Contributing](#contributing)
+
+<a href="https://flatt.tech/oss/gmo/trampoline" target="_blank"><img src="https://flatt.tech/assets/images/badges/gmo-oss.svg" height="24px"/></a>
+
+</div>
+
+---
+
+## What is rfmt?
+
+[RubyGems reference](https://rubygems.org/gems/rfmt)
+
+**rfmt** is a Ruby code formatter that enforces consistent style across your codebase. Key characteristics:
+
+- **Opinionated**: Minimal configuration with consistent output
+- **Idempotent**: Running multiple times produces identical results
+- **Comment preservation**: Maintains existing comment placement
+- **Rust implementation**: Core formatter implemented in Rust
+
+## Features
+
+### Performance
+
+Built with Rust for improved execution speed. See Performance Benchmarks section for details.
+
+### Consistent Style
+
+Enforces code style rules:
+
+- Automatic indentation
+- Spacing and alignment normalization
+- Quote style standardization
+- Method definition formatting
+
+## Performance Benchmarks
+
+Execution time comparison on a Rails project (111 files, 3,241 lines):
+
+| Test Type | Files | rfmt | RuboCop | Ratio |
+|-----------|-------|------|---------|-------|
+| Single File | 1 | 191ms | 1.38s | 7.2x |
+| Directory | 14 | 176ms | 1.68s | 9.6x |
+| Full Project (check) | 111 | 172ms | 4.36s | 25.4x |
+
+**About this comparison:**
+- RuboCop times include startup overhead and loading all cops (linting rules)
+- RuboCop was run with default configuration (all cops enabled)
+- rfmt is a formatting-only tool with minimal overhead
+- Both tools were measured in check mode (no file modifications)
+- Results are averages from 10 runs per test
+
+**Observations:**
+- rfmt execution time remains constant (172-191ms) regardless of file count
+- Low variance across runs (standard deviation: 8-23ms)
+
+**Test Environment:**
+- CPU: Apple Silicon (arm64)
+- Ruby: 3.4.5
+- rfmt: 0.3.0, RuboCop: 1.81.7
+
+See [detailed benchmark report](docs/benchmark.md) for complete data.
+
+## Installation
+
+### Requirements
+
+- Ruby 3.0 or higher
+- Rust 1.70 or higher (for building from source)
+
+### From RubyGems
+
+```bash
+gem install rfmt
+```
+
+### In Your Gemfile
+
+```ruby
+gem 'rfmt'
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+### From Source
+
+```bash
+git clone https://github.com/fs0414/rfmt.git
+cd rfmt
+bundle install
+bundle exec rake compile
+```
+
+## Usage
+
+### Initialize Configuration
+
+First, create a configuration file with default settings:
+
+```bash
+rfmt init
+```
+
+This creates a `.rfmt.yml` file with default settings:
+
+```yaml
+version: "1.0"
+
+formatting:
+  line_length: 100        # Maximum line length (40-500)
+  indent_width: 2         # Spaces/tabs per indent (1-8)
+  indent_style: "spaces"  # "spaces" or "tabs"
+  quote_style: "double"   # "double", "single", or "consistent"
+
+include:
+  - "**/*.rb"
+  - "**/*.rake"
+  - "**/Rakefile"
+  - "**/Gemfile"
+
+exclude:
+  - "vendor/**/*"
+  - "tmp/**/*"
+  - "node_modules/**/*"
+  - "db/schema.rb"
+```
+
+**Options:**
+
+```bash
+# Specify custom path
+rfmt init --path config/.rfmt.yml
+
+# Overwrite existing configuration
+rfmt init --force
+```
+
+### Command Line
+
+Format a single file:
+
+```bash
+rfmt lib/user.rb
+```
+
+Format multiple files:
+
+```bash
+rfmt lib/**/*.rb
+```
+
+Check if files need formatting (CI/CD):
+
+```bash
+rfmt check .
+```
+
+Show diff without modifying files:
+
+```bash
+rfmt lib/user.rb --diff
+```
+
+Enable verbose output for debugging:
+
+```bash
+rfmt lib/user.rb --verbose
+# or use environment variable
+DEBUG=1 rfmt lib/user.rb
+```
+
+### Ruby API
+
+**Input (unformatted code):**
+
+```ruby
+require 'rfmt'
+
+source = <<~RUBY
+  class User
+  def initialize(name)
+  @name=name
+  end
+  end
+RUBY
+
+formatted = Rfmt.format(source)
+puts formatted
+```
+
+**Output (formatted code):**
+
+```ruby
+class User
+  def initialize(name)
+    @name=name
+  end
+end
+```
+
+### Configuration
+
+#### Configuration File Discovery
+
+rfmt automatically searches for configuration files in this order:
+
+1. Current directory (`.rfmt.yml`, `.rfmt.yaml`, `rfmt.yml`, or `rfmt.yaml`)
+2. Parent directories (up to root)
+3. User home directory (`.rfmt.yml`, `.rfmt.yaml`, `rfmt.yml`, or `rfmt.yaml`)
+4. Default settings (if no file found)
+
+#### Ruby API for Configuration
+
+```ruby
+require 'rfmt'
+
+# Generate configuration file
+Rfmt::Config.init('.rfmt.yml', force: false)
+
+# Find configuration file
+config_path = Rfmt::Config.find
+# => "/Users/username/project/.rfmt.yml"
+
+# Check if configuration exists
+Rfmt::Config.exists?
+# => true
+
+# Load configuration
+config = Rfmt::Config.load
+# => {"version"=>"1.0", "formatting"=>{"line_length"=>100, ...}, ...}
+```
+
+## Examples
+
+### Before Formatting
+
+```ruby
+class User<ApplicationRecord
+has_many :posts
+validates :email,presence: true
+def full_name
+"#{first_name} #{last_name}"
+end
+end
+```
+
+### After Formatting
+
+```ruby
+class User < ApplicationRecord
+  has_many :posts
+  validates :email, presence: true
+
+  def full_name
+    "#{first_name} #{last_name}"
+  end
+end
+```
+
+## Editor Integration
+
+### Neovim
+
+Format Ruby files on save using autocmd:
+
+```lua
+-- ~/.config/nvim/init.lua
+
+vim.api.nvim_create_autocmd("BufWritePre", {
+  pattern = { "*.rb", "*.rake", "Gemfile", "Rakefile" },
+  callback = function()
+    local filepath = vim.fn.expand("%:p")
+    local result = vim.fn.system({ "rfmt", filepath })
+    if vim.v.shell_error == 0 then
+      vim.cmd("edit!")
+    end
+  end,
+})
+```
+
+### Coming Soon
+
+- **VS Code** - Extension in development
+- **RubyMine** - Plugin in development
+- **Zed** - Extension in development
+
+## Development
+
+### Setup
+
+After cloning the repository:
+
+```bash
+bundle install
+bundle exec lefthook install
+```
+
+### Git Hooks
+
+This project uses [lefthook](https://github.com/evilmartians/lefthook) for automated validation before push:
+
+**Pre-push checks:**
+- RuboCop (Ruby linting)
+- cargo fmt --check (Rust formatting)
+- cargo clippy (Rust linting)
+
+**Skip hooks temporarily:**
+```bash
+# Skip all hooks for this push
+LEFTHOOK=0 git push
+
+# Skip specific hook
+LEFTHOOK_EXCLUDE=rubocop git push
+```
+
+### Running Tests
+
+```bash
+# Ruby tests
+bundle exec rspec
+
+# Rust tests
+cargo test --manifest-path ext/rfmt/Cargo.toml
+
+# All tests
+bundle exec rake dev:test_all
+```
+
+## Documentation
+
+Documentation is available in the [docs](docs/) directory:
+
+- [User Guide](docs/user_guide.md) - Comprehensive usage guide
+- [Error Reference](docs/error_reference.md) - Error codes and troubleshooting
+- [Contributing Guide](CONTRIBUTING.md) - How to contribute
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## Comparison with Other Tools
+
+### rfmt vs RuboCop
+
+| Feature | rfmt | RuboCop |
+|---------|------|---------|
+| **Primary Purpose** | Code formatting | Linting + formatting |
+| **Configuration** | Minimal | Extensive |
+| **Code Quality Checks** | No | Yes |
+| **Bug Detection** | No | Yes |
+
+**Note**: rfmt focuses on code formatting, while RuboCop provides additional code quality analysis. They can be used together.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the rfmt project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
+
+## Support
+
+- 📖 [Documentation](docs/)
+- 🐛 [Issues](https://github.com/fs0414/rfmt/issues)
+- 📧 Email: fujitanisora0414@gmail.com
+
+## Acknowledgments
+
+- Built with [Prism](https://github.com/ruby/prism) - Modern Ruby parser
+- Powered by [Rust](https://www.rust-lang.org/) - Performance and safety
+- FFI via [Magnus](https://github.com/matsadler/magnus) - Ruby-Rust bridge
+
+---
+
+<div align="center">
+
+Created by [Fujitani Sora](https://github.com/fs0414)
+
+</div>

data/exe/rfmt

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'rfmt/cli'
+
+# Known subcommands - if first arg is not one of these, prepend 'format'
+SUBCOMMANDS = %w[format check version config cache init help].freeze
+
+args = ARGV.dup
+args.unshift('format') if args.empty? || (!SUBCOMMANDS.include?(args.first) && !args.first.start_with?('-'))
+
+begin
+  Rfmt::CLI.start(args)
+rescue Interrupt
+  puts "\nInterrupted"
+  exit(130)
+rescue StandardError => e
+  warn "Error: #{e.message}"
+  warn e.backtrace.join("\n") if ENV['DEBUG']
+  exit(1)
+end