launchy 2.5.0 → 3.0.1

data/lib/launchy.rb

@@ -1,4 +1,9 @@
-require 'addressable/uri'
+# 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.
@@ -11,113 +16,118 @@ require 'addressable/uri'
 #   :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
-#   :ruby_engine  Explicitly state what ruby engine to pretend to be under
 #   :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 = {}, &error_block )
-      leftover = extract_global_options( options )
-      uri = string_to_uri( uri_s )
-      app = app_for_uri( uri )
-      app.new.open( uri, leftover )
-    rescue Launchy::Error => le
-      raise le
-    rescue Exception => e
+    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 $! and block_given? then
-        yield $!
-        return # explicitly swallow the errors
+      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 )
+    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( s )
-      app_for_uri( string_to_uri( s ) )
+    def app_for_uri_string(str)
+      app_for_uri(string_to_uri(str))
     end
 
-    def string_to_uri( s )
-      s = s.to_s
-      uri = Addressable::URI.parse( s )
-      Launchy.log "URI parsing pass 1 : #{s} -> #{uri.to_hash}"
-      if not uri.scheme then
-        uri = Addressable::URI.heuristic_parse( s )
-        Launchy.log "URI parsing pass 2 : #{s} -> #{uri.to_hash}"
+    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: #{s.inspect}" unless uri
-      return uri
+      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.ruby_engine = nil
       Launchy.dry_run     = false
-      Launchy.path        = ENV['PATH']
+      Launchy.path        = ENV.fetch("PATH", nil)
     end
 
-    def extract_global_options( options )
+    def extract_global_options(options)
       leftover = options.dup
-      Launchy.debug        = leftover.delete( :debug       ) || ENV['LAUNCHY_DEBUG']
-      Launchy.application  = leftover.delete( :application ) || ENV['LAUNCHY_APPLICATION']
-      Launchy.host_os      = leftover.delete( :host_os     ) || ENV['LAUNCHY_HOST_OS']
-      Launchy.ruby_engine  = leftover.delete( :ruby_engine ) || ENV['LAUNCHY_RUBY_ENGINE']
-      Launchy.dry_run      = leftover.delete( :dry_run     ) || ENV['LAUNCHY_DRY_RUN']
+      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=( d )
-      @debug = to_bool( d )
+    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['LAUNCHY_DEBUG'] )
+      @debug || to_bool(ENV.fetch("LAUNCHY_DEBUG", nil))
     end
 
-    def application=( app )
+    def application=(app)
       @application = app
     end
 
     def application
-      @application || ENV['LAUNCHY_APPLICATION']
+      @application || ENV.fetch("LAUNCHY_APPLICATION", nil)
     end
 
-    def host_os=( host_os )
+    def host_os=(host_os)
       @host_os = host_os
     end
 
     def host_os
-      @host_os || ENV['LAUNCHY_HOST_OS']
-    end
-
-    def ruby_engine=( ruby_engine )
-      @ruby_engine = ruby_engine
+      @host_os || ENV.fetch("LAUNCHY_HOST_OS", nil)
     end
 
-    def ruby_engine
-      @ruby_engine || ENV['LAUNCHY_RUBY_ENGINE']
-    end
-
-    def dry_run=( dry_run )
-      @dry_run = to_bool( dry_run )
+    def dry_run=(dry_run)
+      @dry_run = to_bool(dry_run)
     end
 
     def dry_run?
-      @dry_run || to_bool( ENV['LAUNCHY_DRY_RUN'] )
+      @dry_run || to_bool(ENV.fetch("LAUNCHY_DRY_RUN", nil))
     end
 
     def bug_report_message
@@ -136,15 +146,13 @@ module Launchy
       @path = path
     end
 
-  private
-    def to_bool( arg )
+    private
+
+    def to_bool(arg)
       if arg.is_a? String
-        arg == 'true'
-      elsif arg.is_a? TrueClass
-        true
+        arg == "true"
       else
-        # All other values mapped to false.
-        false
+        arg.is_a? TrueClass
       end
     end
   end
@@ -153,11 +161,11 @@ module Launchy
   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/deprecated'
+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"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: launchy
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 3.0.1
 platform: ruby
 authors:
 - Jeremy Hinegardner
-autorequire: 
-bindir: bin
+autorequire:
+bindir: exe
 cert_chain: []
-date: 2020-02-28 00:00:00.000000000 Z
+date: 2024-05-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -16,70 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '2.8'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: childprocess
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.14'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.14'
-- !ruby/object:Gem::Dependency
-  name: rdoc
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.2'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.18'
-  type: :development
+        version: '5.0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '5.0'
 description: Launchy is helper class for launching cross-platform applications in
   a fire and forget manner. There are application concepts (browser, email client,
   etc) that are common across all platforms, and they may be launched differently
@@ -92,56 +50,40 @@ extensions: []
 extra_rdoc_files:
 - CONTRIBUTING.md
 - HISTORY.md
+- LICENSE.txt
 - Manifest.txt
 - README.md
 files:
 - CONTRIBUTING.md
 - HISTORY.md
-- LICENSE
+- LICENSE.txt
 - Manifest.txt
 - README.md
-- Rakefile
-- bin/launchy
+- exe/launchy
+- launchy.gemspec
 - lib/launchy.rb
 - lib/launchy/application.rb
 - lib/launchy/applications/browser.rb
 - lib/launchy/argv.rb
 - lib/launchy/cli.rb
-- lib/launchy/deprecated.rb
 - lib/launchy/descendant_tracker.rb
 - lib/launchy/detect.rb
 - lib/launchy/detect/host_os.rb
 - lib/launchy/detect/host_os_family.rb
 - lib/launchy/detect/nix_desktop_environment.rb
-- lib/launchy/detect/ruby_engine.rb
-- lib/launchy/detect/runner.rb
 - lib/launchy/error.rb
 - lib/launchy/os_family.rb
+- lib/launchy/runner.rb
 - lib/launchy/version.rb
-- spec/application_spec.rb
-- spec/applications/browser_spec.rb
-- spec/cli_spec.rb
-- spec/detect/host_os_family_spec.rb
-- spec/detect/host_os_spec.rb
-- spec/detect/nix_desktop_environment_spec.rb
-- spec/detect/ruby_engine_spec.rb
-- spec/detect/runner_spec.rb
-- spec/launchy_spec.rb
-- spec/mock_application.rb
-- spec/spec_helper.rb
-- spec/tattle-host-os.yaml
-- spec/version_spec.rb
-- tasks/default.rake
-- tasks/this.rb
-homepage: http://github.com/copiousfreetime/launchy
+homepage: https://github.com/copiousfreetime/launchy
 licenses:
 - ISC
 metadata:
   bug_tracker_uri: https://github.com/copiousfreetime/launchy/issues
-  changelog_uri: https://github.com/copiousfreetime/launchy/blob/master/README.md
+  changelog_uri: https://github.com/copiousfreetime/launchy/blob/master/HISTORY.md
   homepage_uri: https://github.com/copiousfreetime/launchy
   source_code_uri: https://github.com/copiousfreetime/launchy
-post_install_message: 
+post_install_message:
 rdoc_options:
 - "--main"
 - README.md
@@ -153,29 +95,16 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.5.9
+signing_key:
 specification_version: 4
 summary: Launchy is helper class for launching cross-platform applications in a fire
   and forget manner.
-test_files:
-- spec/application_spec.rb
-- spec/applications/browser_spec.rb
-- spec/cli_spec.rb
-- spec/detect/host_os_family_spec.rb
-- spec/detect/host_os_spec.rb
-- spec/detect/nix_desktop_environment_spec.rb
-- spec/detect/ruby_engine_spec.rb
-- spec/detect/runner_spec.rb
-- spec/launchy_spec.rb
-- spec/mock_application.rb
-- spec/spec_helper.rb
-- spec/tattle-host-os.yaml
-- spec/version_spec.rb
+test_files: []

data/Rakefile

@@ -1,27 +0,0 @@
-# vim: syntax=ruby
-load 'tasks/this.rb'
-
-This.name     = "launchy"
-This.author   = "Jeremy Hinegardner"
-This.email    = "jeremy@copiousfreetime.org"
-This.homepage = "http://github.com/copiousfreetime/#{ This.name }"
-
-This.ruby_gemspec do |spec|
-  spec.add_dependency( 'addressable', '~> 2.7')
-
-  spec.add_development_dependency( 'rake'     , '~> 13.0')
-  spec.add_development_dependency( 'minitest' , '~> 5.14' )
-  spec.add_development_dependency( 'rdoc'     , '~> 6.2' )
-  spec.add_development_dependency( 'simplecov', '~> 0.18' )
-
-  spec.licenses = ['ISC']
-
-  spec.metadata = {
-    "bug_tracker_uri" => "https://github.com/copiousfreetime/launchy/issues",
-    "changelog_uri"   => "https://github.com/copiousfreetime/launchy/blob/master/README.md",
-    "homepage_uri"    => "https://github.com/copiousfreetime/launchy",
-    "source_code_uri" => "https://github.com/copiousfreetime/launchy",
-  }
-end
-
-load 'tasks/default.rake'

data/bin/launchy

@@ -1,4 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'launchy'
-Launchy::Cli.new.run( ARGV, ENV )

data/lib/launchy/deprecated.rb

@@ -1,52 +0,0 @@
-module Launchy
-  #
-  # This class is deprecated and will be removed 
-  #
-  class Browser
-    def self.run( *args )
-      Browser.new.visit( args[0] )
-    end
-
-    def visit( url )
-      _warn "You made a call to a deprecated Launchy API. This call should be changed to 'Launchy.open( uri )'"
-      report_caller_context( caller )
-
-      ::Launchy.open( url )
-    end
-
-    private
-
-    def find_caller_context( stack )
-      caller_file = stack.find do |line|
-        not line.index( __FILE__ )
-      end
-      if caller_file then
-        caller_fname, caller_line, _ = caller_file.split(":")
-        if File.readable?( caller_fname ) then
-          caller_lines = IO.readlines( caller_fname )
-          context = [ caller_file ]
-          context << caller_lines[(caller_line.to_i)-3, 5] 
-          return context.flatten
-        end
-      end
-      return []
-    end
-
-    def report_caller_context( stack )
-      context = find_caller_context( stack )
-      if context.size > 0 then
-        _warn "I think I was able to find the location that needs to be fixed. Please go look at:"
-        _warn
-        context.each do |line|
-          _warn line.rstrip
-        end
-        _warn
-        _warn "If this is not the case, please file a bug. #{Launchy.bug_report_message}"
-      end
-    end
-
-    def _warn( msg = "" )
-      warn "WARNING: #{msg}"
-    end
-  end
-end

data/lib/launchy/detect/ruby_engine.rb

@@ -1,78 +0,0 @@
-module Launchy::Detect
-  class RubyEngine
-    class NotFoundError < Launchy::Error; end
-
-    extend ::Launchy::DescendantTracker
-
-    # Detect the current ruby engine.
-    #
-    # If the current ruby engine cannot be detected, the return
-    # RubyEngine::Unknown
-    def self.detect( ruby_engine = RubyEngine.new )
-      found = find_child( :is_current_engine?, ruby_engine.to_s )
-      return found if found
-      raise NotFoundError, "#{ruby_engine_error_message( ruby_engine )} #{Launchy.bug_report_message}"
-    end
-
-    def self.ruby_engine_error_message( ruby_engine )
-      msg = "Unkonwn RUBY_ENGINE "
-      if ruby_engine then
-        msg += " '#{ruby_engine}'."
-      elsif defined?( RUBY_ENGINE ) then
-        msg += " '#{RUBY_ENGINE}'."
-      else
-        msg = "RUBY_ENGINE not defined for #{RUBY_DESCRIPTION}."
-      end
-      return msg
-    end
-
-    def self.is_current_engine?( ruby_engine )
-      return ruby_engine == self.engine_name
-    end
-
-    def self.mri?()     self == Mri;     end
-    def self.jruby?()   self == Jruby;   end
-    def self.rbx?()     self == Rbx;     end
-    def self.macruby?() self == MacRuby; end
-
-    attr_reader :ruby_engine
-    alias to_s ruby_engine
-    def initialize( ruby_engine = Launchy.ruby_engine )
-      if ruby_engine then
-        @ruby_engine = ruby_engine
-      else
-        @ruby_engine = defined?( RUBY_ENGINE ) ? RUBY_ENGINE : "ruby"
-      end
-    end
-
-
-    #-------------------------------
-    # The list of known ruby engines
-    #-------------------------------
-
-    #
-    # This is the ruby engine if the RUBY_ENGINE constant is not defined
-    class Mri < RubyEngine
-      def self.engine_name() "ruby"; end
-      def self.is_current_engine?( ruby_engine )
-        if ruby_engine then
-          super( ruby_engine )
-        else
-          return true if not Launchy.ruby_engine and not defined?( RUBY_ENGINE )
-        end
-      end
-    end
-
-    class Jruby < RubyEngine
-      def self.engine_name() "jruby"; end
-    end
-
-    class Rbx < RubyEngine
-      def self.engine_name() "rbx"; end
-    end
-
-    class MacRuby < RubyEngine
-      def self.engine_name() "macruby"; end
-    end
-  end
-end