FS (FileSystem) Build Status

Work with your filesystem!

Problem

This Gem shouldn't reinvent the wheel or be a replacement. But in Ruby working with the filesystem really hurts!

In your toolbox are at least File, Dir, FileUtils, Find, and maybe some more. Good tools, but to complicated for most cases. It's not about piping, or copying the shell as it is. But think about a simple ls in the shell, than how you would do this in Ruby. Got the idea?

Solution

FS gathers the cluttered methods for working with files and dirs. Internally using the good old standard library, but providing simple methods in a single place.

Examples

FS.changedir('~/Projects/fs')
==> "/Users/bjuenger/Projects/fs"
FS.list('.')
==> [".git", ".gitignore", ".rvmrc", "fs.gemspec", "Gemfile", "Gemfile.lock", "lib", "Rakefile", "README.mdown", "spec"]
FS.makedirs('tmp/demo')
FS.touch('tmp/demo/newfile.txt')
FS.list('tmp/demo')
==> ["newfile.txt"]
FS.remove('tmp/demo/newfile.txt')
FS.list('tmp/demo')
==> []

Aliases

Although verbose method names are good, there are some aliases for unix shell commands (unsorted).

  • ls => :list
  • mkdir => :makedir
  • mkdir_p => :makedirs
  • rmdir => :removedir
  • rm_r => :removedirs
  • cd => :changedir
  • pwd => :currentdir
  • mv => :move
  • cp => :copy
  • rm => :remove
  • cat => :read
  • ln => :link
  • dir? => :directory?
  • expand => :expand_path
  • [] => :join

Todo

Here is my mind …

  • maybe use underscores (remove_dir)
  • remove! to force something
  • maybe makedir! to mkdir -p
  • maybe touch! to mkdir -p && touch
  • use Find#find in FS#find ;)
  • file type / ftype
  • list_dirs
  • list_files
  • find_dirs
  • find_files
  • FS.link('a.txt' => 'b.txt') with a hash