launchy 2.2.0-java → 2.4.2-java

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6ea0d47e7c69916125a0834056984408882f7916
+  data.tar.gz: 5af496662915600e3b23eb1b82dc82949c5d1662
+SHA512:
+  metadata.gz: df3c8286b31f630b56bd45fddd3c03241e36d19cc6cbeb9b706fd22958685137e25ac786d227aeb5ac89b23dbb0a7e36f28beec4b6f0e4e7bfa3faee6254440e
+  data.tar.gz: 31aea215b5b5d5713efcc85db56f9aa24eee28e5523a02ac4388d09e503e4d621d63f925559d797a87a08059068ee52714f886e7eb1d90422e23a8b3620cbd74

data/CONTRIBUTING.md

@@ -35,14 +35,17 @@ easiest way to contribute.
 
 # Contributors
 
-* [Jeremy Hinegardner][https://github.com/copiousfreetime]
-* [Mike Farmer][https://github.com/mikefarmer]
-* [Suraj N. Kurapati][https://github.com/sunaku]
-* [Postmodern][https://github.com/postmodern]
-* [Stephen Judkins][https://github.com/stephenjudkins]
-* [Mariusz Pietrzyk][https://github.com/wijet]
-* [Bogdan Gusiev][https://github.com/bogdan]
-* [Miquel Rodríguez Telep][https://github.com/mrtorrent]j
+* [Jeremy Hinegardner](https://github.com/copiousfreetime)
+* [Mike Farmer](https://github.com/mikefarmer)
+* [Suraj N. Kurapati](https://github.com/sunaku)
+* [Postmodern](https://github.com/postmodern)
+* [Stephen Judkins](https://github.com/stephenjudkins)
+* [Mariusz Pietrzyk](https://github.com/wijet)
+* [Bogdan Gusiev](https://github.com/bogdan)
+* [Miquel Rodríguez Telep](https://github.com/mrtorrent)
+* [Chris Schmich](https://github.com/schmich)
+* [Gioele Barabucci](https://github.com/gioele)
+* [Colin Noel Bell](https://github.com/colbell)
 
 [GitHub Account]: https://github.com/signup/free "GitHub Signup"
 [GitHub Issues]:  https://github.com/copiousfreetime/launchy/issues "Launchy Issues"

data/HISTORY.md

@@ -0,0 +1,154 @@
+# Launchy Changelog
+
+## Version 2.4.2 - 2013-11-28
+* Fix kde issue - <https://github.com/copiousfreetime/launchy/issues/72> - colbell
+
+## Version 2.4.1 - 2013-11-26
+* Abstract out the argv of the commandline - <https://github.com/copiousfreetime/launchy/issues/71>
+
+## Version 2.4.0 - 2013-11-12
+* Support `Launchy.open( url, :debug => true )` - <http://github.com/copiousfreetime/launchy/issues/63> - schmich
+* Fix inconsistencies in `debug?` and `dry_run?` methods - <http://github.com/copiousfreetime/launchy/issues/63> - schmich
+* Fix detection of missing *nix desktops - <http://github.com/copiousfreetime/launchy/issues/70>
+* Fix running tests in bare Linux environment - <http://github.com/copiousfreetime/launchy/issues/67> - gioele
+* Fix mistaking windows drive as uri schema - <http://github.com/copiousfreetime/launchy/issues/65>
+* Attempt fixing windows `start` command oddities, again - <http://github.com/copiousfreetime/launchy/issues/62>
+
+## Version 2.3.0 - 2013-04-11
+
+* Add the option to call a block on error instead of raising an exception
+
+## Version 2.2.0 - 2013-02-06
+
+* Change XFCE detection to not depend on grep <http://github.com/copiousfreetime/launchy/issues/52> - bogdan
+* Suppress forked process output <http://github.com/copiousfreetime/launchy/issues/51>
+* Display help/usage if no url is given <http://github.com/copiousfreetime/launchy/issues/54>
+* Detect the fluxbox environment <http://github.com/copiousfreetime/launchy/issues/53>
+* Automatically detect `http` url's if they are missing the `http://` <http://github.com/copiousfreetime/launchy/issues/55>
+* Update to latest project management rake tasks
+
+## Version 2.1.2 - 2012-08-06
+
+* Fix where HostOS would fail to convert to string on JRuby in 1.9 mode <http://github.com/copiousfreetime/launchy/issues/45>
+
+## Version 2.1.1 - 2012-07-28
+
+* Update addressable runtime dependency <http://github.com/copiousfreetime/launchy/issues/47>
+* Bring minitest and ffi development dependencies up to date
+
+## Version 2.1.0 - 2012-03-18
+
+* Fix raising exception when no browser program found <http://github.com/copiousfreetime/launchy/issues/42>
+* Add `LAUNCHY_DRY_RUN` environment variable (Mariusz Pietrzyk / wijet)
+* Update dependencies
+
+## Version 2.0.5 - 2011-07-24
+
+* Fix the case where `$BROWSER` is set and no *nix desktop was found <http://github.com/copiousfreetime/launchy/issues/33>
+
+## Version 2.0.4 - 2011-07-23
+
+* Fix windows `start` commandline <http://github.com/copiousfreetime/launchy/issues/5>
+* Add capability to open local files with no file: scheme present <http://github.com/copiousfreetime/launchy/issues/29>
+* Added `rake how_to_contribute` task <http://github.com/copiousfreetime/launchy/issues/30>
+* Make better decisions on when to do shell escaping <http://github.com/copiousfreetime/launchy/issues/31>
+* Switch to Addressable::URI so UTF-8 urls may be parsed. <http://github.com/copiousfreetime/launchy/issues/32>
+
+## Version 2.0.3 - 2011-07-17
+
+* Add in Deprecated API wrappers that warn the user
+
+## Version 2.0.2 - 2011-07-17
+
+* Typo fixes from @mtorrent
+* Documentation updates explicitly stating the Public API
+* Increase test coverage
+
+## Version 2.0.1 - 2011-07-16
+
+* Almost a complete rewrite
+* JRuby Support
+* Organization is such that it will be easier to add additional applications
+* Windows behavior possibly fixed, again
+
+## Version 1.0.0 - 2011-03-17
+
+* Add JRuby support (Stephen Judkins)
+* Remove unused Paths module
+* Switch to using bones
+* Switch to use minitest
+* NOTE, this version was never released.
+
+## Version 0.4.0 - 2011-01-27
+
+* Add support for `file:///` schema (postmodern)
+
+## Version 0.3.7 - 2010-07-19
+
+* Fix launchy on windows (mikefarmer)
+
+## Version 0.3.6 - 2010-02-22
+
+* add a test:spec task to run tests without rcov support
+* added `testing` os family for running tests
+
+## Version 0.3.5 - 2009-12-17
+
+* clarify that launchy is under ISC license
+* fix missing data file in released gem needed for running specs
+
+## Version 0.3.3 - 2009-02-19
+
+* pass command line as discrete items to system() to avoid string
+  interpretation by the system shell. (Suraj N. Kurapati)
+* rework project layout and tasks
+
+## Version 0.3.2 - 2008-05-21
+
+* detect aix and mingw as known operating systems.
+
+## Version 0.3.1 - 2007-09-08
+
+* finalize the command line wrapper around the launchy library.
+* added more tests
+
+## Version 0.3.0 - 2007-08-30
+
+* reorganize the code structure, removing Spawnable namespace
+* removed `do_magic` method, changed it to `open`
+* added override environment variable LAUNCHY_HOST_OS for testing
+* fix broken cygwin support [Bug #13472]
+
+## Version 0.2.1 - 2007-08-18
+
+* fix inability to find windows executables [Bug #13132]
+
+## Version 0.2.0 - 2007-08-11
+
+* rework browser finding
+* manual override with `LAUNCHY_BROWSER` environment variable
+* on *nix use desktop application launcher with fallback to list of browsers
+* On windows, switch to 'start' command and remove dependency on win32-process
+* removed win32 gem
+* Add debug output by setting `LAUNCHY_DEBUG` environment variable to `true`
+
+## Version 0.1.2 - 2007-08-11
+
+* forked child exits without calling `at_exit` handlers
+
+## Version 0.1.1
+
+* fixed rubyforge task to release mswin32 gem also
+
+## Version 0.1.0
+
+* Initial public release
+* switched to using fork to spawn process and `require 'win32/process'` if on windows
+
+## Version 0.0.2
+
+* First attempt at using systemu to spawn processes
+
+## Version 0.0.1
+
+* Initially working release

data/Manifest.txt

@@ -1,13 +1,14 @@
 CONTRIBUTING.md
-HISTORY.rdoc
+HISTORY.md
 LICENSE
 Manifest.txt
-README.rdoc
+README.md
 Rakefile
 bin/launchy
 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

data/{README.rdoc → README.md}

@@ -1,39 +1,39 @@
-== launchy
+# launchy
 
-* Homepage[http://www.copiousfreetime.org/projects/launchy/]
-* {Github Project}[http://github.com/copiousfreetime/launchy]
+* [Homepage](https://github.com/copiousfreetime/launchy)
+* [Github Project](https://github.com/copiousfreetime/launchy)
 * email jeremy at hinegardner dot org
 
-== DESCRIPTION
+## DESCRIPTION
 
-Launchy is helper class for launching cross-platform applications in a
-fire and forget manner.
+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 on
-each platform. Launchy is here to make a common approach to launching
-external application from within ruby programs.
+There are application concepts (browser, email client, etc) that are common
+across all platforms, and they may be launched differently on each platform.
+Launchy is here to make a common approach to launching external application from
+within ruby programs.
 
-== FEATURES
+## FEATURES
 
 Currently only launching a browser is supported.
 
-== SYNOPSIS
+## SYNOPSIS
 
 You can use launchy on the commandline, or via its API.
 
-=== Commandline
+### Commandline
 
     % launchy http://www.ruby-lang.org/
 
-There are additional commandline options, use 'launchy --help' to see them.
+There are additional commandline options, use `launchy --help` to see them.
 
-=== Public API
+### Public API
 
-In the vein of {Semantic Versioning}[http://semver.org], starting with version 2.0.0, this is the
-sole supported public API.
+In the vein of [Semantic Versioning](http://semver.org), this is the sole
+supported public API.
 
-    Launchy.open( uri, options = {} )
+    Launchy.open( uri, options = {} ) { |exception| }
 
 At the moment, the only available options are:
 
@@ -43,15 +43,26 @@ At the moment, the only available options are:
     :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
 
-An example of using the public API:
+If `Launchy.open` is invoked with a block, then no exception will be thrown, and
+the block will be called with the parameters passed to `#open` along with the
+exception that was raised.
+
+### An example of using the public API:
 
     Launchy.open( "http://www.ruby-lang.org" )
 
-== UPGRADING
+### An example of using the public API and using the error block:
+
+    uri = "http://www.ruby-lang.org"
+    Launchy.open( uri ) do |exception|
+      puts "Attempted to open #{uri} and failed because #{exception}"
+    end
 
-The previously published version of Launchy was 0.4.0. There have been so many
-changes, and a mistaken tag at 1.0.0, that I have decided to bump all the way
-to 2.0.x.
+## UPGRADING from versions before 2.0.0
+
+The previously published version of Launchy before the 2.0.0 series was 0.4.0.
+There have been so many changes, and a mistaken tag at 1.0.0, that I have
+decided to bump all the way to 2.x.y.
 
 I have attempted to keep backward compatibility with the previous examples. The
 previous API examples of:
@@ -79,7 +90,10 @@ in the github gem if it was updated to use 2.0.x but not use the supported API.
     WARNING:
     WARNING: If this is not the case, please file a bug. Please file a bug at https://github.com/copiousfreetime/launchy/issues/new
 
-== ISC LICENSE
+These deprecation notices will go away with version 3.0 and the only available
+API will be the documented one.
+
+## ISC LICENSE
 
 http://opensource.org/licenses/isc-license.txt
 

data/Rakefile

@@ -9,8 +9,8 @@ This.homepage = "http://github.com/copiousfreetime/#{ This.name }"
 This.ruby_gemspec do |spec|
   spec.add_dependency( 'addressable', '~> 2.3')
 
-  spec.add_development_dependency( 'rake'     , '~> 10.0.3')
-  spec.add_development_dependency( 'minitest' , '~> 4.5.0' )
+  spec.add_development_dependency( 'rake'     , '~> 10.1')
+  spec.add_development_dependency( 'minitest' , '~> 5.0' )
   spec.add_development_dependency( 'rdoc'     , '~> 3.12'   )
 end
 

data/lib/launchy.rb

@@ -22,16 +22,21 @@ module Launchy
     #
     # Launch an application for the given uri string
     #
-    def open(uri_s, options = {} )
-      extract_global_options( options )
+    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, options )
+      app.new.open( uri, leftover )
     rescue Launchy::Error => le
       raise le
     rescue Exception => 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
+      end
     end
 
     def app_for_uri( uri )
@@ -39,12 +44,16 @@ module Launchy
     end
 
     def app_for_uri_string( s )
-      app_for_uri(  string_to_uri( s ) )
+      app_for_uri( string_to_uri( s ) )
     end
 
     def string_to_uri( s )
       uri = Addressable::URI.parse( s )
-      uri = Addressable::URI.heuristic_parse( s ) unless uri.scheme
+      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}"
+      end
       raise Launchy::ArgumentError, "Invalid URI given: #{s.inspect}" unless uri
       return uri
     end
@@ -58,21 +67,22 @@ module Launchy
     end
 
     def extract_global_options( options )
-      Launchy.debug        = options.delete( :debug       ) || ENV['LAUNCHY_DEBUG']
-      Launchy.application  = options.delete( :application ) || ENV['LAUNCHY_APPLICATION']
-      Launchy.host_os      = options.delete( :host_os     ) || ENV['LAUNCHY_HOST_OS']
-      Launchy.ruby_engine  = options.delete( :ruby_engine ) || ENV['LAUNCHY_RUBY_ENGINE']
-      Launchy.dry_run      = options.delete( :dry_run     ) || ENV['LAUNCHY_DRY_RUN']
+      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']
     end
 
     def debug=( d )
-      @debug = (d == "true")
+      @debug = to_bool( d )
     end
 
     # we may do logging before a call to 'open', hence the need to check
     # LAUNCHY_DEBUG here
     def debug?
-      @debug || (ENV['LAUNCHY_DEBUG'] == 'true')
+      @debug || to_bool( ENV['LAUNCHY_DEBUG'] )
     end
 
     def application=( app )
@@ -100,11 +110,11 @@ module Launchy
     end
 
     def dry_run=( dry_run )
-      @dry_run = dry_run
+      @dry_run = to_bool( dry_run )
     end
 
     def dry_run?
-      @dry_run
+      @dry_run || to_bool( ENV['LAUNCHY_DRY_RUN'] )
     end
 
     def bug_report_message
@@ -114,10 +124,26 @@ module Launchy
     def log(msg)
       $stderr.puts "LAUNCHY_DEBUG: #{msg}" if Launchy.debug?
     end
+
+  private
+    def to_bool( arg )
+      if arg.is_a? String
+        arg == 'true'
+      elsif arg.is_a? TrueClass
+        true
+      else
+        # All other values mapped to false.
+        false
+      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'

data/lib/launchy/applications/browser.rb

@@ -13,26 +13,22 @@ class Launchy::Application
     end
 
     def windows_app_list
-      [ 'start /b' ]
+      [ 'start "launchy" /b' ]
     end
 
     def cygwin_app_list
-      [ 'cmd /C start /b' ]
+      [ 'cmd /C start "launchy" /b' ]
     end
 
+    # hardcode this to open?
     def darwin_app_list
       [ find_executable( "open" ) ]
     end
 
     def nix_app_list
-      app_list = %w[ xdg-open ]
-      if nix_de = Launchy::Detect::NixDesktopEnvironment.detect then
-        app_list << nix_de.browser
-        app_list << nix_de.fallback_browsers
-      end
-      app_list.flatten!
-      app_list.delete_if { |b| b.nil? || (b.strip.size == 0) }
-      app_list.collect { |bin| find_executable( bin ) }.find_all { |x| not x.nil? }
+      nix_de = Launchy::Detect::NixDesktopEnvironment.detect
+      list   = nix_de.browsers
+      list.find_all { |argv| argv.valid? }
     end
 
     # use a call back mechanism to get the right app_list that is decided by the 
@@ -51,10 +47,15 @@ class Launchy::Application
 
     # Get the full commandline of what we are going to add the uri to
     def browser_cmdline
-      possibilities = (browser_env + app_list).flatten
-      possibilities.each do |p|
-        Launchy.log "#{self.class.name} : possibility : #{p}"
+      browser_env.each do |p|
+        Launchy.log "#{self.class.name} : possibility from BROWSER environment variable : #{p}"
+      end
+      app_list.each do |p|
+        Launchy.log "#{self.class.name} : possibility from app_list : #{p}"
       end
+
+      possibilities = (browser_env + app_list).flatten
+
       if browser = possibilities.shift then
         Launchy.log "#{self.class.name} : Using browser value '#{browser}'"
         return browser