module Launchy
def app_for_name(name)
def app_for_name(name) Launchy::Application.for_name(name) rescue Launchy::ApplicationNotFoundError nil end
def app_for_uri(uri)
def app_for_uri(uri) Launchy::Application.handling(uri) end
def app_for_uri_string(str)
def app_for_uri_string(str) app_for_uri(string_to_uri(str)) end
def application
def application @application || ENV.fetch("LAUNCHY_APPLICATION", nil) end
def application=(app)
def application=(app) @application = app end
def bug_report_message
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 debug=(enabled)
def debug=(enabled) @debug = to_bool(enabled) end
def debug?
we may do logging before a call to 'open', hence the need to check
def debug? @debug || to_bool(ENV.fetch("LAUNCHY_DEBUG", nil)) end
def dry_run=(dry_run)
def dry_run=(dry_run) @dry_run = to_bool(dry_run) end
def dry_run?
def dry_run? @dry_run || to_bool(ENV.fetch("LAUNCHY_DRY_RUN", nil)) end
def extract_global_options(options)
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 host_os
def host_os @host_os || ENV.fetch("LAUNCHY_HOST_OS", nil) end
def host_os=(host_os)
def host_os=(host_os) @host_os = host_os end
def log(msg)
def log(msg) $stderr.puts "LAUNCHY_DEBUG: #{msg}" if Launchy.debug? end
def open(uri_s, options = {})
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 path
def path @path end
def path=(path)
def path=(path) @path = path end
def reset_global_options
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 string_to_uri(str)
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 to_bool(arg)
def to_bool(arg) if arg.is_a? String arg == "true" else arg.is_a? TrueClass end end