Class: RbFind::Entry

Inherits:
Object
  • Object
show all
Includes:
Csv
Defined in:
lib/rbfind.rb

Constant Summary collapse

ARROW =
" -> "

Constants included from Csv

Csv::COLON

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Csv

#colsep, #csv, outfile, putl, #spcsep, #tabsep

Constructor Details

#initialize(filename, walk) ⇒ Entry

Returns a new instance of Entry.



413
414
415
416
417
# File 'lib/rbfind.rb', line 413

def initialize filename, walk
  @walk = walk
  @prev, @name = walk.current, filename.dup.freeze
  @path = join_path @name
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(sym, *args, &block) ⇒ Object (private)



464
465
466
467
468
469
470
# File 'lib/rbfind.rb', line 464

def method_missing sym, *args, &block
  if stat.respond_to? sym then
    stat.send sym, *args, &block
  else
    super
  end
end

Instance Attribute Details

#nameObject (readonly)

Returns the value of attribute name.



411
412
413
# File 'lib/rbfind.rb', line 411

def name
  @name
end

#pathObject (readonly)

Returns the value of attribute path.



411
412
413
# File 'lib/rbfind.rb', line 411

def path
  @path
end

Class Method Details

.colored(arg, num) ⇒ Object Also known as: coloured



815
816
817
818
# File 'lib/rbfind.rb', line 815

def colored arg, num
  colors col_str
  "\e[#{@colors[num]}m#{arg}\e[m"
end

.colors(str) ⇒ Object Also known as: colours



821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
# File 'lib/rbfind.rb', line 821

def colors str
  @colors ||= if str =~ /:/ then
    h = {}
    (str.split ":").each { |a|
      t, c = a.split "="
      h[  t] = c
    }
    %w(rs or di ln so pi ex bd cd su sg tw ow - -).map { |t| h[ t] }
  else
    cols = []
    str.scan /(.)(.)/i do
      fg, bg = $~.captures.map { |x| x.downcase.ord - ?a.ord }
      a = []
      case fg
      when 0..7 then a.push 30 + fg
      end
      a.push 1 if $1 == $1.upcase
      case bg
      when 0..7 then a.push 40 + bg
      end
      e = a.join ";"
      cols.push e
    end
    cols
  end
end

Instance Method Details

#aageObject



491
# File 'lib/rbfind.rb', line 491

def aage ; @walk.start - stat.atime ; end

#arrowObject



556
557
558
# File 'lib/rbfind.rb', line 556

def arrow
  ARROW + (File.readlink @path) if symlink?
end

#binary?(n = 1) ⇒ Boolean Also known as: bin?

:call-seq:

binary?( n = 1)   -> true or false

Test whether the first n blocks contain null characters.

Returns:

  • (Boolean)


681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
# File 'lib/rbfind.rb', line 681

def binary? n = 1
  bs = stat.blksize
  open { |file|
    loop do
      if n then
        break if n <= 0
        n -= 1
      end
      b = file.read bs
      b or break
      return true if b[ "\0"]
    end
  }
  false
end

#broken_link?Boolean Also known as: broken?

Returns:

  • (Boolean)


546
547
548
549
550
551
552
# File 'lib/rbfind.rb', line 546

def broken_link?
  return unless symlink?
  rstat
  false
rescue
  true
end

#cageObject



493
# File 'lib/rbfind.rb', line 493

def cage ; @walk.start - stat.ctime ; end

#carrowObject



759
760
761
762
# File 'lib/rbfind.rb', line 759

def carrow
  r = creadlink
  ARROW + r if r
end

#cfullpathObject



747
# File 'lib/rbfind.rb', line 747

def cfullpath  ; color fullpath  ; end

#cfullpath!Object



749
# File 'lib/rbfind.rb', line 749

def cfullpath! ; color fullpath! ; end

#cnameObject



745
# File 'lib/rbfind.rb', line 745

def cname      ; color name      ; end

#color(arg) ⇒ Object Also known as: colour



765
766
767
# File 'lib/rbfind.rb', line 765

def color arg
  color_stat arg, stat
end

#contains?(name) ⇒ Boolean

:call-seq:

contains?( name)     -> true or false

Check whether a directory contains an entry.

Returns:

  • (Boolean)


579
580
581
582
583
584
585
# File 'lib/rbfind.rb', line 579

def contains? name
  p = File.join @path, name
  File.lstat p
  true
rescue
  false
end

#countObject



432
# File 'lib/rbfind.rb', line 432

def count ; @walk.count ; end

#cpathObject



746
# File 'lib/rbfind.rb', line 746

def cpath      ; color path      ; end

#cpath!Object



748
# File 'lib/rbfind.rb', line 748

def cpath!     ; color path!     ; end


751
752
753
754
755
756
757
# File 'lib/rbfind.rb', line 751

def creadlink
  l = readlink
  if l then
    s = rstat rescue nil
    color_stat l, s
  end
end

#cyclic?Boolean

Returns:

  • (Boolean)


478
479
480
481
482
483
484
485
486
487
488
# File 'lib/rbfind.rb', line 478

def cyclic?
  e = self
  loop do
    e = e.prev
    e or break
    if File.identical? e.path, @path then
      return true
    end
  end
  false
end

#depthObject



433
# File 'lib/rbfind.rb', line 433

def depth ; @walk.depth ; end

#directory?Boolean Also known as: dir?

Returns:

  • (Boolean)


473
# File 'lib/rbfind.rb', line 473

def directory? ; stat.directory? ; end

#dirnameObject



449
450
451
# File 'lib/rbfind.rb', line 449

def dirname
  File.basename File.dirname fullpath
end

#doneObject Also known as: done!

Raises:



707
# File 'lib/rbfind.rb', line 707

def done  ; raise Done  ; end

#empty?Boolean

:call-seq:

empty?()     -> true or false

Look up if the directory is empty. If the object is not a directory or not accessible, nil is returned.

Returns:

  • (Boolean)


568
569
570
571
572
# File 'lib/rbfind.rb', line 568

def empty?
  (Dir.new @path).each_child { |f| return false }
  true
rescue Errno::ENOTDIR
end

#entriesObject Also known as: children

:call-seq:

entries()     -> ary

Return all entries in an array. If the object is not a directory, nil is returned.



593
594
595
596
# File 'lib/rbfind.rb', line 593

def entries
  (Dir.new @path).children
rescue Errno::ENOTDIR
end

#extObject



454
# File 'lib/rbfind.rb', line 454

def ext         ; File.extname name ; end

#filesizeObject

:call-seq:

filesize => nil or int
filesize { |size| ... } => obj

Returns the files size. When the object is not a regular file, nil will be returned or the block will not be called.



503
504
505
506
507
508
509
510
# File 'lib/rbfind.rb', line 503

def filesize
  stat.file? or return
  if block_given? then
    yield stat.size
  else
    stat.size
  end
end

#fullpathObject



436
# File 'lib/rbfind.rb', line 436

def fullpath ; @fullpath ||= File.absolute_path @path ; end

#fullpath!Object



447
# File 'lib/rbfind.rb', line 447

def fullpath! ; append_slash fullpath ; end

#grep(re, color = nil) ⇒ Object



661
662
663
664
665
666
667
668
669
670
671
672
673
674
# File 'lib/rbfind.rb', line 661

def grep re, color = nil
  case color
  when /\A\d+(?:;\d+)*\z/, nil, false then
  when true then color = "31;1"  # red
  else           raise "Illegal color spec: #{color}"
  end
  lines { |l,i|
    l.scrub!
    l =~ re or next
    color and l = "#$`\e[#{color}m#$&\e[m#$'"
    colsep @path, i, l
    true
  }
end

#groupObject



534
535
536
# File 'lib/rbfind.rb', line 534

def group
  get_group stat.gid
end

#group!Object



538
539
540
541
# File 'lib/rbfind.rb', line 538

def group!
  g = stat.gid
  g == Process.gid ? "." : (get_group g)
end

#hidden?Boolean

Returns:

  • (Boolean)


457
# File 'lib/rbfind.rb', line 457

def hidden?  ; name =~ /^\./ ; end

#inspectObject



419
# File 'lib/rbfind.rb', line 419

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

#linesObject

:call-seq:

lines { |l,i| ... }    -> nil

Yield line by line together with the line number i.



647
648
649
650
651
652
653
654
655
656
657
658
659
# File 'lib/rbfind.rb', line 647

def lines
  block_given? or return lines do end
  r = false
  open { |file|
    n = 0
    file.each_line { |l|
      l.chomp!
      n += 1
      r ||= true if yield l, n
    }
    r
  }
end

#mageObject Also known as: age



492
# File 'lib/rbfind.rb', line 492

def mage ; @walk.start - stat.mtime ; end

#modeObject



461
# File 'lib/rbfind.rb', line 461

def mode ; stat.mode ; end

#novcsObject Also known as: no_vcs



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

def novcs
  prune if vcs?
end

#nowObject



434
# File 'lib/rbfind.rb', line 434

def now   ; @walk.start ; end

#open(&block) ⇒ Object

:call-seq:

open() { |h| ... }    -> obj

Open the file for reading. If the object is not a regular file, nothing will be done.



611
612
613
614
615
616
# File 'lib/rbfind.rb', line 611

def open &block
  @ostat ||= $stdout.stat
  @ostat.identical? @path and
    raise "Refusing to open output file."
  File.open @path, &block if file?
end

#path!Object



446
# File 'lib/rbfind.rb', line 446

def path!     ; append_slash path     ; end

#pruneObject Also known as: prune!

Raises:



710
# File 'lib/rbfind.rb', line 710

def prune ; raise Prune ; end

#read(n = nil) ⇒ Object

:call-seq:

read( n = nil)               -> str or nil
read( n = nil) { |b| ... }   -> nil

Read the first n bytes or return nil for others than regular files. nil reads to end of file. If a block is given, chonks of n bytes (or all) will be yielded.



626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
# File 'lib/rbfind.rb', line 626

def read n = nil
  open { |o|
    if block_given? then
      if n then
        while (r = o.read n) do
          yield r
        end
      else
        yield o.read
      end
    else
      o.read n
    end
  }
end


544
# File 'lib/rbfind.rb', line 544

def readlink ; File.readlink @path if symlink? ; end

#rename(newname) ⇒ Object Also known as: mv



722
723
724
725
726
727
728
729
730
731
# File 'lib/rbfind.rb', line 722

def rename newname
  @name = newname
  newname == (File.basename newname) or
    raise "Rename to `#{newname}' may not be a path."
  p = join_path newname
  (File.exist? p) and raise "Rename to `#{p}` would overwrite."
  File.rename @path, p
  @name, @path = newname.dup.freeze, p
  reset
end

#rmObject



734
735
736
737
738
739
740
741
742
# File 'lib/rbfind.rb', line 734

def rm
  if directory? then
    Dir.rmdir @path
  else
    File.unlink @path
  end
  @name = @path = nil
  reset
end

#rstatObject



439
# File 'lib/rbfind.rb', line 439

def rstat ; @rstat ||= File.stat  @path ; end

#statObject



438
# File 'lib/rbfind.rb', line 438

def stat  ; @stat  ||= File.lstat @path ; end

#symlink?Boolean

Returns:

  • (Boolean)


476
# File 'lib/rbfind.rb', line 476

def symlink? ; stat.symlink? ; end

#userObject Also known as: owner



523
524
525
# File 'lib/rbfind.rb', line 523

def user
  get_user stat.uid
end

#user!Object Also known as: owner!



528
529
530
531
# File 'lib/rbfind.rb', line 528

def user!
  u = stat.uid
  u == Process.uid ? "."  : (get_user u)
end

#vcs?Boolean

Returns:

  • (Boolean)


600
601
602
# File 'lib/rbfind.rb', line 600

def vcs?
  %w(CVS .svn .git .hg .fslckout).include? name
end

#vimswap?Boolean

Returns:

  • (Boolean)


698
699
700
701
702
703
# File 'lib/rbfind.rb', line 698

def vimswap?
  if name =~ /\A(\..+)?\.sw[a-z]\z/i then
    mark = read 5
    mark == "b0VIM"
  end
end

#visible?Boolean

Returns:

  • (Boolean)


458
# File 'lib/rbfind.rb', line 458

def visible? ; not hidden?   ; end

#without_extObject



455
# File 'lib/rbfind.rb', line 455

def without_ext ; name[ /^(.+?)(?:\.[^.]+)?$/, 1 ].to_s ; end