opener 0.0.1

data/README.markdown

@@ -0,0 +1,64 @@
+# Opener
+
+Opener is a Ruby library for opening things in an cross-platform way.
+
+It is a tiny (28 lines of code) alternative to Ruby's [launchy] gem.
+
+[launchy]: http://rubygems.org/gems/launchy
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'opener'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install opener
+
+## Usage
+
+Load this library:
+
+    require 'opener'
+
+Open something in the foreground (blocking call):
+
+    Opener.system(thing_to_open_in_foreground)
+
+Open something in the foreground while suppressing output:
+
+    Opener.system(thing_to_open_in_foreground, 1 => :close)
+
+Open something in the foreground while suppressing errors:
+
+    Opener.system(thing_to_open_in_foreground, 2 => :close)
+
+Open something in the background (non-blocking call):
+
+    Opener.spawn(thing_to_open_in_background)
+
+Open something in the background while suppressing output:
+
+    Opener.spawn(thing_to_open_in_background, 1 => :close)
+
+Open something in the background while suppressing errors:
+
+    Opener.spawn(thing_to_open_in_background, 2 => :close)
+
+Reveal the OS-specific command that is opening things:
+
+    puts Opener.command()
+
+## License
+
+This library is distributed under the same terms as Ruby:
+<http://www.ruby-lang.org/en/about/license.txt>
+
+Copyright 2013 Suraj N. Kurapati <https://github.com/sunaku>
+
+Thanks to 2010 David A. Wheeler <http://www.dwheeler.com/essays/open-files-urls.html>

data/lib/opener.rb

@@ -0,0 +1,105 @@
+require 'rbconfig'
+
+#
+# Ruby library for opening things in an cross-platform way.
+#
+# == Usage
+#
+# Load this library:
+#
+#   require 'opener'
+#
+# Open something in the foreground (blocking call):
+#
+#   Opener.system(thing_to_open_in_foreground)
+#
+# Open something in the foreground while suppressing output:
+#
+#   Opener.system(thing_to_open_in_foreground, 1 => :close)
+#
+# Open something in the foreground while suppressing errors:
+#
+#   Opener.system(thing_to_open_in_foreground, 2 => :close)
+#
+# Open something in the background (non-blocking call):
+#
+#   Opener.spawn(thing_to_open_in_background)
+#
+# Open something in the background while suppressing output:
+#
+#   Opener.spawn(thing_to_open_in_background, 1 => :close)
+#
+# Open something in the background while suppressing errors:
+#
+#   Opener.spawn(thing_to_open_in_background, 2 => :close)
+#
+# Reveal the OS-specific command that is opening things:
+#
+#   puts Opener.command()
+#
+# == License
+#
+# This library is distributed under the same terms as Ruby:
+# <http://www.ruby-lang.org/en/about/license.txt>
+#
+# Copyright 2013 Suraj N. Kurapati <https://github.com/sunaku>
+#
+# Thanks to 2010 David A. Wheeler <http://www.dwheeler.com/essays/open-files-urls.html>
+#
+module Opener
+  class << self
+
+    #
+    # Returns an OS-specific command for opening things.
+    #
+    # http://www.dwheeler.com/essays/open-files-urls.html
+    # http://www.par.univie.ac.at/solaris/cde-www/
+    #
+    def command
+      @command ||=
+        case RbConfig::CONFIG['host_os']
+        when /darwin/i then 'open'
+        when /cygwin/i then 'cygstart'
+        when /linux|bsd/i then 'xdg-open'
+        when /mswin|mingw/i then 'start'
+        when /sunos|solaris/i then '/usr/dt/bin/sdtwebclient'
+        end
+    end
+
+    #
+    # Opens the given things in the foreground.
+    #
+    # @see Kernel#system()
+    #
+    def system *arguments
+      insert_command_into_arguments! arguments
+      super
+    end
+
+    #
+    # Opens the given things in the background.
+    #
+    # @see Kernel#spawn()
+    #
+    def spawn *arguments
+      insert_command_into_arguments! arguments
+      super
+    end
+
+    private
+
+    #
+    # The first argument to Kernel#system() and Kernel#spawn() can be either:
+    #
+    # * Hash - containing a mapping of environment variables and values
+    # * String - containing the first word of the command to be executed
+    #
+    # This method carefully inserts our Opener.command() before that String.
+    #
+    def insert_command_into_arguments! arguments
+      insertion_point = (arguments[0].kind_of? Hash) ? 1 : 0
+      arguments.insert insertion_point, self.command
+    end
+
+  end
+end

data/opener.gemspec

@@ -0,0 +1,16 @@
+# coding: utf-8
+Gem::Specification.new do |spec|
+  spec.name          = 'opener'
+  spec.version       = '0.0.1'
+  spec.author        = 'Suraj N. Kurapati'
+  spec.email         = 'sunaku@gmail.com'
+  spec.description   = 'Library for opening things in an cross-platform way.'
+  spec.summary       = "A 28-line alternative to Ruby's launchy gem."
+  spec.homepage      = 'https://github.com/sunaku/opener'
+  spec.license       = 'Ruby'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: opener
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Suraj N. Kurapati
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-08 00:00:00.000000000 Z
+dependencies: []
+description: Library for opening things in an cross-platform way.
+email: sunaku@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.markdown
+- lib/opener.rb
+- opener.gemspec
+homepage: https://github.com/sunaku/opener
+licenses:
+- Ruby
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: A 28-line alternative to Ruby's launchy gem.
+test_files: []