ptools 1.3.2-universal-mingw32 → 1.3.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 +4 -4
- checksums.yaml.gz.sig +1 -0
- data.tar.gz.sig +0 -0
- data/CHANGES +172 -168
- data/Gemfile +12 -12
- data/MANIFEST +20 -19
- data/README +66 -66
- data/Rakefile +135 -139
- data/certs/djberg96_pub.pem +21 -0
- data/lib/ptools.rb +482 -482
- data/ptools.gemspec +31 -30
- data/test/test_binary.rb +65 -65
- data/test/test_constants.rb +38 -38
- data/test/test_head.rb +48 -48
- data/test/test_image.rb +57 -57
- data/test/test_is_sparse.rb +53 -53
- data/test/test_nlconvert.rb +110 -110
- data/test/test_null.rb +40 -40
- data/test/test_tail.rb +124 -124
- data/test/test_touch.rb +53 -53
- data/test/test_wc.rb +73 -73
- data/test/test_whereis.rb +98 -98
- data/test/test_which.rb +126 -126
- data/test/txt/english.txt +1 -1
- data/test/txt/korean.txt +1 -1
- metadata +27 -4
- metadata.gz.sig +0 -0
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 825f3067d1acabd589eb633c4307140008626138
|
|
4
|
+
data.tar.gz: 2924015a89255311cb29ce3f26de584a81935288
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 204eff0e8d7e2251793f0acf20ec16b113d35595a57012525700a343f917492d6ce2a5dee7504e6792f37f84f563bef421f232ea2e41776eafef49bc183a942a
|
|
7
|
+
data.tar.gz: 6ea1e00173da43e41da1400af67369d68e68fa56582c480cc4b51be43f9f28553bcac286ee0a0d6b4945de6163582dc09bbe82bc4321c647a6800ec9de9beab3
|
checksums.yaml.gz.sig
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
7,����o���f!�x(p��Q�e6M@y#�g>�"ξ��&�@Z�Q�"�|T2��-5�m���C��k��|b�^�z�Mʔ�F� &%u1��ʲK��� jeh�g���IGc��/�U� E����ͱ��B5.}�K0�Ρ�o~2�ٍ��Pĉ��(g�ә�$z+�0����2�g2�#-��MvF����n������ �`�H)��hw��a"cgB�*� j9 �'KWcZu�;�4+���=O"�A �?^� ��]ˢ
|
data.tar.gz.sig
ADDED
|
Binary file
|
data/CHANGES
CHANGED
|
@@ -1,168 +1,172 @@
|
|
|
1
|
-
== 1.3.
|
|
2
|
-
*
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
== 1.3.
|
|
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
|
-
== 1.2.
|
|
61
|
-
* Added
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
== 1.
|
|
65
|
-
*
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
*
|
|
70
|
-
*
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
*
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
*
|
|
81
|
-
*
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
*
|
|
86
|
-
*
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
*
|
|
90
|
-
*
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
*
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
*
|
|
108
|
-
*
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
*
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
* Added
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
*
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
*
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
* Modified the
|
|
131
|
-
*
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
* File.
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
*
|
|
139
|
-
|
|
140
|
-
*
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
*
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
*
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
*
|
|
160
|
-
*
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
*
|
|
164
|
-
*
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
*
|
|
1
|
+
== 1.3.3 - 25-Sep-2015
|
|
2
|
+
* This gem is now signed.
|
|
3
|
+
* The Rakefile tasks now assume Rubygems 2.x.
|
|
4
|
+
|
|
5
|
+
== 1.3.2 - 11-Dec-2014
|
|
6
|
+
* Update to the File.tail method that deals prevents potential line ending
|
|
7
|
+
issues in JRuby.
|
|
8
|
+
* Added known issues with JRuby to the README.
|
|
9
|
+
|
|
10
|
+
== 1.3.1 - 9-Dec-2014
|
|
11
|
+
* Fixed some potential issues with File.tail. Thanks go to Matt Hoyle for
|
|
12
|
+
the patch.
|
|
13
|
+
|
|
14
|
+
== 1.3.0 - 8-Dec-2014
|
|
15
|
+
* Made the File.tail method efficient. It's no longer slurpy, and it also no
|
|
16
|
+
longer includes line endings in the result.
|
|
17
|
+
* Removed the File.middle method. I don't think it's useful.
|
|
18
|
+
|
|
19
|
+
== 1.2.7 - 6-Dec-2014
|
|
20
|
+
* File.which now expands ~ for paths. Thanks go to dg-vrnetze for the patch.
|
|
21
|
+
* Use /dev/null for cygwin instead of NUL.
|
|
22
|
+
* Use mv instead of cp in the nl_convert method.
|
|
23
|
+
* Solaris now handled explicitly in nl_convert, and OSX now considered Unix.
|
|
24
|
+
* Modified the binary? method to check 4096 bytes at most.
|
|
25
|
+
* Thanks to Matt Hoyle for many of the changes implemented in this release.
|
|
26
|
+
|
|
27
|
+
== 1.2.6 - 14-Jul-2014
|
|
28
|
+
* Updated the png? and jpg? methods so they explicitly specify the
|
|
29
|
+
offset argument so that it works with 1.9.2 and earlier. Thanks go to
|
|
30
|
+
Anurag Priyam for the spot.
|
|
31
|
+
|
|
32
|
+
== 1.2.5 - 11-Jul-2014
|
|
33
|
+
* Added a Gemfile, mostly for Travis CI.
|
|
34
|
+
* Added rake as a development dependency.
|
|
35
|
+
* Revert back to hash syntax supported by 1.8.x.
|
|
36
|
+
* Removed rubyforge_project from gemspec.
|
|
37
|
+
* Updated the tests for File.sparse? so that it doesn't rely on
|
|
38
|
+
an external file.
|
|
39
|
+
|
|
40
|
+
== 1.2.4 - 25-Feb-2014
|
|
41
|
+
* The File.binary method now always returns false for images. It is meant to
|
|
42
|
+
detect executables, shared objects, etc. Use File.image? to detect images.
|
|
43
|
+
* Encoding fixes for the File.image? method.
|
|
44
|
+
|
|
45
|
+
== 1.2.3 - 19-Feb-2014
|
|
46
|
+
* Fixed a bug where File.binary? would return true for unicode text. Thanks go
|
|
47
|
+
to Ben Hollis for the spot.
|
|
48
|
+
* Updated the win32-file and test-unit dependencies.
|
|
49
|
+
* Replace all instances of File.exists? with File.exist? because the former
|
|
50
|
+
is deprecated in Ruby 2.1 and later.
|
|
51
|
+
|
|
52
|
+
== 1.2.2 - 6-Apr-2012
|
|
53
|
+
* Yet another sparse file test fix for OSX, which does not support
|
|
54
|
+
sparse file generation on HFS+.
|
|
55
|
+
* Fixed a bug in the File.whereis method on Windows when dealing with
|
|
56
|
+
absolute paths.
|
|
57
|
+
* Some Config vs RbConfig fixes to silence 1.9.3 warnings.
|
|
58
|
+
* Refactored and cleaned up some tests.
|
|
59
|
+
|
|
60
|
+
== 1.2.1 - 20-May-2011
|
|
61
|
+
* Added an (empty) .gemtest file so that it can be used with test.rubygems.org.
|
|
62
|
+
* Fixed a sparse file test.
|
|
63
|
+
|
|
64
|
+
== 1.2.0 - 8-Jan-2011
|
|
65
|
+
* Added the File.sparse? method for Unix platforms. This method already
|
|
66
|
+
exists on Windows courtesy of the win32-file library.
|
|
67
|
+
|
|
68
|
+
== 1.1.9 - 25-Mar-2010
|
|
69
|
+
* Refactored File.which and File.whereis and added additional tests for each.
|
|
70
|
+
* Removed the block form of File.whereis.
|
|
71
|
+
* Reorganized the Rakefile a bit and put the test tasks under the 'test'
|
|
72
|
+
namespace, and the gem tasks under the 'gem' namespace.
|
|
73
|
+
* Updated the test-unit development dependency.
|
|
74
|
+
* Updates the README.
|
|
75
|
+
|
|
76
|
+
== 1.1.8 - 6-Oct-2009
|
|
77
|
+
* Fixed some bad variable names that crept into the File.nl_convert method.
|
|
78
|
+
* Added the File.null_device alias for File.null.
|
|
79
|
+
* Added cygwin and mingw to Windows detection code.
|
|
80
|
+
* One of the nlconvert tests is now skipped on Windows.
|
|
81
|
+
* Two text files that were previously bundled as part of this library for
|
|
82
|
+
testing purposes have been removed. Those are now dynamically generated
|
|
83
|
+
within the tests themselves.
|
|
84
|
+
* Gemspec updates.
|
|
85
|
+
* Documentation updates.
|
|
86
|
+
* Added the :gem rake task.
|
|
87
|
+
|
|
88
|
+
== 1.1.7 - 28-Jul-2009
|
|
89
|
+
* Now compatible with Ruby 1.9.x.
|
|
90
|
+
* Replaced RUBY_PLATFORM with rbconfig check for the sake of other
|
|
91
|
+
implementations, such as JRuby.
|
|
92
|
+
* Updated the tests to be more friendly to JRuby.
|
|
93
|
+
* Added Test::Unit 2.x as a development dependency.
|
|
94
|
+
* Renamed the test files.
|
|
95
|
+
|
|
96
|
+
== 1.1.6 - 31-Aug-2007
|
|
97
|
+
* Fixed the File.touch method so that it doesn't whack existing files. Thanks
|
|
98
|
+
go to Thomas Preymesser for the spot.
|
|
99
|
+
* Added corresponding tests to the tc_touch.rb file.
|
|
100
|
+
|
|
101
|
+
== 1.1.5 - 19-Jul-2007
|
|
102
|
+
* Added the File.image? method. Inspired by ruby-talk: 260487.
|
|
103
|
+
|
|
104
|
+
== 1.1.4 - 21-May-2007
|
|
105
|
+
* Removed the install.rb file. Installation is now handled exclusively by the
|
|
106
|
+
rake install task.
|
|
107
|
+
* Updated the MANIFEST file, and made it rdoc friendly.
|
|
108
|
+
* Manual installation corrections in the README file.
|
|
109
|
+
|
|
110
|
+
== 1.1.3 - 29-Apr-2007
|
|
111
|
+
* I changed the way that the constants IS_WINDOWS and WIN32EXTS are defined.
|
|
112
|
+
* The IS_WINDOWS and WIN32EXTS are no long documented publically. They were
|
|
113
|
+
never meant for public use.
|
|
114
|
+
* The tc_constants.rb file was modified to only run certain tests on Windows.
|
|
115
|
+
|
|
116
|
+
== 1.1.2 - 28-Apr-2007
|
|
117
|
+
* Fixed a require line that could cause problems on MS Windows.
|
|
118
|
+
* Added a Rakefile which includes tasks for installation and testing.
|
|
119
|
+
* Some cleanup and improvement in the various test files.
|
|
120
|
+
|
|
121
|
+
== 1.1.1 - 24-Aug-2006
|
|
122
|
+
* Added the File.binary? method, based on code from Ryan Davis.
|
|
123
|
+
|
|
124
|
+
== 1.1.0 - 23-Aug-2006
|
|
125
|
+
* Added the File.null method which returns the bit bucket on your platform.
|
|
126
|
+
* The suffixes on MS Windows are now based on the PATHEXT environment variable,
|
|
127
|
+
and defaults to '.com', '.bat' and '.exe' only if it's not defined.
|
|
128
|
+
* The File.which and File.whereis methods were tweaked a bit for Windows so
|
|
129
|
+
that they ignore the case of suffixes.
|
|
130
|
+
* Modified the platform checking and path separator handling.
|
|
131
|
+
* Added and tweaked some tests.
|
|
132
|
+
|
|
133
|
+
== 1.0.0 - 2-Jun-2005
|
|
134
|
+
* Modified the File.middle method to accept an optional block.
|
|
135
|
+
* File.whereis is now limited to unique values so that redundant PATH entries
|
|
136
|
+
do not cause redundant entries in the returned array (or block).
|
|
137
|
+
* File.nl_convert and File.touch now return self.
|
|
138
|
+
* File.nl_convert now raises ArgumentError (instead of StandardError) if
|
|
139
|
+
an unknown platform is provided.
|
|
140
|
+
* File.wc now raises ArgumentError (instead of RuntimeError) if a bad option
|
|
141
|
+
is provided.
|
|
142
|
+
* Made documentation rdoc friendly.
|
|
143
|
+
* Test suite updates, corrections and additions.
|
|
144
|
+
* Removed the INSTALL file. See the README instead.
|
|
145
|
+
* Moved project to RubyForge.
|
|
146
|
+
|
|
147
|
+
== 0.1.3 - 5-Dec-2003
|
|
148
|
+
* Modified File#which and File#whereis for Win32 to handle extensions better,
|
|
149
|
+
i.e. you can send "ruby" or "ruby.exe" and get back the same result.
|
|
150
|
+
* Minor test changes to tc_which.rb and tc_whereis.rb.
|
|
151
|
+
|
|
152
|
+
== 0.1.2 - 14-May-2003
|
|
153
|
+
* Modified nl_convert() to allow the destination filename to be the same as the
|
|
154
|
+
source file. In that case, a tempfile is used and copied back over the
|
|
155
|
+
original file.
|
|
156
|
+
* The target file name for nl_convert() now defaults to the source file name and
|
|
157
|
+
the default format is now "dos".
|
|
158
|
+
* Added a tc_constants.rb test suite.
|
|
159
|
+
* Test suite additions/fixes.
|
|
160
|
+
* Updates to MANIFEST.
|
|
161
|
+
|
|
162
|
+
== 0.1.1 - 21-Mar-2003
|
|
163
|
+
* Modified File.tail to return data in the same order that 'tail' does.
|
|
164
|
+
* Modified File.which to return nil if the program is not found.
|
|
165
|
+
* Modified File.whereis now uses '\' instead of '/' on MS Windows.
|
|
166
|
+
* Added File.middle class method.
|
|
167
|
+
* Test suite modification & additions.
|
|
168
|
+
* Thanks go to Shanko for both the spot and patch for tail, which, whereis
|
|
169
|
+
and middle.
|
|
170
|
+
|
|
171
|
+
== 0.1.0 - 18-Mar-2003
|
|
172
|
+
* Initial release
|
data/Gemfile
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
source 'https://rubygems.org'
|
|
2
|
-
|
|
3
|
-
gem 'structured_warnings'
|
|
4
|
-
|
|
5
|
-
group :production do
|
|
6
|
-
gem 'win32-file' if File::ALT_SEPARATOR
|
|
7
|
-
end
|
|
8
|
-
|
|
9
|
-
group :test do
|
|
10
|
-
gem 'rake'
|
|
11
|
-
gem 'test-unit'
|
|
12
|
-
end
|
|
1
|
+
source 'https://rubygems.org'
|
|
2
|
+
|
|
3
|
+
gem 'structured_warnings'
|
|
4
|
+
|
|
5
|
+
group :production do
|
|
6
|
+
gem 'win32-file' if File::ALT_SEPARATOR
|
|
7
|
+
end
|
|
8
|
+
|
|
9
|
+
group :test do
|
|
10
|
+
gem 'rake'
|
|
11
|
+
gem 'test-unit'
|
|
12
|
+
end
|
data/MANIFEST
CHANGED
|
@@ -1,19 +1,20 @@
|
|
|
1
|
-
* CHANGES
|
|
2
|
-
* README
|
|
3
|
-
* MANIFEST
|
|
4
|
-
* Rakefile
|
|
5
|
-
* ptools.gemspec
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* test/
|
|
9
|
-
* test/
|
|
10
|
-
* test/
|
|
11
|
-
* test/
|
|
12
|
-
* test/
|
|
13
|
-
* test/
|
|
14
|
-
* test/
|
|
15
|
-
* test/
|
|
16
|
-
* test/
|
|
17
|
-
* test/
|
|
18
|
-
* test/img/test.
|
|
19
|
-
* test/img/test.
|
|
1
|
+
* CHANGES
|
|
2
|
+
* README
|
|
3
|
+
* MANIFEST
|
|
4
|
+
* Rakefile
|
|
5
|
+
* ptools.gemspec
|
|
6
|
+
* certs/djberg96_pub.pem
|
|
7
|
+
* lib/ptools.rb
|
|
8
|
+
* test/test_constants.rb
|
|
9
|
+
* test/test_head.rb
|
|
10
|
+
* test/test_image.rb
|
|
11
|
+
* test/test_nlconvert.rb
|
|
12
|
+
* test/test_null.rb
|
|
13
|
+
* test/test_tail.rb
|
|
14
|
+
* test/test_touch.rb
|
|
15
|
+
* test/test_wc.rb
|
|
16
|
+
* test/test_which.rb
|
|
17
|
+
* test/test_whereis.rb
|
|
18
|
+
* test/img/test.gif
|
|
19
|
+
* test/img/test.jpg
|
|
20
|
+
* test/img/test.png
|
data/README
CHANGED
|
@@ -1,66 +1,66 @@
|
|
|
1
|
-
== Description
|
|
2
|
-
The ptools (power tools) library is an additional set of commands for the
|
|
3
|
-
File class based on Unix command line tools.
|
|
4
|
-
|
|
5
|
-
== Prerequisites
|
|
6
|
-
On MS Windows you will need the win32-file gem.
|
|
7
|
-
|
|
8
|
-
== Installation
|
|
9
|
-
gem install ptools
|
|
10
|
-
|
|
11
|
-
== Synopsis
|
|
12
|
-
require "ptools"
|
|
13
|
-
|
|
14
|
-
File.which("ruby") # '/usr/local/bin/ruby'
|
|
15
|
-
File.whereis("ruby") # ['/usr/local/bin/ruby','/opt/bin/ruby']
|
|
16
|
-
|
|
17
|
-
File.head("myfile") # Returns first 10 lines of 'myfile'
|
|
18
|
-
File.tail("myfile",3) # Returns last 3 lines of 'myfile'
|
|
19
|
-
File.wc("myfile",'words') # Returns the number of words in 'myfile'
|
|
20
|
-
|
|
21
|
-
File.touch("newfile") # "newfile" now exists
|
|
22
|
-
File.null # '/dev/null' on Unix, 'NUL' on Windows
|
|
23
|
-
File.binary?('some_file') # true or false
|
|
24
|
-
File.sparse?('some_file') # true or false
|
|
25
|
-
|
|
26
|
-
# Creates a copy of 'myfile' called 'newfile', in DOS format
|
|
27
|
-
File.nl_convert("myfile", "newfile", "dos")
|
|
28
|
-
|
|
29
|
-
== Known Bugs
|
|
30
|
-
The File.which and File.whereis methods may fail when using JRuby on Windows.
|
|
31
|
-
See https://github.com/jruby/jruby/issues/2291 for details.
|
|
32
|
-
|
|
33
|
-
Please report any other issues on the github project page.
|
|
34
|
-
|
|
35
|
-
http://www.github.com/djberg96/ptools
|
|
36
|
-
|
|
37
|
-
== Acknowledgements
|
|
38
|
-
The File.which method was originally adopted from the FileWhich code posted
|
|
39
|
-
by Michael Granger on the now defunct rubygarden.org website. That code was
|
|
40
|
-
later replaced by a version based on the ruby-which library.
|
|
41
|
-
|
|
42
|
-
The File.nl_convert method is based on the nlcvt program found at
|
|
43
|
-
http://www.perl.com/language/ppt/src/nlcvt/nlcvt, written by Tom Christiansen.
|
|
44
|
-
|
|
45
|
-
The binary?() method was based almost entirely on a blog post by Ryan
|
|
46
|
-
Davis (who, in turn, based his code on Perl's -B switch).
|
|
47
|
-
|
|
48
|
-
Thanks go to Matt Hoyle for help with the File.tail method.
|
|
49
|
-
|
|
50
|
-
== Future Plans
|
|
51
|
-
Add whatever other tools people think might be useful.
|
|
52
|
-
|
|
53
|
-
== License
|
|
54
|
-
Artistic 2.0
|
|
55
|
-
|
|
56
|
-
== Copyright
|
|
57
|
-
(C) 2003-2014 Daniel J. Berger
|
|
58
|
-
All Rights Reserved.
|
|
59
|
-
|
|
60
|
-
== Warranty
|
|
61
|
-
This package is provided "as is" and without any express or
|
|
62
|
-
implied warranties, including, without limitation, the implied
|
|
63
|
-
warranties of merchantability and fitness for a particular purpose.
|
|
64
|
-
|
|
65
|
-
== Author
|
|
66
|
-
Daniel J. Berger
|
|
1
|
+
== Description
|
|
2
|
+
The ptools (power tools) library is an additional set of commands for the
|
|
3
|
+
File class based on Unix command line tools.
|
|
4
|
+
|
|
5
|
+
== Prerequisites
|
|
6
|
+
On MS Windows you will need the win32-file gem.
|
|
7
|
+
|
|
8
|
+
== Installation
|
|
9
|
+
gem install ptools
|
|
10
|
+
|
|
11
|
+
== Synopsis
|
|
12
|
+
require "ptools"
|
|
13
|
+
|
|
14
|
+
File.which("ruby") # '/usr/local/bin/ruby'
|
|
15
|
+
File.whereis("ruby") # ['/usr/local/bin/ruby','/opt/bin/ruby']
|
|
16
|
+
|
|
17
|
+
File.head("myfile") # Returns first 10 lines of 'myfile'
|
|
18
|
+
File.tail("myfile",3) # Returns last 3 lines of 'myfile'
|
|
19
|
+
File.wc("myfile",'words') # Returns the number of words in 'myfile'
|
|
20
|
+
|
|
21
|
+
File.touch("newfile") # "newfile" now exists
|
|
22
|
+
File.null # '/dev/null' on Unix, 'NUL' on Windows
|
|
23
|
+
File.binary?('some_file') # true or false
|
|
24
|
+
File.sparse?('some_file') # true or false
|
|
25
|
+
|
|
26
|
+
# Creates a copy of 'myfile' called 'newfile', in DOS format
|
|
27
|
+
File.nl_convert("myfile", "newfile", "dos")
|
|
28
|
+
|
|
29
|
+
== Known Bugs
|
|
30
|
+
The File.which and File.whereis methods may fail when using JRuby on Windows.
|
|
31
|
+
See https://github.com/jruby/jruby/issues/2291 for details.
|
|
32
|
+
|
|
33
|
+
Please report any other issues on the github project page.
|
|
34
|
+
|
|
35
|
+
http://www.github.com/djberg96/ptools
|
|
36
|
+
|
|
37
|
+
== Acknowledgements
|
|
38
|
+
The File.which method was originally adopted from the FileWhich code posted
|
|
39
|
+
by Michael Granger on the now defunct rubygarden.org website. That code was
|
|
40
|
+
later replaced by a version based on the ruby-which library.
|
|
41
|
+
|
|
42
|
+
The File.nl_convert method is based on the nlcvt program found at
|
|
43
|
+
http://www.perl.com/language/ppt/src/nlcvt/nlcvt, written by Tom Christiansen.
|
|
44
|
+
|
|
45
|
+
The binary?() method was based almost entirely on a blog post by Ryan
|
|
46
|
+
Davis (who, in turn, based his code on Perl's -B switch).
|
|
47
|
+
|
|
48
|
+
Thanks go to Matt Hoyle for help with the File.tail method.
|
|
49
|
+
|
|
50
|
+
== Future Plans
|
|
51
|
+
Add whatever other tools people think might be useful.
|
|
52
|
+
|
|
53
|
+
== License
|
|
54
|
+
Artistic 2.0
|
|
55
|
+
|
|
56
|
+
== Copyright
|
|
57
|
+
(C) 2003-2014 Daniel J. Berger
|
|
58
|
+
All Rights Reserved.
|
|
59
|
+
|
|
60
|
+
== Warranty
|
|
61
|
+
This package is provided "as is" and without any express or
|
|
62
|
+
implied warranties, including, without limitation, the implied
|
|
63
|
+
warranties of merchantability and fitness for a particular purpose.
|
|
64
|
+
|
|
65
|
+
== Author
|
|
66
|
+
Daniel J. Berger
|