• Homepage
• Issues
• Documentation
• Email

This gem contains a collection of libraries to ease working with the shell with ruby.

A lot of the ideas here are inspired by the utilities in methadone. In particular logger.rb and sh.rb which were based on cli_logger.rb, cli_logging.rb, error.rb, exit_now.rb, process_status.rb, run.rb from methadone.

The reason to incorporate them in this gem is that I wanted to be able to add some functionalities (such as log_and_do for logger.rb, and on succes and on error callbacks for sh.rb), and also to be able to use this functionality from other command parsers than methadone (like gli).

One of the main feature is an extension of the class Pathname with a lots of methods to help in shell related task.

~~~ ruby
require 'shell_helpers'
SH::Pathname.new("foo").cp("bar") #calls FileUtils.cp("foo","bar")
SH::Pathname.new("foo/").on_cp("bar","baz") #copy 'bar' and 'baz' to 'foo/'
SH::Pathname.new("foo").on_rm(mode: :dangling_symlink) #remove 'foo' only if it is a dangling symlink
SH::Pathname.new("foo").squel("bar/baz", action: :on_ln_s) #create a symlink foo/bar/baz -> ../../bar/baz

#Symlink all files in a directory into another, while preserving the structure
SH::Pathname.new("foo").squel_dir("bar',action: :on_ln_s)
#Remove these symlinks
SH::Pathname.new("foo").squel_dir("bar") {|o,t| o.on_rm(mode: :symlink)} 
~~~

For now the API is experimental and some parts are not ready to use!

$ gem install shell_helpers

Copyright © 2015–2020 Damien Robert

MIT License. See LICENSE.txt for details.

See above for the copyright: for the files logger.rb and sh.rb the copyright applies only to the diff from the original import from methadone.