recls-ruby 2.11.0 → 2.11.0.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (43) hide show
  1. checksums.yaml +5 -5
  2. data/LICENSE +27 -24
  3. data/README.md +242 -1
  4. data/examples/find_files_and_directories.md +33 -30
  5. data/examples/find_files_and_directories.recursive.md +255 -254
  6. data/examples/show_hidden_files.md +4 -1
  7. data/examples/show_hidden_files.rb +1 -1
  8. data/examples/show_readonly_files.md +4 -1
  9. data/examples/show_readonly_files.rb +1 -1
  10. data/lib/recls/api.rb +76 -73
  11. data/lib/recls/combine_paths_1.rb +26 -23
  12. data/lib/recls/combine_paths_2plus.rb +32 -29
  13. data/lib/recls/entry.rb +277 -273
  14. data/lib/recls/file_search.rb +194 -193
  15. data/lib/recls/flags.rb +47 -45
  16. data/lib/recls/foreach.rb +105 -98
  17. data/lib/recls/obsolete.rb +80 -79
  18. data/lib/recls/recls.rb +16 -15
  19. data/lib/recls/stat.rb +137 -134
  20. data/lib/recls/util.rb +95 -92
  21. data/lib/recls/version.rb +18 -17
  22. data/lib/recls/ximpl/os.rb +45 -43
  23. data/lib/recls/ximpl/unix.rb +38 -35
  24. data/lib/recls/ximpl/util.rb +597 -596
  25. data/lib/recls/ximpl/windows.rb +139 -136
  26. data/lib/recls.rb +10 -9
  27. data/test/scratch/test_display_parts.rb +33 -33
  28. data/test/scratch/test_entry.rb +6 -6
  29. data/test/scratch/test_files_and_directories.rb +8 -8
  30. data/test/scratch/test_foreach.rb +10 -10
  31. data/test/scratch/test_module_function.rb +33 -33
  32. data/test/scratch/test_pattern_arrays.rb +5 -5
  33. data/test/scratch/test_show_dev_and_ino.rb +1 -1
  34. data/test/scratch/test_show_hidden.rb +3 -3
  35. data/test/unit/tc_recls_entries.rb +31 -31
  36. data/test/unit/tc_recls_entry.rb +19 -19
  37. data/test/unit/tc_recls_file_search.rb +32 -32
  38. data/test/unit/tc_recls_module.rb +25 -25
  39. data/test/unit/tc_recls_util.rb +161 -161
  40. data/test/unit/tc_recls_ximpl_util.rb +676 -676
  41. data/test/unit/test_all_separately.sh +1 -1
  42. data/test/unit/ts_all.rb +4 -4
  43. metadata +6 -6
data/lib/recls/ximpl/os.rb CHANGED
@@ -1,14 +1,15 @@
1
- # ######################################################################### #
2
- # File: recls/ximpl/os.rb
1
+ # ######################################################################## #
2
+ # File: recls/ximpl/os.rb
3
3
  #
4
- # Purpose: Operating system internal implementation constructs for the
5
- # recls library.
4
+ # Purpose: Operating system internal implementation constructs for the
5
+ # recls library.
6
6
  #
7
- # Created: 16th February 2014
8
- # Updated: 14th April 2019
7
+ # Created: 16th February 2014
8
+ # Updated: 20th April 2024
9
9
  #
10
- # Author: Matthew Wilson
10
+ # Author: Matthew Wilson
11
11
  #
12
+ # Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
12
13
  # Copyright (c) 2012-2019, Matthew Wilson and Synesis Software
13
14
  # All rights reserved.
14
15
  #
@@ -34,7 +35,7 @@
34
35
  # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35
36
  # POSSIBILITY OF SUCH DAMAGE.
36
37
  #
37
- # ######################################################################### #
38
+ # ######################################################################## #
38
39
 
39
40
 
40
41
  =begin
@@ -44,56 +45,57 @@ module Recls # :nodoc:
44
45
 
45
46
  # :stopdoc:
46
47
 
47
- module Ximpl # :nodoc: all
48
+ module Ximpl # :nodoc: all
48
49
 
49
- module OS # :nodoc: all
50
+ module OS # :nodoc: all
50
51
 
51
- # @!visibility private
52
- OS_IS_WINDOWS = (RUBY_PLATFORM =~ /(mswin|mingw|bccwin|wince)/i) ? true : false
52
+ # @!visibility private
53
+ OS_IS_WINDOWS = (RUBY_PLATFORM =~ /(mswin|mingw|bccwin|wince)/i) ? true : false
53
54
 
54
- # @!visibility private
55
- PATH_NAME_SEPARATOR = OS_IS_WINDOWS ? '\\' : '/'
55
+ # @!visibility private
56
+ PATH_NAME_SEPARATOR = OS_IS_WINDOWS ? '\\' : '/'
56
57
 
57
- # @!visibility private
58
- PATH_SEPARATOR = OS_IS_WINDOWS ? ';' : ':'
58
+ # @!visibility private
59
+ PATH_SEPARATOR = OS_IS_WINDOWS ? ';' : ':'
59
60
 
60
- # @!visibility private
61
- WILDCARDS_ALL = OS_IS_WINDOWS ? '*' : '*'
61
+ # @!visibility private
62
+ WILDCARDS_ALL = OS_IS_WINDOWS ? '*' : '*'
62
63
 
63
- # @!visibility private
64
- def OS.get_number_of_dots_dir_(p) # :nodoc:
64
+ # @!visibility private
65
+ def OS.get_number_of_dots_dir_(p) # :nodoc:
65
66
 
66
- if p
67
- if ?. == p[0]
68
- return 1 if 1 == p.size
69
- return 1 if ?/ == p[1]
70
- return 1 if OS_IS_WINDOWS and ?\\ == p[1]
71
- if ?. == p[1]
72
- return 2 if 2 == p.size
73
- return 2 if ?/ == p[2]
74
- return 2 if OS_IS_WINDOWS and ?\\ == p[2]
75
- end
76
- end
77
- end
67
+ if p
68
+ if ?. == p[0]
69
+ return 1 if 1 == p.size
70
+ return 1 if ?/ == p[1]
71
+ return 1 if OS_IS_WINDOWS and ?\\ == p[1]
72
+ if ?. == p[1]
73
+ return 2 if 2 == p.size
74
+ return 2 if ?/ == p[2]
75
+ return 2 if OS_IS_WINDOWS and ?\\ == p[2]
76
+ end
77
+ end
78
+ end
78
79
 
79
- return 0
80
- end
80
+ return 0
81
+ end
81
82
 
82
- # @!visibility private
83
- def OS.is_root_dir_(p) # :nodoc:
83
+ # @!visibility private
84
+ def OS.is_root_dir_(p) # :nodoc:
84
85
 
85
- return nil if not p
86
- return true if '/' == p
87
- return true if OS_IS_WINDOWS and '\\' == p
86
+ return nil if not p
87
+ return true if '/' == p
88
+ return true if OS_IS_WINDOWS and '\\' == p
88
89
 
89
- return false
90
- end
91
- end # module OS
92
- end # module Ximpl
90
+ return false
91
+ end
92
+ end # module OS
93
+ end # module Ximpl
93
94
 
94
95
  # :startdoc:
95
96
 
96
97
  end # module Recls
97
98
 
99
+
98
100
  # ############################## end of file ############################# #
99
101
 
data/lib/recls/ximpl/unix.rb CHANGED
@@ -1,13 +1,14 @@
1
- # ######################################################################### #
2
- # File: recls/ximpl/unix.rb
1
+ # ######################################################################## #
2
+ # File: recls/ximpl/unix.rb
3
3
  #
4
- # Purpose: UNIX-specific constructs for the recls library.
4
+ # Purpose: UNIX-specific constructs for the recls library.
5
5
  #
6
- # Created: 19th February 2014
7
- # Updated: 14th April 2019
6
+ # Created: 19th February 2014
7
+ # Updated: 20th April 2024
8
8
  #
9
- # Author: Matthew Wilson
9
+ # Author: Matthew Wilson
10
10
  #
11
+ # Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
11
12
  # Copyright (c) 2012-2019, Matthew Wilson and Synesis Software
12
13
  # All rights reserved.
13
14
  #
@@ -33,11 +34,12 @@
33
34
  # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34
35
  # POSSIBILITY OF SUCH DAMAGE.
35
36
  #
36
- # ######################################################################### #
37
+ # ######################################################################## #
37
38
 
38
39
 
39
40
  require 'recls/ximpl/util'
40
41
 
42
+
41
43
  =begin
42
44
  =end
43
45
 
@@ -45,50 +47,51 @@ module Recls # :nodoc:
45
47
 
46
48
  # :stopdoc:
47
49
 
48
- module Ximpl # :nodoc: all
50
+ module Ximpl # :nodoc: all
49
51
 
50
- # @!visibility private
51
- class FileStat < File::Stat # :nodoc:
52
+ # @!visibility private
53
+ class FileStat < File::Stat # :nodoc:
52
54
 
53
- private
54
- # @!visibility private
55
- def initialize(path) # :nodoc:
55
+ private
56
+ # @!visibility private
57
+ def initialize(path) # :nodoc:
56
58
 
57
- @path = path
59
+ @path = path
58
60
 
59
- super(path)
60
- end
61
+ super(path)
62
+ end
61
63
 
62
- public
63
- # @!visibility private
64
- attr_reader :path # :nodoc:
64
+ public
65
+ # @!visibility private
66
+ attr_reader :path # :nodoc:
65
67
 
66
- # @!visibility private
67
- def hidden? # :nodoc:
68
+ # @!visibility private
69
+ def hidden? # :nodoc:
68
70
 
69
- basename = File.basename @path
71
+ basename = File.basename @path
70
72
 
71
- return false if basename.empty?
72
- return false if '.' == basename
73
- return false if '..' == basename
74
- return false if ?. != basename[0]
73
+ return false if basename.empty?
74
+ return false if '.' == basename
75
+ return false if '..' == basename
76
+ return false if ?. != basename[0]
75
77
 
76
- return true
77
- end
78
+ return true
79
+ end
78
80
 
79
- public
80
- # @!visibility private
81
- def FileStat.stat(path) # :nodoc:
81
+ public
82
+ # @!visibility private
83
+ def FileStat.stat(path) # :nodoc:
82
84
 
83
- Recls::Ximpl::FileStat.new(path)
85
+ Recls::Ximpl::FileStat.new(path)
84
86
 
85
- end
86
- end # class FileStat
87
- end # module Ximpl
87
+ end
88
+ end # class FileStat
89
+ end # module Ximpl
88
90
 
89
91
  # :startdoc:
90
92
 
91
93
  end # module Recls
92
94
 
95
+
93
96
  # ############################## end of file ############################# #
94
97