docuseal/vendor/bundle/ruby/4.0.0/gems/launchy-3.1.1/lib/launchy.rb

# frozen_string_literal: true

require "English"
require "addressable/uri"
require "shellwords"
require "stringio"

#
# The entry point into Launchy. This is the sole supported public API.
#
#   Launchy.open( uri, options = {} )
#
# The currently defined global options are:
#
#   :debug        Turn on debugging output
#   :application  Explicitly state what application class is going to be used.
#                 This must be a child class of Launchy::Application
#   :host_os      Explicitly state what host operating system to pretend to be
#   :dry_run      Do nothing and print the command that would be executed on $stdout
#
# Other options may be used, and those will be passed directly to the
# application class
#
module Launchy
  class << self
    #
    # Launch an application for the given uri string
    #
    def open(uri_s, options = {})
      leftover = extract_global_options(options)
      uri = string_to_uri(uri_s)
      if (name = options[:application])
        app = app_for_name(name)
      end

      app = app_for_uri(uri) if app.nil?

      app.new.open(uri, leftover)
    rescue Launchy::Error => e
      raise e
    rescue StandardError => e
      msg = "Failure in opening uri #{uri_s.inspect} with options #{options.inspect}: #{e}"
      raise Launchy::Error, msg
    ensure
      if $ERROR_INFO && block_given?
        yield $ERROR_INFO

        # explicitly return here to swallow the errors if there was an error
        # and we yielded to the block
        # rubocop:disable Lint/EnsureReturn
        return
        # rubocop:enable Lint/EnsureReturn
      end
    end

    def app_for_uri(uri)
      Launchy::Application.handling(uri)
    end

    def app_for_name(name)
      Launchy::Application.for_name(name)
    rescue Launchy::ApplicationNotFoundError
      nil
    end

    def app_for_uri_string(str)
      app_for_uri(string_to_uri(str))
    end

    def string_to_uri(str)
      str = str.to_s
      uri = Addressable::URI.parse(str)
      Launchy.log "URI parsing pass 1 : #{str} -> #{uri.to_hash}"
      unless uri.scheme
        uri = Addressable::URI.heuristic_parse(str)
        Launchy.log "URI parsing pass 2 : #{str} -> #{uri.to_hash}"
      end
      raise Launchy::ArgumentError, "Invalid URI given: #{str.inspect}" unless uri

      uri
    end

    def reset_global_options
      Launchy.debug       = false
      Launchy.application = nil
      Launchy.host_os     = nil
      Launchy.dry_run     = false
      Launchy.path        = ENV.fetch("PATH", nil)
    end

    def extract_global_options(options)
      leftover = options.dup
      Launchy.debug        = leftover.delete(:debug) || ENV.fetch("LAUNCHY_DEBUG", nil)
      Launchy.application  = leftover.delete(:application) || ENV.fetch("LAUNCHY_APPLICATION", nil)
      Launchy.host_os      = leftover.delete(:host_os) || ENV.fetch("LAUNCHY_HOST_OS", nil)
      Launchy.dry_run      = leftover.delete(:dry_run) || ENV.fetch("LAUNCHY_DRY_RUN", nil)
    end

    def debug=(enabled)
      @debug = to_bool(enabled)
    end

    # we may do logging before a call to 'open', hence the need to check
    # LAUNCHY_DEBUG here
    def debug?
      @debug || to_bool(ENV.fetch("LAUNCHY_DEBUG", nil))
    end

    def application=(app)
      @application = app
    end

    def application
      @application || ENV.fetch("LAUNCHY_APPLICATION", nil)
    end

    def host_os=(host_os)
      @host_os = host_os
    end

    def host_os
      @host_os || ENV.fetch("LAUNCHY_HOST_OS", nil)
    end

    def dry_run=(dry_run)
      @dry_run = to_bool(dry_run)
    end

    def dry_run?
      @dry_run || to_bool(ENV.fetch("LAUNCHY_DRY_RUN", nil))
    end

    def bug_report_message
      "Please rerun with environment variable LAUNCHY_DEBUG=true or the '-d' commandline option and file a bug at https://github.com/copiousfreetime/launchy/issues/new"
    end

    def log(msg)
      $stderr.puts "LAUNCHY_DEBUG: #{msg}" if Launchy.debug?
    end

    def path
      @path
    end

    def path=(path)
      @path = path
    end

    private

    def to_bool(arg)
      if arg.is_a? String
        arg == "true"
      else
        arg.is_a? TrueClass
      end
    end
  end

  # Iniitialize the global options to sane defaults during parse time.
  Launchy.reset_global_options
end

require "launchy/version"
require "launchy/argv"
require "launchy/cli"
require "launchy/descendant_tracker"
require "launchy/error"
require "launchy/application"
require "launchy/detect"
require "launchy/runner"