bridgetown-builder 1.0.0.beta3 → 1.1.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0146eff5ec7cd4cc86e8a6875e1972fddf15b42f9b07ece028e22a5e84e37466
-  data.tar.gz: aceafe5263cc94a43b2a7aab9f585f70bcf40b97e99a3cbd31a7d3f094805096
+  metadata.gz: 5e95e26924a3b4cfb3fb95fe5af3d2a7be3630a7d3aaf8dc738b24102ea0dc16
+  data.tar.gz: 2ae5a954e86865d3886eed2b4ecd146c892b1b5c47acc903d9d5d83611f73415
 SHA512:
-  metadata.gz: 4815a30ce7a876508b26ad957a782a83fa2406f22233fd50d8f37730d9d5478969d252abc753c12d79f97e2ab6677b412a6bc778ec872ba5b2078428b7fbad0f
-  data.tar.gz: 606f95191c4a22438f5caf23e4bcba13de93aa0f67630d9c4a66d81cdc221ff1a1dc9c5c86ffb5909814d98b93ad133e41732136a9da56095cf81358dfa50bf3
+  metadata.gz: b308dbf4bd761cead11ec7f5fba42ab136b549ba48b226b5b321ca5488d41bd527555267ce88df7b077f484506cdd5eff092d4925c82ca0f4fd24b21aa0e1775
+  data.tar.gz: ae39eb4841a8075f3d6c278450837434ed64f836ab2f4df5d4e5deff0e35326de617ea89b10bc3c89428f59e66165ae6daf378f5705b9663b3b01359cddcaacd

data/lib/bridgetown-builder/dsl/generators.rb

@@ -7,13 +7,16 @@ module Bridgetown
         def generator(method_name = nil, &block)
           block = method(method_name) if method_name.is_a?(Symbol)
           local_name = name # pull the name method into a local variable
+          builder_priority = self.class.instance_variable_get(:@priority)
 
-          new_gen = Class.new(Bridgetown::Generator) do
+          anon_generator = Class.new(Bridgetown::Generator) do
             define_method(:_builder_block) { block }
             define_singleton_method(:custom_name) { local_name }
 
             attr_reader :site
 
+            priority builder_priority || :low
+
             def inspect
               "#<#{self.class.custom_name} (Generator)>"
             end
@@ -23,10 +26,10 @@ module Bridgetown
             end
           end
 
-          first_low_priority_index = site.generators.find_index { |gen| gen.class.priority == :low }
-          site.generators.insert(first_low_priority_index || 0, new_gen.new(site.config))
+          site.generators << anon_generator.new(site.config)
+          site.generators.sort!
 
-          functions << { name: name, generator: new_gen }
+          functions << { name: name, generator: anon_generator }
         end
       end
     end

data/lib/bridgetown-builder/dsl/inspectors.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module Bridgetown
+  module Builders
+    module DSL
+      module Inspectors
+        # Add a couple familar DOM API features
+        module QuerySelection
+          def query_selector(selector)
+            css(selector).first
+          end
+
+          def query_selector_all(selector)
+            css(selector)
+          end
+        end
+
+        # HTML inspector type
+        module HTML
+          # Are there inspectors available? Is it an .htm* file?
+          def self.can_run?(resource, inspectors)
+            inspectors &&
+              resource.destination&.output_ext&.starts_with?(".htm") &&
+              !resource.data.bypass_inspectors
+          end
+
+          # Process the resource with the available inspectors and return the output HTML
+          #
+          # @return [String] transformed HTML
+          def self.call(resource, inspectors)
+            doc = Nokogiri.HTML5(resource.output)
+
+            inspectors.each do |block|
+              block.call(doc, resource)
+            end
+
+            doc.to_html
+          end
+        end
+
+        # XML inspector type
+        module XML
+          # Strip the resource's initial extension dot. `.rss` => `rss`
+          def self.resource_ext(resource)
+            resource.destination&.output_ext&.delete_prefix(".")
+          end
+
+          # Are there any inspectors available which match the resource extension?
+          def self.can_run?(resource, inspectors)
+            inspectors &&
+              inspectors[resource_ext(resource)] &&
+              !resource.data.bypass_inspectors
+          end
+
+          # Process the resource with the available inspectors and return the output XML
+          #
+          # @return [String] transformed XML
+          def self.call(resource, inspectors)
+            doc = Nokogiri::XML(resource.output)
+
+            inspectors[resource_ext(resource)].each do |block|
+              block.call(doc, resource)
+            end
+
+            doc.to_xml
+          end
+        end
+
+        class << self
+          # Require the Nokogiri gem if necessary and add the `QuerySelection` mixin
+          def setup_nokogiri
+            unless defined?(Nokogiri)
+              Bridgetown::Utils::RequireGems.require_with_graceful_fail "nokogiri"
+            end
+
+            return if Nokogiri::XML::Node <= QuerySelection
+
+            Nokogiri::XML::Node.include QuerySelection
+          end
+
+          # Shorthand for `HTML.call`
+          def process_html(...)
+            HTML.call(...)
+          end
+
+          # Shorthand for `XML.call`
+          def process_xml(...)
+            XML.call(...)
+          end
+        end
+
+        # Set up an inspector to review or manipulate HTML resources
+        # @yield the block to be called after the resource has been rendered
+        # @yieldparam [Nokogiri::HTML5::Document] the Nokogiri document
+        def inspect_html(&block)
+          unless @_html_inspectors
+            @_html_inspectors = []
+
+            Inspectors.setup_nokogiri
+
+            hook :resources, :post_render do |resource|
+              next unless HTML.can_run?(resource, @_html_inspectors)
+
+              resource.output = Inspectors.process_html(resource, @_html_inspectors)
+            end
+          end
+
+          @_html_inspectors << block
+        end
+
+        # Set up an inspector to review or manipulate XML resources
+        # @param extension [String] defaults to `xml`
+        # @yield the block to be called after the resource has been rendered
+        # @yieldparam [Nokogiri::XML::Document] the Nokogiri document
+        def inspect_xml(extension = "xml", &block)
+          unless @_xml_inspectors
+            @_xml_inspectors = {}
+
+            Inspectors.setup_nokogiri
+
+            hook :resources, :post_render do |resource|
+              next unless Inspectors::XML.can_run?(resource, @_xml_inspectors)
+
+              resource.output = Inspectors.process_xml(resource, @_xml_inspectors)
+            end
+          end
+
+          (@_xml_inspectors[extension.to_s] ||= []).tap do |arr|
+            arr << block
+          end
+
+          @_xml_inspectors
+        end
+      end
+    end
+  end
+end

data/lib/bridgetown-builder/plugin.rb

@@ -3,15 +3,28 @@
 require "bridgetown-builder/dsl/generators"
 require "bridgetown-builder/dsl/helpers"
 require "bridgetown-builder/dsl/hooks"
+require "bridgetown-builder/dsl/inspectors"
 require "bridgetown-builder/dsl/http"
 require "bridgetown-builder/dsl/liquid"
 require "bridgetown-builder/dsl/resources"
+
 module Bridgetown
   module Builders
     class PluginBuilder
+      include Bridgetown::Prioritizable
+
+      self.priorities = {
+        highest: 100,
+        high: 10,
+        normal: 0,
+        low: -10,
+        lowest: -100,
+      }.freeze
+
       include DSL::Generators
       include DSL::Helpers
       include DSL::Hooks
+      include DSL::Inspectors
       include DSL::HTTP
       include DSL::Liquid
       include DSL::Resources

data/lib/bridgetown-builder.rb

@@ -15,7 +15,7 @@ Bridgetown::Hooks.register_one :site, :pre_read, priority: :low, reloadable: fal
   # SiteBuilder is the superclass sites can subclass to create any number of
   # builders, but if the site hasn't defined it explicitly, this is a no-op
   if defined?(SiteBuilder)
-    SiteBuilder.descendants.map do |c|
+    SiteBuilder.descendants.sort.map do |c|
       c.new(c.name, site).build_with_callbacks
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bridgetown-builder
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta3
+  version: 1.1.0.beta2
 platform: ruby
 authors:
 - Bridgetown Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-18 00:00:00.000000000 Z
+date: 2022-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bridgetown-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.beta3
+        version: 1.1.0.beta2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.beta3
+        version: 1.1.0.beta2
 description: 
 email: maintainers@bridgetownrb.com
 executables: []
@@ -39,6 +39,7 @@ files:
 - lib/bridgetown-builder/dsl/helpers.rb
 - lib/bridgetown-builder/dsl/hooks.rb
 - lib/bridgetown-builder/dsl/http.rb
+- lib/bridgetown-builder/dsl/inspectors.rb
 - lib/bridgetown-builder/dsl/liquid.rb
 - lib/bridgetown-builder/dsl/resources.rb
 - lib/bridgetown-builder/plugin.rb