launchy 3.0.0 → 3.1.0

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: launchy
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Jeremy Hinegardner
-autorequire:
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2024-03-04 00:00:00.000000000 Z
+date: 2025-01-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -39,75 +38,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '5.0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: logger
   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.21'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.21'
-- !ruby/object:Gem::Dependency
-  name: minitest-junit
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: rdoc
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.6'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.6'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.22'
-  type: :development
+        version: '1.6'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '1.6'
 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
@@ -120,16 +63,17 @@ 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
@@ -144,28 +88,14 @@ files:
 - 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/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: 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:
 rdoc_options:
 - "--main"
 - README.md
@@ -184,20 +114,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 3.6.3
 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/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,29 +0,0 @@
-# vim: syntax=ruby
-load 'tasks/this.rb'
-
-This.name     = "launchy"
-This.author   = "Jeremy Hinegardner"
-This.email    = "jeremy@copiousfreetime.org"
-This.homepage = "https://github.com/copiousfreetime/#{ This.name }"
-
-This.ruby_gemspec do |spec|
-  spec.add_dependency( 'addressable', '~> 2.8')
-  spec.add_dependency( 'childprocess', '~> 5.0')
-
-  spec.add_development_dependency( 'rake'     , '~> 13.0')
-  spec.add_development_dependency( 'minitest' , '~> 5.21' )
-  spec.add_development_dependency( 'minitest-junit' , '~> 1.0' )
-  spec.add_development_dependency( 'rdoc'     , '~> 6.6' )
-  spec.add_development_dependency( 'simplecov', '~> 0.22' )
-
-  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/spec/application_spec.rb

@@ -1,43 +0,0 @@
-require 'spec_helper'
-require 'mock_application'
-
-class JunkApp < Launchy::Application
-  def self.handles?( uri )
-    uri.scheme == "junk"
-  end
-end
-
-describe Launchy::Application do
-  it 'registers inherited classes' do
-    class Junk2App < Launchy::Application
-      def self.handles?( uri )
-        uri.scheme == "junk2"
-      end
-    end
-    _(Launchy::Application.children).must_include( Junk2App )
-    Launchy::Application.children.delete( Junk2App )
-  end
-
-  it "can find an app" do
-    _(Launchy::Application.children).must_include( JunkApp )
-    _(Launchy::Application.children.size).must_equal 3
-    uri = Addressable::URI.parse( "junk:///foo" )
-    _(Launchy::Application.handling( uri )).must_equal( JunkApp  )
-  end
-
-  it "raises an error if an application cannot be found for the given scheme" do
-    uri = Addressable::URI.parse( "foo:///bar" )
-    _(lambda { Launchy::Application.handling( uri ) }).must_raise( Launchy::ApplicationNotFoundError )
-  end
-
-  it "can find open or curl or xdg-open" do
-    found = %w[ open curl xdg-open ].any? do |app|
-      Launchy::Application.find_executable( app )
-    end
-    _(found).must_equal true
-  end
-
-  it "does not find xyzzy" do
-    _(Launchy::Application.find_executable( "xyzzy" )).must_be_nil
-  end
-end

data/spec/applications/browser_spec.rb

@@ -1,73 +0,0 @@
-require 'spec_helper'
-
-describe Launchy::Application::Browser do
-  before do
-    Launchy.reset_global_options
-    ENV['KDE_FULL_SESSION'] = "launchy"
-    @test_url = "http://example.com/"
-  end
-
-  after do
-    Launchy.reset_global_options
-    ENV.delete( 'KDE_FULL_SESSION' )
-    ENV.delete( 'BROWSER' )
-  end
-
-  { 'windows' => 'windows_app_list',
-    'darwin'  => 'darwin_app_list',
-    'cygwin'  => 'cygwin_app_list',
-    'linux'   => 'nix_app_list',
-  }.each  do |host_os, called_method|
-    it "when host_os is '#{host_os}' the '#{called_method}' method is called" do
-      Launchy.host_os = host_os
-      browser = Launchy::Application::Browser.new
-      browser.stub(called_method, [:called_me]) do
-        item = browser.app_list.first
-        _(item).must_equal :called_me
-      end
-    end
-  end
-
-  %w[ linux windows darwin cygwin ].each do |host_os|
-    it "the BROWSER environment variable overrides any host defaults on '#{host_os}'" do
-      ENV['BROWSER'] = "my_special_browser --new-tab '%s'"
-      Launchy.host_os = host_os
-      browser = Launchy::Application::Browser.new
-      cmd, args = browser.cmd_and_args( @test_url )
-      _(cmd).must_equal "my_special_browser --new-tab 'http://example.com/'"
-      _(args).must_equal []
-    end
-  end
-
-  it "handles a file on the file system when there is no file:// scheme" do
-    uri = Addressable::URI.parse( __FILE__ )
-    _(Launchy::Application::Browser.handles?( uri )).must_equal true
-  end
-
-  it "handles the case where $BROWSER is set and no *nix desktop environment is found" do
-    ENV.delete( "KDE_FULL_SESSION" )
-    ENV.delete( "GNOME_DESKTOP_SESSION_ID" )
-    ENV['BROWSER'] = "do-this-instead"
-    Launchy.host_os = 'linux'
-    browser = Launchy::Application::Browser.new
-    _(browser.browser_cmdline).must_equal "do-this-instead"
-  end
-
-  # NOTE: Unable to figure out how capture the stderr from the child which has
-  # moved it at least once. This test just serves the purpose of noting why
-  # something happens, and the problem we are attempting to fix.
-  #it "When BROWSER is set to something that is not executable, error still appears on stderr" do
-  #  ENV['BROWSER'] = "not-an-app"
-  #  url = "http://example.com/"
-
-  #  _, err = capture_subprocess_io do 
-  #    begin
-  #      Launchy.open( url )
-  #    rescue => nil
-  #    end
-  #  end
-  #  #_(err).must_match( /wibble/m )
-  #  err # something
-  #end
-end
-

data/spec/cli_spec.rb

@@ -1,74 +0,0 @@
-require 'spec_helper'
-
-describe Launchy::Cli do
-
-  before do
-    @old_stderr = $stderr
-    $stderr = StringIO.new
-
-    @old_stdout = $stdout
-    $stdout = StringIO.new
-    Launchy.reset_global_options
-  end
-
-  after do
-    Launchy.reset_global_options
-    $stderr = @old_stderr
-    $stdout = @old_stdout
-  end
-
-  def cli_test( argv, env, exit_val, stderr_regex, stdout_regex )
-    begin
-      Launchy::Cli.new.run( argv, env )
-    rescue SystemExit => se
-      _(se.status).must_equal exit_val
-      _($stderr.string).must_match stderr_regex if stderr_regex
-      _($stdout.string).must_match stdout_regex if stdout_regex
-    end
-  end
-
-  it "exits 1 when invalid options are given" do
-    cli_test( %w[ -z foo ], {}, 1, /invalid option/, nil )
-  end
-
-  %w[ -h --help ].each do |opt|
-    it "output help and exits 0 when using #{opt}" do
-      cli_test( [ opt ], {}, 0, nil, /Print this message/m )
-    end
-  end
-
-  %w[ -v --version ].each do |opt|
-    it "outputs version and exits 0 when using #{opt}" do
-      cli_test( [ opt ], {}, 0, nil, /Launchy version/ )
-    end
-  end
-
-  it "leaves the url on argv after parsing" do
-    l = Launchy::Cli.new
-    argv = %w[ --debug --dry-run https://github.com/copiousfreetime/launchy ]
-    l.parse( argv , {} )
-    _(argv.size).must_equal 1
-    _(argv[0]).must_equal "https://github.com/copiousfreetime/launchy" 
-  end
-
-  it "prints the command on stdout when using --dry-run" do
-   argv = %w[ --debug --dry-run https://github.com/copiousfreetime/launchy ]
-   Launchy::Cli.new.good_run( argv, {} )
-   _($stdout.string).must_match %r[github.com]
-  end
-
-  {
-    '--application' => [ :application, 'Browser'],
-    '--host-os'     => [ :host_os,     'cygwin'] }.each_pair do |opt, val|
-    it "the commandline option #{opt} sets the program option #{val[0]}" do
-      argv = [ opt, val[1], "https://github.com/copiousfreetime/launchy" ]
-      l = Launchy::Cli.new
-      rc = l.parse( argv, {} )
-      _(rc).must_equal true
-      _(argv.size).must_equal 1
-      _(argv[0]).must_equal "https://github.com/copiousfreetime/launchy"
-      _(l.options[val[0]]).must_equal val[1]
-    end
-  end
-end
- 

data/spec/detect/host_os_family_spec.rb

@@ -1,42 +0,0 @@
-require 'spec_helper'
-require 'yaml'
-
-describe Launchy::Detect::HostOsFamily do
-
-  before do
-    Launchy.reset_global_options
-  end
-
-  after do
-    Launchy.reset_global_options
-  end
-
-  YAML::load( IO.read( File.expand_path( "../../tattle-host-os.yaml", __FILE__ ) ) )['host_os'].keys.sort.each do |os|
-    it "OS family of #{os} is detected" do
-      os_family = Launchy::Detect::HostOsFamily.detect( os )
-      _(os_family).must_be_kind_of Launchy::Detect::HostOsFamily
-    end
-  end
-
-  { 'mswin'  => :windows?,
-    'darwin' => :darwin?,
-    'linux'  => :nix?,
-    'cygwin' => :cygwin? }.each_pair do |os, method|
-    it "#{method} returns true for #{os} " do
-      r = Launchy::Detect::HostOsFamily.detect( os ).send( method )
-      _(r).must_equal true
-    end
-  end
-
-  it "uses the global host_os overrides" do
-    ENV['LAUNCHY_HOST_OS'] = "fake-os-2"
-    _(lambda { Launchy::Detect::HostOsFamily.detect }).must_raise Launchy::Detect::HostOsFamily::NotFoundError
-    ENV.delete('LAUNCHY_HOST_OS')
-  end
-
-
-  it "does not find an os of 'dos'" do
-    _(lambda { Launchy::Detect::HostOsFamily.detect( 'dos' ) }).must_raise Launchy::Detect::HostOsFamily::NotFoundError
-  end
-
-end

data/spec/detect/host_os_spec.rb

@@ -1,19 +0,0 @@
-require 'spec_helper'
-
-describe Launchy::Detect::HostOs do
-
-  it "uses the defult host os from ruby's config" do
-    _(Launchy::Detect::HostOs.new.host_os).must_equal RbConfig::CONFIG['host_os']
-  end
-
-  it "uses the passed in value as the host os" do
-    _(Launchy::Detect::HostOs.new( "fake-os-1").host_os).must_equal "fake-os-1"
-  end
-
-  it "uses the environment variable LAUNCHY_HOST_OS to override ruby's config" do
-    ENV['LAUNCHY_HOST_OS'] = "fake-os-2"
-    _(Launchy::Detect::HostOs.new.host_os).must_equal "fake-os-2"
-    ENV.delete('LAUNCHY_HOST_OS')
-  end
-
-end

data/spec/detect/nix_desktop_environment_spec.rb

@@ -1,27 +0,0 @@
-require 'spec_helper'
-
-describe Launchy::Detect::NixDesktopEnvironment do
-
-  before do
-    Launchy.reset_global_options
-  end
-
-  after do
-    Launchy.reset_global_options
-  end
-
-  it "returns false for XFCE if xprop is not found" do
-    Launchy.host_os = "linux"
-    _(Launchy::Detect::NixDesktopEnvironment::Xfce.is_current_desktop_environment?).must_equal( false )
-  end
-
-  it "returns NotFound if it cannot determine the *nix desktop environment" do
-    Launchy.host_os = "linux"
-    ENV.delete( "KDE_FULL_SESSION" )
-    ENV.delete( "GNOME_DESKTOP_SESSION_ID" )
-    Launchy.path = %w[ / /tmp ].join(File::PATH_SEPARATOR)
-    not_found = Launchy::Detect::NixDesktopEnvironment.detect
-    _(not_found).must_equal( Launchy::Detect::NixDesktopEnvironment::NotFound )
-    _(not_found.browser).must_equal( Launchy::Argv.new )
-  end
-end

data/spec/launchy_spec.rb

@@ -1,142 +0,0 @@
-require 'spec_helper'
-require 'pathname'
-require 'mock_application'
-
-describe Launchy do
-
-  before do
-    Launchy.reset_global_options
-    @stderr  = $stderr
-    $stderr = StringIO.new
-    @stdout = $stdout
-    $stdout = StringIO.new
-    @invalid_url = 'blah://example.com/invalid'
-  end
-
-  after do
-    Launchy.reset_global_options
-    $stderr = @stderr
-    $stdout = @stdout
-  end
-
-  it "logs to stderr when LAUNCHY_DEBUG environment variable is set" do
-    ENV["LAUNCHY_DEBUG"] = 'true'
-    old_stderr = $stderr
-    $stderr = StringIO.new
-    Launchy.log "This is a test log message"
-    _($stderr.string.strip).must_equal "LAUNCHY_DEBUG: This is a test log message"
-    $stderr = old_stderr
-    ENV["LAUNCHY_DEBUG"] = nil
-  end
-
-  it "sets the global option :dry_run to true if LAUNCHY_DRY_RUN environment variable is 'true'" do
-    ENV['LAUNCHY_DRY_RUN'] = 'true'
-    Launchy.extract_global_options({})
-    _(Launchy.dry_run?).must_equal true
-    ENV['LAUNCHY_DRY_RUN'] = nil
-  end
-
-  it "sets the global option :debug to true if LAUNCHY_DEBUG environment variable is 'true'" do
-    ENV['LAUNCHY_DEBUG'] = 'true'
-    Launchy.extract_global_options({})
-    _(Launchy.debug?).must_equal true
-    ENV['LAUNCHY_DEBUG'] = nil
-  end
-
-  it "has the global option :debug" do
-    Launchy.extract_global_options( { :debug => 'true' } )
-    _(Launchy.debug?).must_equal true
-    Launchy.extract_global_options( { :debug => true } )
-    _(Launchy.debug?).must_equal true
-  end
-
-  it "has the global option :dry_run" do
-    Launchy.extract_global_options( { :dry_run => 'true' } )
-    _(Launchy.dry_run?).must_equal true
-    Launchy.extract_global_options( { :dry_run => true } )
-    _(Launchy.dry_run?).must_equal true
-  end
-
-  it "has the global option :application" do
-    Launchy.extract_global_options(  { :application => "wibble" } )
-    _(Launchy.application).must_equal 'wibble'
-  end
-
-  it "has the global option :host_os" do
-    Launchy.extract_global_options(  { :host_os => "my-special-os-v2" } )
-    _(Launchy.host_os).must_equal 'my-special-os-v2'
-  end
-
-  it "raises an exception if no scheme is found for the given uri" do
-    _(lambda { Launchy.open( @invalid_url ) }).must_raise Launchy::ApplicationNotFoundError
-  end
-
-  it "raises an exepction if the browser failed to launch" do
-    skip("because headless CI") if ENV["CI"] == "true"
-    caught = nil
-    Launchy.open( @invalid_url, application: "browser") do |exception|
-      caught = exception
-    end
-    _(caught).must_be_kind_of Launchy::Error
-  end
-
-  it "asssumes we open a local file if we have an exception if we have an invalid scheme and a valid path" do
-    uri = "blah://example.com/#{__FILE__}"
-    Launchy.open( uri , :dry_run => true )
-    parts = $stdout.string.strip.split
-    _(parts.size).must_be :>, 1
-    _(parts.last).must_equal uri
-  end
-
-  it "opens a local file if we have a drive letter and a valid path on windows" do
-    uri = "C:#{__FILE__}"
-    Launchy.open( uri, :dry_run => true, :host_os => 'windows'  )
-    _($stdout.string.strip).must_equal 'start launchy /b ' + uri
-  end
-
-  it "opens a data url with a forced browser application" do
-    uri = "data:text/html,hello%20world"
-    Launchy.open( uri, :dry_run => true, :application => "browser" )
-    _($stdout.string.strip).must_match(/open/) # /usr/bin/open or xdg-open
-  end
-
-  it "calls the block if instead of raising an exception if there is an error" do
-    Launchy.open( @invalid_url ) { $stderr.puts "oops had an error opening #{@invalid_url}" }
-    _($stderr.string.strip).must_equal "oops had an error opening #{@invalid_url}"
-  end
-
-  it "calls the block with the values passed to launchy and the error" do
-    options = { :dry_run => true }
-    Launchy.open( @invalid_url, :dry_run => true ) { |e| $stderr.puts "had an error opening #{@invalid_url} with options #{options}: #{e}" }
-    _($stderr.string.strip).must_equal "had an error opening #{@invalid_url} with options #{options}: No application found to handle '#{@invalid_url}'"
-  end
-
-  it "raises the error in the called block" do
-    _(lambda { Launchy.open( @invalid_url ) { raise StandardError, "KABOOM!" } }).must_raise StandardError
-  end
-
-  it "can force a specific application to be used" do
-    result = Launchy.open( "http://example.com", :application => "mockapplication" )
-    _(result).must_equal "MockApplication opened http://example.com"
-  end
-
-  [ 'www.example.com', 'www.example.com/foo/bar', "C:#{__FILE__}" ].each do |x|
-    it "picks a Browser for #{x}" do
-      app = Launchy.app_for_uri_string( x )
-      _(app).must_equal( Launchy::Application::Browser )
-    end
-  end
-
-  it "can use a Pathname as the URI" do
-    path = Pathname.new( Dir.pwd )
-    app = Launchy.app_for_uri_string( path )
-    _(app).must_equal( Launchy::Application::Browser )
-  end
-
-  [ "BROWSER", "bRoWsEr", "browser", "Browser" ].each do |x|
-    it "can find the browser by name #{x}" do
-      app = Launchy.app_for_name( x )
-    _(app).must_equal( Launchy::Application::Browser )
-    end
-  end
-end

data/spec/mock_application.rb

@@ -1,13 +0,0 @@
-class MockApplication < Launchy::Application
-  def self.schemes
-    %w[ mock mockother ]
-  end
-
-  def self.handles?( uri )
-    schemes.include?( uri.scheme )
-  end
-
-  def open( uri, options = {} )
-    return "MockApplication opened #{uri}"
-  end
-end

data/spec/spec_helper.rb

@@ -1,8 +0,0 @@
-require 'simplecov'
-SimpleCov.start if ENV['COVERAGE']
-
-gem 'minitest'
-require 'launchy'
-require 'stringio'
-require 'minitest/autorun'
-require 'minitest/pride'