jekyll-uj-powertools 1.7.0 → 1.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60803db8fb2a1e2c50aea11a0f49e964fc16d3323943ce0330f4312fd6468e37
-  data.tar.gz: 05f5ac27b7651b0d5592395cc510ba5b31e77f9b5ead9f35f0de6420d5919fd9
+  metadata.gz: 59b2d051f809592cc566481818bc2ac531de4378c131841b1e01f6a1187b5a6d
+  data.tar.gz: ffab0a040714b14e3c407ac76a7ce9ffd73dd7bd91a8103a75eb14c15ada7e1d
 SHA512:
-  metadata.gz: 17bb830ad04f8be16741f99f9dcaab5f723b7c9bb58f1ffbdfa0bf9a9637c0357e829c82dd4dc13feee2e70773bde48cd71e1cface15873f7232a60ea6880f4c
-  data.tar.gz: 21c374abbaa0e43c40bf1ecda75ac52eda70dd33140c69c972bf352eca2d571c35c5d70485947275a639c46b7df8e235f496a2b678a29008722ebeadb9e4e62b
+  metadata.gz: 1bdb38f9cd185d941472c5ed062eea7e244b9fdbd706a877d1f7ec5873cea5f2e5781591c39793b1d85d5a2bc101c9d4e94fd90cc1b22494e9718c090a55ff05
+  data.tar.gz: 8add8dcc5ba487868e90d03ace655a195abd6891ab983066badd1ded22c6d2bb9cae2a99bb3aa33aa80b4d56edbef18bfacaf65be0b80578bbb12c29e1fe610d

data/README.md

@@ -365,6 +365,38 @@ layout: default
 {% endfor %}
 ```
 
+## Parallel Build
+Speed up Jekyll builds by rendering pages and documents in parallel using multiple CPU threads. This can significantly reduce build times for sites with many pages.
+
+**Enabled by default** - no configuration needed! The plugin automatically uses all available CPU cores.
+
+### Configuration
+Customize parallel build behavior in `_config.yml`:
+
+```yaml
+parallel_build:
+  enabled: true          # Enable/disable parallel builds (default: true)
+  threads: 8             # Number of threads (default: number of CPU cores)
+  min_items: 1           # Minimum items before parallelizing (default: 1)
+```
+
+### Disabling Parallel Build
+If you encounter issues with thread-safety in custom Liquid tags:
+
+```yaml
+# Option 1: Disable entirely
+parallel_build: false
+
+# Option 2: Disable via enabled flag
+parallel_build:
+  enabled: false
+```
+
+### Performance Tips
+- Parallel builds work best with CPU-bound Liquid rendering
+- For maximum speed, combine with `limit_collections` during development
+- Use `--profile` to identify slow templates that benefit most from parallelization
+
 ## Development Config (`_config.dev.yml`)
 Speed up dev builds by limiting collections. Create `_config.dev.yml` in your Jekyll source:
 

data/jekyll-uj-powertools.gemspec

@@ -5,7 +5,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 Gem::Specification.new do |spec|
   # Gem info
   spec.name = "jekyll-uj-powertools"
-  spec.version = "1.7.0"
+  spec.version = "1.7.2"
 
   # Author info
   spec.authors = ["ITW Creative Works"]
@@ -31,10 +31,14 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"
   spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "ostruct"
 
   # Translation and HTML manipulation requires Nokogiri
   spec.add_runtime_dependency 'nokogiri', '>= 1.17'
 
+  # Parallel processing for faster builds
+  spec.add_runtime_dependency 'parallel', '>= 1.20'
+
   # Ruby version
   spec.required_ruby_version = ">= 2.0.0"
 end

data/lib/hooks/parallel-build.rb

@@ -0,0 +1,129 @@
+# Parallel Build Generator
+# Speeds up Jekyll builds by rendering pages and documents in parallel
+#
+# This runs as a Generator with :lowest priority to ensure it processes
+# all pages AFTER other generators (like DynamicPages) have created them.
+#
+# Configuration in _config.yml:
+#
+#   parallel_build:
+#     enabled: true          # Enable/disable parallel builds (default: true)
+#     threads: 8             # Number of threads (default: number of CPU cores)
+#     min_items: 1           # Minimum items before parallelizing (default: 1)
+#
+# Note: Parallel builds work best with CPU-bound rendering.
+# Some Liquid tags may not be thread-safe - if you encounter issues,
+# disable with `parallel_build: false` or `parallel_build.enabled: false`
+
+require 'parallel'
+
+module Jekyll
+  class ParallelBuildGenerator < Generator
+    safe true
+    priority :lowest  # Run AFTER all other generators
+
+    def generate(site)
+      config = site.config['parallel_build']
+
+      # Handle both `parallel_build: false` and `parallel_build.enabled: false`
+      if config == false
+        Jekyll.logger.info "ParallelBuild:", "Disabled via config"
+        return
+      end
+
+      config = {} if config.nil? || config == true
+      return unless config.fetch('enabled', true)
+
+      threads = config.fetch('threads', Parallel.processor_count)
+      min_items = config.fetch('min_items', 1)
+
+      # Render documents in parallel (posts, collections)
+      render_documents_parallel(site, threads, min_items)
+
+      # Render pages in parallel
+      render_pages_parallel(site, threads, min_items)
+    end
+
+    private
+
+    def render_documents_parallel(site, threads, min_items)
+      # Collect all documents that need rendering
+      documents = site.collections.flat_map do |_name, collection|
+        collection.docs.select { |doc| doc.respond_to?(:render) && !doc.data['rendered_parallel'] }
+      end
+
+      return if documents.size < min_items
+
+      Jekyll.logger.info "ParallelBuild:", "Rendering #{documents.size} documents with #{threads} threads..."
+
+      start_time = Time.now
+
+      # Pre-render: prepare payload and info for each document
+      # We need to do the actual Liquid rendering in parallel
+      Parallel.each(documents, in_threads: threads) do |doc|
+        begin
+          # Mark as rendered to avoid double-rendering
+          doc.data['rendered_parallel'] = true
+
+          # Render content through Liquid
+          if doc.content && !doc.content.empty?
+            payload = site.site_payload
+            info = {
+              filters: [Jekyll::Filters],
+              registers: {
+                site: site,
+                page: doc.to_liquid
+              }
+            }
+
+            # Parse and render Liquid template
+            template = site.liquid_renderer.file(doc.path).parse(doc.content)
+            doc.content = template.render!(payload, info)
+          end
+        rescue => e
+          Jekyll.logger.warn "ParallelBuild:", "Error rendering #{doc.relative_path}: #{e.message}"
+        end
+      end
+
+      elapsed = Time.now - start_time
+      Jekyll.logger.info "ParallelBuild:", "Documents rendered in #{elapsed.round(2)}s"
+    end
+
+    def render_pages_parallel(site, threads, min_items)
+      # Get all pages (including dynamically generated ones without content)
+      pages = site.pages.reject { |page| page.data['rendered_parallel'] }
+
+      return if pages.size < min_items
+
+      Jekyll.logger.info "ParallelBuild:", "Rendering #{pages.size} pages with #{threads} threads..."
+
+      start_time = Time.now
+
+      Parallel.each(pages, in_threads: threads) do |page|
+        begin
+          page.data['rendered_parallel'] = true
+
+          # Only render if there's content to process
+          if page.content && !page.content.empty?
+            payload = site.site_payload
+            info = {
+              filters: [Jekyll::Filters],
+              registers: {
+                site: site,
+                page: page.to_liquid
+              }
+            }
+
+            template = site.liquid_renderer.file(page.path).parse(page.content)
+            page.content = template.render!(payload, info)
+          end
+        rescue => e
+          Jekyll.logger.warn "ParallelBuild:", "Error rendering #{page.name}: #{e.message}"
+        end
+      end
+
+      elapsed = Time.now - start_time
+      Jekyll.logger.info "ParallelBuild:", "Pages rendered in #{elapsed.round(2)}s"
+    end
+  end
+end

data/lib/jekyll-uj-powertools.rb

@@ -1,5 +1,6 @@
 # Libraries
 require "jekyll"
+require "parallel"
 
 module Jekyll
   # Load Filters
@@ -14,6 +15,7 @@ module Jekyll
   # Load Hooks
   require_relative "hooks/inject-properties"
   require_relative "hooks/markdown-images"
+  # require_relative "hooks/parallel-build"
 
   # Load Tags
   require_relative "tags/external"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-uj-powertools
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.7.2
 platform: ruby
 authors:
 - ITW Creative Works
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-29 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -86,6 +85,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -100,6 +113,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: parallel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.20'
 description: jekyll-uj-powertools provides a powerful set of utilities for Jekyll,
   including functions to remove ads from strings and escape JSON characters.
 email:
@@ -121,6 +148,7 @@ files:
 - lib/helpers/variable_resolver.rb
 - lib/hooks/inject-properties.rb
 - lib/hooks/markdown-images.rb
+- lib/hooks/parallel-build.rb
 - lib/jekyll-uj-powertools.rb
 - lib/tags/external.rb
 - lib/tags/fake_comments.rb
@@ -142,7 +170,6 @@ homepage: https://github.com/itw-creative-works/jekyll-uj-powertools
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -157,8 +184,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: A powerful set of utilities for Jekyll
 test_files: []