# class Chef::ChefFS::PathUtils

### Public Class Methods

descendant_of?(path, ancestor) click to toggle source

    # File lib/chef/chef_fs/path_utils.rb, line 85
    def self.descendant_of?(path, ancestor)
      path[0,ancestor.length] == ancestor &&
        (ancestor.length == path.length || path[ancestor.length,1] =~ /#{PathUtils.regexp_path_separator}/)
    end

is_absolute?(path) click to toggle source

    # File lib/chef/chef_fs/path_utils.rb, line 90
    def self.is_absolute?(path)
      path =~ /^#{regexp_path_separator}/
    end

join(*parts) click to toggle source

    # File lib/chef/chef_fs/path_utils.rb, line 43
    def self.join(*parts)
      return "" if parts.length == 0
      # Determine if it started with a slash
      absolute = parts[0].length == 0 || parts[0].length > 0 && parts[0] =~ /^#{regexp_path_separator}/
      # Remove leading and trailing slashes from each part so that the join will work (and the slash at the end will go away)
      parts = parts.map { |part| part.gsub(/^\/|\/$/, "") }
      # Don't join empty bits
      result = parts.select { |part| part != "" }.join("/")
      # Put the / back on
      absolute ? "/#{result}" : result
    end

realest_path(path) click to toggle source

Given a path which may only be partly real (i.e. /x/y/z when only /x exists, or /x/y /blah when /x/y/z/blah exists), call File.realpath on the biggest part that actually exists.

If /x is a symlink to /blarghle, and has no subdirectories, then: ::realest_path(‘/x/y/z’) == ‘/blarghle/y/z’ ::realest_path(‘/x/ z’) == ‘/blarghle /z’ ::realest_path(‘/ y/z’) == ‘/*/y/z’

    # File lib/chef/chef_fs/path_utils.rb, line 71
    def self.realest_path(path)
      path = Pathname.new(path)
      begin
        path.realpath.to_s
      rescue Errno::ENOENT
        dirname = path.dirname
        if dirname
          PathUtils.join(realest_path(dirname), path.basename.to_s)
        else
          path.to_s
        end
      end
    end

regexp_path_separator() click to toggle source

    # File lib/chef/chef_fs/path_utils.rb, line 59
    def self.regexp_path_separator
      Chef::ChefFS::windows? ? '[\/\\]' : '/'
    end

relative_to(dest, source) click to toggle source

If you are in ‘source’, this is what you would have to type to reach ‘dest’ ::relative_to(‘/a/b/c/d/e’, ‘/a/b/x/y’) == ‘../../c/d/e’ ::relative_to(‘/a/b’, ‘/a/b’) == ‘.’

    # File lib/chef/chef_fs/path_utils.rb, line 29
    def self.relative_to(dest, source)
      # Skip past the common parts
      source_parts = Chef::ChefFS::PathUtils.split(source)
      dest_parts = Chef::ChefFS::PathUtils.split(dest)
      i = 0
      until i >= source_parts.length || i >= dest_parts.length || source_parts[i] != dest_parts[i]
        i+=1
      end
      # dot-dot up from 'source' to the common ancestor, then
      # descend to 'dest' from the common ancestor
      result = Chef::ChefFS::PathUtils.join(*(['..']*(source_parts.length-i) + dest_parts[i,dest.length-i]))
      result == '' ? '.' : result
    end

split(path) click to toggle source

    # File lib/chef/chef_fs/path_utils.rb, line 55
    def self.split(path)
      path.split(Regexp.new(regexp_path_separator))
    end