fallocate 0.1.0 → 0.1.1

data/{README.rdoc → README.markdown}

@@ -1,8 +1,24 @@
-= fallocate
+# fallocate
 
-Description goes here.
+Pure-Ruby FFI bindings to
+[posix_fallocate](http://www.kernel.org/doc/man-pages/online/pages/man3/posix_fallocate.3.html)
 
-== Contributing to fallocate
+## Usage
+
+```ruby
+require 'fallocate'
+
+File.open 'some/file', 'w' do |f|
+  f.allocate 0, 1024 * 1024 * 1024
+end
+```
+
+## Requirements
+
+Right now, fallocate raises a FFI exception at loading time if
+`posix_fallocate` isn't available in `libc`.
+
+## Contributing to fallocate
  
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
@@ -12,8 +28,7 @@ Description goes here.
 * Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
 * Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
 
-== Copyright
+## Copyright
 
-Copyright (c) 2012 Victor Costan. See LICENSE.txt for
-further details.
+Copyright (c) 2012 Victor Costan. See LICENSE.txt for further details.
 

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/fallocate.gemspec

@@ -5,27 +5,29 @@
 
 Gem::Specification.new do |s|
   s.name = "fallocate"
-  s.version = "0.1.0"
+  s.version = "0.1.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Victor Costan"]
-  s.date = "2012-05-21"
+  s.date = "2012-08-08"
   s.description = "fallocate is a fast method for allocating real disk\n                       space for files"
   s.email = "victor@costan.us"
   s.extra_rdoc_files = [
     "LICENSE.txt",
-    "README.rdoc"
+    "README.markdown"
   ]
   s.files = [
     ".document",
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
-    "README.rdoc",
+    "README.markdown",
     "Rakefile",
     "VERSION",
     "fallocate.gemspec",
     "lib/fallocate.rb",
+    "lib/fallocate/18.rb",
+    "lib/fallocate/19.rb",
     "test/helper.rb",
     "test/test_fallocate.rb"
   ]

data/lib/fallocate.rb

@@ -9,18 +9,9 @@ module Fallocate
   attach_function :posix_fallocate, [:int, :off_t, :off_t], :int
 end
 
-class File
-  # Ensures there is enough disk space for writing to a file.
-  #
-  # This method asks the filesystem to allocate disk blocks for a file region,
-  # so that writes to that region will not fail due to out-of-space errors.
-  #
-  # @param [Integer] offset the 0-based offset of the region's starting byte
-  # @param [Integer] length the region's length, in bytes
-  def allocate(offset = 0, length)
-    errno = Fallocate.posix_fallocate fileno, offset, length
-    return if errno == 0
-    raise SystemCallError.new(errno)
-  end
+if RUBY_VERSION >= '1.9'
+  require 'fallocate/19.rb'
+else
+  require 'fallocate/18.rb'
 end
 

data/lib/fallocate/18.rb

@@ -0,0 +1,19 @@
+class File
+  # Ensures there is enough disk space for writing to a file.
+  #
+  # This method asks the filesystem to allocate disk blocks for a file region,
+  # so that writes to that region will not fail due to out-of-space errors.
+  #
+  # @param [Integer] offset the 0-based offset of the region's starting byte
+  # @param [Integer] length the region's length, in bytes
+  def allocate(offset, length = nil)
+    unless length
+      length = offset
+      offset = 0
+    end
+    
+    errno = Fallocate.posix_fallocate fileno, offset, length
+    return if errno == 0
+    raise SystemCallError.new(errno)
+  end
+end

data/lib/fallocate/19.rb

@@ -0,0 +1,15 @@
+class File
+  # Ensures there is enough disk space for writing to a file.
+  #
+  # This method asks the filesystem to allocate disk blocks for a file region,
+  # so that writes to that region will not fail due to out-of-space errors.
+  #
+  # @param [Integer] offset the 0-based offset of the region's starting byte
+  # @param [Integer] length the region's length, in bytes
+  def allocate(offset = 0, length)
+    errno = Fallocate.posix_fallocate fileno, offset, length
+    return if errno == 0
+    raise SystemCallError.new(errno)
+  end
+end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fallocate
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-21 00:00:00.000000000 Z
+date: 2012-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -114,17 +114,19 @@ executables: []
 extensions: []
 extra_rdoc_files:
 - LICENSE.txt
-- README.rdoc
+- README.markdown
 files:
 - .document
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
-- README.rdoc
+- README.markdown
 - Rakefile
 - VERSION
 - fallocate.gemspec
 - lib/fallocate.rb
+- lib/fallocate/18.rb
+- lib/fallocate/19.rb
 - test/helper.rb
 - test/test_fallocate.rb
 homepage: http://github.com/pwnall/fallocate
@@ -142,7 +144,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 4523764401574152228
+      hash: 1490748833886583460
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: