== Pow
by Corey Johnson
http://github.com/probablycorey/pow
== Description:
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.
== Basic Usage
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/subdir - 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 accepcts symbols, strings or other Pow objects
file = path / :subdir / "file.txt"
# You can also use brackets to access paths
file = path[:subdir, "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
Do you hate having to write <b>require File.expand_path(File.dirname(__FILE__) + "/lib/something_else")</b> 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!
== Installation:
$ sudo gem install pow
== Why Is It Called Pow:
1.) Pow is fun to say.
2.) Pow is easy to type.
3.) It knocks you on your ass.
== Requirements:
* A computer
== Install:
* sudo gem install pow
== Special Thanks:
* Chris Shea http://ruby.tie-rack.org/
== License:
Copyright (c) 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.
) is private.
