Sha256: 53b553cb2a53234ec04f8ba05c943d7af3678fdeb7c1739374092f89ce8fed40

Contents?: true

Size: 1.62 KB

Versions: 138

Compression:

Stored size: 1.62 KB

Contents

module J1
  module External
    class << self
      #
      # Gems that, if installed, should be loaded.
      # Usually contain subcommands.
      #
      def blessed_gems
        %w(
          jekyll-docs
          jekyll-import
        )
      end

      #
      # Require a gem or file if it's present, otherwise silently fail.
      #
      # names - a string gem name or array of gem names
      #
      def require_if_present(names)
        Array(names).each do |name|
          begin
            require name
          rescue LoadError
            J1.logger.debug "Couldn't load #{name}. Skipping."
            yield(name) if block_given?
            false
          end
        end
      end

      #
      # Require a gem or gems. If it's not present, show a very nice error
      # message that explains everything and is much more helpful than the
      # normal LoadError.
      #
      # names - a string gem name or array of gem names
      #
      def require_with_graceful_fail(names)
        Array(names).each do |name|
          begin
            J1.logger.debug "Requiring:", name.to_s
            require name
          rescue LoadError => e
            J1.logger.error "Dependency Error:", <<-MSG
Yikes! It looks like you don't have #{name} or one of its dependencies installed.
In order to use Jekyll as currently configured, you'll need to install this gem.

The full error message from Ruby is: '#{e.message}'

If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/!
            MSG
            raise Jekyll::Errors::MissingDependencyException, name
          end
        end
      end
    end
  end
end

Version data entries

138 entries across 138 versions & 3 rubygems

Version Path
j1-template-2022.0.15 lib/j1/external.rb
j1-template-2022.0.14 lib/j1/external.rb
j1-template-2022.0.13 lib/j1/external.rb
j1-template-2022.0.12 lib/j1/external.rb
j1-template-2022.0.11 lib/j1/external.rb
j1-template-2022.0.10 lib/j1/external.rb
j1-template-2022.0.9 lib/j1/external.rb
j1-template-2022.0.8 lib/j1/external.rb
j1-template-2022.0.7 lib/j1/external.rb
j1-template-2022.0.6 lib/j1/external.rb
j1-template-2022.0.5 lib/j1/external.rb
j1-template-2022.0.4 lib/j1/external.rb
j1-template-2022.0.3 lib/j1/external.rb
j1-template-2022.0.2 lib/j1/external.rb
j1-template-2022.0.1 lib/j1/external.rb
j1-template-2022.0.0 lib/j1/external.rb
j1-template-2021.3.2 lib/j1/external.rb
j1-template-2021.3.1 lib/j1/external.rb
j1-template-2021.3.0 lib/j1/external.rb
j1-template-2021.2.12 lib/j1/external.rb