opener 0.0.1 → 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2c64531e6a4a66e2067c67b6786eeffbd67d61a9
+  data.tar.gz: 3869ec0ef55e75688f64db302f8f3f2158ca4c0a
+SHA512:
+  metadata.gz: aedd2c106bd827ba82c035ab1db64b8a08f9b77c69066c466badbbb63d9c40328026737e9a08247f52ed9508670fa4905d88dc06499ba9e9bc6dde5ea0d70a21
+  data.tar.gz: 503415abca7e70597ace5d9a3ca80433f4814ab3e1db2aa5791e5c2eeef67881c177e3a6c56163f3c8eaa908009f47ea4f3d46ddbf7617da98bcd78bfbe49bc3

data/README.markdown

@@ -2,7 +2,7 @@
 
 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.
+It is a tiny (33 lines of code) alternative to the [launchy] library.
 
 [launchy]: http://rubygems.org/gems/launchy
 
@@ -30,29 +30,39 @@ Open something in the foreground (blocking call):
 
     Opener.system(thing_to_open_in_foreground)
 
-Open something in the foreground while suppressing output:
+Open something in the background (non-blocking call):
 
-    Opener.system(thing_to_open_in_foreground, 1 => :close)
+    Opener.spawn(thing_to_open_in_background)
 
-Open something in the foreground while suppressing errors:
+Open something in place of the current process:
 
-    Opener.system(thing_to_open_in_foreground, 2 => :close)
+    Opener.exec(thing_to_open_in_place)
 
-Open something in the background (non-blocking call):
+Reveal the OS-specific command that is opening things:
 
-    Opener.spawn(thing_to_open_in_background)
+    puts Opener.command()
 
-Open something in the background while suppressing output:
+### Suppression
 
+Open something while detaching terminal (close STDIN):
+
+    Opener.system(thing_to_open_in_foreground, 0 => :close)
+    Opener.spawn(thing_to_open_in_background, 0 => :close)
+    Opener.exec(thing_to_open_in_place, 0 => :close)
+
+Open something while suppressing output (close STDOUT):
+
+    Opener.system(thing_to_open_in_foreground, 1 => :close)
     Opener.spawn(thing_to_open_in_background, 1 => :close)
+    Opener.exec(thing_to_open_in_place, 1 => :close)
 
-Open something in the background while suppressing errors:
+Open something while suppressing errors (close STDERR):
 
+    Opener.system(thing_to_open_in_foreground, 2 => :close)
     Opener.spawn(thing_to_open_in_background, 2 => :close)
+    Opener.exec(thing_to_open_in_place, 2 => :close)
 
-Reveal the OS-specific command that is opening things:
-
-    puts Opener.command()
+See Kernel#spawn() documentation for more tips and tricks.
 
 ## License
 

data/lib/opener.rb

@@ -13,29 +13,39 @@ require 'rbconfig'
 #
 #   Opener.system(thing_to_open_in_foreground)
 #
-# Open something in the foreground while suppressing output:
+# Open something in the background (non-blocking call):
 #
-#   Opener.system(thing_to_open_in_foreground, 1 => :close)
+#   Opener.spawn(thing_to_open_in_background)
 #
-# Open something in the foreground while suppressing errors:
+# Open something in place of the current process:
 #
-#   Opener.system(thing_to_open_in_foreground, 2 => :close)
+#   Opener.exec(thing_to_open_in_place)
 #
-# Open something in the background (non-blocking call):
+# Reveal the OS-specific command that is opening things:
 #
-#   Opener.spawn(thing_to_open_in_background)
+#   puts Opener.command()
+#
+# === Suppression
 #
-# Open something in the background while suppressing output:
+# Open something while detaching terminal (close STDIN):
 #
+#   Opener.system(thing_to_open_in_foreground, 0 => :close)
+#   Opener.spawn(thing_to_open_in_background, 0 => :close)
+#   Opener.exec(thing_to_open_in_place, 0 => :close)
+#
+# Open something while suppressing output (close STDOUT):
+#
+#   Opener.system(thing_to_open_in_foreground, 1 => :close)
 #   Opener.spawn(thing_to_open_in_background, 1 => :close)
+#   Opener.exec(thing_to_open_in_place, 1 => :close)
 #
-# Open something in the background while suppressing errors:
+# Open something while suppressing errors (close STDERR):
 #
+#   Opener.system(thing_to_open_in_foreground, 2 => :close)
 #   Opener.spawn(thing_to_open_in_background, 2 => :close)
+#   Opener.exec(thing_to_open_in_place, 2 => :close)
 #
-# Reveal the OS-specific command that is opening things:
-#
-#   puts Opener.command()
+# See Kernel#spawn() documentation for more tips and tricks.
 #
 # == License
 #
@@ -57,12 +67,13 @@ module Opener
     #
     def command
       @command ||=
-        case RbConfig::CONFIG['host_os']
+        case host_os = 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'
+        else raise NotImplementedError, host_os
         end
     end
 
@@ -86,6 +97,16 @@ module Opener
       super
     end
 
+    #
+    # Opens the given things in place of the current process.
+    #
+    # @see Kernel#exec()
+    #
+    def exec *arguments
+      insert_command_into_arguments! arguments
+      super
+    end
+
     private
 
     #

data/opener.gemspec

@@ -1,11 +1,11 @@
 # coding: utf-8
 Gem::Specification.new do |spec|
   spec.name          = 'opener'
-  spec.version       = '0.0.1'
+  spec.version       = '0.1.0'
   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.description   = 'A 33-line alternative to the popular launchy library.'
+  spec.summary       = 'Library for opening things in an cross-platform way.'
   spec.homepage      = 'https://github.com/sunaku/opener'
   spec.license       = 'Ruby'
 

metadata

@@ -1,8 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opener
 version: !ruby/object:Gem::Version
-  version: 0.0.1
-  prerelease: 
+  version: 0.1.0
 platform: ruby
 authors:
 - Suraj N. Kurapati
@@ -11,7 +10,7 @@ bindir: bin
 cert_chain: []
 date: 2013-05-08 00:00:00.000000000 Z
 dependencies: []
-description: Library for opening things in an cross-platform way.
+description: A 33-line alternative to the popular launchy library.
 email: sunaku@gmail.com
 executables: []
 extensions: []
@@ -23,26 +22,26 @@ files:
 homepage: https://github.com/sunaku/opener
 licenses:
 - Ruby
+metadata: {}
 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
+rubygems_version: 2.0.0
 signing_key: 
-specification_version: 3
-summary: A 28-line alternative to Ruby's launchy gem.
+specification_version: 4
+summary: Library for opening things in an cross-platform way.
 test_files: []
+has_rdoc: