by Corey Johnson http://github.com/probablycorey/pow
Manipulating files and directories in Ruby is boring and tedious – it’s missing POW! Pow treats files and directories as ruby objects giving you more power and flexibility.
Why not just use File, FileUtils, Find, FileTest, Pathname, etc…? Because Pow combines the power of those libraries into one rubyish interface.
Consider this directory structure
/tmp
README
/sub_dir
/deeper_dir
file.txt
program
/extra_dir
To open a directory
path = Pow("tmp")
Check out what’s inside a directory
path = Pow("tmp")
path.each {|child| puts "#{child} - #{child.class.name}!" }
# Output!
# -------
/tmp/README - Pow::File
/tmp/sub_dir - Pow::Directory
/tmp/sub_dir/deeper_dir - Pow::Directory
/tmp/sub_dir/file.txt - Pow::File
/tmp/sub_dir/program - Pow::File
/tmp/extra_dir - Pow::Directory
Access a file in that directory
# The / operator accepts symbols, strings or other Pow objects file = path / :sub_dir / "file.txt" # You can also use brackets to access paths file = path[:sub_dir, "file.txt"]
Create nested directories
# When you create a directory, the block will change the current working directory to the newly created directory
Pow("MOAR").create do
Pow("sub_dir").create do
Pow("info.txt").create {|file| file.puts "Here is the info you desired!"}
end
Pow("README").create_file {|file| file.puts "I'm so glad you read this."}
end
# Creates directory structure
/MOAR
/sub_dir
info.txt
README
Open a file
Pow(:tmp, :sub_dir, :file.txt) do |file| # All the stuff you usually do with an open file! end
Create a file
Pow("tmp/sub_dir/new_file.txt").create do |file| # All the stuff you usually do with an new file! end
If you hate having to write require File.expand_path(File.dirname(__FILE__) + “/lib/something_else”) all the time, instead try this
# The Pow! method will automatically create a path based on the current files parent require Pow!("lib/something_else") # Instead of require File.expand_path(File.dirname(__FILE__) + "/lib/something_else")
Other things you can do (read more about them in the docs)
- Directories that actually use Enumerable! - Move files/directores - Copy files/directories - Get/set permissions - Delete and recursive deletes - Combining paths with the / operator - And much much more!
$ sudo gem install pow
1.) Pow is fun to say. 2.) Pow is easy to type. 3.) It knocks you on your ass.
-
A computer
-
sudo gem install pow
-
Chris Shea ruby.tie-rack.org/
Copyright © 2007 Corey Johnson and the rest of the Ruby Hit Squad
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ‘Software’), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.