sys-filesystem 0.2.0-x86-mswin32-60 → 0.3.0-x86-mswin32-60

data/CHANGES

@@ -1,3 +1,9 @@
+== 0.3.0 - 26-Feb-2009
+* Added support for OS X and FreeBSD thanks to an awesome patch by Nobuyoshi
+  Miyokawa.
+* Added the Filesystem.mount_point method that takes a file and returns
+  the mount point its sitting on.
+
 == 0.2.0 - 30-Dec-2008
 * Added the Filesystem.mounts method for iterating over mount or volume
   information.

data/README

@@ -13,7 +13,8 @@
    require 'sys/filesystem'
    include Sys
    
-   p Filesystem.stat("/")
+   # Display information about a particular filesystem.
+   p Filesystem.stat('/')
 
    # Sample output
 
@@ -33,11 +34,15 @@
       @blocks_free = 20301129
    >
    
+   # Describe all mount points on the system
    Filesystem.mounts{ |mount| p mount }
+   
+   # Find the mount point of any particular file
+   puts Filesystem.mount_point('/home/djberge/some_file.txt') => '/home'
 
 = Notes
 === MS Windows
-   This is a pure Ruby implementation using the windows-pr package, which in
+   This is a pure Ruby implementation using the windows-pr library, which in
    turn wraps native Windows functions.
 === UNIX
    This is a C extension that wraps statvfs, etc.
@@ -54,11 +59,15 @@
    Suggestions welcome.
 
 = Acknowledgements
-   Mike Hall, for ideas and code that I borrowed from his 'filesystem' package.
+   Mike Hall, for ideas and code that I borrowed from his 'filesystem'
+   library.
+   
    Park Heesob, for implementation and API ideas for the MS Windows version.
+   
+   Nobuyoshi Miyokawa, for adding FreeBSD and OS X support.
 
 = Copyright
-   (C) 2003-2008 Daniel J. Berger
+   (C) 2003-2009 Daniel J. Berger
    All Rights Reserved
 
 = Warranty

data/Rakefile

@@ -58,6 +58,10 @@ Rake::TestTask.new("test") do |t|
    t.test_files = FileList['test/test_sys_filesystem.rb']
 end
 
+task :test do
+   Rake.application[:clean].execute
+end
+
 desc "Run the example program"
 task :example => [:build] do |t|
    Dir.chdir('examples') do

data/lib/sys/filesystem.rb

@@ -1,4 +1,5 @@
 require 'windows/error'
+require 'windows/path'
 require 'windows/filesystem'
 require 'windows/volume'
 require 'windows/handle'
@@ -20,6 +21,7 @@ module Sys
       extend Windows::Error
       extend Windows::FileSystem
       extend Windows::Volume
+      extend Windows::Path
 
       # Error typically raised if any of the Sys::Filesystem methods fail.
       class Error < StandardError; end
@@ -39,7 +41,7 @@ module Sys
       NAMED_STREAMS              = 0x00040000  
       READ_ONLY_VOLUME           = 0x00080000
       
-      VERSION = '0.2.0'
+      VERSION = '0.2.1'
 
       class Mount
          # The name of the volume. This is the device mapping.
@@ -235,10 +237,23 @@ module Sys
          mounts # Nil if the block form was used.
       end
 
+      # Returns the mount point for the given +file+. For MS Windows this
+      # means the root of the path.
+      #
+      # Example:
+      #
+      #    File.mount_point("C:\\Documents and Settings") # => "C:\\'
+      #
+      def self.mount_point(file)
+         file = file.tr(File::SEPARATOR, File::ALT_SEPARATOR)
+         PathStripToRoot(file)
+         file[/^[^\0]*/]
+      end
+
       # Returns a Filesystem::Stat object that contains information about the
       # +path+ file system.
       #
-      # Example:
+      # Examples:
       #
       #    File.stat("C:\\")
       #    File.stat("C:\\Documents and Settings\\some_user")

data/sys-filesystem.gemspec

@@ -2,7 +2,7 @@ require 'rubygems'
 
 spec = Gem::Specification.new do |gem|
    gem.name         = 'sys-filesystem'
-   gem.version      = '0.2.0'
+   gem.version      = '0.3.0'
    gem.author       = 'Daniel J. Berger'
    gem.email        = 'djberg96@gmail.com'
    gem.homepage     = 'http://www.rubyforge.org/projects/sysutils'

data/test/test_sys_filesystem_unix.rb

@@ -15,6 +15,8 @@ class TC_Sys_Filesystem_Unix < Test::Unit::TestCase
    def self.startup
       @@solaris = Config::CONFIG['host_os'] =~ /solaris/i
       @@linux   = Config::CONFIG['host_os'] =~ /linux/i
+      @@freebsd = Config::CONFIG['host_os'] =~ /freebsd/i
+      @@darwin  = Config::CONFIG['host_os'] =~ /darwin/i
    end
 
    def setup
@@ -26,7 +28,7 @@ class TC_Sys_Filesystem_Unix < Test::Unit::TestCase
    end
 
    def test_version
-      assert_equal('0.2.0', Filesystem::VERSION)
+      assert_equal('0.3.0', Filesystem::VERSION)
    end
 
    def test_stat_path
@@ -105,7 +107,8 @@ class TC_Sys_Filesystem_Unix < Test::Unit::TestCase
    end
 
    def test_stat_base_type
-      omit_unless(@@solaris, "NOTRUNC test skipped except on Solaris")
+      omit_unless(@@solaris, "base_type test skipped except on Solaris")
+
       assert_respond_to(@stat, :base_type)
       assert_kind_of(String, @stat.base_type)
    end
@@ -113,7 +116,9 @@ class TC_Sys_Filesystem_Unix < Test::Unit::TestCase
    def test_stat_constants
       assert_not_nil(Filesystem::Stat::RDONLY)
       assert_not_nil(Filesystem::Stat::NOSUID)
+
       omit_unless(@@solaris, "NOTRUNC test skipped except on Solaris")
+
       assert_not_nil(Filesystem::Stat::NOTRUNC)
    end
 
@@ -192,15 +197,16 @@ class TC_Sys_Filesystem_Unix < Test::Unit::TestCase
 
    def test_mount_time
       assert_respond_to(@mnt, :mount_time)
+
       if @@solaris
-         assert_kind_of(String, @mnt.mount_time)
+         assert_kind_of(Time, @mnt.mount_time)
       else
          assert_nil(@mnt.mount_time)
       end
    end
 
    def test_mount_dump_frequency
-      omit_if(@@solaris, 'dump_frequency test skipped on Solaris')
+      omit_if(@@solaris || @@freebsd || @@darwin, 'dump_frequency test skipped on this platform')
       assert_respond_to(@mnt, :dump_frequency)
       assert_kind_of(Fixnum, @mnt.dump_frequency)
    end
@@ -211,7 +217,7 @@ class TC_Sys_Filesystem_Unix < Test::Unit::TestCase
    end
 
    def test_mount_pass_number
-      omit_if(@@solaris, 'pass_number test skipped on Solaris')
+      omit_if(@@solaris || @@freebsd || @@darwin, 'pass_number test skipped on this platform')
       assert_respond_to(@mnt, :pass_number)
       assert_kind_of(Fixnum, @mnt.pass_number)
    end
@@ -221,6 +227,12 @@ class TC_Sys_Filesystem_Unix < Test::Unit::TestCase
       assert_true(@mnt.method(:passno) == @mnt.method(:pass_number))
    end
 
+   def test_mount_point_singleton
+      assert_respond_to(Filesystem, :mount_point)
+      assert_nothing_raised{ Filesystem.mount_point(Dir.pwd) }
+      assert_kind_of(String, Filesystem.mount_point(Dir.pwd))
+   end
+
    def teardown
       @dir   = nil
       @stat  = nil
@@ -230,5 +242,7 @@ class TC_Sys_Filesystem_Unix < Test::Unit::TestCase
    def self.shutdown
       @@solaris = nil
       @@linux   = nil
+      @@freebsd = nil
+      @@darwin  = nil
    end
 end

data/test/test_sys_filesystem_windows.rb

@@ -22,7 +22,7 @@ class TC_Sys_Filesystem_Windows < Test::Unit::TestCase
    end
 
    def test_version
-      assert_equal('0.2.0', Filesystem::VERSION)
+      assert_equal('0.3.0', Filesystem::VERSION)
    end
 
    def test_stat_path
@@ -93,6 +93,12 @@ class TC_Sys_Filesystem_Windows < Test::Unit::TestCase
       assert_kind_of(String, @stat.base_type)
    end
 
+   def test_mount_point_singleton
+      assert_respond_to(Filesystem, :mount_point)
+      assert_nothing_raised{ Filesystem.mount_point(Dir.pwd) }
+      assert_kind_of(String, Filesystem.mount_point(Dir.pwd))
+   end
+
    def test_constants
       assert_not_nil(Filesystem::CASE_SENSITIVE_SEARCH)
       assert_not_nil(Filesystem::CASE_PRESERVED_NAMES)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: sys-filesystem
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  version: 0.3.0
 platform: x86-mswin32-60
 authors: 
 - Daniel J. Berger
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-12-30 00:00:00 -07:00
+date: 2009-02-26 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency