Class: Pathname

Inherits:
Object
  • Object
show all
Defined in:
lib/rubysl/pathname/pathname.rb,
lib/rubysl/pathname/pathname.rb,
lib/rubysl/pathname/pathname.rb,
lib/rubysl/pathname/pathname.rb,
lib/rubysl/pathname/pathname.rb,
lib/rubysl/pathname/pathname.rb,
lib/rubysl/pathname/pathname.rb,
lib/rubysl/pathname/pathname.rb,
lib/rubysl/pathname/pathname.rb

Overview

  • mixed *

Constant Summary collapse

TO_PATH =

to_path is implemented so Pathname objects are usable with File.open, etc.

:to_path
SAME_PATHS = 
if File::FNM_SYSCASE.nonzero?
  proc {|a, b| a.casecmp(b).zero?}
else
  proc {|a, b| a == b}
end
SEPARATOR_LIST = 
"#{Regexp.quote File::SEPARATOR}"
SEPARATOR_PAT = 
/#{Regexp.quote File::SEPARATOR}/

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(path) ⇒ Pathname

Create a Pathname object from the given String (or String-like object). If path contains a NUL character (\0), an ArgumentError is raised.



210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
 
# File 'lib/rubysl/pathname/pathname.rb', line 210

def initialize(path)
  if path.respond_to? TO_PATH
    path = path.__send__(TO_PATH)
  elsif path.respond_to? :to_str
    path = path.__send__(:to_str)
  end

  @path = path.dup

  if /\0/ =~ @path
    raise ArgumentError, "pathname contains \\0: #{@path.inspect}"
  end

  self.taint if @path.tainted?
end

Class Method Details

.getwd ⇒ Object Also known as: pwd

See Dir.getwd. Returns the current working directory as a Pathname.



966
 
# File 'lib/rubysl/pathname/pathname.rb', line 966

def Pathname.getwd() self.new(Dir.getwd) end

.glob(*args) ⇒ Object

See Dir.glob. Returns or yields Pathname objects.



957
958
959
960
961
962
963
 
# File 'lib/rubysl/pathname/pathname.rb', line 957

def Pathname.glob(*args) # :yield: pathname
  if block_given?
    Dir.glob(*args) {|f| yield self.new(f) }
  else
    Dir.glob(*args).map {|f| self.new(f) }
  end
end

Instance Method Details

#+(other) ⇒ Object

Pathname#+ appends a pathname fragment to this one to produce a new Pathname object.

p1 = Pathname.new("/usr")      # Pathname:/usr
p2 = p1 + "bin/ruby"           # Pathname:/usr/bin/ruby
p3 = p1 + "/etc/passwd"        # Pathname:/etc/passwd

This method doesn’t access the file system; it is pure string manipulation.



586
587
588
589
 
# File 'lib/rubysl/pathname/pathname.rb', line 586

def +(other)
  other = Pathname.new(other) unless Pathname === other
  Pathname.new(plus(@path, other.to_s))
end

#<=>(other) ⇒ Object

Provides for comparing pathnames, case-sensitively.



243
244
245
246
 
# File 'lib/rubysl/pathname/pathname.rb', line 243

def <=>(other)
  return nil unless Pathname === other
  @path.tr('/', "\0") <=> other.to_s.tr('/', "\0")
end

#==(other) ⇒ Object Also known as: ===, eql?

Compare this pathname with other. The comparison is string-based. Be aware that two different paths (foo.txt and ./foo.txt) can refer to the same file.



235
236
237
238
 
# File 'lib/rubysl/pathname/pathname.rb', line 235

def ==(other)
  return false unless Pathname === other
  other.to_s == @path
end

#absolute? ⇒ Boolean

Predicate method for testing whether a path is absolute. It returns true if the pathname begins with a slash.

Returns:

  • (Boolean) 


493
494
495
 
# File 'lib/rubysl/pathname/pathname.rb', line 493

def absolute?
  !relative?
end

#ascend {|_self| ... } ⇒ Object

Iterates over and yields a new Pathname object for each element in the given path in ascending order.

Pathname.new('/path/to/some/file.rb').ascend {|v| p v}
   #<Pathname:/path/to/some/file.rb>
   #<Pathname:/path/to/some>
   #<Pathname:/path/to>
   #<Pathname:/path>
   #<Pathname:/>

Pathname.new('path/to/some/file.rb').ascend {|v| p v}
   #<Pathname:path/to/some/file.rb>
   #<Pathname:path/to/some>
   #<Pathname:path/to>
   #<Pathname:path>

It doesn’t access actual filesystem.

This method is available since 1.8.5.

Yields:

  • (_self)

Yield Parameters:

  • _self (Pathname) —

    the object that the method was called on



566
567
568
569
570
571
572
573
574
 
# File 'lib/rubysl/pathname/pathname.rb', line 566

def ascend
  path = @path
  yield self
  while r = chop_basename(path)
    path, name = r
    break if path.empty?
    yield self.class.new(del_trailing_separator(path))
  end
end

#atime ⇒ Object

See File.atime. Returns last access time.



801
 
# File 'lib/rubysl/pathname/pathname.rb', line 801

def atime() File.atime(@path) end

#basename(*args) ⇒ Object

See File.basename. Returns the last component of the path.



862
 
# File 'lib/rubysl/pathname/pathname.rb', line 862

def basename(*args) self.class.new(File.basename(@path, *args)) end

#binread(*args) ⇒ Object

See IO.binread. Returns all the bytes from the file, or the first N if specified.



782
 
# File 'lib/rubysl/pathname/pathname.rb', line 782

def binread(*args) IO.binread(@path, *args) end

#binwrite(*args) ⇒ Object

See IO.binwrite. Returns the number of bytes written to the file.



788
 
# File 'lib/rubysl/pathname/pathname.rb', line 788

def binwrite(*args) IO.binwrite(@path, *args) end

#blockdev? ⇒ Boolean

See FileTest.blockdev?.

Returns:

  • (Boolean) 


882
 
# File 'lib/rubysl/pathname/pathname.rb', line 882

def blockdev?() FileTest.blockdev?(@path) end

#chardev? ⇒ Boolean

See FileTest.chardev?.

Returns:

  • (Boolean) 


885
 
# File 'lib/rubysl/pathname/pathname.rb', line 885

def chardev?() FileTest.chardev?(@path) end

#children(with_directory = true) ⇒ Object

Returns the children of the directory (files and subdirectories, not recursive) as an array of Pathname objects. By default, the returned pathnames will have enough information to access the files. If you set with_directory to false, then the returned pathnames will contain the filename only.

For example:

pn = Pathname("/usr/lib/ruby/1.8")
pn.children
    # -> [ Pathname:/usr/lib/ruby/1.8/English.rb,
           Pathname:/usr/lib/ruby/1.8/Env.rb,
           Pathname:/usr/lib/ruby/1.8/abbrev.rb, ... ]
pn.children(false)
    # -> [ Pathname:English.rb, Pathname:Env.rb, Pathname:abbrev.rb, ... ]

Note that the result never contain the entries . and .. in the directory because they are not children.

This method has existed since 1.8.1.



673
674
675
676
677
678
679
680
681
682
683
684
685
 
# File 'lib/rubysl/pathname/pathname.rb', line 673

def children(with_directory=true)
  with_directory = false if @path == '.'
  result = []
  Dir.foreach(@path) {|e|
    next if e == '.' || e == '..'
    if with_directory
      result << self.class.new(File.join(@path, e))
    else
      result << self.class.new(e)
    end
  }
  result
end

#chmod(mode) ⇒ Object

See File.chmod. Changes permissions.



810
 
# File 'lib/rubysl/pathname/pathname.rb', line 810

def chmod(mode) File.chmod(mode, @path) end

#chown(owner, group) ⇒ Object

See File.chown. Change owner and group of file.



816
 
# File 'lib/rubysl/pathname/pathname.rb', line 816

def chown(owner, group) File.chown(owner, group, @path) end

#cleanpath(consider_symlink = false) ⇒ Object

Returns clean pathname of self with consecutive slashes and useless dots removed. The filesystem is not accessed.

If consider_symlink is true, then a more conservative algorithm is used to avoid breaking symbolic linkages. This may retain more .. entries than absolutely necessary, but without accessing the filesystem, this can’t be avoided. See #realpath.



343
344
345
346
347
348
349
 
# File 'lib/rubysl/pathname/pathname.rb', line 343

def cleanpath(consider_symlink=false)
  if consider_symlink
    cleanpath_conservative
  else
    cleanpath_aggressive
  end
end

#ctime ⇒ Object

See File.ctime. Returns last (directory entry, not file) change time.



804
 
# File 'lib/rubysl/pathname/pathname.rb', line 804

def ctime() File.ctime(@path) end

#descend ⇒ Object

Iterates over and yields a new Pathname object for each element in the given path in descending order.

Pathname.new('/path/to/some/file.rb').descend {|v| p v}
   #<Pathname:/>
   #<Pathname:/path>
   #<Pathname:/path/to>
   #<Pathname:/path/to/some>
   #<Pathname:/path/to/some/file.rb>

Pathname.new('path/to/some/file.rb').descend {|v| p v}
   #<Pathname:path>
   #<Pathname:path/to>
   #<Pathname:path/to/some>
   #<Pathname:path/to/some/file.rb>

It doesn’t access actual filesystem.

This method is available since 1.8.5.



539
540
541
542
543
544
 
# File 'lib/rubysl/pathname/pathname.rb', line 539

def descend
  vs = []
  ascend {|v| vs << v }
  vs.reverse_each {|v| yield v }
  nil
end

#directory? ⇒ Boolean

See FileTest.directory?.

Returns:

  • (Boolean) 


900
 
# File 'lib/rubysl/pathname/pathname.rb', line 900

def directory?() FileTest.directory?(@path) end

#dirname ⇒ Object

See File.dirname. Returns all but the last component of the path.



865
 
# File 'lib/rubysl/pathname/pathname.rb', line 865

def dirname() self.class.new(File.dirname(@path)) end

#each_child(with_directory = true, &b) ⇒ Object

Iterates over the children of the directory (files and subdirectories, not recursive). It yields Pathname object for each child. By default, the yielded pathnames will have enough information to access the files. If you set with_directory to false, then the returned pathnames will contain the filename only.

Pathname("/usr/local").each_child {|f| p f }
#=> #<Pathname:/usr/local/share>
#   #<Pathname:/usr/local/bin>
#   #<Pathname:/usr/local/games>
#   #<Pathname:/usr/local/lib>
#   #<Pathname:/usr/local/include>
#   #<Pathname:/usr/local/sbin>
#   #<Pathname:/usr/local/src>
#   #<Pathname:/usr/local/man>

Pathname("/usr/local").each_child(false) {|f| p f }
#=> #<Pathname:share>
#   #<Pathname:bin>
#   #<Pathname:games>
#   #<Pathname:lib>
#   #<Pathname:include>
#   #<Pathname:sbin>
#   #<Pathname:src>
#   #<Pathname:man>



713
714
715
 
# File 'lib/rubysl/pathname/pathname.rb', line 713

def each_child(with_directory=true, &b)
  children(with_directory).each(&b)
end

#each_entry(&block) ⇒ Object

Iterates over the entries (files and subdirectories) in the directory. It yields a Pathname object for each entry.

This method has existed since 1.8.1.



977
978
979
 
# File 'lib/rubysl/pathname/pathname.rb', line 977

def each_entry(&block) # :yield: pathname
  Dir.foreach(@path) {|f| yield self.class.new(f) }
end

#each_filename ⇒ Object

Iterates over each component of the path.

Pathname.new("/usr/bin/ruby").each_filename {|filename| ... }
  # yields "usr", "bin", and "ruby".



512
513
514
515
516
517
 
# File 'lib/rubysl/pathname/pathname.rb', line 512

def each_filename # :yield: filename
  return to_enum(__method__) unless block_given?
  prefix, names = split_names(@path)
  names.each {|filename| yield filename }
  nil
end

#each_line(*args, &block) ⇒ Object

#each_line iterates over the line in the file. It yields a String object for each line.

This method has existed since 1.8.1.



772
773
774
 
# File 'lib/rubysl/pathname/pathname.rb', line 772

def each_line(*args, &block) # :yield: line
  IO.foreach(@path, *args, &block)
end

#entries ⇒ Object

Return the entries (files and subdirectories) in the directory, each as a Pathname object.



971
 
# File 'lib/rubysl/pathname/pathname.rb', line 971

def entries() Dir.entries(@path).map {|f| self.class.new(f) } end

#executable? ⇒ Boolean

See FileTest.executable?.

Returns:

  • (Boolean) 


888
 
# File 'lib/rubysl/pathname/pathname.rb', line 888

def executable?() FileTest.executable?(@path) end

#executable_real? ⇒ Boolean

See FileTest.executable_real?.

Returns:

  • (Boolean) 


891
 
# File 'lib/rubysl/pathname/pathname.rb', line 891

def executable_real?() FileTest.executable_real?(@path) end

#exist? ⇒ Boolean

See FileTest.exist?.

Returns:

  • (Boolean) 


894
 
# File 'lib/rubysl/pathname/pathname.rb', line 894

def exist?() FileTest.exist?(@path) end

#expand_path(*args) ⇒ Object

See File.expand_path.



871
 
# File 'lib/rubysl/pathname/pathname.rb', line 871

def expand_path(*args) self.class.new(File.expand_path(@path, *args)) end

#extname ⇒ Object

See File.extname. Returns the file’s extension.



868
 
# File 'lib/rubysl/pathname/pathname.rb', line 868

def extname() File.extname(@path) end

#file? ⇒ Boolean

See FileTest.file?.

Returns:

  • (Boolean) 


903
 
# File 'lib/rubysl/pathname/pathname.rb', line 903

def file?() FileTest.file?(@path) end

#find(&block) ⇒ Object

Pathname#find is an iterator to traverse a directory tree in a depth first manner. It yields a Pathname for each file under “this” directory.

Returns an Enumerator if no block is given.

Since it is implemented by find.rb, Find.prune can be used to control the traverse.

If self is ., yielded pathnames begin with a filename in the current directory, not ./.



1007
1008
1009
1010
1011
1012
1013
1014
1015
 
# File 'lib/rubysl/pathname/pathname.rb', line 1007

def find(&block) # :yield: pathname
  return to_enum(__method__) unless block_given?
  require 'find'
  if @path == '.'
    Find.find(@path) {|f| yield self.class.new(f.sub(%r{\A\./}, '')) }
  else
    Find.find(@path) {|f| yield self.class.new(f) }
  end
end

#fnmatch(pattern, *args) ⇒ Object

See File.fnmatch. Return true if the receiver matches the given pattern.



823
 
# File 'lib/rubysl/pathname/pathname.rb', line 823

def fnmatch(pattern, *args) File.fnmatch(pattern, @path, *args) end

#fnmatch?(pattern, *args) ⇒ Boolean

See File.fnmatch? (same as #fnmatch).

Returns:

  • (Boolean) 


826
 
# File 'lib/rubysl/pathname/pathname.rb', line 826

def fnmatch?(pattern, *args) File.fnmatch?(pattern, @path, *args) end

#freeze ⇒ Object 



226
 
# File 'lib/rubysl/pathname/pathname.rb', line 226

def freeze() super; @path.freeze; self end

#ftype ⇒ Object

See File.ftype. Returns “type” of file (“file”, “directory”, etc).



830
 
# File 'lib/rubysl/pathname/pathname.rb', line 830

def ftype() File.ftype(@path) end

#grpowned? ⇒ Boolean

See FileTest.grpowned?.

Returns:

  • (Boolean) 


897
 
# File 'lib/rubysl/pathname/pathname.rb', line 897

def grpowned?() FileTest.grpowned?(@path) end

#hash ⇒ Object

:nodoc:



248
249
250
 
# File 'lib/rubysl/pathname/pathname.rb', line 248

def hash # :nodoc:
  @path.hash
end

#inspect ⇒ Object

:nodoc:



260
261
262
 
# File 'lib/rubysl/pathname/pathname.rb', line 260

def inspect # :nodoc:
  "#<#{self.class}:#{@path}>"
end

#join(*args) ⇒ Object

Pathname#join joins pathnames.

path0.join(path1, ..., pathN) is the same as path0 + path1 + ... + pathN.



639
640
641
642
643
644
645
646
647
648
649
650
 
# File 'lib/rubysl/pathname/pathname.rb', line 639

def join(*args)
  args.unshift self
  result = args.pop
  result = Pathname.new(result) unless Pathname === result
  return result if result.absolute?
  args.reverse_each {|arg|
    arg = Pathname.new(arg) unless Pathname === arg
    result = arg + result
    return result if result.absolute?
  }
  result
end

#lchmod(mode) ⇒ Object

See File.lchmod.



813
 
# File 'lib/rubysl/pathname/pathname.rb', line 813

def lchmod(mode) File.lchmod(mode, @path) end

#lchown(owner, group) ⇒ Object

See File.lchown.



819
 
# File 'lib/rubysl/pathname/pathname.rb', line 819

def lchown(owner, group) File.lchown(owner, group, @path) end

#lstat ⇒ Object

See File.lstat.



850
 
# File 'lib/rubysl/pathname/pathname.rb', line 850

def lstat() File.lstat(@path) end

#make_link(old) ⇒ Object

See File.link. Creates a hard link.



833
 
# File 'lib/rubysl/pathname/pathname.rb', line 833

def make_link(old) File.link(old, @path) end

#make_symlink(old) ⇒ Object

See File.symlink. Creates a symbolic link.



853
 
# File 'lib/rubysl/pathname/pathname.rb', line 853

def make_symlink(old) File.symlink(old, @path) end

#mkdir(*args) ⇒ Object

See Dir.mkdir. Create the referenced directory.



982
 
# File 'lib/rubysl/pathname/pathname.rb', line 982

def mkdir(*args) Dir.mkdir(@path, *args) end

#mkpath ⇒ Object

See FileUtils.mkpath. Creates a full path, including any intermediate directories that don’t yet exist.



1022
1023
1024
1025
1026
 
# File 'lib/rubysl/pathname/pathname.rb', line 1022

def mkpath
  require 'fileutils'
  FileUtils.mkpath(@path)
  nil
end

#mountpoint? ⇒ Boolean

#mountpoint? returns true if self points to a mountpoint.

Returns:

  • (Boolean) 


469
470
471
472
473
474
475
476
477
478
 
# File 'lib/rubysl/pathname/pathname.rb', line 469

def mountpoint?
  begin
    stat1 = self.lstat
    stat2 = self.parent.lstat
    stat1.dev == stat2.dev && stat1.ino == stat2.ino ||
      stat1.dev != stat2.dev
  rescue Errno::ENOENT
    false
  end
end

#mtime ⇒ Object

See File.mtime. Returns last modification time.



807
 
# File 'lib/rubysl/pathname/pathname.rb', line 807

def mtime() File.mtime(@path) end

#open(*args, &block) ⇒ Object

See File.open. Opens the file for reading or writing.



836
837
838
 
# File 'lib/rubysl/pathname/pathname.rb', line 836

def open(*args, &block) # :yield: file
  File.open(@path, *args, &block)
end

#opendir(&block) ⇒ Object

See Dir.open.



988
989
990
 
# File 'lib/rubysl/pathname/pathname.rb', line 988

def opendir(&block) # :yield: dir
  Dir.open(@path, &block)
end

#owned? ⇒ Boolean

See FileTest.owned?.

Returns:

  • (Boolean) 


912
 
# File 'lib/rubysl/pathname/pathname.rb', line 912

def owned?() FileTest.owned?(@path) end

#parent ⇒ Object

#parent returns the parent directory.

This is same as self + '..'.



464
465
466
 
# File 'lib/rubysl/pathname/pathname.rb', line 464

def parent
  self + '..'
end

#pipe? ⇒ Boolean

See FileTest.pipe?.

Returns:

  • (Boolean) 


906
 
# File 'lib/rubysl/pathname/pathname.rb', line 906

def pipe?() FileTest.pipe?(@path) end

#read(*args) ⇒ Object

See IO.read. Returns all data from the file, or the first N bytes if specified.



778
 
# File 'lib/rubysl/pathname/pathname.rb', line 778

def read(*args) IO.read(@path, *args) end

#readable? ⇒ Boolean

See FileTest.readable?.

Returns:

  • (Boolean) 


915
 
# File 'lib/rubysl/pathname/pathname.rb', line 915

def readable?() FileTest.readable?(@path) end

#readable_real? ⇒ Boolean

See FileTest.readable_real?.

Returns:

  • (Boolean) 


921
 
# File 'lib/rubysl/pathname/pathname.rb', line 921

def readable_real?() FileTest.readable_real?(@path) end

#readlines(*args) ⇒ Object

See IO.readlines. Returns all the lines from the file.



791
 
# File 'lib/rubysl/pathname/pathname.rb', line 791

def readlines(*args) IO.readlines(@path, *args) end

#readlink ⇒ Object

See File.readlink. Read symbolic link.



841
 
# File 'lib/rubysl/pathname/pathname.rb', line 841

def readlink() self.class.new(File.readlink(@path)) end

#realdirpath(basedir = nil) ⇒ Object

Returns the real (absolute) pathname of self in the actual filesystem. The real pathname doesn’t contain symlinks or useless dots.

The last component of the real pathname can be nonexistent.



457
458
459
 
# File 'lib/rubysl/pathname/pathname.rb', line 457

def realdirpath(basedir=nil)
  self.class.new(File.realdirpath(@path, basedir))
end

#realpath(basedir = nil) ⇒ Object

Returns the real (absolute) pathname of self in the actual filesystem not containing symlinks or useless dots.

All components of the pathname must exist when this method is called.



447
448
449
 
# File 'lib/rubysl/pathname/pathname.rb', line 447

def realpath(basedir=nil)
  self.class.new(File.realpath(@path, basedir))
end

#relative? ⇒ Boolean

The opposite of #absolute?

Returns:

  • (Boolean) 


498
499
500
501
502
503
504
 
# File 'lib/rubysl/pathname/pathname.rb', line 498

def relative?
  path = @path
  while r = chop_basename(path)
    path, basename = r
  end
  path == ''
end

#relative_path_from(base_directory) ⇒ Object

#relative_path_from returns a relative path from the argument to the receiver. If self is absolute, the argument must be absolute too. If self is relative, the argument must be relative too.

#relative_path_from doesn’t access the filesystem. It assumes no symlinks.

ArgumentError is raised when it cannot find a relative path.

This method has existed since 1.8.1.



728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
 
# File 'lib/rubysl/pathname/pathname.rb', line 728

def relative_path_from(base_directory)
  dest_directory = self.cleanpath.to_s
  base_directory = base_directory.cleanpath.to_s
  dest_prefix = dest_directory
  dest_names = []
  while r = chop_basename(dest_prefix)
    dest_prefix, basename = r
    dest_names.unshift basename if basename != '.'
  end
  base_prefix = base_directory
  base_names = []
  while r = chop_basename(base_prefix)
    base_prefix, basename = r
    base_names.unshift basename if basename != '.'
  end
  unless SAME_PATHS[dest_prefix, base_prefix]
    raise ArgumentError, "different prefix: #{dest_prefix.inspect} and #{base_directory.inspect}"
  end
  while !dest_names.empty? &&
        !base_names.empty? &&
        SAME_PATHS[dest_names.first, base_names.first]
    dest_names.shift
    base_names.shift
  end
  if base_names.include? '..'
    raise ArgumentError, "base_directory has ..: #{base_directory.inspect}"
  end
  base_names.fill('..')
  relpath_names = base_names + dest_names
  if relpath_names.empty?
    Pathname.new('.')
  else
    Pathname.new(File.join(*relpath_names))
  end
end

#rename(to) ⇒ Object

See File.rename. Rename the file.



844
 
# File 'lib/rubysl/pathname/pathname.rb', line 844

def rename(to) File.rename(@path, to) end

#rmdir ⇒ Object

See Dir.rmdir. Remove the referenced directory.



985
 
# File 'lib/rubysl/pathname/pathname.rb', line 985

def rmdir() Dir.rmdir(@path) end

#rmtree ⇒ Object

See FileUtils.rm_r. Deletes a directory and all beneath it.



1029
1030
1031
1032
1033
1034
1035
 
# File 'lib/rubysl/pathname/pathname.rb', line 1029

def rmtree
  # The name "rmtree" is borrowed from File::Path of Perl.
  # File::Path provides "mkpath" and "rmtree".
  require 'fileutils'
  FileUtils.rm_r(@path)
  nil
end

#root? ⇒ Boolean

#root? is a predicate for root directories. I.e. it returns true if the pathname consists of consecutive slashes.

It doesn’t access actual filesystem. So it may return false for some pathnames which points to roots such as /usr/...

Returns:

  • (Boolean) 


487
488
489
 
# File 'lib/rubysl/pathname/pathname.rb', line 487

def root?
  !!(chop_basename(@path) == nil && /#{SEPARATOR_PAT}/o =~ @path)
end

#setgid? ⇒ Boolean

See FileTest.setgid?.

Returns:

  • (Boolean) 


927
 
# File 'lib/rubysl/pathname/pathname.rb', line 927

def setgid?() FileTest.setgid?(@path) end

#setuid? ⇒ Boolean

See FileTest.setuid?.

Returns:

  • (Boolean) 


924
 
# File 'lib/rubysl/pathname/pathname.rb', line 924

def setuid?() FileTest.setuid?(@path) end

#size ⇒ Object

See FileTest.size.



930
 
# File 'lib/rubysl/pathname/pathname.rb', line 930

def size() FileTest.size(@path) end

#size? ⇒ Boolean

See FileTest.size?.

Returns:

  • (Boolean) 


933
 
# File 'lib/rubysl/pathname/pathname.rb', line 933

def size?() FileTest.size?(@path) end

#socket? ⇒ Boolean

See FileTest.socket?.

Returns:

  • (Boolean) 


909
 
# File 'lib/rubysl/pathname/pathname.rb', line 909

def socket?() FileTest.socket?(@path) end

#split ⇒ Object

See File.split. Returns the #dirname and the #basename in an Array.



875
 
# File 'lib/rubysl/pathname/pathname.rb', line 875

def split() File.split(@path).map {|f| self.class.new(f) } end

#stat ⇒ Object

See File.stat. Returns a File::Stat object.



847
 
# File 'lib/rubysl/pathname/pathname.rb', line 847

def stat() File.stat(@path) end

#sticky? ⇒ Boolean

See FileTest.sticky?.

Returns:

  • (Boolean) 


936
 
# File 'lib/rubysl/pathname/pathname.rb', line 936

def sticky?() FileTest.sticky?(@path) end

#sub(pattern, *rest, &block) ⇒ Object

Return a pathname which is substituted by String#sub.



265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
 
# File 'lib/rubysl/pathname/pathname.rb', line 265

def sub(pattern, *rest, &block)
  if block
    path = @path.sub(pattern, *rest) {|*args|
      begin
        old = Thread.current[:pathname_sub_matchdata]
        Thread.current[:pathname_sub_matchdata] = $~
        eval("$~ = Thread.current[:pathname_sub_matchdata]", block.binding)
      ensure
        Thread.current[:pathname_sub_matchdata] = old
      end
      yield(*args)
    }
  else
    path = @path.sub(pattern, *rest)
  end
  self.class.new(path)
end

#sub_ext(repl) ⇒ Object

Return a pathname which the extension of the basename is substituted by repl.

If self has no extension part, repl is appended.



295
296
297
298
 
# File 'lib/rubysl/pathname/pathname.rb', line 295

def sub_ext(repl)
  ext = File.extname(@path)
  self.class.new(@path.chomp(ext) + repl)
end

#symlink? ⇒ Boolean

See FileTest.symlink?.

Returns:

  • (Boolean) 


939
 
# File 'lib/rubysl/pathname/pathname.rb', line 939

def symlink?() FileTest.symlink?(@path) end

#sysopen(*args) ⇒ Object

See IO.sysopen.



794
 
# File 'lib/rubysl/pathname/pathname.rb', line 794

def sysopen(*args) IO.sysopen(@path, *args) end

#taint ⇒ Object 



227
 
# File 'lib/rubysl/pathname/pathname.rb', line 227

def taint() super; @path.taint; self end

#to_s ⇒ Object

Return the path as a String.



253
254
255
 
# File 'lib/rubysl/pathname/pathname.rb', line 253

def to_s
  @path.dup
end

#truncate(length) ⇒ Object

See File.truncate. Truncate the file to length bytes.



856
 
# File 'lib/rubysl/pathname/pathname.rb', line 856

def truncate(length) File.truncate(@path, length) end

#unlink ⇒ Object Also known as: delete

Removes a file or directory, using File.unlink or Dir.unlink as necessary.



1042
1043
1044
1045
1046
1047
1048
 
# File 'lib/rubysl/pathname/pathname.rb', line 1042

def unlink()
  begin
    Dir.unlink @path
  rescue Errno::ENOTDIR
    File.unlink @path
  end
end

#untaint ⇒ Object 



228
 
# File 'lib/rubysl/pathname/pathname.rb', line 228

def untaint() super; @path.untaint; self end

#utime(atime, mtime) ⇒ Object

See File.utime. Update the access and modification times.



859
 
# File 'lib/rubysl/pathname/pathname.rb', line 859

def utime(atime, mtime) File.utime(atime, mtime, @path) end

#world_readable? ⇒ Boolean

See FileTest.world_readable?.

Returns:

  • (Boolean) 


918
 
# File 'lib/rubysl/pathname/pathname.rb', line 918

def world_readable?() FileTest.world_readable?(@path) end

#world_writable? ⇒ Boolean

See FileTest.world_writable?.

Returns:

  • (Boolean) 


945
 
# File 'lib/rubysl/pathname/pathname.rb', line 945

def world_writable?() FileTest.world_writable?(@path) end

#writable? ⇒ Boolean

See FileTest.writable?.

Returns:

  • (Boolean) 


942
 
# File 'lib/rubysl/pathname/pathname.rb', line 942

def writable?() FileTest.writable?(@path) end

#writable_real? ⇒ Boolean

See FileTest.writable_real?.

Returns:

  • (Boolean) 


948
 
# File 'lib/rubysl/pathname/pathname.rb', line 948

def writable_real?() FileTest.writable_real?(@path) end

#write(*args) ⇒ Object

See IO.write. Returns the number of bytes written to the file.



785
 
# File 'lib/rubysl/pathname/pathname.rb', line 785

def write(*args) IO.write(@path, *args) end

#zero? ⇒ Boolean

See FileTest.zero?.

Returns:

  • (Boolean) 


951
 
# File 'lib/rubysl/pathname/pathname.rb', line 951

def zero?() FileTest.zero?(@path) end