ffi_dry 0.1.11 → 0.1.12

data/History.txt

@@ -1,3 +1,6 @@
+=== 0.1.12 / 2010-11-8
+  * Added ffi/dry/errno for handling errno errors from FFI-bound functions
+
 === 0.1.11 / 2010-6-2
   * Added attach_optional_function to FFI::Library for dealing with functions
     that are not always present.

data/VERSION

@@ -1 +1 @@
-0.1.11
+0.1.12

data/ffi_dry.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{ffi_dry}
-  s.version = "0.1.11"
+  s.version = "0.1.12"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Eric Monti"]
-  s.date = %q{2010-06-02}
+  s.date = %q{2010-11-08}
   s.description = %q{Provides some useful modules, classes, and methods for FFI bindings  as well as a DSL-like syntax for FFI::Struct layouts}
   s.email = %q{emonti@matasano.com}
   s.extra_rdoc_files = [
@@ -26,10 +26,12 @@ Gem::Specification.new do |s|
      "VERSION",
      "ffi_dry.gemspec",
      "lib/ffi/dry.rb",
+     "lib/ffi/dry/errno.rb",
      "lib/ffi_dry.rb",
      "samples/afmap.rb",
      "samples/basic.rb",
      "samples/describer.rb",
+     "spec/errno_spec.rb",
      "spec/ffi_dry_spec.rb",
      "spec/spec_helper.rb"
   ]
@@ -39,7 +41,8 @@ Gem::Specification.new do |s|
   s.rubygems_version = %q{1.3.6}
   s.summary = %q{Syntactic sugar and helper utilities for FFI}
   s.test_files = [
-    "spec/ffi_dry_spec.rb",
+    "spec/errno_spec.rb",
+     "spec/ffi_dry_spec.rb",
      "spec/spec_helper.rb"
   ]
 

data/lib/ffi/dry/errno.rb

@@ -0,0 +1,37 @@
+require 'ffi'
+
+module FFI
+  module DRY
+    # This module lets us handle FFI-generated system call errors
+    # through ruby as exceptions using the Errno and SystemCallError
+    # exception classes.
+    #
+    # This module is not automatically included in the runtime when you
+    # include 'ffi/dry'. You must explicitely say
+    #
+    #   require 'ffi/dry/errno'
+    #
+    module ErrnoHelper
+      extend  FFI::Library
+      libs = ffi_lib FFI::Library::LIBC
+
+      attach_function :strerror, [:int], :string
+
+      # Returns a ruby exception derived from the current value of errno.
+      # As per the intro(2) manpage, this should only ever be called after an
+      # error has been deteted from a function that sets the errno variable.
+      def errno_exception(arg=nil)
+        err = self.errno
+        return SystemCallError.new(arg, err)
+      end
+
+      # An alias for FFI.errno
+      def errno
+        FFI.errno
+      end
+
+    end
+
+    extend ErrnoHelper
+  end
+end

data/spec/errno_spec.rb

@@ -0,0 +1,30 @@
+require 'ffi/dry/errno'
+
+module TestLib
+  extend FFI::Library
+  ffi_lib FFI::Library::LIBC
+  attach_function :fopen, [:string, :string],  :pointer
+end
+
+
+describe  FFI::DRY::ErrnoHelper do
+  it "should supply errno errors as exceptions" do
+    filename = "/veryboguspath/bogus filename#{rand(0xffff)}"
+    TestLib.fopen(filename, 'r').should be_null
+
+    exc1 = FFI::DRY.errno_exception
+    exc1.should be_kind_of(Errno::ENOENT)
+  end
+
+  it "should take an optional argument for additional error info" do
+    filename = "/veryboguspath/bogus filename#{rand(0xffff)}"
+    TestLib.fopen(filename, 'r').should be_null
+
+    exc2 = FFI::DRY.errno_exception(filename)
+    exc2.should be_kind_of(Errno::ENOENT)
+
+    exc2.message.index(filename).should_not be_nil
+  end
+
+
+end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 11
-  version: 0.1.11
+  - 12
+  version: 0.1.12
 platform: ruby
 authors: 
 - Eric Monti
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-06-02 00:00:00 -05:00
+date: 2010-11-08 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -50,10 +50,12 @@ files:
 - VERSION
 - ffi_dry.gemspec
 - lib/ffi/dry.rb
+- lib/ffi/dry/errno.rb
 - lib/ffi_dry.rb
 - samples/afmap.rb
 - samples/basic.rb
 - samples/describer.rb
+- spec/errno_spec.rb
 - spec/ffi_dry_spec.rb
 - spec/spec_helper.rb
 has_rdoc: true
@@ -87,5 +89,6 @@ signing_key:
 specification_version: 3
 summary: Syntactic sugar and helper utilities for FFI
 test_files: 
+- spec/errno_spec.rb
 - spec/ffi_dry_spec.rb
 - spec/spec_helper.rb