Can path manipulation be enjoyable? YES!
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
.gitignore
License.txt
Manifest.txt
README.rdoc
Rakefile
TODO
VERSION
pow.gemspec

README.rdoc

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/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!

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:

License:

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.