dia 1.3.pre → 1.3

data/.yardopts

@@ -1,2 +1,4 @@
 -m markdown
-
+-
+NEWS.md
+HACKING.md

data/NEWS.md

@@ -1,6 +1,7 @@
 ## NEWS
 
 ### 1.3
+* Added Dia::Sandbox#running? to check if a process running a sandbox is alive or not.
 * Dia::Sandbox only exposes its instance variables through getters now. No more setters.
 * Dia::Sandbox#app_path is now Dia::Sandbox#app
 * Removed run\_with\_block in favor of passing a block to the constructer. Dia::Sandbox#run is used to execute a block or an application now, 
@@ -8,6 +9,7 @@
 * Removed Dia::SandBox in favor of Dia::Sandbox.
 * Added "has_rdoc = 'yard'" to the gem spec.
 * Added ".yardopts" to the list of files in the gem spec.
+* SandBoxException becomes SandboxException.
 
 ### 1.2
 * I've decided to use Dia::Sandbox instead of Dia::SandBox but it won't be removed until 1.3 .. (Deprecated for 1.2)

data/README.md

@@ -11,7 +11,7 @@
 * A complete lockdown of Operating System resources.
 
 ## How it is done
-FFI, and the C header "sandbox.h" (found on OSX).
+It uses the FFI library, and the features exposed by the sandbox header on OSX.
 
 ## Examples
 
@@ -44,6 +44,17 @@ FFI, and the C header "sandbox.h" (found on OSX).
     sleep(5)
     sandbox.terminate
     
+### Example 4 (Checking if a sandbox is running)
+
+    require 'rubygems'
+    require 'dia'
+    sandbox = Dia::Sandbox.new(Dia::Profiles::NO_OS_SERVICES) do
+      sleep(20)
+    end
+    
+    sandbox.run
+    puts sandbox.running? # => true
+
 ## Install
 
 It's available at gemcutter: 

data/lib/dia.rb

@@ -5,7 +5,7 @@ require File.join(File.dirname(__FILE__), 'dia/commonapi.rb')
 require File.join(File.dirname(__FILE__), 'dia/sandbox.rb')
 
 module Dia
-  VERSION = '1.3.pre'
-  class SandBoxException < StandardError; end
+  VERSION = '1.3'
+  class SandboxException < StandardError; end
 end
 

data/lib/dia/sandbox.rb

@@ -43,19 +43,19 @@ module Dia
       @pid      = nil
     end
     
-    # The run method will spawn a child process and run the application _or_ block supplied in the constructer under a sandbox.  
+    # The run method will spawn a child process and run the application _or_ block supplied to the constructer under a sandbox.  
     # This method will not block.
     #
     # @raise  [SystemCallError]       In the case of running a block, a number of subclasses of SystemCallError may be raised if the block violates sandbox restrictions.
     #                                 The parent process will not be affected and if you wish to catch exceptions you should do so in your block.
     #
-    # @raise  [Dia::SandBoxException] Will raise Dia::SandBoxException in a child process and exit if the sandbox could not be initiated.
+    # @raise  [Dia::SandboxException] Will raise Dia::SandboxException in a child process and exit if the sandbox could not be initiated.
     # @return [Fixnum]                The Process ID(PID) that the sandboxed application is being run under.
     def run
       
       @pid = fork do
         if ( ret = sandbox_init(@profile, 0x0001, error = FFI::MemoryPointer.new(:pointer)) ) != 0
-          raise Dia::SandBoxException, "Couldn't sandbox #{@app}, sandbox_init returned #{ret} with error message: '#{error.get_pointer(0).read_string}'"
+          raise Dia::SandboxException, "Couldn't sandbox #{@app}, sandbox_init returned #{ret} with error message: '#{error.get_pointer(0).read_string}'"
         end
         
         if @app_path
@@ -78,6 +78,22 @@ module Dia
       Process.kill('SIGKILL', @pid)
     end
     
+    # The running? method will return true if a sandbox is running, and false otherwise.
+    # It does so by sending a signal to the process running a sandbox.
+    #
+    # @raise  [SystemCallError] It may raise a subclass of SystemCallError if you do not have permission to send a signal
+    #                           to the process running in a sandbox.
+    #
+    # @return [Boolean]         It will return true or false.
+    def running?
+      begin
+        Process.kill(0, @pid)
+        true
+      rescue Errno::ESRCH
+        false
+      end
+    end
+    
   end
   
 end

metadata

@@ -1,7 +1,11 @@
 --- !ruby/object:Gem::Specification 
 name: dia
 version: !ruby/object:Gem::Version 
-  version: 1.3.pre
+  prerelease: false
+  segments: 
+  - 1
+  - 3
+  version: "1.3"
 platform: ruby
 authors: 
 - Robert Gleeson
@@ -9,29 +13,37 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-02-21 00:00:00 +00:00
+date: 2010-02-23 00:00:00 +00:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: ffi
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
     requirements: 
     - - "="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 5
+        - 4
         version: 0.5.4
-    version: 
+  type: :runtime
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: baretest
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 2
+        - 4
         version: 0.2.4
-    version: 
+  type: :development
+  version_requirements: *id002
 description: Dia allows you to sandbox application(s) or block(s) of ruby on the OSX platform by restricting access to operating system resources
 email: rob@flowof.info
 executables: []
@@ -54,7 +66,7 @@ has_rdoc: yard
 homepage: 
 licenses: []
 
-post_install_message: "  ********************************************************************\n  Thanks for installing Dia! (1.3.pre)\n  \n  Don't forget to check NEWS.md for what has changed in this release:\n  http://github.com/robgleeson/Dia/blob/experimental/NEWS.md\n  \n  You can chat with us at irc.freenode.net / #flowof.info if you have\n  any problems. Feel free to join us!\n  ********************************************************************\n"
+post_install_message: "  ********************************************************************\n  Thanks for installing Dia! (1.3)\n  \n  Don't forget to check NEWS.md for what has changed in this release:\n  http://www.flowof.info/dia/file.NEWS.html\n  \n  You can chat with us at irc.freenode.net / #flowof.info if you have\n  any problems. Feel free to join us!\n  ********************************************************************\n"
 rdoc_options: []
 
 require_paths: 
@@ -63,18 +75,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version 
-      version: 1.3.1
-  version: 
+      segments: 
+      - 0
+      version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
 summary: Dia allows you to sandbox application(s) or block(s) of ruby on the OSX platform by restricting access to operating system resources