ruby-changes:72096
From: Burdette <ko1@a...>
Date: Wed, 8 Jun 2022 21:35:16 +0900 (JST)
Subject: [ruby-changes:72096] a07acbe417 (master): [ruby/fileutils] File trees (https://github.com/ruby/fileutils/pull/80)
https://git.ruby-lang.org/ruby.git/commit/?id=a07acbe417 From a07acbe417fe0e24e3bdbcfadeb678e1cb9c6f9d Mon Sep 17 00:00:00 2001 From: Burdette Lamar <BurdetteLamar@Y...> Date: Wed, 8 Jun 2022 07:34:47 -0500 Subject: [ruby/fileutils] File trees (https://github.com/ruby/fileutils/pull/80) Adds a note about file tree examples. https://github.com/ruby/fileutils/commit/65ac65067a --- lib/fileutils.rb | 46 +++++++++++++++++++++++++++++++++++++++------- 1 file changed, 39 insertions(+), 7 deletions(-) diff --git a/lib/fileutils.rb b/lib/fileutils.rb index cbf7f526c6..f4171548ca 100644 --- a/lib/fileutils.rb +++ b/lib/fileutils.rb @@ -18,6 +18,38 @@ end https://github.com/ruby/ruby/blob/trunk/lib/fileutils.rb#L18 # # Namespace for several file utility methods for copying, moving, removing, etc. # +# == About the Examples +# +# Some examples here involve trees of file entries. +# For these, we sometimes display trees using the +# {tree command-line utility}[https://en.wikipedia.org/wiki/Tree_(command)], +# which is a recursive directory-listing utility that produces +# a depth-indented listing of files and directories. +# +# We use a helper method to launch the command and control the format: +# +# def tree(dirpath = '.') +# command = "tree --noreport --charset=ascii #{dirpath}" +# system(command) +# end +# +# To illustrate, here's the tree for the test directory for \FileUtils: +# tree('test') +# test +# |-- fileutils +# | |-- clobber.rb +# | |-- fileasserts.rb +# | |-- test_dryrun.rb +# | |-- test_fileutils.rb +# | |-- test_nowrite.rb +# | |-- test_verbose.rb +# | `-- visibility_tests.rb +# `-- lib +# |-- core_assertions.rb +# |-- envutil.rb +# |-- find_executable.rb +# `-- helper.rb +# # === Module Functions # # require 'fileutils' @@ -839,7 +871,7 @@ module FileUtils https://github.com/ruby/ruby/blob/trunk/lib/fileutils.rb#L871 # # If +src+ is a directory, recursively copies +src+ to +dest+: # - # system('tree --charset=ascii src1') + # tree('src1') # src1 # |-- dir0 # | |-- src0.txt @@ -848,7 +880,7 @@ module FileUtils https://github.com/ruby/ruby/blob/trunk/lib/fileutils.rb#L880 # |-- src2.txt # `-- src3.txt # FileUtils.copy_entry('src1', 'dest1') - # system('tree --charset=ascii dest1') + # tree('dest1') # dest1 # |-- dir0 # | |-- src0.txt @@ -923,14 +955,14 @@ module FileUtils https://github.com/ruby/ruby/blob/trunk/lib/fileutils.rb#L955 # If +src+ is the path to a single file or directory and +dest+ does not exist, # moves +src+ to +dest+: # - # system('tree --charset=ascii src0') + # tree('src0') # src0 # |-- src0.txt # `-- src1.txt # File.exist?('dest0') # => false # FileUtils.mv('src0', 'dest0') # File.exist?('src0') # => false - # system('tree --charset=ascii dest0') + # tree('dest0') # dest0 # |-- src0.txt # `-- src1.txt @@ -940,13 +972,13 @@ module FileUtils https://github.com/ruby/ruby/blob/trunk/lib/fileutils.rb#L972 # copies from each path in the array to +dest+: # # File.file?('src1.txt') # => true - # system('tree --charset=ascii src1') + # tree('src1') # src1 # |-- src.dat # `-- src.txt # Dir.empty?('dest1') # => true # FileUtils.mv(['src1.txt', 'src1'], 'dest1') - # system('tree --charset=ascii dest1') + # tree('dest1') # dest1 # |-- src1 # | |-- src.dat @@ -1076,7 +1108,7 @@ module FileUtils https://github.com/ruby/ruby/blob/trunk/lib/fileutils.rb#L1108 # # For each directory path, recursively removes files and directories: # - # system('tree --charset=ascii src1') + # tree('src1') # src1 # |-- dir0 # | |-- src0.txt -- cgit v1.2.1 -- ML: ruby-changes@q... Info: http://www.atdot.net/~ko1/quickml/