libpath-ruby 0.2.1 → 0.2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE +33 -0
  3. data/README.md +25 -8
  4. data/examples/path_from_arg0.md +43 -43
  5. data/examples/path_from_arg0.rb +25 -23
  6. data/lib/libpath/constants/unix.rb +71 -71
  7. data/lib/libpath/constants/windows.rb +72 -72
  8. data/lib/libpath/constants.rb +18 -19
  9. data/lib/libpath/diagnostics/parameter_checking.rb +25 -25
  10. data/lib/libpath/diagnostics.rb +1 -1
  11. data/lib/libpath/exceptions/libpath_base_exception.rb +13 -13
  12. data/lib/libpath/exceptions/malformed_name_exception.rb +23 -22
  13. data/lib/libpath/exceptions.rb +3 -3
  14. data/lib/libpath/form/unix.rb +104 -103
  15. data/lib/libpath/form/windows.rb +200 -199
  16. data/lib/libpath/form.rb +18 -18
  17. data/lib/libpath/internal_/array.rb +53 -53
  18. data/lib/libpath/internal_/platform.rb +24 -24
  19. data/lib/libpath/internal_/string.rb +20 -17
  20. data/lib/libpath/internal_/unix/form.rb +117 -112
  21. data/lib/libpath/internal_/windows/drive.rb +62 -59
  22. data/lib/libpath/internal_/windows/form.rb +193 -188
  23. data/lib/libpath/libpath.rb +3 -0
  24. data/lib/libpath/path/unix.rb +114 -112
  25. data/lib/libpath/path/windows.rb +120 -118
  26. data/lib/libpath/path.rb +18 -20
  27. data/lib/libpath/util/unix.rb +258 -258
  28. data/lib/libpath/util/windows.rb +400 -400
  29. data/lib/libpath/util.rb +18 -19
  30. data/lib/libpath/version.rb +23 -23
  31. data/lib/libpath.rb +1 -1
  32. data/test/performance/benchmark_drive_letter.rb +50 -10
  33. data/test/performance/benchmark_gsub_string_or_regex.rb +27 -23
  34. data/test/performance/benchmark_rindex2.rb +56 -48
  35. data/test/performance/benchmark_split.rb +16 -10
  36. data/test/unit/compare/ts_all.rb +4 -4
  37. data/test/unit/equate/ts_all.rb +4 -4
  38. data/test/unit/equate/unix/ts_all.rb +4 -4
  39. data/test/unit/equate/windows/ts_all.rb +4 -4
  40. data/test/unit/exceptions/tc_libpath_base_exception.rb +10 -8
  41. data/test/unit/exceptions/tc_malformed_name_exception.rb +14 -12
  42. data/test/unit/exceptions/ts_all.rb +4 -4
  43. data/test/unit/form/tc_absolute_functions.rb +242 -240
  44. data/test/unit/form/ts_all.rb +4 -4
  45. data/test/unit/form/unix/tc_absolute_functions.rb +158 -155
  46. data/test/unit/form/unix/ts_all.rb +4 -4
  47. data/test/unit/form/windows/tc_absolute_functions.rb +628 -625
  48. data/test/unit/form/windows/ts_all.rb +4 -4
  49. data/test/unit/internal_/tc_array.rb +36 -32
  50. data/test/unit/internal_/ts_all.rb +4 -4
  51. data/test/unit/internal_/unix/form/tc_slash_functions.rb +38 -35
  52. data/test/unit/internal_/unix/form/ts_all.rb +4 -4
  53. data/test/unit/internal_/unix/tc_split_path.rb +387 -384
  54. data/test/unit/internal_/unix/ts_all.rb +4 -4
  55. data/test/unit/internal_/windows/form/tc_get_windows_volume.rb +157 -153
  56. data/test/unit/internal_/windows/form/tc_slash_functions.rb +39 -35
  57. data/test/unit/internal_/windows/form/ts_all.rb +4 -4
  58. data/test/unit/internal_/windows/tc_split_path.rb +874 -869
  59. data/test/unit/internal_/windows/ts_all.rb +4 -4
  60. data/test/unit/parse/ts_all.rb +4 -4
  61. data/test/unit/path/tc_path.rb +732 -732
  62. data/test/unit/path/ts_all.rb +4 -4
  63. data/test/unit/path/unix/tc_path.rb +544 -540
  64. data/test/unit/path/unix/ts_all.rb +4 -4
  65. data/test/unit/path/windows/tc_path.rb +608 -603
  66. data/test/unit/path/windows/ts_all.rb +4 -4
  67. data/test/unit/tc_version.rb +25 -22
  68. data/test/unit/ts_all.rb +4 -4
  69. data/test/unit/util/tc_combine_paths.rb +110 -105
  70. data/test/unit/util/tc_derive_relative_path.rb +8 -3
  71. data/test/unit/util/tc_make_path_canonical.rb +142 -138
  72. data/test/unit/util/ts_all.rb +4 -4
  73. data/test/unit/util/unix/tc_combine_paths.rb +38 -34
  74. data/test/unit/util/unix/tc_derive_relative_path.rb +80 -75
  75. data/test/unit/util/unix/tc_make_path_absolute.rb +74 -70
  76. data/test/unit/util/unix/tc_make_path_canonical.rb +95 -90
  77. data/test/unit/util/unix/ts_all.rb +4 -4
  78. data/test/unit/util/windows/tc_combine_paths.rb +82 -77
  79. data/test/unit/util/windows/tc_derive_relative_path.rb +98 -93
  80. data/test/unit/util/windows/tc_make_path_absolute.rb +105 -101
  81. data/test/unit/util/windows/tc_make_path_canonical.rb +158 -153
  82. data/test/unit/util/windows/ts_all.rb +4 -4
  83. metadata +9 -8
data/test/unit/form/unix/tc_absolute_functions.rb CHANGED
@@ -10,260 +10,263 @@ require 'xqsr3/extensions/test/unit'
10
10
 
11
11
  class Test_existence_of_namespace_LibPath_Form_Unix < Test::Unit::TestCase
12
12
 
13
- def test_LibPath_module_exists
13
+ def test_LibPath_module_exists
14
14
 
15
- assert defined?(::LibPath)
16
- end
15
+ assert defined?(::LibPath)
16
+ end
17
17
 
18
- def test_LibPath_Form_module_exists
18
+ def test_LibPath_Form_module_exists
19
19
 
20
- assert defined?(::LibPath::Form)
21
- end
20
+ assert defined?(::LibPath::Form)
21
+ end
22
22
 
23
- def test_LibPath_Form_Unix_module_exists
23
+ def test_LibPath_Form_Unix_module_exists
24
24
 
25
- assert defined?(::LibPath::Form::Unix)
26
- end
25
+ assert defined?(::LibPath::Form::Unix)
26
+ end
27
27
  end
28
28
 
29
29
  class Test_classify_path_Unix < Test::Unit::TestCase
30
30
 
31
- include ::LibPath::Form::Unix
31
+ include ::LibPath::Form::Unix
32
32
 
33
- def test_with_nil
33
+ def test_with_nil
34
34
 
35
- if $DEBUG
35
+ if $DEBUG
36
36
 
37
- assert_raise(::ArgumentError) { classify_path(nil) }
38
- else
37
+ assert_raise(::ArgumentError) { classify_path(nil) }
38
+ else
39
39
 
40
- assert_nil classify_path(nil)
41
- end
42
- end
40
+ assert_nil classify_path(nil)
41
+ end
42
+ end
43
43
 
44
- def test_empty
44
+ def test_empty
45
45
 
46
- assert_nil classify_path('')
47
- end
46
+ assert_nil classify_path('')
47
+ end
48
48
 
49
- def test_absolute
49
+ def test_absolute
50
50
 
51
- assert_equal :absolute, classify_path('/')
51
+ assert_equal :absolute, classify_path('/')
52
52
 
53
- assert_equal :absolute, classify_path('/abc')
54
- end
53
+ assert_equal :absolute, classify_path('/abc')
54
+ end
55
55
 
56
- def test_homed
56
+ def test_homed
57
57
 
58
- assert_equal :homed, classify_path('~')
58
+ assert_equal :homed, classify_path('~')
59
59
 
60
- assert_equal :homed, classify_path('~/')
60
+ assert_equal :homed, classify_path('~/')
61
61
 
62
- assert_equal :homed, classify_path('~/abc')
63
- end
62
+ assert_equal :homed, classify_path('~/abc')
63
+ end
64
64
 
65
- def test_relative
65
+ def test_relative
66
66
 
67
- assert_equal :relative, classify_path('abc')
67
+ assert_equal :relative, classify_path('abc')
68
68
 
69
- assert_equal :relative, classify_path('~~')
70
- end
69
+ assert_equal :relative, classify_path('~~')
70
+ end
71
71
  end
72
72
 
73
73
  class Test_name_is_malformed_Unix < Test::Unit::TestCase
74
74
 
75
- include ::LibPath::Form::Unix
75
+ include ::LibPath::Form::Unix
76
76
 
77
- def test_with_nil
77
+ def test_with_nil
78
78
 
79
- assert name_is_malformed?(nil)
80
- end
79
+ assert name_is_malformed?(nil)
80
+ end
81
81
 
82
- def test_empty
82
+ def test_empty
83
83
 
84
- assert_false name_is_malformed?('')
85
- end
84
+ assert_false name_is_malformed?('')
85
+ end
86
86
 
87
- def test_absolute_paths_from_root
87
+ def test_absolute_paths_from_root
88
88
 
89
- assert_false name_is_malformed?('/')
90
- assert_false name_is_malformed?('//')
91
- assert_false name_is_malformed?('/abc')
92
- end
89
+ assert_false name_is_malformed?('/')
90
+ assert_false name_is_malformed?('//')
91
+ assert_false name_is_malformed?('/abc')
92
+ end
93
93
 
94
- def test_absolute_paths_from_home
94
+ def test_absolute_paths_from_home
95
95
 
96
- assert_false name_is_malformed?('~')
97
- assert_false name_is_malformed?('~/')
98
- assert_false name_is_malformed?('~/abc')
99
- end
96
+ assert_false name_is_malformed?('~')
97
+ assert_false name_is_malformed?('~/')
98
+ assert_false name_is_malformed?('~/abc')
99
+ end
100
100
 
101
- def test_relative_paths
101
+ def test_relative_paths
102
102
 
103
- assert_false name_is_malformed?('abc')
104
- assert_false name_is_malformed?('abc/')
105
- assert_false name_is_malformed?('a/')
103
+ assert_false name_is_malformed?('abc')
104
+ assert_false name_is_malformed?('abc/')
105
+ assert_false name_is_malformed?('a/')
106
106
 
107
- assert_false name_is_malformed?('~abc')
108
- end
107
+ assert_false name_is_malformed?('~abc')
108
+ end
109
109
 
110
- def test_innate_invalid_characters
110
+ def test_innate_invalid_characters
111
111
 
112
- assert name_is_malformed?("\0")
113
- assert name_is_malformed?("a\0")
114
- assert name_is_malformed?("\0a")
112
+ assert name_is_malformed?("\0")
113
+ assert name_is_malformed?("a\0")
114
+ assert name_is_malformed?("\0a")
115
115
 
116
- assert name_is_malformed?("\0", reject_shell_characters: true)
117
- assert name_is_malformed?("a\0", reject_shell_characters: true)
118
- assert name_is_malformed?("\0a", reject_shell_characters: true)
119
- end
116
+ assert name_is_malformed?("\0", reject_shell_characters: true)
117
+ assert name_is_malformed?("a\0", reject_shell_characters: true)
118
+ assert name_is_malformed?("\0a", reject_shell_characters: true)
119
+ end
120
120
 
121
- def test_shell_invalid_characters
121
+ def test_shell_invalid_characters
122
122
 
123
- assert_false name_is_malformed?('*')
124
- assert_false name_is_malformed?('?')
125
- assert_false name_is_malformed?('|')
123
+ assert_false name_is_malformed?('*')
124
+ assert_false name_is_malformed?('?')
125
+ assert_false name_is_malformed?('|')
126
126
 
127
- assert name_is_malformed?('*', reject_shell_characters: true)
128
- assert name_is_malformed?('?', reject_shell_characters: true)
129
- assert name_is_malformed?('|', reject_shell_characters: true)
130
- end
127
+ assert name_is_malformed?('*', reject_shell_characters: true)
128
+ assert name_is_malformed?('?', reject_shell_characters: true)
129
+ assert name_is_malformed?('|', reject_shell_characters: true)
130
+ end
131
131
 
132
- def test_path_name_separators
132
+ def test_path_name_separators
133
133
 
134
- assert_false name_is_malformed?('/')
134
+ assert_false name_is_malformed?('/')
135
135
 
136
- assert name_is_malformed?('/', reject_path_name_separators: true)
137
- end
136
+ assert name_is_malformed?('/', reject_path_name_separators: true)
137
+ end
138
138
 
139
- def test_path_separators
139
+ def test_path_separators
140
140
 
141
- assert_false name_is_malformed?(':')
141
+ assert_false name_is_malformed?(':')
142
142
 
143
- assert name_is_malformed?(':', reject_path_separators: true)
144
- end
143
+ assert name_is_malformed?(':', reject_path_separators: true)
144
+ end
145
145
  end
146
146
 
147
147
  class Test_path_is_absolute_Unix < Test::Unit::TestCase
148
148
 
149
- include ::LibPath::Form::Unix
149
+ include ::LibPath::Form::Unix
150
150
 
151
- if $DEBUG
151
+ if $DEBUG
152
152
 
153
- def test_with_nil
153
+ def test_with_nil
154
154
 
155
- assert_raise(::ArgumentError) { path_is_absolute?(nil) }
156
- end
157
- end
155
+ assert_raise(::ArgumentError) { path_is_absolute?(nil) }
156
+ end
157
+ end
158
158
 
159
- def test_empty
159
+ def test_empty
160
160
 
161
- assert_false path_is_absolute?('')
162
- end
161
+ assert_false path_is_absolute?('')
162
+ end
163
163
 
164
- def test_absolute_paths_from_root
164
+ def test_absolute_paths_from_root
165
165
 
166
- assert path_is_absolute?('/')
167
- assert path_is_absolute?('//')
168
- assert path_is_absolute?('/abc')
169
- end
166
+ assert path_is_absolute?('/')
167
+ assert path_is_absolute?('//')
168
+ assert path_is_absolute?('/abc')
169
+ end
170
170
 
171
- def test_absolute_paths_from_home
171
+ def test_absolute_paths_from_home
172
172
 
173
- assert path_is_absolute?('~')
174
- assert path_is_absolute?('~/')
175
- assert path_is_absolute?('~/abc')
176
- end
173
+ assert path_is_absolute?('~')
174
+ assert path_is_absolute?('~/')
175
+ assert path_is_absolute?('~/abc')
176
+ end
177
177
 
178
- def test_relative_paths
178
+ def test_relative_paths
179
179
 
180
- assert_false path_is_absolute?('abc')
181
- assert_false path_is_absolute?('abc/')
182
- assert_false path_is_absolute?('a/')
180
+ assert_false path_is_absolute?('abc')
181
+ assert_false path_is_absolute?('abc/')
182
+ assert_false path_is_absolute?('a/')
183
183
 
184
- assert_false path_is_absolute?('~abc')
185
- end
184
+ assert_false path_is_absolute?('~abc')
185
+ end
186
186
  end
187
187
 
188
188
  class Test_path_is_homed_Unix < Test::Unit::TestCase
189
189
 
190
- include ::LibPath::Form::Unix
190
+ include ::LibPath::Form::Unix
191
191
 
192
- if $DEBUG
192
+ if $DEBUG
193
193
 
194
- def test_with_nil
194
+ def test_with_nil
195
195
 
196
- assert_raise(::ArgumentError) { path_is_homed?(nil) }
197
- end
198
- end
196
+ assert_raise(::ArgumentError) { path_is_homed?(nil) }
197
+ end
198
+ end
199
199
 
200
- def test_empty
200
+ def test_empty
201
201
 
202
- assert_false path_is_homed?('')
203
- end
202
+ assert_false path_is_homed?('')
203
+ end
204
204
 
205
- def test_absolute_paths_from_root
205
+ def test_absolute_paths_from_root
206
206
 
207
- assert_false path_is_homed?('/')
208
- assert_false path_is_homed?('//')
209
- assert_false path_is_homed?('/abc')
210
- end
207
+ assert_false path_is_homed?('/')
208
+ assert_false path_is_homed?('//')
209
+ assert_false path_is_homed?('/abc')
210
+ end
211
211
 
212
- def test_absolute_paths_from_home
212
+ def test_absolute_paths_from_home
213
213
 
214
- assert path_is_homed?('~')
215
- assert path_is_homed?('~/')
216
- assert path_is_homed?('~/abc')
217
- end
214
+ assert path_is_homed?('~')
215
+ assert path_is_homed?('~/')
216
+ assert path_is_homed?('~/abc')
217
+ end
218
218
 
219
- def test_relative_paths
219
+ def test_relative_paths
220
220
 
221
- assert_false path_is_homed?('abc')
222
- assert_false path_is_homed?('abc/')
223
- assert_false path_is_homed?('a/')
221
+ assert_false path_is_homed?('abc')
222
+ assert_false path_is_homed?('abc/')
223
+ assert_false path_is_homed?('a/')
224
224
 
225
- assert_false path_is_homed?('~abc')
226
- end
225
+ assert_false path_is_homed?('~abc')
226
+ end
227
227
  end
228
228
 
229
229
  class Test_path_is_rooted_Unix < Test::Unit::TestCase
230
230
 
231
- include ::LibPath::Form::Unix
231
+ include ::LibPath::Form::Unix
232
232
 
233
- if $DEBUG
233
+ if $DEBUG
234
234
 
235
- def test_with_nil
235
+ def test_with_nil
236
236
 
237
- assert_raise(::ArgumentError) { path_is_rooted?(nil) }
238
- end
239
- end
237
+ assert_raise(::ArgumentError) { path_is_rooted?(nil) }
238
+ end
239
+ end
240
240
 
241
- def test_empty
241
+ def test_empty
242
242
 
243
- assert_false path_is_rooted?('')
244
- end
243
+ assert_false path_is_rooted?('')
244
+ end
245
245
 
246
- def test_absolute_paths_from_root
246
+ def test_absolute_paths_from_root
247
247
 
248
- assert path_is_rooted?('/')
249
- assert path_is_rooted?('//')
250
- assert path_is_rooted?('/abc')
251
- end
248
+ assert path_is_rooted?('/')
249
+ assert path_is_rooted?('//')
250
+ assert path_is_rooted?('/abc')
251
+ end
252
252
 
253
- def test_absolute_paths_from_home
253
+ def test_absolute_paths_from_home
254
254
 
255
- assert_false path_is_rooted?('~')
256
- assert_false path_is_rooted?('~/')
257
- assert_false path_is_rooted?('~/abc')
258
- end
255
+ assert_false path_is_rooted?('~')
256
+ assert_false path_is_rooted?('~/')
257
+ assert_false path_is_rooted?('~/abc')
258
+ end
259
259
 
260
- def test_relative_paths
260
+ def test_relative_paths
261
261
 
262
- assert_false path_is_rooted?('abc')
263
- assert_false path_is_rooted?('abc/')
264
- assert_false path_is_rooted?('a/')
262
+ assert_false path_is_rooted?('abc')
263
+ assert_false path_is_rooted?('abc/')
264
+ assert_false path_is_rooted?('a/')
265
265
 
266
- assert_false path_is_rooted?('~abc')
267
- end
266
+ assert_false path_is_rooted?('~abc')
267
+ end
268
268
  end
269
269
 
270
+
271
+ # ############################## end of file ############################# #
272
+
data/test/unit/form/unix/ts_all.rb CHANGED
@@ -7,16 +7,16 @@ this_dir = File.expand_path(File.dirname(__FILE__))
7
7
  # all tc_*rb in current directory
8
8
  Dir[File.join(this_dir, 'tc_*rb')].each do |file|
9
9
 
10
- $stderr.puts "requiring file '#{file}'" if $DEBUG
10
+ $stderr.puts "requiring file '#{file}'" if $DEBUG
11
11
 
12
- require file
12
+ require file
13
13
  end
14
14
 
15
15
  # all ts_*rb in immediate sub-directories
16
16
  Dir[File.join(this_dir, '*', 'ts_*rb')].each do |file|
17
17
 
18
- $stderr.puts "requiring file '#{file}'" if $DEBUG
18
+ $stderr.puts "requiring file '#{file}'" if $DEBUG
19
19
 
20
- require file
20
+ require file
21
21
  end
22
22