launchy 2.0.0-java

data/.autotest

@@ -0,0 +1,28 @@
+# vim: ft=ruby
+
+require 'autotest/growl'
+
+Autotest.add_hook :initialize do |at|
+
+  at.libs = "lib:spec"
+  at.testlib = 'minitest/autorun'
+
+  at.add_exception 'coverage.info'
+  at.add_exception 'coverage'
+  at.add_exception '.git'
+
+  at.clear_mappings
+
+  at.add_mapping(%r|^spec/.*_spec\.rb$|) do |filename, _|
+    filename
+  end
+
+  at.add_mapping(%r|^lib/(.*)\.rb$|) do |_, match|
+    [ "test/#{match[1]}_spec.rb" ]
+  end
+
+  at.add_mapping(%r|^spec/spec_helper\.rb|) do
+    at.files_matching( %r|^spec/.*_spec\.rb| )
+  end
+end
+

data/.gitignore

@@ -0,0 +1,6 @@
+*~
+*.swo
+*.swp
+doc/
+coverage/
+pkg/

data/HISTORY

@@ -0,0 +1,90 @@
+= Launchy Changlog
+
+== Version 2.0.0 - 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/LICENSE

@@ -0,0 +1,16 @@
+ISC LICENSE - http://opensource.org/licenses/isc-license.txt
+
+Copyright (c) 2007-2011 Jeremy Hinegardner
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

data/NOTES

@@ -0,0 +1 @@
+* Allow for new tab/ new window for opening a browser

data/README

@@ -0,0 +1,53 @@
+== launchy
+
+* Homepage[http://www.copiousfreetime.org/projects/launchy/]
+* {Github Project}[http://github.com/copiousfreetime/launchy]
+* email jeremy at hinegardner dot org
+
+== 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 on
+each platform. Launchy is here to make a common approach to launching
+external application from within ruby programs.
+
+== FEATURES
+
+Currently only launching a browser is supported.
+
+== SYNOPSIS
+
+From within your ruby code you can trust launchy to do the right thing:
+
+    Launchy.open("http://www.ruby-lang.org/")
+
+Or, if you want to launch the application yourself:
+
+    Launchy::Browser.open("http://www.ruby-lang.org/")
+
+OR
+
+    Launchy::Browser.new.open("http://www.ruby-lang.org/")
+
+== ISC LICENSE
+
+http://opensource.org/licenses/isc-license.txt
+
+Copyright (c) 2007-2011 Jeremy Hinegardner
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

data/Rakefile

@@ -0,0 +1,58 @@
+#--
+# Copyright (c) 2007 Jeremy Hinegardner
+# All rights reserved.  See LICENSE and/or COPYING for details.
+#++
+
+begin
+  require 'bones'
+rescue LoadError
+  abort '### Please install the "bones" gem ###'
+end
+
+task :default => 'test:run'
+task 'gem:release' => 'test:run'
+
+$:.unshift( "lib" )
+require 'launchy/version'
+
+Bones {
+  name      "launchy"
+  authors   "Jeremy Hinegardner"
+  email     "jeremy@copiousfreetime.org"
+  url       'http://www.copiousfreetime.org/projects/launchy'
+  version   Launchy::VERSION
+
+  ruby_opts     %w[ -W0 -rubygems ]
+  readme_file   'README'
+  ignore_file   '.gitignore'
+  history_file  'HISTORY'
+
+  rdoc.include << "README" << "HISTORY" << "LICENSE"
+
+  summary 'Launchy is helper class for launching cross-platform applications in a fire and forget manner.'
+  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 on
+each platform.  Launchy is here to make a common approach to launching
+external application from within ruby programs.
+_
+
+  if RUBY_PLATFORM == "java" then
+    depend_on "spoon"   , "~> 0.0.1"
+    gem.extras = { :platform => Gem::Platform.new( "java" ) }
+  end
+
+  depend_on "rake"    , "~> 0.9.2", :development => true
+  depend_on "minitest", "~> 2.3.1", :development => true
+  depend_on 'bones'   , "~> 3.7.0", :development => true
+
+  if defined?( RUBY_ENGINE ) and RUBY_ENGINE == "jruby" then
+    depend_on 'spoon'   , "~> 0.0.1"
+  end
+
+  test.files = FileList["spec/**/*_spec.rb"]
+  test.opts << "-w -Ilib:spec"
+}

data/bin/launchy

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

data/lib/launchy.rb

@@ -0,0 +1,119 @@
+require 'uri'
+
+#
+# Top level entry point into Launchy. Almost everyone will just use the single
+# call:
+#
+#   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
+#   :host_os      Explicitly state what host operating system to pretend to be
+#   :ruby_engine  Explicitly state what ruby engine to pretend to be under
+#
+# Other options may be used, and those will be passed directly to the
+# application class
+#
+module Launchy
+
+  class << self
+    #
+    # Convenience method to launch an item
+    #
+    def open(uri, options = {} )
+      begin
+        extract_global_options( options )
+        uri = URI.parse( uri )
+        if app = Launchy::Application.for_scheme( uri ) then
+          app.new.open( uri, options )
+        else
+          msg = "Unable to launch #{uri} with options #{options.inspect}"
+          Launchy.log "#{self.name} : #{msg}"
+          $stderr.puts msg
+        end
+      rescue Exception => e
+        msg = "Failure in opening #{uri} with options #{options.inspect}: #{e}"
+        Launchy.log "#{self.name} : #{msg}"
+        e.backtrace.each do |bt|
+          Launchy.log bt
+        end
+        $stderr.puts msg
+      end
+    end
+
+    def reset_global_options
+      Launchy.debug       = false
+      Launchy.application = nil
+      Launchy.host_os     = nil
+      Launchy.ruby_engine = nil
+      Launchy.dry_run     = false
+    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     )
+    end
+
+    def debug=( d )
+      @debug = (d == "true")
+    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')
+    end
+
+    def application=( app )
+      @application = app
+    end
+
+    def application
+      @application || ENV['LAUNCHY_APPLICATION']
+    end
+
+    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
+    end
+
+    def ruby_engine
+      @ruby_engine || ENV['LAUNCHY_RUBY_ENGINE']
+    end
+
+    def dry_run=( dry_run )
+      @dry_run = dry_run
+    end
+
+    def dry_run?
+      @dry_run
+    end
+
+    def bug_report_message
+      "Please file a bug at https://github.com/copiousfreetime/launchy/issues/new"
+    end
+
+    def log(msg)
+      $stderr.puts "LAUNCHY_DEBUG: #{msg}" if Launchy.debug?
+    end
+  end
+end
+
+require 'launchy/version'
+require 'launchy/cli'
+require 'launchy/descendant_tracker'
+require 'launchy/error'
+require 'launchy/application'
+require 'launchy/detect'

data/lib/launchy/application.rb

@@ -0,0 +1,81 @@
+require 'set'
+module Launchy
+  #
+  # Application is the base class of all the application types that launchy may
+  # invoke. It essentially defines the public api of the launchy system.
+  #
+  # Every class that inherits from Application must define:
+  #
+  # 1. A constructor taking no parameters
+  # 2. An instance method 'open' taking a string or URI as the first parameter and a
+  #    hash as the second
+  # 3. A class method 'schemes' that returns an array of Strings containing the
+  #    schemes that the Application will handle
+  class Application
+    extend DescendantTracker
+
+    class << self
+      #
+      # The list of all the schemes all the applications know
+      #
+      def scheme_list
+        children.collect { |a| a.schemes }.flatten.sort
+      end
+
+      #
+      # if this application handles the given scheme
+      #
+      def handles?( scheme )
+        schemes.include?( scheme )
+      end
+
+      #
+      # Find the application that handles the given scheme.  May take either a
+      # String or something that responds_to?( :scheme )
+      #
+      def for_scheme( scheme )
+        if scheme.respond_to?( :scheme ) then
+          scheme = scheme.scheme
+        end
+
+        klass = find_child( :handles?, scheme )
+        return klass if klass
+
+        raise SchemeNotFoundError, "No application found to handle scheme '#{scheme}'. Known schemes: #{scheme_list.join(", ")}"
+      end
+
+      #
+      # Find the given executable in the available paths
+      def find_executable( bin, *paths )
+        paths = ENV['PATH'].split( File::PATH_SEPARATOR ) if paths.empty?
+        paths.each do |path|
+          file = File.join( path, bin )
+          if File.executable?( file ) then
+            Launchy.log "#{self.name} : found executable #{file}"
+            return file
+          end
+        end
+        Launchy.log "#{self.name} : Unable to find `#{bin}' in #{paths.join(", ")}"
+        return nil
+      end
+    end
+
+    attr_reader :host_os_family
+    attr_reader :ruby_engine
+    attr_reader :runner
+    def initialize
+      @host_os_family = Launchy::Detect::HostOsFamily.detect
+      @ruby_engine    = Launchy::Detect::RubyEngine.detect
+      @runner         = Launchy::Detect::Runner.detect
+    end
+
+    def find_executable( bin, *paths )
+      Application.find_executable( bin, *paths )
+    end
+
+    def run( cmd, *args )
+      runner.run( cmd, *args )
+    end
+  end
+end
+require 'launchy/applications/browser'