Sha256: 689bc4a5c2e0ac073d58903a1617b08a893ef0f4c879c650b81deecdaf2b6cc1

Contents?: true

Size: 1.9 KB

Versions: 21

Compression:

Stored size: 1.9 KB

Contents

# frozen_string_literal: true

module Bridgetown
  class Plugin
    PRIORITIES = {
      low: -10,
      highest: 100,
      lowest: -100,
      normal: 0,
      high: 10,
    }.freeze

    SourceManifest = Struct.new(:origin, :components, :content, :layouts, keyword_init: true)

    #

    def self.inherited(const)
      catch_inheritance(const) do |const_|
        catch_inheritance(const_)
      end
    end

    #

    def self.catch_inheritance(const)
      const.define_singleton_method :inherited do |const_|
        (@children ||= Set.new).add const_
        yield const_ if block_given?
      end
    end

    #

    def self.descendants
      @children ||= Set.new
      out = @children.map(&:descendants)
      out << self unless superclass == Plugin
      Set.new(out).flatten
    end

    # Get or set the priority of this plugin. When called without an
    # argument it returns the priority. When an argument is given, it will
    # set the priority.
    #
    # priority - The Symbol priority (default: nil). Valid options are:
    #            :lowest, :low, :normal, :high, :highest
    #
    # Returns the Symbol priority.
    def self.priority(priority = nil)
      @priority ||= nil
      @priority = priority if priority && PRIORITIES.key?(priority)
      @priority || :normal
    end

    # Spaceship is priority [higher -> lower]
    #
    # other - The class to be compared.
    #
    # Returns -1, 0, 1.
    def self.<=>(other)
      PRIORITIES[other.priority] <=> PRIORITIES[priority]
    end

    # Spaceship is priority [higher -> lower]
    #
    # other - The class to be compared.
    #
    # Returns -1, 0, 1.
    def <=>(other)
      self.class <=> other.class
    end

    # Initialize a new plugin. This should be overridden by the subclass.
    #
    # config - The Hash of configuration options.
    #
    # Returns a new instance.
    def initialize(config = {})
      # no-op for default
    end
  end
end

Version data entries

21 entries across 21 versions & 1 rubygems

Version Path
bridgetown-core-0.19.1 lib/bridgetown-core/plugin.rb
bridgetown-core-0.19.0 lib/bridgetown-core/plugin.rb
bridgetown-core-0.18.6 lib/bridgetown-core/plugin.rb
bridgetown-core-0.18.5 lib/bridgetown-core/plugin.rb
bridgetown-core-0.18.4 lib/bridgetown-core/plugin.rb
bridgetown-core-0.18.3 lib/bridgetown-core/plugin.rb
bridgetown-core-0.18.2 lib/bridgetown-core/plugin.rb
bridgetown-core-0.18.1 lib/bridgetown-core/plugin.rb
bridgetown-core-0.18.0 lib/bridgetown-core/plugin.rb
bridgetown-core-0.17.1 lib/bridgetown-core/plugin.rb
bridgetown-core-0.17.0 lib/bridgetown-core/plugin.rb
bridgetown-core-0.16.0 lib/bridgetown-core/plugin.rb
bridgetown-core-0.16.0.beta2 lib/bridgetown-core/plugin.rb
bridgetown-core-0.16.0.beta1 lib/bridgetown-core/plugin.rb
bridgetown-core-0.15.0 lib/bridgetown-core/plugin.rb
bridgetown-core-0.15.0.beta4 lib/bridgetown-core/plugin.rb
bridgetown-core-0.15.0.beta3 lib/bridgetown-core/plugin.rb
bridgetown-core-0.15.0.beta2 lib/bridgetown-core/plugin.rb
bridgetown-core-0.15.0.beta1 lib/bridgetown-core/plugin.rb
bridgetown-core-0.14.1 lib/bridgetown-core/plugin.rb