Ruby 2.4

FileUtils

module FileUtils

Included modules:FileUtils::StreamUtils_

fileutils.rb

这个程序是免费软件。您可以按照ruby的相同条款分发/修改此程序。

module FileUtils

用于复制,移动,删除等几种文件实用程序方法的命名空间

模块功能

require 'fileutils' FileUtils.cd(dir, options) FileUtils.cd(dir, options) {|dir| block } FileUtils.pwd() FileUtils.mkdir(dir, options) FileUtils.mkdir(list, options) FileUtils.mkdir_p(dir, options) FileUtils.mkdir_p(list, options) FileUtils.rmdir(dir, options) FileUtils.rmdir(list, options) FileUtils.ln(target, link, options) FileUtils.ln(targets, dir, options) FileUtils.ln_s(target, link, options) FileUtils.ln_s(targets, dir, options) FileUtils.ln_sf(target, link, options) FileUtils.cp(src, dest, options) FileUtils.cp(list, dir, options) FileUtils.cp_r(src, dest, options) FileUtils.cp_r(list, dir, options) FileUtils.mv(src, dest, options) FileUtils.mv(list, dir, options) FileUtils.rm(list, options) FileUtils.rm_r(list, options) FileUtils.rm_rf(list, options) FileUtils.install(src, dest, options) FileUtils.chmod(mode, list, options) FileUtils.chmod_R(mode, list, options) FileUtils.chown(user, group, list, options) FileUtils.chown_R(user, group, list, options) FileUtils.touch(list, options)

options参数是一个hash选项,从列表中取:force:noop:preserve,和:verbose:noop意味着不做任何更改。其他三个是显而易见的。每种方法都会记录它所授予的选项。

所有具有“source”文件或目录概念的方法都可以采用该参数中的一个文件或文件列表。有关示例,请参阅方法文档。

有一些“低级”方法,它们不接受任何选项:

FileUtils.copy_entry(src, dest, preserve = false, dereference = false) FileUtils.copy_file(src, dest, preserve = false, dereference = true) FileUtils.copy_stream(srcstream, deststream) FileUtils.remove_entry(path, force = false) FileUtils.remove_entry_secure(path, force = false) FileUtils.remove_file(path, force = false) FileUtils.compare_file(path_a, path_b) FileUtils.compare_stream(stream_a, stream_b) FileUtils.uptodate?(file, cmp_list)

module FileUtils::Verbose

此模块具有FileUtils模块的所有方法,但在执行操作之前会输出消息。这等同于将:verbose标志传递给FileUtils中的方法。

module FileUtils::NoWrite

此模块具有FileUtils模块的所有方法,但不会更改文件/目录。这等同于将:noop标志传递给FileUtils中的方法。

module FileUtils::DryRun

此模块具有FileUtils模块的所有方法,但不会更改文件/目录。这相当于将文件:noop:verbose标志传递给FileUtils中的方法。

常量

LOW_METHODS METHODS

Public Class Methods

cd(dir, verbose: nil) { |dir| ... } Show source

将当前目录更改为目录dir

如果使用块调用此方法,则在块执行完成后,恢复到旧的工作目录。

FileUtils.cd('/', :verbose => true) # chdir and report it FileUtils.cd('/') do # chdir # ... # do something end # return to original directory

# File lib/fileutils.rb, line 117 def cd(dir, verbose: nil, &block) # :yield: dir fu_output_message "cd #{dir}" if verbose Dir.chdir(dir, &block) fu_output_message 'cd -' if verbose and block end

Also aliased as: chdir

chdir(dir, verbose: nil)

Alias for: cd

chmod(mode, list, noop: nil, verbose: nil) Show source

将指定文件(in list)中的权限位更改为由表示的位模式mode

mode 是可以使用的符号和绝对模式。

绝对模式是

FileUtils.chmod 0755, 'somecommand' FileUtils.chmod 0644, %w(my.rb your.rb his.rb her.rb) FileUtils.chmod 0755, '/usr/bin/ruby', :verbose => true

符号模式是

FileUtils.chmod "u=wrx,go=rx", 'somecommand' FileUtils.chmod "u=wr,go=rr", %w(my.rb your.rb his.rb her.rb) FileUtils.chmod "u=wrx,go=rx", '/usr/bin/ruby', :verbose => true

“a”

是user,group,other mask。

“u”

是用户的mask。

“g”

是组的mask。

“o”

是other的mask。

“w”

是写入权限。

“r”

是读取权限。

“x”

是执行权限。

“X”

仅对目录执行权限,必须与“+”一起使用

“s”

是uid,gid。

“t”

是sticky bit。

“+”

被添加到给定指定模式的类中。

“-”

从给定的类给定模式中删除。

“=”

这个类别的确切性质是否会被赋予一个特定的模式。

# File lib/fileutils.rb, line 912 def chmod(mode, list, noop: nil, verbose: nil) list = fu_list(list) fu_output_message sprintf('chmod %s %s', mode_to_s(mode), list.join(' ')) if verbose return if noop list.each do |path| Entry_.new(path).chmod(fu_mode(mode, path)) end end

chmod_R(mode, list, noop: nil, verbose: nil, force: nil) Show source

将指定文件(in list)中的权限位更改为由表示的位模式mode

FileUtils.chmod_R 0700, "/tmp/app.#{$$}" FileUtils.chmod_R "u=wrx", "/tmp/app.#{$$}"

# File lib/fileutils.rb, line 929 def chmod_R(mode, list, noop: nil, verbose: nil, force: nil) list = fu_list(list) fu_output_message sprintf('chmod -R%s %s %s', (force ? 'f' : ''), mode_to_s(mode), list.join(' ')) if verbose return if noop list.each do |root| Entry_.new(root).traverse do |ent| begin ent.chmod(fu_mode(mode, ent.path)) rescue raise unless force end end end end

chown(user, group, list, noop: nil, verbose: nil) Show source

将指定文件的所有者和组(更改list)更改为用户user和组groupuser并且group可以是ID(整数/字符串)或名称(字符串)。如果user或者group为零,则此方法不会更改该属性。

FileUtils.chown 'root', 'staff', '/usr/local/bin/ruby' FileUtils.chown nil, 'bin', Dir.glob('/usr/bin/*'), :verbose => true

# File lib/fileutils.rb, line 957 def chown(user, group, list, noop: nil, verbose: nil) list = fu_list(list) fu_output_message sprintf('chown %s %s', (group ? "#{user}:#{group}" : user || ':'), list.join(' ')) if verbose return if noop uid = fu_get_uid(user) gid = fu_get_gid(group) list.each do |path| Entry_.new(path).chown uid, gid end end

chown_R(user, group, list, noop: nil, verbose: nil, force: nil) Show source

将指定文件的所有者和组更改为(递归list)用户user和组groupuser并且group可以是ID(整数/字符串)或名称(字符串)。如果user或者group为零,则此方法不会更改该属性。

FileUtils.chown_R 'www', 'www', '/var/www/htdocs' FileUtils.chown_R 'cvs', 'cvs', '/var/cvs', :verbose => true

# File lib/fileutils.rb, line 981 def chown_R(user, group, list, noop: nil, verbose: nil, force: nil) list = fu_list(list) fu_output_message sprintf('chown -R%s %s %s', (force ? 'f' : ''), (group ? "#{user}:#{group}" : user || ':'), list.join(' ')) if verbose return if noop uid = fu_get_uid(user) gid = fu_get_gid(group) list.each do |root| Entry_.new(root).traverse do |ent| begin ent.chown uid, gid rescue raise unless force end end end end

cmp(a, b)

Alias for: compare_file

compare_file(a, b) Show source

如果文件A和文件B的内容相同,则返回true。

FileUtils.compare_file('somefile', 'somefile') #=> true FileUtils.compare_file('/bin/cp', '/bin/mv') #=> maybe false

# File lib/fileutils.rb, line 723 def compare_file(a, b) return false unless File.size(a) == File.size(b) File.open(a, 'rb') {|fa| File.open(b, 'rb') {|fb| return compare_stream(fa, fb) } } end

另外别名为:相同?, cmp

compare_stream(a,b)显示源文件

如果流的内容相同ab则返回true 。

# File lib/fileutils.rb, line 741 def compare_stream(a, b) bsize = fu_stream_blksize(a, b) sa = "" sb = "" begin a.read(bsize, sa) b.read(bsize, sb) return true if sa.empty? && sb.empty? end while sa == sb false end

copy(src, dest, preserve: nil, noop: nil, verbose: nil)

Alias for: cp

copy_entry(src,dest,preserve = false,dereference_root = false,remove_destination = false)显示源代码

将文件系统条目复制srcdest。如果src是目录,则此方法递归复制其内容。此方法保留文件类型,比如符号链接,目录...(FIFO,设备文件等尚不受支持)

srcdest必须为路径名。src必须存在,dest不得存在。

如果preserve属实,则此方法将保留所有者,组和修改时间。无论权限是否被复制preserve

如果dereference_root为true,则此方法解引用tree root。

如果remove_destination为true,则此方法在复制之前删除每个目标文件。

# File lib/fileutils.rb, line 410 def copy_entry(src, dest, preserve = false, dereference_root = false, remove_destination = false) Entry_.new(src, nil, dereference_root).wrap_traverse(proc do |ent| destent = Entry_.new(dest, ent.rel, false) File.unlink destent.path if remove_destination && File.file?(destent.path) ent.copy destent.path end, proc do |ent| destent = Entry_.new(dest, ent.rel, false) ent.copy_metadata destent.path if preserve end) end

copy_file(src,dest,preserve = false,dereference = true)显示源文件

复制文件的内容srcdest。两者的srcdest必须的路径名。

# File lib/fileutils.rb, line 426 def copy_file(src, dest, preserve = false, dereference = true) ent = Entry_.new(src, nil, dereference) ent.copy_file dest ent.copy_metadata dest if preserve end

copy_stream(src,dest)显示源文件

将流复制srcdestsrc必须响应读取(n)并且dest必须响应写入(str)。

# File lib/fileutils.rb, line 438 def copy_stream(src, dest) IO.copy_stream(src, dest) end

cp(src,dest,preserve:nil,noop:nil,verbose:nil)显示源文件

将文件内容复制srcdest。如果dest是目录,则复制srcdest/src

如果src是文件列表,则dest必须是目录。

FileUtils.cp 'eval.c', 'eval.c.org' FileUtils.cp %w(cgi.rb complex.rb date.rb), '/usr/lib/ruby/1.6' FileUtils.cp %w(cgi.rb complex.rb date.rb), '/usr/lib/ruby/1.6', :verbose => true FileUtils.cp 'symlink', 'dest' # copy content, "dest" is not a symlink

# File lib/fileutils.rb, line 351 def cp(src, dest, preserve: nil, noop: nil, verbose: nil) fu_output_message "cp#{preserve ? ' -p' : ''} #{[src,dest].flatten.join ' '}" if verbose return if noop fu_each_src_dest(src, dest) do |s, d| copy_file s, d, preserve end end

另外别名为:copy

cp_r(src,dest,preserve:nil,noop:nil,详细:nil,dereference_root:true,remove_destination:nil)显示源代码

复制srcdest。如果src是目录,则此方法将递归地复制其所有内容。如果dest是目录,则复制srcdest/src

src 可以是文件列表。

# Installing Ruby library "mylib" under the site_ruby FileUtils.rm_r site_ruby + '/mylib', :force FileUtils.cp_r 'lib/', site_ruby + '/mylib' # Examples of copying several files to target directory. FileUtils.cp_r %w(mail.rb field.rb debug/), site_ruby + '/tmail' FileUtils.cp_r Dir.glob('*.rb'), '/home/foo/lib/ruby', :noop => true, :verbose => true # If you want to copy all contents of a directory instead of the # directory itself, c.f. src/x -> dest/x, src/y -> dest/y, # use following code. FileUtils.cp_r 'src/.', 'dest' # cp_r('src', 'dest') makes dest/src, # but this doesn't.

# File lib/fileutils.rb, line 384 def cp_r(src, dest, preserve: nil, noop: nil, verbose: nil, dereference_root: true, remove_destination: nil) fu_output_message "cp -r#{preserve ? 'p' : ''}#{remove_destination ? ' --remove-destination' : ''} #{[src,dest].flatten.join ' '}" if verbose return if noop fu_each_src_dest(src, dest) do |s, d| copy_entry s, d, preserve, dereference_root, remove_destination end end

getwd()

别名为:pwd

identical?(a, b)

别名为:compare_file

install(src,dest,mode:nil,owner:nil,group:nil,preserve:nil,noop:nil,verbose:nil)显示源代码

如果srcdest不相同,则将其复制并将权限模式更改为mode。如果dest是目录,则目标是dest/ src。此方法在复制之前删除目标。

FileUtils.install 'ruby', '/usr/local/bin/ruby', :mode => 0755, :verbose => true FileUtils.install 'lib.rb', '/usr/local/lib/ruby/site_ruby', :verbose => true

# File lib/fileutils.rb, line 762 def install(src, dest, mode: nil, owner: nil, group: nil, preserve: nil, noop: nil, verbose: nil) if verbose msg = +"install -c" msg << ' -p' if preserve msg << ' -m ' << mode_to_s(mode) if mode msg << " -o #{owner}" if owner msg << " -g #{group}" if group msg << ' ' << [src,dest].flatten.join(' ') fu_output_message msg end return if noop uid = fu_get_uid(owner) gid = fu_get_gid(group) fu_each_src_dest(src, dest) do |s, d| st = File.stat(s) unless File.exist?(d) and compare_file(s, d) remove_file d, true copy_file s, d File.utime st.atime, st.mtime, d if preserve File.chmod fu_mode(mode, st), d if mode File.chown uid, gid, d if uid or gid end end end

link(src, dest, force: nil, noop: nil, verbose: nil)

别名为:ln

ln(target, link, force: nil, noop: nil, verbose: nil) 显示源

ln(target, dir, force: nil, noop: nil, verbose: nil)

ln(targets, dir, force: nil, noop: nil, verbose: nil)

在第一种形式,创建一个硬链接link指向target。如果link已经存在,则引发Errno::EEXIST。但是,如果设置:force选项,则会覆盖link

FileUtils.ln 'gcc', 'cc', verbose: true FileUtils.ln '/usr/bin/emacs21', '/usr/bin/emacs'

在第二种形式中,创建dir/target指向的链接target。在第三种形式中,在目录中创建几个硬链接dir,指向每个项目targets。如果dir不是目录,则引发Errno::ENOTDIR。

FileUtils.cd '/sbin' FileUtils.ln %w(cp mv mkdir), '/bin' # Now /sbin/cp and /bin/cp are linked.

# File lib/fileutils.rb, line 281 def ln(src, dest, force: nil, noop: nil, verbose: nil) fu_output_message "ln#{force ? ' -f' : ''} #{[src,dest].flatten.join ' '}" if verbose return if noop fu_each_src_dest0(src, dest) do |s,d| remove_file d, true if force File.link s, d end end

另外别名为:link

ln_s(target, link, force: nil, noop: nil, verbose: nil) Show source

ln_s(target, dir, force: nil, noop: nil, verbose: nil)

ln_s(targets, dir, force: nil, noop: nil, verbose: nil)

在第一种形式,创建了一个符号链接link指向target。如果link已经存在,则引发Errno::EEXIST。但是,如果设置:force选项,则会覆盖link

FileUtils.ln_s '/usr/bin/ruby', '/usr/local/bin/ruby' FileUtils.ln_s 'verylongsourcefilename.c', 'c', force: true

在第二种形式中,创建dir/target指向的链接target。在第三种形式中,在目录中创建几个符号链接dir,指向每个项目targets。如果dir不是目录,则引发Errno::ENOTDIR。

FileUtils.ln_s Dir.glob('/bin/*.rb'), '/home/foo/bin'

# File lib/fileutils.rb, line 314 def ln_s(src, dest, force: nil, noop: nil, verbose: nil) fu_output_message "ln -s#{force ? 'f' : ''} #{[src,dest].flatten.join ' '}" if verbose return if noop fu_each_src_dest0(src, dest) do |s,d| remove_file d, true if force File.symlink s, d end end

另外别名为:symlink

ln_sf(*args) Show source

与下列一样

FileUtils.ln_s(*args, force: true)

# File lib/fileutils.rb, line 335 def ln_sf(src, dest, noop: nil, verbose: nil) ln_s src, dest, force: true, noop: noop, verbose: verbose end

makedirs(list, mode: nil, noop: nil, verbose: nil)

别名为:mkdir_p

mkdir(list, mode: nil, noop: nil, verbose: nil) Show source

创建一个或多个目录。

FileUtils.mkdir 'test' FileUtils.mkdir %w( tmp data ) FileUtils.mkdir 'notexist', :noop => true # Does not really create. FileUtils.mkdir 'tmp', :mode => 0700

# File lib/fileutils.rb, line 159 def mkdir(list, mode: nil, noop: nil, verbose: nil) list = fu_list(list) fu_output_message "mkdir #{mode ? ('-m %03o ' % mode) : ''}#{list.join ' '}" if verbose return if noop list.each do |dir| fu_mkdir dir, mode end end

mkdir_p(list, mode: nil, noop: nil, verbose: nil) Show source

创建一个目录及其所有父目录。例如,

FileUtils.mkdir_p '/usr/local/lib/ruby'

导致以下目录,如果它不存在。

  • /usr

  • /usr/local

  • /usr/local/lib

  • /usr/local/lib/ruby

您可以一次在列表中传递多个目录。

# File lib/fileutils.rb, line 185 def mkdir_p(list, mode: nil, noop: nil, verbose: nil) list = fu_list(list) fu_output_message "mkdir -p #{mode ? ('-m %03o ' % mode) : ''}#{list.join ' '}" if verbose return *list if noop list.map {|path| remove_trailing_slash(path)}.each do |path| # optimize for the most common case begin fu_mkdir path, mode next rescue SystemCallError next if File.directory?(path) end stack = [] until path == stack.last # dirname("/")=="/", dirname("C:/")=="C:/" stack.push path path = File.dirname(path) end stack.reverse_each do |dir| begin fu_mkdir dir, mode rescue SystemCallError raise unless File.directory?(dir) end end end return *list end

还有别名:mkpath,makedirs

mkpath(list, mode: nil, noop: nil, verbose: nil)

别名为:mkdir_p

move(src, dest, force: nil, noop: nil, verbose: nil, secure: nil)

别名为:mv

mv(src, dest, force: nil, noop: nil, verbose: nil, secure: nil) Show source

将文件移动srcdest。如果filedest在不同的磁盘分区存在,则文件被复制,则原始文件被删除。

FileUtils.mv 'badname.rb', 'goodname.rb' FileUtils.mv 'stuff.rb', '/notexist/lib/ruby', :force => true # no error FileUtils.mv %w(junk.txt dust.txt), '/home/foo/.trash/' FileUtils.mv Dir.glob('test*.rb'), 'test', :noop => true, :verbose => true

# File lib/fileutils.rb, line 453 def mv(src, dest, force: nil, noop: nil, verbose: nil, secure: nil) fu_output_message "mv#{force ? ' -f' : ''} #{[src,dest].flatten.join ' '}" if verbose return if noop fu_each_src_dest(src, dest) do |s, d| destent = Entry_.new(d, nil, true) begin if destent.exist? if destent.directory? raise Errno::EEXIST, d else destent.remove_file if rename_cannot_overwrite_file? end end begin File.rename s, d rescue Errno::EXDEV copy_entry s, d, true if secure remove_entry_secure s, force else remove_entry s, force end end rescue SystemCallError raise unless force end end end

Also aliased as: move

pwd() Show source

返回当前目录的名称。

# File lib/fileutils.rb, line 97 def pwd Dir.pwd end

另外别名为:getwd

remove(list, force: nil, noop: nil, verbose: nil)

别名为:rm

remove_dir(path, force = false) Show source

dir递归删除一个目录及其内容。如果force为true,则此方法忽略StandardError 。

# File lib/fileutils.rb, line 712 def remove_dir(path, force = false) remove_entry path, force # FIXME?? check if it is a directory end

remove_entry(path, force = false) Show source

此方法删除文件系统条目pathpath可能是一个普通文件,一个目录或其他东西。如果path是目录,请递归删除。

另请参见remove_entry_secure。

# File lib/fileutils.rb, line 684 def remove_entry(path, force = false) Entry_.new(path).postorder_traverse do |ent| begin ent.remove rescue raise unless force end end rescue raise unless force end

remove_entry_secure(path,force = false)显示源文件

此方法删除文件系统条目pathpath应该是一个普通文件,一个目录或其他东西。如果path是目录,请递归删除它。需要此方法以避免rm_r的本地安全漏洞的TOCTTOU(检查时间到达时间)漏洞。在以下情况下rm_r会导致安全漏洞:

  • 父目录是世界可写的(包括/ tmp)。

  • 删除目录树包括世界可写目录。

  • 系统具有符号链接。为避免此安全漏洞,此方法采用特殊预处理。如果path是目录,则此方法chown(2)和chmod(2)全部删除目录。这要求当前进程是删除整个目录树的所有者,或者是超级用户(root)。

对于fileutils.rb,此漏洞在ruby-dev:26100中报告。

  • /usr

  • /usr/local

  • /usr/local/lib

  • /usr/local/lib/ruby

  • 父目录是世界可写的(包括/ tmp)。

  • 删除目录树包括世界可写目录。

  • 该系统具有符号链接。

为避免此安全漏洞,此方法应用特殊的预处理。如果path是目录,则此方法chown(2)和chmod(2)全部删除目录。这要求当前进程是删除整个目录树的所有者,或者是超级用户(root)。

警告:您必须确保所有父目录不能被其他不受信任的用户移动。例如,父目录不应该由不受信任的用户拥有,除非设置了粘滞位,否则不应该是世界可写的。

警告:只有删除目录树的所有者或Unix超级用户(root)才能调用此方法。否则,此方法不起作用。

有关此安全漏洞的详细信息,请参阅Perl的案例:

对于fileutils.rb,此漏洞在ruby-dev:26100中报告。

# File lib/fileutils.rb, line 607 def remove_entry_secure(path, force = false) unless fu_have_symlink? remove_entry path, force return end fullpath = File.expand_path(path) st = File.lstat(fullpath) unless st.directory? File.unlink fullpath return end # is a directory. parent_st = File.stat(File.dirname(fullpath)) unless parent_st.world_writable? remove_entry path, force return end unless parent_st.sticky? raise ArgumentError, "parent directory is world writable, FileUtils#remove_entry_secure does not work; abort: #{path.inspect} (parent directory mode #{'%o' % parent_st.mode})" end # freeze tree root euid = Process.euid File.open(fullpath + '/.') {|f| unless fu_stat_identical_entry?(st, f.stat) # symlink (TOC-to-TOU attack?) File.unlink fullpath return end f.chown euid, -1 f.chmod 0700 unless fu_stat_identical_entry?(st, File.lstat(fullpath)) # TOC-to-TOU attack? File.unlink fullpath return end } # ---- tree root is frozen ---- root = Entry_.new(path) root.preorder_traverse do |ent| if ent.directory? ent.chown euid, -1 ent.chmod 0700 end end root.postorder_traverse do |ent| begin ent.remove rescue raise unless force end end rescue raise unless force end

remove_file(path, force = false) Show source

删除文件path。如果force为true,则此方法忽略StandardError 。

# File lib/fileutils.rb, line 701 def remove_file(path, force = false) Entry_.new(path).remove_file rescue raise unless force end

rm(list, force: nil, noop: nil, verbose: nil) Show source

删除中指定的文件list。此方法无法删除目录。当设置了:force选项时,所有StandardErrors都会被忽略。

FileUtils.rm %w( junk.txt dust.txt ) FileUtils.rm Dir.glob('*.so') FileUtils.rm 'NotExistFile', :force => true # never raises exception

# File lib/fileutils.rb, line 499 def rm(list, force: nil, noop: nil, verbose: nil) list = fu_list(list) fu_output_message "rm#{force ? ' -f' : ''} #{list.join ' '}" if verbose return if noop list.each do |path| remove_file path, force end end

另外别名为:remove

rm_f(list, noop: nil, verbose: nil) Show source

相当于

FileUtils.rm(list, :force => true)

# File lib/fileutils.rb, line 518 def rm_f(list, noop: nil, verbose: nil) rm list, force: true, noop: noop, verbose: verbose end

另外别名为:safe_unlink

rm_r(list, force: nil, noop: nil, verbose: nil, secure: nil) Show source

删除文件list[0] list[1]...如果list[n]是目录,则递归删除其所有内容。当设置force选项时,此方法忽略StandardError。

FileUtils.rm_r Dir.glob('/tmp/*') FileUtils.rm_r 'some_dir', :force => true

警告:如果父目录或删除目录树中的一个是世界可写的(包括/ tmp,其权限为1777),并且当前进程具有强权限,如Unix超级用户(root),并且系统具有符号链接。为了安全移除,请仔细阅读remove_entry_secure文档,并将secure选项设置为true。缺省值是:secure => false。

注意:如果设置了secure选项,则此方法调用remove_entry_secure。另请参见remove_entry_secure。

# File lib/fileutils.rb, line 545 def rm_r(list, force: nil, noop: nil, verbose: nil, secure: nil) list = fu_list(list) fu_output_message "rm -r#{force ? 'f' : ''} #{list.join ' '}" if verbose return if noop list.each do |path| if secure remove_entry_secure path, force else remove_entry path, force end end end

rm_rf(list, noop: nil, verbose: nil, secure: nil) Show source

相当于

FileUtils.rm_r(list, :force => true)

警告:此方法会导致本地漏洞。首先阅读rm_r的文档。

# File lib/fileutils.rb, line 567 def rm_rf(list, noop: nil, verbose: nil, secure: nil) rm_r list, force: true, noop: noop, verbose: verbose, secure: secure end

另外别名为:rmtree

rmdir(list,parents:nil,noop:nil,verbose:nil)显示源文件

删除一个或多个目录。

FileUtils.rmdir 'somedir' FileUtils.rmdir %w(somedir anydir otherdir) # Does not really remove directory; outputs message. FileUtils.rmdir 'somedir', :verbose => true, :noop => true

# File lib/fileutils.rb, line 241 def rmdir(list, parents: nil, noop: nil, verbose: nil) list = fu_list(list) fu_output_message "rmdir #{parents ? '-p ' : ''}#{list.join ' '}" if verbose return if noop list.each do |dir| begin Dir.rmdir(dir = remove_trailing_slash(dir)) if parents until (parent = File.dirname(dir)) == '.' or parent == dir dir = parent Dir.rmdir(dir) end end rescue Errno::ENOTEMPTY, Errno::EEXIST, Errno::ENOENT end end end

rmtree(list, noop: nil, verbose: nil, secure: nil)

别名为:rm_rf

safe_unlink(list, noop: nil, verbose: nil)

别名为:rm_f

symlink(src, dest, force: nil, noop: nil, verbose: nil)

别名为:ln_s

touch(list,noop:nil,verbose:nil,mtime:nil,nocreate:nil)显示源代码

更新文件中的修改时间(mtime)和访问时间(atime)list。如果文件不存在,则会创建文件。

FileUtils.touch 'timestamp' FileUtils.touch Dir.glob('*.c' system 'make'

# File lib/fileutils.rb, line 1040 def touch(list, noop: nil, verbose: nil, mtime: nil, nocreate: nil) list = fu_list(list) t = mtime if verbose fu_output_message "touch #{nocreate ? '-c ' : ''}#{t ? t.strftime('-t %Y%m%d%H%M.%S ') : ''}#{list.join ' '}" end return if noop list.each do |path| created = nocreate begin File.utime(t, t, path) rescue Errno::ENOENT raise if created File.open(path, 'a') { ; } created = true retry if t end end end

uptodate?(new,old_list)显示源代码

如果new比全部更新,则返回true old_list。不存在的文件比任何文件都旧。

FileUtils.uptodate?('hello.o', %w(hello.c hello.h)) or system 'make hello.o'

# File lib/fileutils.rb, line 134 def uptodate?(new, old_list) return false unless File.exist?(new) new_time = File.mtime(new) old_list.each do |old| if File.exist?(old) return false unless new_time > File.mtime(old) end end true end