railpack 1.3.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b714e261e3a676ca82d2ea8b33bb47cdf23de847ab367c50edd500883ce1d5a
-  data.tar.gz: c12f5f2c37108aba8bc3f565ce80a3441895b2eada01a127f33129f15ec28f4f
+  metadata.gz: f0e77f850d344d1b29f2e275c3cd49be7a4a684d0f3d5c880d03146b5cbeed6b
+  data.tar.gz: 2d2874defb0fd76f9c2c0ca3d4e746edf9067ce59fba07ef151ff096ffad5016
 SHA512:
-  metadata.gz: 364d8756b8fe2139b37fecc94196e44f56e05a238bedfca6618d8485ceb1f0e1bed9bf5ae08dc0f424055f431146a68d2406b34e65ba84e1f88a671507cd6841
-  data.tar.gz: bd7b094432e4a15707f1878a1c5045187892247ae38a1f41cbf42823a4681b2ff217d220e02fff73528213fcf15d1973f5b3aebfddf6f13d721639be45aa1098
+  metadata.gz: e7308ab9513cfbdb703dac82f3534b8382948e9ee705dc39505014ad951141e3e75c7c2277977e20912975236b9f0efbe9acecf0032ad4203723a273f48cb8d9
+  data.tar.gz: 652705db3d4555423ea5ddcfbf8aecb6aa3584063a1c594934594052e5d7ec370c8ac44e7804092963a5b550f740fc15b414e86d03cb53811f732a0638b384d6

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [1.3.1] - 2026-01-26
+
+This patch release includes final polish and documentation improvements.
+
+### Changes
+
+- **Code style**: Properly indented private methods and removed duplicate `private` keyword
+- **Pre-build validation**: Added `FileUtils.mkdir_p(outdir)` to ensure output directories exist before build
+- **Documentation**: Added comprehensive examples for `analyze_bundle` (gzip output), build hooks (payload details), and manifest delegation
+
 ## [1.3.0] - 2026-01-26
 
 ### 🚀 **Major Architecture Refactoring**

data/README.md

@@ -43,6 +43,7 @@ default:
   sourcemap: false
   entrypoint: "./app/javascript/application.js"
   outdir: "app/assets/builds"
+  analyze_bundle: false  # Enable for gzip size reporting
 
 # Bundler-specific config
 bun:
@@ -52,9 +53,11 @@ bun:
 # Environment overrides
 development:
   sourcemap: true
+  analyze_bundle: true  # Show gzip sizes in dev
 
 production:
   minify: true
+  analyze_bundle: true  # Production bundle analysis
 ```
 
 ## Usage
@@ -111,6 +114,61 @@ Railpack.on_build_complete do |result|
 end
 ```
 
+### Advanced Usage
+
+#### Bundle Analysis with Gzip
+
+Enable `analyze_bundle: true` to see both uncompressed and gzipped bundle sizes:
+
+```yaml
+# config/railpack.yml
+default:
+  analyze_bundle: true
+```
+
+Output example:
+```
+✅ Build completed successfully in 45.23ms (1.23 MB (0.45 MB gzipped))
+```
+
+#### Build Hooks with Payload Details
+
+Hook payloads provide detailed information about build results:
+
+```ruby
+# config/initializers/railpack.rb
+Railpack.on_build_complete do |payload|
+  if payload[:success]
+    # Success payload: { success: true, config: {...}, duration: 45.23, bundle_size: "1.23 MB" }
+    Rails.logger.info "Build succeeded in #{payload[:duration]}ms - #{payload[:bundle_size]}"
+  else
+    # Error payload: { success: false, error: #<Error>, config: {...}, duration: 12.34 }
+    Rails.logger.error "Build failed after #{payload[:duration]}ms: #{payload[:error].message}"
+  end
+end
+
+Railpack.on_build_start do |config|
+  # Config hash contains all current settings
+  Rails.logger.info "Starting #{config['bundler']} build for #{Rails.env}"
+end
+```
+
+#### Manifest Generation
+
+Railpack automatically detects your asset pipeline and generates appropriate manifests:
+
+```ruby
+# For Propshaft (Rails 7+ default)
+# Generates: app/assets/builds/.manifest.json
+Railpack::Manifest::Propshaft.generate(config)
+
+# For Sprockets (Rails < 7)
+# Generates: app/assets/builds/.sprockets-manifest-*.json
+Railpack::Manifest::Sprockets.generate(config)
+```
+
+The manifest generation is handled automatically after each build, but you can trigger it manually if needed.
+
 ## Supported Bundlers
 
 ### Bun (Default)

data/lib/railpack/manager.rb

@@ -132,107 +132,107 @@ module Railpack
 
     private
 
-    def create_bundler
-      bundler_name = Railpack.config.bundler
-      bundler_class = BUNDLERS[bundler_name]
+      def create_bundler
+        bundler_name = Railpack.config.bundler
+        bundler_class = BUNDLERS[bundler_name]
 
-      unless bundler_class
-        raise Error, "Unsupported bundler: #{bundler_name}. Available: #{BUNDLERS.keys.join(', ')}"
-      end
+        unless bundler_class
+          raise Error, "Unsupported bundler: #{bundler_name}. Available: #{BUNDLERS.keys.join(', ')}"
+        end
 
-      bundler_class.new(Railpack.config)
-    end
+        bundler_class.new(Railpack.config)
+      end
 
-    # Calculate human-readable bundle size with optional gzip compression
-    def calculate_bundle_size(config)
-      outdir = config['outdir']
-      return 'unknown' unless outdir && Dir.exist?(outdir)
+      # Calculate human-readable bundle size with optional gzip compression
+      def calculate_bundle_size(config)
+        outdir = config['outdir']
+        return 'unknown' unless outdir && Dir.exist?(outdir)
 
-      total_size = 0
-      Dir.glob("#{outdir}/**/*.{js,css,map}").each do |file|
-        total_size += File.size(file) if File.file?(file)
-      end
+        total_size = 0
+        Dir.glob("#{outdir}/**/*.{js,css,map}").each do |file|
+          total_size += File.size(file) if File.file?(file)
+        end
 
-      # Include gzip size if analyze_bundle is enabled
-      if config['analyze_bundle']
-        gzip_size = calculate_gzip_size(outdir)
-        "#{human_size(total_size)} (#{human_size(gzip_size)} gzipped)"
-      else
-        human_size(total_size)
+        # Include gzip size if analyze_bundle is enabled
+        if config['analyze_bundle']
+          gzip_size = calculate_gzip_size(outdir)
+          "#{human_size(total_size)} (#{human_size(gzip_size)} gzipped)"
+        else
+          human_size(total_size)
+        end
+      rescue => error
+        Railpack.logger.debug "Bundle size calculation failed: #{error.message}"
+        'unknown'
       end
-    rescue => error
-      Railpack.logger.debug "Bundle size calculation failed: #{error.message}"
-      'unknown'
-    end
 
-    # Calculate total gzip-compressed size of assets
-    def calculate_gzip_size(outdir)
-      Dir.glob("#{outdir}/**/*.{js,css}").sum do |file|
-        next 0 unless File.file?(file)
-        Zlib::Deflate.deflate(File.read(file)).bytesize
+      # Calculate total gzip-compressed size of assets
+      def calculate_gzip_size(outdir)
+        Dir.glob("#{outdir}/**/*.{js,css}").sum do |file|
+          next 0 unless File.file?(file)
+          Zlib::Deflate.deflate(File.read(file)).bytesize
+        end
+      rescue => error
+        Railpack.logger.debug "Gzip size calculation failed: #{error.message}"
+        0
       end
-    rescue => error
-      Railpack.logger.debug "Gzip size calculation failed: #{error.message}"
-      0
-    end
 
-    # Convert bytes to human-readable format (B, KB, MB, GB)
-    def human_size(bytes)
-      units = %w[B KB MB GB]
-      size = bytes.to_f
-      units.each do |unit|
-        return "#{(size).round(2)} #{unit}" if size < 1024
-        size /= 1024
+      # Convert bytes to human-readable format (B, KB, MB, GB)
+      def human_size(bytes)
+        units = %w[B KB MB GB]
+        size = bytes.to_f
+        units.each do |unit|
+          return "#{(size).round(2)} #{unit}" if size < 1024
+          size /= 1024
+        end
       end
-    end
 
-    def generate_asset_manifest(config)
-      outdir = config['outdir']
-      return unless outdir && Dir.exist?(outdir)
+      def generate_asset_manifest(config)
+        outdir = config['outdir']
+        return unless outdir && Dir.exist?(outdir)
 
-      # Detect asset pipeline type and delegate to appropriate manifest generator
-      pipeline_type = detect_asset_pipeline
-      manifest_class = Railpack::Manifest.const_get(pipeline_type.capitalize)
+        # Detect asset pipeline type and delegate to appropriate manifest generator
+        pipeline_type = detect_asset_pipeline
+        manifest_class = Railpack::Manifest.const_get(pipeline_type.capitalize)
 
-      manifest_class.generate(config)
-    rescue => error
-      # Enhanced error logging with context
-      asset_files = Dir.glob("#{outdir}/**/*.{js,css}").length rescue 0
-      Railpack.logger.warn "⚠️  Failed to generate #{pipeline_type} asset manifest for #{outdir} (#{asset_files} assets): #{error.message}"
-    end
+        manifest_class.generate(config)
+      rescue => error
+        # Enhanced error logging with context
+        asset_files = Dir.glob("#{outdir}/**/*.{js,css}").length rescue 0
+        Railpack.logger.warn "⚠️  Failed to generate #{pipeline_type} asset manifest for #{outdir} (#{asset_files} assets): #{error.message}"
+      end
 
-    # Validate output directory exists and is writable before build
-    def validate_output_directory(config)
-      outdir = config['outdir']
-      return unless outdir
+      # Validate output directory exists and is writable before build
+      def validate_output_directory(config)
+        outdir = config['outdir']
+        return unless outdir
 
-      unless Dir.exist?(outdir)
-        Railpack.logger.warn "⚠️  Output directory #{outdir} does not exist - assets will be created on first build"
+        unless Dir.exist?(outdir)
+          Railpack.logger.warn "⚠️  Output directory #{outdir} does not exist - assets will be created on first build"
+          # Ensure directory exists to prevent early build failures
+          FileUtils.mkdir_p(outdir)
+        end
       end
-    end
 
-    def detect_asset_pipeline
-      # Check Rails.application.config.assets class directly (more reliable)
-      if defined?(Rails) && Rails.respond_to?(:application) && Rails.application
-        assets_config = Rails.application.config.assets
-        if assets_config.is_a?(Propshaft::Assembler) || defined?(Propshaft::Assembler)
+      def detect_asset_pipeline
+        # Check Rails.application.config.assets class directly (more reliable)
+        if defined?(Rails) && Rails.respond_to?(:application) && Rails.application
+          assets_config = Rails.application.config.assets
+          if assets_config.is_a?(Propshaft::Assembler) || defined?(Propshaft::Assembler)
+            :propshaft
+          elsif defined?(Sprockets::Manifest)
+            :sprockets
+          end
+        end
+
+        # Fallback to version-based detection
+        if defined?(Rails) && Rails.version.to_f >= 7.0
           :propshaft
-        elsif defined?(Sprockets::Manifest)
+        elsif defined?(Rails) && Rails.version.to_f < 7.0 && defined?(Sprockets)
           :sprockets
+        else
+          # Safe default for modern Rails
+          :propshaft
         end
       end
-
-      # Fallback to version-based detection
-      if defined?(Rails) && Rails.version.to_f >= 7.0
-        :propshaft
-      elsif defined?(Rails) && Rails.version.to_f < 7.0 && defined?(Sprockets)
-        :sprockets
-      else
-        # Safe default for modern Rails
-        :propshaft
-      end
-    end
-
-
   end
-end
+end

data/lib/railpack/version.rb

@@ -1,3 +1,3 @@
 module Railpack
-  VERSION = "1.3.0"
+  VERSION = "1.3.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railpack
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.1
 platform: ruby
 authors:
 - 21tycoons LLC