module BannerEngines

BannerEngines — catalog of text banner CLIs plus internal block glyphs. chafa/jp2a are image-only and excluded from the random pool for text headings.

Public: ENGINES, available, pick, fetch, argv_for, resolve_id Depends: (none) Tests: test/lib/banner_engines_test.rb

Constants

ENGINES

Public Instance Methods

argv_for (id, text, extras: [])

Source

# File lib/banner_engines.rb, line 40
def argv_for(id, text, extras: [])
  entry = fetch(id)
  return nil unless entry&.dig(:argv)

  entry[:argv].call(text, extras: extras)
end

available (executable: default_executable)

Source

# File lib/banner_engines.rb, line 52
def available(executable: default_executable)
  ENGINES.keys.select do |id|
    entry = ENGINES[id]
    next true if entry[:type] == :internal
    if entry[:pipeline]
      entry[:pipeline].all? { |stage_id| executable.call(ENGINES.fetch(stage_id)[:bin]) }
    else
      executable.call(entry[:bin])
    end
  end
end

default_executable ()

Source

# File lib/banner_engines.rb, line 70
def default_executable
  lambda do |bin|
    ENV.fetch("PATH", "").split(File::PATH_SEPARATOR).any? do |dir|
      path = File.join(dir, bin)
      File.file?(path) && File.executable?(path)
    end
  end
end

fetch (id)

Source

# File lib/banner_engines.rb, line 36
def fetch(id)
  ENGINES[id.to_sym]
end

pick (rng: Random, pool: nil, executable: default_executable)

Source

# File lib/banner_engines.rb, line 64
def pick(rng: Random, pool: nil, executable: default_executable)
  candidates = pool || available(executable: executable)
  candidates = [:blocks] if candidates.empty?
  candidates[rng.rand(candidates.length)]
end

resolve_id (token)

Source

# File lib/banner_engines.rb, line 47
def resolve_id(token)
  id = token.to_s.strip.downcase.to_sym
  ENGINES.key?(id) ? id : nil
end