epath 0.0.1 → 0.1.0

data/lib/epath/io.rb

@@ -0,0 +1,59 @@
+class Path
+  # Opens the file for reading or writing. See +File.open+.
+  def open(*args, &block) # :yield: file
+    File.open(@path, *args, &block)
+  end
+
+  # Iterates over the lines in the file. See +IO.foreach+.
+  def each_line(*args, &block) # :yield: line
+    IO.foreach(@path, *args, &block)
+  end
+  alias :lines :each_line
+
+  # Returns all data from the file, or the first +N+ bytes if specified.
+  # See +IO.read+.
+  def read(*args)
+    IO.read(@path, *args)
+  end
+
+  # Returns all the bytes from the file, or the first +N+ if specified.
+  # See +IO.binread+.
+  if IO.respond_to? :binread
+    def binread(*args)
+      IO.binread(@path, *args)
+    end
+  else
+    alias :binread :read
+  end
+
+  # Returns all the lines from the file. See +IO.readlines+.
+  def readlines(*args)
+    IO.readlines(@path, *args)
+  end
+
+  # See +IO.sysopen+.
+  def sysopen(*args)
+    IO.sysopen(@path, *args)
+  end
+
+  if IO.respond_to? :write
+    def write(contents, *open_args)
+      IO.write(@path, contents, *open_args)
+    end
+  else
+    def write(contents, *open_args)
+      open('w', *open_args) { |f| f.write(contents) }
+    end
+  end
+
+  if IO.respond_to? :write and !RUBY_DESCRIPTION.start_with?('jruby')
+    def append(contents, open_args = {})
+      open_args[:mode] = 'a'
+      IO.write(@path, contents, open_args)
+    end
+  else
+    def append(contents, open_args = nil)
+      open('a') { |f| f.write(contents) }
+    end
+  end
+end

data/lib/epath/load.rb

@@ -0,0 +1,26 @@
+class Path
+
+  # The list of loaders. See {Path.register_loader}.
+  LOADERS = {}
+
+  # Registers a new loader (a block which will be called with the Path to load)
+  # for the given extensions (either with the leading dot or not)
+  #
+  #     Path.register_loader('.marshal') { |file| Marshal.load file.read }
+  def self.register_loader(*extensions, &loader)
+    extensions.each { |ext|
+      LOADERS[pure_ext(ext)] = loader
+    }
+  end
+
+  # Path#load helps loading data from various files.
+  # JSON and YAML loaders are provided by default.
+  # See Path.register_loader.
+  def load
+    if LOADERS.key? ext
+      LOADERS[ext].call(self)
+    else
+      raise "Unable to load #{self} (unrecognized extension)"
+    end
+  end
+end

data/lib/epath/parts.rb

@@ -0,0 +1,115 @@
+class Path
+  # Returns the last component of the path. See +File.basename+.
+  def basename(*args)
+    Path.new(File.basename(@path, *args))
+  end
+
+  # basename(extname)
+  def base
+    basename(extname)
+  end
+
+  # Returns all but the last component of the path. See +File.dirname+.
+  def dirname
+    Path.new(File.dirname(@path))
+  end
+  alias :dir :dirname
+
+  # Returns the file's extension. See +File.extname+.
+  def extname
+    File.extname(@path)
+  end
+
+  # extname without leading .
+  def ext
+    ext = extname
+    ext.empty? ? ext : ext[1..-1]
+  end
+
+  # Returns the #dirname and the #basename in an Array. See +File.split+.
+  def split
+    File.split(@path).map(&Path)
+  end
+
+  def add_extension(ext)
+    return self if ext.empty?
+    Path.new @path+dotted_ext(ext)
+  end
+  alias :add_ext :add_extension
+
+  def without_extension
+    Path.new @path[0..-extname.size-1]
+  end
+  alias :rm_ext :without_extension
+
+  def replace_extension(ext)
+    return without_extension if ext.empty?
+    Path.new(@path[0..-extname.size-1] << dotted_ext(ext))
+  end
+  alias :sub_ext :replace_extension
+
+  # Iterates over each component of the path.
+  #
+  #   Path.new("/usr/bin/ruby").each_filename { |filename| ... }
+  #     # yields "usr", "bin", and "ruby".
+  def each_filename # :yield: filename
+    return to_enum(__method__) unless block_given?
+    _, names = split_names(@path)
+    names.each { |filename| yield filename }
+    nil
+  end
+
+  # Iterates over and yields a new Path object
+  # for each element in the given path in descending order.
+  #
+  #  Path.new('/path/to/some/file.rb').descend { |v| p v }
+  #     #<Path />
+  #     #<Path /path>
+  #     #<Path /path/to>
+  #     #<Path /path/to/some>
+  #     #<Path /path/to/some/file.rb>
+  #
+  #  Path.new('path/to/some/file.rb').descend { |v| p v }
+  #     #<Path path>
+  #     #<Path path/to>
+  #     #<Path path/to/some>
+  #     #<Path path/to/some/file.rb>
+  #
+  # It doesn't access actual filesystem.
+  def descend
+    return to_enum(:descend) unless block_given?
+    vs = []
+    ascend { |v| vs << v }
+    vs.reverse_each { |v| yield v }
+    nil
+  end
+
+  # Iterates over and yields a new Path object
+  # for each element in the given path in ascending order.
+  #
+  #  Path.new('/path/to/some/file.rb').ascend { |v| p v }
+  #     #<Path /path/to/some/file.rb>
+  #     #<Path /path/to/some>
+  #     #<Path /path/to>
+  #     #<Path /path>
+  #     #<Path />
+  #
+  #  Path.new('path/to/some/file.rb').ascend { |v| p v }
+  #     #<Path path/to/some/file.rb>
+  #     #<Path path/to/some>
+  #     #<Path path/to>
+  #     #<Path path>
+  #
+  # It doesn't access actual filesystem.
+  def ascend
+    return to_enum(:ascend) unless block_given?
+    path = @path
+    yield self
+    while r = chop_basename(path)
+      path, = r
+      break if path.empty?
+      yield Path.new(del_trailing_separator(path))
+    end
+  end
+  alias :ancestors :ascend
+end

data/lib/epath/predicates.rb

@@ -0,0 +1,35 @@
+class Path
+  # Whether a path is absolute.
+  def absolute?
+    !relative?
+  end
+
+  # Whether a path is relative.
+  def relative?
+    path = @path
+    while r = chop_basename(path)
+      path, = r
+    end
+    path == ''
+  end
+
+  # #root? is a predicate for root directories. I.e. it returns +true+ if the
+  # path consists of consecutive slashes.
+  #
+  # It doesn't access actual filesystem. So it may return +false+ for some
+  # paths which points to roots such as +/usr/..+.
+  def root?
+    !!(chop_basename(@path) == nil && @path.include?('/'))
+  end
+
+  # #mountpoint? returns +true+ if +self+ points to a mountpoint.
+  def mountpoint?
+    begin
+      stat1 = lstat
+      stat2 = parent.lstat
+      stat1.dev != stat2.dev or stat1.ino == stat2.ino
+    rescue Errno::ENOENT
+      false
+    end
+  end
+end

data/lib/epath/require_tree.rb

@@ -0,0 +1,14 @@
+class Path
+  def self.require_tree(directory = nil)
+    if directory
+      new(directory).require_tree
+    else
+      file = Path.file(caller)
+      file.dir.require_tree(file)
+    end
+  end
+
+  def require_tree(source = nil)
+    glob('**/*.rb').sort.each { |file| require file.expand(dir) unless file == source }
+  end
+end

metadata

@@ -1,49 +1,95 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: epath
-version: !ruby/object:Gem::Version
-  version: 0.0.1
+version: !ruby/object:Gem::Version 
+  hash: 27
   prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
 platform: ruby
-authors:
+authors: 
 - eregon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-16 00:00:00.000000000 Z
-dependencies: []
+
+date: 2012-03-16 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
 description: 
 email: eregontp@gmail.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
+- lib/epath/dir.rb
+- lib/epath/file.rb
+- lib/epath/file_dir.rb
+- lib/epath/file_predicates.rb
+- lib/epath/fileutils.rb
+- lib/epath/find.rb
+- lib/epath/identity.rb
 - lib/epath/implementation.rb
+- lib/epath/io.rb
+- lib/epath/load.rb
+- lib/epath/parts.rb
+- lib/epath/predicates.rb
+- lib/epath/require_tree.rb
 - lib/epath.rb
 - README.md
 - LICENSE
 - epath.gemspec
 homepage: https://github.com/eregon/epath
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.8.11
+rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3
 summary: a Path manipulation library
 test_files: []
+
+has_rdoc: