Class | File
In: | ftools.rb
Parent: | Object

When you

      require 'ftools'

then the File class aquires some utility methods for copying, moving, and deleting files, and more.

See the method descriptions below, and consider using `fileutils` as it is more comprehensive.

### Methods

catname chmod compare copy install makedirs move safe_unlink syscopy

### Constants

BUFSIZE | = | 8 * 1024

### External Aliases

copy | -> | cp
move | -> | mv
compare | -> | cmp
safe_unlink | -> | rm_f
makedirs | -> | mkpath
chmod | -> | o_chmod

### Public Class methods

catname(from, to)

If `to` is a valid directory, `from` will be appended to `to`, adding and escaping backslashes as necessary. Otherwise, `to` will be returned. Useful for appending `from` to `to` only if the filename was not specified in `to`.

[Source]

    # File ftools.rb, line 47
      def catname(from, to)
        if directory? to
          join to.sub(%r([/\\]$), ''), basename(from)
        else
          to
        end
      end

chmod(mode, *files)

Changes permission bits on `files` to the bit pattern represented by `mode`. If the last parameter isn’t a String, verbose mode will be enabled.

      File.chmod 0755, 'somecommand'
      File.chmod 0644, 'my.rb', 'your.rb', true

[Source]

    # File ftools.rb, line 240
      def chmod(mode, *files)
        verbose = if files[-1].is_a? String then false else files.pop end
        $stderr.printf "chmod %04o %s\n", mode, files.join(" ") if verbose
        o_chmod mode, *files
      end

compare(from, to, verbose = false)

Returns `true` iff the contents of files `from` and `to` are identical. If `verbose` is `true`, `from <=> to` is printed.

[Source]

    # File ftools.rb, line 133
      def compare(from, to, verbose = false)
        $stderr.print from, " <=> ", to, "\n" if verbose

        return false if stat(from).size != stat(to).size

        from = open(from, "rb")
        to = open(to, "rb")

        ret = false
        fr = tr = ''

        begin
          while fr == tr
            fr = from.read(BUFSIZE)
            if fr
              tr = to.read(fr.size)
            else
              ret = to.read(BUFSIZE)
              ret = !ret || ret.length == 0
              break
            end
          end
        rescue
          ret = false
        ensure
          to.close
          from.close
        end
        ret
      end

copy(from, to, verbose = false)

Copies a file `from` to `to` using syscopy. If `to` is a directory, copies `from` to `to/from`. If `verbose` is true, `from -> to` is printed.

[Source]

    # File ftools.rb, line 90
      def copy(from, to, verbose = false)
        $stderr.print from, " -> ", catname(from, to), "\n" if verbose
        syscopy from, to
      end

install(from, to, mode = nil, verbose = false)

If `src` is not the same as `dest`, copies it and changes the permission mode to `mode`. If `dest` is a directory, destination is `dest/src`. If `mode` is not set, default is used. If `verbose` is set to true, the name of each file copied will be printed.

[Source]

    # File ftools.rb, line 253
      def install(from, to, mode = nil, verbose = false)
        to = catname(from, to)
        unless exist? to and cmp from, to
          safe_unlink to if exist? to
          cp from, to, verbose
          chmod mode, to, verbose if mode
        end
      end

makedirs(*dirs)

Creates a directory and all its parent directories. For example,

        File.makedirs '/usr/lib/ruby'

causes the following directories to be made, if they do not exist.

        * /usr
        * /usr/lib
        * /usr/lib/ruby

You can pass several directories, each as a parameter. If the last parameter isn’t a String, verbose mode will be enabled.

[Source]

    # File ftools.rb, line 208
      def makedirs(*dirs)
        verbose = if dirs[-1].is_a? String then false else dirs.pop end
        mode = 0755
        for dir in dirs
          parent = dirname(dir)
          next if parent == dir or directory? dir
          makedirs parent unless directory? parent
          $stderr.print "mkdir ", dir, "\n" if verbose
          if basename(dir) != ""
            begin
              Dir.mkdir dir, mode
            rescue SystemCallError
              raise unless directory? dir
            end
          end
        end
      end

move(from, to, verbose = false)

Moves a file `from` to `to` using syscopy. If `to` is a directory, copies from `from` to `to/from`. If `verbose` is true, `from -> to` is printed.

[Source]

    # File ftools.rb, line 102
      def move(from, to, verbose = false)
        to = catname(from, to)
        $stderr.print from, " -> ", to, "\n" if verbose

        if RUBY_PLATFORM =~ /djgpp|(cyg|ms|bcc)win|mingw/ and file? to
          unlink to
        end
        fstat = stat(from)
        begin
          rename from, to
        rescue
          begin
            symlink readlink(from), to and unlink from
          rescue
            from_stat = stat(from)
            syscopy from, to and unlink from
            utime(from_stat.atime, from_stat.mtime, to)
            begin
              chown(fstat.uid, fstat.gid, to)
            rescue
            end
          end
        end
      end

safe_unlink(*files)

Removes a list of files. Each parameter should be the name of the file to delete. If the last parameter isn’t a String, verbose mode will be enabled. Returns the number of files deleted.

[Source]

    # File ftools.rb, line 171
      def safe_unlink(*files)
        verbose = if files[-1].is_a? String then false else files.pop end
        files.each do |file|
          begin
            unlink file
            $stderr.print "removing ", file, "\n" if verbose
          rescue Errno::EACCES # for Windows
            continue if symlink? file
            begin
              mode = stat(file).mode
              o_chmod mode | 0200, file
              unlink file
              $stderr.print "removing ", file, "\n" if verbose
            rescue
              o_chmod mode, file rescue nil
            end
          rescue
          end
        end
      end

syscopy(from, to)

Copies a file `from` to `to`. If `to` is a directory, copies `from` to `to/from`.

[Source]

    # File ftools.rb, line 59
      def syscopy(from, to)
        to = catname(from, to)

        fmode = stat(from).mode
        tpath = to
        not_exist = !exist?(tpath)

        from = open(from, "rb")
        to = open(to, "wb")

        begin
          while true
            to.syswrite from.sysread(BUFSIZE)
          end
        rescue EOFError
          ret = true
        rescue
          ret = false
        ensure
          to.close
          from.close
        end
        chmod(fmode, tpath) if not_exist
        ret
      end

[Validate]