pathname2 1.7.2-universal-mingw32 → 1.7.3-universal-mingw32
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.
- checksums.yaml +14 -6
- data/CHANGES +151 -148
- data/MANIFEST +38 -38
- data/README +98 -98
- data/lib/pathname2.rb +1140 -1140
- data/pathname2.gemspec +36 -36
- data/test/test_pathname.rb +484 -484
- data/test/test_version.rb +13 -13
- metadata +23 -25
checksums.yaml
CHANGED
|
@@ -1,7 +1,15 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
3
|
-
metadata.gz:
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
2
|
+
!binary "U0hBMQ==":
|
|
3
|
+
metadata.gz: !binary |-
|
|
4
|
+
NzM0YjhkYjYwYjUxYTJhYjFhOWQyYWZiMmIzOGUwMTEzNjNjMDdkMg==
|
|
5
|
+
data.tar.gz: !binary |-
|
|
6
|
+
NjEyYWFhM2Q1YzRjYTI4MTA2Nzg5MjhmYTNhMDY4MmQzYzk0ZjI0ZA==
|
|
7
|
+
!binary "U0hBNTEy":
|
|
8
|
+
metadata.gz: !binary |-
|
|
9
|
+
NTg4MTBiOTBjMmFjOWYxY2ZjMDkyZmQyOWI0NjUxZmE5NDdlMTJkYTAyYjc0
|
|
10
|
+
OTdjZGYyMDU1YzY2ZjliNjk3MmYxNDgxMWE2ZGIyNzI2YmE1ZjVkOTQ4YmI5
|
|
11
|
+
ODczNThhZjQyOGYxNDI3YWU3ZjM1YzQ5NjQ2MDg2OTY0MWUxYjQ=
|
|
12
|
+
data.tar.gz: !binary |-
|
|
13
|
+
ZDMxMGEzNjJhZTk3Y2U2OTdiYzM2NjEzY2FiOGM4YzMxMzU1ZTZhMjllZWI1
|
|
14
|
+
NmRmZGRiNWI0OTAwNDc2OGU1YjU2YzdjM2Y4YzMwOWU4MWI1MWNmMTYxZDgy
|
|
15
|
+
MWFhMGQ0ODllYzQ0ZTA1MGM2NDA0NWE4YTZjYjQ5MDAyZGM0MGI=
|
data/CHANGES
CHANGED
|
@@ -1,148 +1,151 @@
|
|
|
1
|
-
== 1.7.
|
|
2
|
-
* The
|
|
3
|
-
|
|
4
|
-
== 1.7.
|
|
5
|
-
*
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
*
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
*
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
*
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
*
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
*
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
*
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
*
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
*
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
*
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
*
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
*
|
|
57
|
-
|
|
58
|
-
*
|
|
59
|
-
*
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
*
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
*
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
*
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
* The
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
*
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
*
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
*
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
== 1.4.
|
|
102
|
-
*
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
* Added
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
*
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
*
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
* Added
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
*
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
*
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
*
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
* Added
|
|
146
|
-
|
|
147
|
-
== 1.
|
|
148
|
-
*
|
|
1
|
+
== 1.7.3 - 24-Apr-2014
|
|
2
|
+
* The basename and dirname methods now return Pathname objects.
|
|
3
|
+
|
|
4
|
+
== 1.7.2 - 23-Apr-2014
|
|
5
|
+
* The join and expand_path methods now return Pathname objects.
|
|
6
|
+
|
|
7
|
+
== 1.7.1 - 28-Mar-2014
|
|
8
|
+
* Updated gemspec for Windows vs Unix.
|
|
9
|
+
* Updated README and MANIFEST.
|
|
10
|
+
|
|
11
|
+
== 1.7.0 - 28-Mar-2014
|
|
12
|
+
* Windows now uses FFI internally instead of win32-api.
|
|
13
|
+
* Added a custom pretty_print method for the pp library.
|
|
14
|
+
* Reorganized the test suite for Windows, and added many
|
|
15
|
+
more test tasks to the Rakefile.
|
|
16
|
+
|
|
17
|
+
== 1.6.5 - 19-Sep-2011
|
|
18
|
+
* Added the String#to_path instance method. This returns a Pathname
|
|
19
|
+
object.
|
|
20
|
+
* The architecture for the Windows gem is now "universal", and some
|
|
21
|
+
gemspec dependencies were simplified.
|
|
22
|
+
|
|
23
|
+
== 1.6.4 - 20-Jan-2011
|
|
24
|
+
* Explicitly remove the Pathname const if it is already defined in order
|
|
25
|
+
to avoid a superclass mismatch error. This library assumes that if you
|
|
26
|
+
require pathname2, you want my version of the Pathname class.
|
|
27
|
+
* Updated URI handling for Ruby 1.9.x.
|
|
28
|
+
* Added the Pathname() method, a synonym for Pathname.new.
|
|
29
|
+
* Some Rakefile and gemspec tweaks.
|
|
30
|
+
* Some updates to the test suite, including some specifically for Windows 7.
|
|
31
|
+
|
|
32
|
+
== 1.6.3 - 2-Oct-2009
|
|
33
|
+
* Updated Windows platform handling code to include mingw and cygwin.
|
|
34
|
+
* Added the :gem rake task.
|
|
35
|
+
* Minor gemspec updates.
|
|
36
|
+
* Some minor test suite updates.
|
|
37
|
+
|
|
38
|
+
== 1.6.2 - 4-Aug-2009
|
|
39
|
+
* Now compatible with Ruby 1.9.x.
|
|
40
|
+
* License changed to Artistic 2.0.
|
|
41
|
+
* Added the Pathname.pwd method as a synonym for Pathname.new(Dir.pwd).
|
|
42
|
+
* Modified Pathname#dirname so that you can specify a level that indicates
|
|
43
|
+
how many levels up you want to retrieve. For example, if your path was
|
|
44
|
+
'/usr/local/bin', then path.dirname(2) would return '/usr'.
|
|
45
|
+
* Now compatible with Ruby 1.9.x.
|
|
46
|
+
* Bumped required version of the facade library to 1.0.4.
|
|
47
|
+
|
|
48
|
+
== 1.6.1 - 8-Nov-2008
|
|
49
|
+
* Added the Pathname#[] method, which accepts an index, an index plus a
|
|
50
|
+
length, or a range, and returns appropriate the path element(s).
|
|
51
|
+
* Refactoring the platform checking in the test suite to use rbconfig instead
|
|
52
|
+
of RUBY_PLATFORM.
|
|
53
|
+
* More inline documentation examples.
|
|
54
|
+
|
|
55
|
+
== 1.6.0 - 13-July-2008
|
|
56
|
+
* The facade for ftools (and ftools itself) has been removed. The ftools
|
|
57
|
+
library is deprecated in favor of FileUtils.
|
|
58
|
+
* PathnameError is now Pathname::Error.
|
|
59
|
+
* Bug fix for Pathname#relative_path_from for MS Windows. Thanks go to an
|
|
60
|
+
anonymous user for the spot.
|
|
61
|
+
* Fixed a bug where frozen strings would raise an error on MS Windows.
|
|
62
|
+
* The code is now -w clean.
|
|
63
|
+
* Removed the C version as part of the release because it was just too
|
|
64
|
+
difficult to maintain both versions. The C code remains in CVS, however.
|
|
65
|
+
* Changed platform checking to use rbconfig instead of RUBY_PLATFORM to avoid
|
|
66
|
+
potential issues with other Ruby implementation.
|
|
67
|
+
|
|
68
|
+
== 1.5.2 - 9-Mar-2007
|
|
69
|
+
* Bug fix for the Pathname#realpath method where it was not handling recursive
|
|
70
|
+
symlinks. The C version was also fixed, but it only affected platforms that
|
|
71
|
+
don't have the realpath() function.
|
|
72
|
+
* Added a test for recursive symlinks (for Solaris, anyway).
|
|
73
|
+
* Updated the docs for Pathname#realpath.
|
|
74
|
+
* Minor speed enhancements for the C version and the elimination of one
|
|
75
|
+
(potential) segfault.
|
|
76
|
+
* Added a 'Future Plans' section to the README.
|
|
77
|
+
* Added a Rakefile. You can now build, clean, and test and install (both the
|
|
78
|
+
pure Ruby and C versions).
|
|
79
|
+
|
|
80
|
+
== 1.5.1 - 28-Aug-2006
|
|
81
|
+
* Added the Kernel#pn method as a shortcut for Pathname.new.
|
|
82
|
+
* The Pathname#readlink now properly handles symbolic links. The 'fix'
|
|
83
|
+
from 1.4.4 did not work.
|
|
84
|
+
* The C extension uses your system's realpath() function for the
|
|
85
|
+
Pathname#readlink method if it has one.
|
|
86
|
+
* Added the '/' alias for '+'. So, p1 / p2 is the same as p1 + p2.
|
|
87
|
+
* The windows-pr package is now required on MS Windows.
|
|
88
|
+
|
|
89
|
+
== 1.5.0 - 17-Apr-2006
|
|
90
|
+
* Better subclass handling, in that some methods that previously returned
|
|
91
|
+
hardcoded Pathname.new now return self.class.new.
|
|
92
|
+
* File URL's are now handled on Unix as well (using the 'uri' package).
|
|
93
|
+
* Some comment changes/clarifications.
|
|
94
|
+
* Added the PathnameError class to the pure Ruby version.
|
|
95
|
+
|
|
96
|
+
== 1.4.4 - 23-Mar-2006
|
|
97
|
+
* If the path is a symbolic link the Pathname#realpath method
|
|
98
|
+
now returns the absolute path of that link, i.e. the result
|
|
99
|
+
of File.readlink (as a Pathname object).
|
|
100
|
+
|
|
101
|
+
== 1.4.3 - 3-Mar-2006
|
|
102
|
+
* Added the Pathname#realpath method.
|
|
103
|
+
|
|
104
|
+
== 1.4.2 - 22-Feb-2006
|
|
105
|
+
* Fixed the Pathname#relative_path_from method for Windows. This really only
|
|
106
|
+
affected edge cases that you probably never saw anyway.
|
|
107
|
+
* Added corresponding tests for Windows.
|
|
108
|
+
|
|
109
|
+
== 1.4.1 - 18-Feb-2006
|
|
110
|
+
* Added the Pathname#parent method.
|
|
111
|
+
* Added the Pathname#relative_path_from method.
|
|
112
|
+
* Bug fix for Pathname#pstrip on *nix.
|
|
113
|
+
* Corresponding test suite additions.
|
|
114
|
+
|
|
115
|
+
== 1.4.0 - 19-Dec-2005
|
|
116
|
+
* Added destructive and non-destructive methods for some methods - pstrip,
|
|
117
|
+
pstrip!, undecorate, undecorate!, clean and clean!.
|
|
118
|
+
* Added a C extension version of this package. You can use the C version
|
|
119
|
+
instead of the pure Ruby version instead. See the README for more details.
|
|
120
|
+
* Fixed bug in the root method where the result wasn't guaranteed to be a
|
|
121
|
+
Pathname class.
|
|
122
|
+
* Fixed bugs in Windows version where the receiver was inadvertantly modified
|
|
123
|
+
in some cases, and added tests to check for this in the future.
|
|
124
|
+
* Modified the Dir.glob facade so that it (temporarily) changes to the path
|
|
125
|
+
directory, globs on that path, then returns to the original directory.
|
|
126
|
+
* Added the bench_pathname.rb script to let you benchmark all Pathname
|
|
127
|
+
methods.
|
|
128
|
+
|
|
129
|
+
== 1.3.1 - 21-Nov-2005
|
|
130
|
+
* Added the Pathname#children method.
|
|
131
|
+
* Added tests for the Pathname#children method.
|
|
132
|
+
|
|
133
|
+
== 1.3.0 - 28-Oct-2005
|
|
134
|
+
* Added the short_path and long_path methods for MS Windows.
|
|
135
|
+
* Optimization for the '+' method on Unix.
|
|
136
|
+
* Added some examples under the 'examples' directory.
|
|
137
|
+
* More tests added and some minor changes to the test suite in general.
|
|
138
|
+
|
|
139
|
+
== 1.2.1 - 1-Sep-2005
|
|
140
|
+
* Bug fix for the ascend and descend methods wrt Windows and UNC paths.
|
|
141
|
+
* More tests added for ascend and descend methods.
|
|
142
|
+
|
|
143
|
+
== 1.2.0 - 29-Aug-2005
|
|
144
|
+
* Added the 'ascend' and 'descend' methods.
|
|
145
|
+
* Added corresponding test suite additions.
|
|
146
|
+
|
|
147
|
+
== 1.1.0 - 13-Jul-2005
|
|
148
|
+
* Added the 'find' facade.
|
|
149
|
+
|
|
150
|
+
== 1.0.0 - 11-Jun-2005
|
|
151
|
+
* Initial release
|
data/MANIFEST
CHANGED
|
@@ -1,38 +1,38 @@
|
|
|
1
|
-
* CHANGES
|
|
2
|
-
* MANIFEST
|
|
3
|
-
* Rakefile
|
|
4
|
-
* README
|
|
5
|
-
* pathname2.gempsec
|
|
6
|
-
* benchmarks/bench_all.rb
|
|
7
|
-
* benchmarks/bench_plus.rb
|
|
8
|
-
* examples/example_pathname.rb
|
|
9
|
-
* lib/pathname2.rb
|
|
10
|
-
* test/test_pathname.rb
|
|
11
|
-
* test/test_version.rb
|
|
12
|
-
* test/windows/test_append.rb
|
|
13
|
-
* test/windows/test_aref.rb
|
|
14
|
-
* test/windows/test_ascend.rb
|
|
15
|
-
* test/windows/test_children.rb
|
|
16
|
-
* test/windows/test_clean.rb
|
|
17
|
-
* test/windows/test_clean_bang.rb
|
|
18
|
-
* test/windows/test_constructor.rb
|
|
19
|
-
* test/windows/test_descend.rb
|
|
20
|
-
* test/windows/test_drive_number.rb
|
|
21
|
-
* test/windows/test_each.rb
|
|
22
|
-
* test/windows/test_facade.rb
|
|
23
|
-
* test/windows/test_is_absolute.rb
|
|
24
|
-
* test/windows/test_is_relative.rb
|
|
25
|
-
* test/windows/test_is_root.rb
|
|
26
|
-
* test/windows/test_is_unc.rb
|
|
27
|
-
* test/windows/test_long_path.rb
|
|
28
|
-
* test/windows/test_misc.rb
|
|
29
|
-
* test/windows/test_parent.rb
|
|
30
|
-
* test/windows/test_pstrip.rb
|
|
31
|
-
* test/windows/test_pstrip_bang.rb
|
|
32
|
-
* test/windows/test_realpath.rb
|
|
33
|
-
* test/windows/test_relative_path_from.rb
|
|
34
|
-
* test/windows/test_root.rb
|
|
35
|
-
* test/windows/test_short_path.rb
|
|
36
|
-
* test/windows/test_to_a.rb
|
|
37
|
-
* test/windows/test_undecorate.rb
|
|
38
|
-
* test/windows/test_undecorate_bang.rb
|
|
1
|
+
* CHANGES
|
|
2
|
+
* MANIFEST
|
|
3
|
+
* Rakefile
|
|
4
|
+
* README
|
|
5
|
+
* pathname2.gempsec
|
|
6
|
+
* benchmarks/bench_all.rb
|
|
7
|
+
* benchmarks/bench_plus.rb
|
|
8
|
+
* examples/example_pathname.rb
|
|
9
|
+
* lib/pathname2.rb
|
|
10
|
+
* test/test_pathname.rb
|
|
11
|
+
* test/test_version.rb
|
|
12
|
+
* test/windows/test_append.rb
|
|
13
|
+
* test/windows/test_aref.rb
|
|
14
|
+
* test/windows/test_ascend.rb
|
|
15
|
+
* test/windows/test_children.rb
|
|
16
|
+
* test/windows/test_clean.rb
|
|
17
|
+
* test/windows/test_clean_bang.rb
|
|
18
|
+
* test/windows/test_constructor.rb
|
|
19
|
+
* test/windows/test_descend.rb
|
|
20
|
+
* test/windows/test_drive_number.rb
|
|
21
|
+
* test/windows/test_each.rb
|
|
22
|
+
* test/windows/test_facade.rb
|
|
23
|
+
* test/windows/test_is_absolute.rb
|
|
24
|
+
* test/windows/test_is_relative.rb
|
|
25
|
+
* test/windows/test_is_root.rb
|
|
26
|
+
* test/windows/test_is_unc.rb
|
|
27
|
+
* test/windows/test_long_path.rb
|
|
28
|
+
* test/windows/test_misc.rb
|
|
29
|
+
* test/windows/test_parent.rb
|
|
30
|
+
* test/windows/test_pstrip.rb
|
|
31
|
+
* test/windows/test_pstrip_bang.rb
|
|
32
|
+
* test/windows/test_realpath.rb
|
|
33
|
+
* test/windows/test_relative_path_from.rb
|
|
34
|
+
* test/windows/test_root.rb
|
|
35
|
+
* test/windows/test_short_path.rb
|
|
36
|
+
* test/windows/test_to_a.rb
|
|
37
|
+
* test/windows/test_undecorate.rb
|
|
38
|
+
* test/windows/test_undecorate_bang.rb
|
data/README
CHANGED
|
@@ -1,98 +1,98 @@
|
|
|
1
|
-
== Description
|
|
2
|
-
A drop-in replacement for the current Pathname class.
|
|
3
|
-
|
|
4
|
-
== Prerequisites
|
|
5
|
-
* facade
|
|
6
|
-
* ffi (Windows only)
|
|
7
|
-
* test-unit (testing only)
|
|
8
|
-
|
|
9
|
-
== Installation
|
|
10
|
-
|
|
11
|
-
gem install pathname2
|
|
12
|
-
|
|
13
|
-
== Synopsis
|
|
14
|
-
require 'pathname2'
|
|
15
|
-
|
|
16
|
-
# Unix
|
|
17
|
-
path1 = Pathname.new("/foo/bar/baz")
|
|
18
|
-
path2 = Pathname.new("../zap")
|
|
19
|
-
|
|
20
|
-
path1 + path2 # "/foo/bar/zap"
|
|
21
|
-
path1 / path2 # "/foo/bar/zap" (same as +)
|
|
22
|
-
path1.exists? # Does this path exist?
|
|
23
|
-
path1.dirname # "/foo/bar"
|
|
24
|
-
path1.to_a # ['foo','bar','baz']
|
|
25
|
-
|
|
26
|
-
# Windows
|
|
27
|
-
path1 = Pathname.new("C:/foo/bar/baz")
|
|
28
|
-
path2 = Pathname.new("../zap")
|
|
29
|
-
|
|
30
|
-
path1 + path2 # "C:\\foo\\bar\\zap"
|
|
31
|
-
path1.root # "C:\\"
|
|
32
|
-
path1.to_a # ['C:','foo','bar','baz']
|
|
33
|
-
|
|
34
|
-
== Windows Notes
|
|
35
|
-
All forward slashes are converted to backslashes for Pathname objects.
|
|
36
|
-
|
|
37
|
-
== Differences between Unix and Windows
|
|
38
|
-
If your pathname consists solely of ".", or "..", the return
|
|
39
|
-
value for Pathname#clean will be different. On Win32, "\\" is returned,
|
|
40
|
-
while on Unix "." is returned. I consider this an extreme edge case and
|
|
41
|
-
will not worry myself with it.
|
|
42
|
-
|
|
43
|
-
== Differences between Pathname in the standard library and this version
|
|
44
|
-
* It is a subclass of String (and thus, mixes in Enumerable).
|
|
45
|
-
* It has sensical to_a and root instance methods.
|
|
46
|
-
* It works on Windows and Unix. The current implementation does not work
|
|
47
|
-
with Windows path names very well, and not at all when it comes to UNC
|
|
48
|
-
paths.
|
|
49
|
-
* The Pathname#cleanpath method works differently - it always returns
|
|
50
|
-
a canonical pathname. In addition, there is no special consideration
|
|
51
|
-
for symlinks (yet), though I'm not sure it warrants it.
|
|
52
|
-
* The Pathname#+ method auto cleans.
|
|
53
|
-
* It uses a facade for all File and Dir methods, as well as most FileUtils
|
|
54
|
-
methods.
|
|
55
|
-
* Pathname#clean works slightly differently. In the stdlib version,
|
|
56
|
-
Pathname#clean("../a") returns "../a". In this version, it returns "a".
|
|
57
|
-
This affects other methods, such as Pathname#relative_path_from.
|
|
58
|
-
* Accepts file urls and converts them to paths automatically, e.g.
|
|
59
|
-
file:///foo%20bar/baz becomes '/foo/bar/baz'.
|
|
60
|
-
* Adds a Kernel level +pn+ method as a shortcut.
|
|
61
|
-
* Allows you to add paths together with the '/' operator.
|
|
62
|
-
|
|
63
|
-
== Method Priority
|
|
64
|
-
Because there is some overlap in method names between File, Dir, and
|
|
65
|
-
FileUtils, the priority is as follows:
|
|
66
|
-
|
|
67
|
-
* File
|
|
68
|
-
* Dir
|
|
69
|
-
* FileUtils
|
|
70
|
-
|
|
71
|
-
In other words, whichever of these defines a given method first is the
|
|
72
|
-
method that is used by the pathname2 library.
|
|
73
|
-
|
|
74
|
-
== Known Issues
|
|
75
|
-
In Ruby 1.8.3 and 1.8.4 you will see a failure in the test suite regarding
|
|
76
|
-
'fu_world_writable?' from FileUtils. You can ignore this. That method is
|
|
77
|
-
supposed to be private. See ruby-core:7383.
|
|
78
|
-
|
|
79
|
-
Any other issues should be reported on the project page at
|
|
80
|
-
https://github.com/djberg96/pathname2
|
|
81
|
-
|
|
82
|
-
== Future Plans
|
|
83
|
-
Suggestions welcome.
|
|
84
|
-
|
|
85
|
-
== License
|
|
86
|
-
Artistic 2.0
|
|
87
|
-
|
|
88
|
-
== Copyright
|
|
89
|
-
(C) 2003-2014 Daniel J. Berger
|
|
90
|
-
All rights reserved.
|
|
91
|
-
|
|
92
|
-
== Warranty
|
|
93
|
-
This library is provided "as is" and without any express or
|
|
94
|
-
implied warranties, including, without limitation, the implied
|
|
95
|
-
warranties of merchantability and fitness for a particular purpose.
|
|
96
|
-
|
|
97
|
-
== Author
|
|
98
|
-
Daniel J. Berger
|
|
1
|
+
== Description
|
|
2
|
+
A drop-in replacement for the current Pathname class.
|
|
3
|
+
|
|
4
|
+
== Prerequisites
|
|
5
|
+
* facade
|
|
6
|
+
* ffi (Windows only)
|
|
7
|
+
* test-unit (testing only)
|
|
8
|
+
|
|
9
|
+
== Installation
|
|
10
|
+
|
|
11
|
+
gem install pathname2
|
|
12
|
+
|
|
13
|
+
== Synopsis
|
|
14
|
+
require 'pathname2'
|
|
15
|
+
|
|
16
|
+
# Unix
|
|
17
|
+
path1 = Pathname.new("/foo/bar/baz")
|
|
18
|
+
path2 = Pathname.new("../zap")
|
|
19
|
+
|
|
20
|
+
path1 + path2 # "/foo/bar/zap"
|
|
21
|
+
path1 / path2 # "/foo/bar/zap" (same as +)
|
|
22
|
+
path1.exists? # Does this path exist?
|
|
23
|
+
path1.dirname # "/foo/bar"
|
|
24
|
+
path1.to_a # ['foo','bar','baz']
|
|
25
|
+
|
|
26
|
+
# Windows
|
|
27
|
+
path1 = Pathname.new("C:/foo/bar/baz")
|
|
28
|
+
path2 = Pathname.new("../zap")
|
|
29
|
+
|
|
30
|
+
path1 + path2 # "C:\\foo\\bar\\zap"
|
|
31
|
+
path1.root # "C:\\"
|
|
32
|
+
path1.to_a # ['C:','foo','bar','baz']
|
|
33
|
+
|
|
34
|
+
== Windows Notes
|
|
35
|
+
All forward slashes are converted to backslashes for Pathname objects.
|
|
36
|
+
|
|
37
|
+
== Differences between Unix and Windows
|
|
38
|
+
If your pathname consists solely of ".", or "..", the return
|
|
39
|
+
value for Pathname#clean will be different. On Win32, "\\" is returned,
|
|
40
|
+
while on Unix "." is returned. I consider this an extreme edge case and
|
|
41
|
+
will not worry myself with it.
|
|
42
|
+
|
|
43
|
+
== Differences between Pathname in the standard library and this version
|
|
44
|
+
* It is a subclass of String (and thus, mixes in Enumerable).
|
|
45
|
+
* It has sensical to_a and root instance methods.
|
|
46
|
+
* It works on Windows and Unix. The current implementation does not work
|
|
47
|
+
with Windows path names very well, and not at all when it comes to UNC
|
|
48
|
+
paths.
|
|
49
|
+
* The Pathname#cleanpath method works differently - it always returns
|
|
50
|
+
a canonical pathname. In addition, there is no special consideration
|
|
51
|
+
for symlinks (yet), though I'm not sure it warrants it.
|
|
52
|
+
* The Pathname#+ method auto cleans.
|
|
53
|
+
* It uses a facade for all File and Dir methods, as well as most FileUtils
|
|
54
|
+
methods.
|
|
55
|
+
* Pathname#clean works slightly differently. In the stdlib version,
|
|
56
|
+
Pathname#clean("../a") returns "../a". In this version, it returns "a".
|
|
57
|
+
This affects other methods, such as Pathname#relative_path_from.
|
|
58
|
+
* Accepts file urls and converts them to paths automatically, e.g.
|
|
59
|
+
file:///foo%20bar/baz becomes '/foo/bar/baz'.
|
|
60
|
+
* Adds a Kernel level +pn+ method as a shortcut.
|
|
61
|
+
* Allows you to add paths together with the '/' operator.
|
|
62
|
+
|
|
63
|
+
== Method Priority
|
|
64
|
+
Because there is some overlap in method names between File, Dir, and
|
|
65
|
+
FileUtils, the priority is as follows:
|
|
66
|
+
|
|
67
|
+
* File
|
|
68
|
+
* Dir
|
|
69
|
+
* FileUtils
|
|
70
|
+
|
|
71
|
+
In other words, whichever of these defines a given method first is the
|
|
72
|
+
method that is used by the pathname2 library.
|
|
73
|
+
|
|
74
|
+
== Known Issues
|
|
75
|
+
In Ruby 1.8.3 and 1.8.4 you will see a failure in the test suite regarding
|
|
76
|
+
'fu_world_writable?' from FileUtils. You can ignore this. That method is
|
|
77
|
+
supposed to be private. See ruby-core:7383.
|
|
78
|
+
|
|
79
|
+
Any other issues should be reported on the project page at
|
|
80
|
+
https://github.com/djberg96/pathname2
|
|
81
|
+
|
|
82
|
+
== Future Plans
|
|
83
|
+
Suggestions welcome.
|
|
84
|
+
|
|
85
|
+
== License
|
|
86
|
+
Artistic 2.0
|
|
87
|
+
|
|
88
|
+
== Copyright
|
|
89
|
+
(C) 2003-2014 Daniel J. Berger
|
|
90
|
+
All rights reserved.
|
|
91
|
+
|
|
92
|
+
== Warranty
|
|
93
|
+
This library is provided "as is" and without any express or
|
|
94
|
+
implied warranties, including, without limitation, the implied
|
|
95
|
+
warranties of merchantability and fitness for a particular purpose.
|
|
96
|
+
|
|
97
|
+
== Author
|
|
98
|
+
Daniel J. Berger
|