ptools 1.3.2-universal-mingw32 → 1.3.3-universal-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- 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
|