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.



398
399
400
401
402
# File 'lib/rbfind.rb', line 398

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)



447
448
449
450
451
452
453
# File 'lib/rbfind.rb', line 447

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.



396
397
398
# File 'lib/rbfind.rb', line 396

def name
  @name
end

#pathObject (readonly)

Returns the value of attribute path.



396
397
398
# File 'lib/rbfind.rb', line 396

def path
  @path
end

Class Method Details

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



799
800
801
802
# File 'lib/rbfind.rb', line 799

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

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



805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
# File 'lib/rbfind.rb', line 805

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



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

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

#arrowObject



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

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)


665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
# File 'lib/rbfind.rb', line 665

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)


529
530
531
532
533
534
535
# File 'lib/rbfind.rb', line 529

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

#cageObject



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

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

#carrowObject



743
744
745
746
# File 'lib/rbfind.rb', line 743

def carrow
  r = creadlink
  ARROW + r if r
end

#cfullpathObject



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

def cfullpath  ; color fullpath  ; end

#cfullpath!Object



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

def cfullpath! ; color fullpath! ; end

#cnameObject



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

def cname      ; color name      ; end

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



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

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)


562
563
564
565
566
567
568
# File 'lib/rbfind.rb', line 562

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

#countObject



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

def count ; @walk.count ; end

#cpathObject



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

def cpath      ; color path      ; end

#cpath!Object



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

def cpath!     ; color path!     ; end


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

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

#cyclic?Boolean

Returns:

  • (Boolean)


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

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



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

def depth ; @walk.depth ; end

#directory?Boolean Also known as: dir?

Returns:

  • (Boolean)


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

def directory? ; stat.directory? ; end

#dirnameObject



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

def dirname
  File.basename File.dirname fullpath
end

#doneObject Also known as: done!

Raises:



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

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)


551
552
553
554
555
# File 'lib/rbfind.rb', line 551

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.



576
577
578
579
# File 'lib/rbfind.rb', line 576

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

#extObject



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

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.



486
487
488
489
490
491
492
493
# File 'lib/rbfind.rb', line 486

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

#fullpathObject



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

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

#fullpath!Object



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

def fullpath! ; append_slash fullpath ; end

#grep(re, color = nil) ⇒ Object



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

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



517
518
519
# File 'lib/rbfind.rb', line 517

def group
  get_group stat.gid
end

#group!Object



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

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

#hidden?Boolean

Returns:

  • (Boolean)


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

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

#linesObject

:call-seq:

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

Yield line by line together with the line number i.



630
631
632
633
634
635
636
637
638
639
640
641
642
643
# File 'lib/rbfind.rb', line 630

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

#mageObject Also known as: age



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

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

#modeObject



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

def mode ; stat.mode ; end

#novcsObject Also known as: no_vcs



697
698
699
# File 'lib/rbfind.rb', line 697

def novcs
  prune if vcs?
end

#nowObject



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

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.



594
595
596
597
598
599
# File 'lib/rbfind.rb', line 594

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



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

def path!     ; append_slash path     ; end

#pruneObject Also known as: prune!

Raises:



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

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.



609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
# File 'lib/rbfind.rb', line 609

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


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

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

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



706
707
708
709
710
711
712
713
714
715
# File 'lib/rbfind.rb', line 706

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



718
719
720
721
722
723
724
725
726
# File 'lib/rbfind.rb', line 718

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

#rstatObject



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

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

#statObject



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

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

#symlink?Boolean

Returns:

  • (Boolean)


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

def symlink? ; stat.symlink? ; end

#userObject Also known as: owner



506
507
508
# File 'lib/rbfind.rb', line 506

def user
  get_user stat.uid
end

#user!Object Also known as: owner!



511
512
513
514
# File 'lib/rbfind.rb', line 511

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

#vcs?Boolean

Returns:

  • (Boolean)


583
584
585
# File 'lib/rbfind.rb', line 583

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

#vimswap?Boolean

Returns:

  • (Boolean)


682
683
684
685
686
687
# File 'lib/rbfind.rb', line 682

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

#visible?Boolean

Returns:

  • (Boolean)


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

def visible? ; not hidden?   ; end

#without_extObject



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

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