ruby_spriter 0.6.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f794b569ca3be84a3e33923a645ee3f98a8771d12d1e9befc5bc9f63241d079d
+  data.tar.gz: b8e2078fa01d7095ec071c83e6d0e17683f86b2653a8f610b50925084e9d4984
+SHA512:
+  metadata.gz: 7fea2f1769c71ae55b040b41c6f1dd29f8d1c384eda0606464fee0c26892d48463586f541a484395c3368170484028488bc3bc6b7f1820f20132ec004fc5ae81
+  data.tar.gz: a751cdce97247fc81627bb3a0d4628c5c560885ce4df8eed744c9923bdd8cb86842c07363e02cc66ff94f2792ff8a50504b980ba7035e559014e1bc24f692985

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--color
+--format documentation

data/CHANGELOG.md

@@ -0,0 +1,217 @@
+
+---
+
+### **CHANGELOG.md**
+```markdown
+# Changelog
+
+All notable changes to Ruby Spriter will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.6.5] - 2025-10-23
+
+### 📦 Distribution & Packaging Release
+
+**Note**: Version 0.6.5 is functionally identical to 0.6.4, which was yanked from RubyGems due to RubyGems policy preventing re-publication of yanked versions.
+
+#### Added
+- **GitHub Actions CI/CD Pipeline**: Automated testing across Ruby 2.7-3.3 on Ubuntu, macOS, and Windows
+- **Automated RubyGems Publishing**: Auto-publish gem to RubyGems.org on version tag push
+- **Release Automation Workflow**: Multi-platform gem builds with artifact uploads to GitHub Releases
+- **Code Coverage Reporting**: SimpleCov integration in CI with PR summaries
+
+#### Changed
+- **Installation Options**: Two installation methods (RubyGems for all platforms, from source)
+- **README Structure**: Simplified installation section focusing on gem distribution
+- **Gemspec Author Info**: Updated from placeholders to actual author details
+
+#### Distribution
+- **RubyGems**: Published gem with all runtime files (works on Windows, macOS, Linux)
+- **Source Install**: Git clone with local gem build option
+
+#### Deferred
+- **Windows Standalone Executable**: Deferred due to OCRA incompatibility with Ruby 3.x
+  - OCRA 1.3.11 (last version, 2019) fails with Ruby 3.2+ due to internal fiber changes
+  - Windows users can use `gem install ruby_spriter` after installing Ruby
+  - Will revisit when better Windows packaging tools become available
+
+Closes #18
+
+---
+
+## [0.6.4] - 2025-10-23 [YANKED]
+
+Version yanked from RubyGems. Use 0.6.5 instead.
+
+### 📦 Distribution & Packaging Release
+
+#### Added
+- **GitHub Actions CI/CD Pipeline**: Automated testing across Ruby 2.7-3.3 on Ubuntu, macOS, and Windows
+- **Automated RubyGems Publishing**: Auto-publish gem to RubyGems.org on version tag push
+- **Release Automation Workflow**: Multi-platform gem builds with artifact uploads to GitHub Releases
+- **Code Coverage Reporting**: SimpleCov integration in CI with PR summaries
+
+#### Changed
+- **Installation Options**: Two installation methods (RubyGems for all platforms, from source)
+- **README Structure**: Simplified installation section focusing on gem distribution
+- **Gemspec Author Info**: Updated from placeholders to actual author details
+
+#### Distribution
+- **RubyGems**: Published gem with all runtime files (works on Windows, macOS, Linux)
+- **Source Install**: Git clone with local gem build option
+
+#### Deferred
+- **Windows Standalone Executable**: Deferred due to OCRA incompatibility with Ruby 3.x
+  - OCRA 1.3.11 (last version, 2019) fails with Ruby 3.2+ due to internal fiber changes
+  - Windows users can use `gem install ruby_spriter` after installing Ruby
+  - Will revisit when better Windows packaging tools become available
+
+Closes #18
+
+---
+
+## [0.6.3] - 2025-10-23
+
+### 🧪 Testing & Quality Assurance Release
+
+#### Added
+- **155 New RSpec Tests**: Comprehensive test coverage for CLI, GimpProcessor, Consolidator, PathHelper
+- **Test Fixtures**: Real spritesheet fixtures (4x2, 6x2, 4x4), PNG images, MP4 video
+- **Code Coverage Reporting**: SimpleCov tracking showing 57.09% coverage
+
+#### Fixed
+- **CLI Preset Bug**: Fixed OptionParser limitation preventing all 4 presets from working
+- **PathHelper Quote Escaping**: Fixed single quote escaping in Unix paths (needed 4 backslashes)
+- **Spec Helper Bug**: Changed instance variable to global variable for cross-context access
+- **PathHelper Tests**: Made drive letter detection flexible for E: drive compatibility
+
+#### Testing
+- **CLI Tests (97)**: --help, --version, --check-dependencies, --image, --video, --consolidate, --verify
+- **GimpProcessor Tests (48)**: Initialization, operations, interpolation, output filtering, script generation
+- **Consolidator Tests (33)**: File validation, metadata, column validation, consolidation logic
+- **PathHelper Tests (7)**: Quote paths, normalize for Python, native format conversion
+- **Coverage**: Increased from 22.52% to 57.09% (+34.57 percentage points)
+
+Closes #5
+
+---
+
+## [0.6.2] - 2025-10-22
+
+### ✨ Quality Enhancement & Tooling Release
+
+#### Added
+- **Interpolation Options**: 5 interpolation methods for scaling (none, linear, cubic, nohalo, lohalo)
+- **Sharpening Support**: Unsharp mask with configurable radius, gain, and threshold
+- **`--version` Flag**: Display version, platform, and date information
+- **`--check-dependencies` Flag**: Verify all external tools are installed with platform-specific guidance
+- **File Extension Validation**: Runtime validation for MP4 (video) and PNG (images)
+- **GIMP Investigation Documentation**: Comprehensive documentation of GIMP sharpen attempts and solutions
+
+#### Changed
+- **Automatic Operation Order**: Auto-optimize to remove background before scaling for better quality
+- **Sharpening via ImageMagick**: Use ImageMagick instead of GIMP for reliable cross-platform sharpening
+- **Alpha Channel Preservation**: Use merge instead of flatten to preserve transparency
+- **Conservative Sharpen Defaults**: radius: 2.0, gain: 0.5, threshold: 0.03 to minimize halo artifacts
+- **Parameter Terminology**: Changed "amount" to "gain" to match ImageMagick documentation
+
+#### Fixed
+- **Gem Build Error**: Removed .rb extension from `bin/ruby_spriter` executable
+- **Clear Error Messages**: File extension validation provides helpful feedback
+
+#### Documentation
+- **README.md**: Added interpolation and sharpening documentation, file format requirements
+- **CLAUDE.md**: Updated with new features and validation details
+- **GIMP_SHARPEN_INVESTIGATION.md**: Documents 8 failed GIMP attempts and architectural decisions
+
+---
+
+## [0.6.1] - 2025-10-22
+
+### 🎉 Major Refactoring Release
+
+#### Added
+- **Modular Architecture**: Split monolithic script into organized modules
+- **RSpec Testing Framework**: Comprehensive unit test coverage
+- **Dependency Checking**: Automatic validation of external tools
+- **Better Error Handling**: Custom exception classes
+- **Code Documentation**: Inline comments and YARD-compatible docs
+- **SimpleCov Integration**: Code coverage reporting
+- **RuboCop Support**: Code style enforcement
+
+#### Changed
+- **Project Structure**: Reorganized into `lib/`, `spec/`, and `bin/` directories
+- **Class Organization**:
+  - `Platform` - Platform detection and configuration
+  - `DependencyChecker` - External tool validation
+  - `VideoProcessor` - FFmpeg operations
+  - `GimpProcessor` - GIMP operations
+  - `MetadataManager` - PNG metadata handling
+  - `Consolidator` - Spritesheet consolidation
+  - `Processor` - Main orchestration
+  - `CLI` - Command-line interface
+  - Utilities: `PathHelper`, `FileHelper`, `OutputFormatter`
+
+#### Fixed
+- Path handling edge cases on Windows
+- Improved error messages with actionable guidance
+- Better temp file cleanup
+
+#### Developer Experience
+- Gemfile for dependency management
+- RSpec test suite with fixtures
+- Comprehensive README with examples
+- Troubleshooting guide
+- Contributing guidelines
+
+---
+
+## [0.6.0] - 2024-XX-XX
+
+### Added
+- Metadata embedding in PNG files
+- Spritesheet consolidation feature
+- Metadata verification command (`--verify`)
+- Debug mode for troubleshooting
+
+### Changed
+- Improved GIMP script generation
+- Better cross-platform path handling
+
+---
+
+## [0.5.0] - 2024-XX-XX
+
+### Added
+- Background removal with GIMP
+- Fuzzy select and global color select options
+- Image scaling support
+- Configurable operation order
+
+---
+
+## [0.4.0] - 2024-XX-XX
+
+### Added
+- Video to spritesheet conversion
+- FFmpeg integration
+- Customizable grid layouts
+
+---
+
+## [0.1.0] - 2024-XX-XX
+
+### Added
+- Initial release
+- Basic video processing
+- Cross-platform support
+
+---
+
+[0.6.2]: https://github.com/scooter-indie/ruby-spriter/compare/v0.6.1...v0.6.2
+[0.6.1]: https://github.com/scooter-indie/ruby-spriter/compare/v0.6.0...v0.6.1
+[0.6.0]: https://github.com/scooter-indie/ruby-spriter/releases/tag/v0.6.0

data/Gemfile

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'rspec', '~> 3.12'
+  gem 'simplecov', '~> 0.22', require: false
+  gem 'rubocop', '~> 1.50', require: false
+  gem 'rubocop-rspec', '~> 2.20', require: false
+end
+
+group :development do
+  gem 'rake', '~> 13.0'
+  gem 'bundler', '~> 2.0'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 scooter-indie
+
+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.