Shards are a miscellaneous collection of Ruby libraries that the author put under a common project. The libraries range from additional methods for the core File class, to ports of various Perl modules (more or less) to libraries designed to replace the ones that ship with Ruby's standard library.
Click on the library name on the left to go to the documentation for that library. In some cases the documentation is generic. In others it's platform specific.
Below is a quick synopsis of each library.
Works on all platforms that have a 'tar' command line program, along with at least one compression program.
Installation: gem install archive-tar-external
It's a handy shortcut for dealing with situations where the the host/server you're connecting to might flake out temporarily, and you would rather try again rather than have your program terminate immediately.
Installation: gem install attempt
Installation: gem install crypt-fog
But, it's cool because, you know, Julius Caesar used character rotation as a means of encryption. You want to be like Julius Caesar, don't you? Of course you do!
Installation: gem install crypt-rot13
You can also just use it as a simple password manager if you prefer. Just keep in mind that this library does NOT do any sort of implicit encryption.
Installation: gem install dbi-dbrc
In short, it allows you to mixin singleton methods from other classes as though they were instance methods of the current class.
Installation: gem install facade
It was modeled somewhat on the 'find' command line tool, in terms of the options that it supports.
Installation: gem install file-find
This library uses your system's native tmpfile(), tmpfile_s() or mkstemp() functions instead of trying to handle race conditions manually via pure Ruby.
In addition, the FileTemp class is a subclass of File (Ruby's Tempfile is not), so you have a familiar sensible interface with all the behavior you would expect of an IO instance. Except for that bit where the file is temporary, of course.
Installation: gem install file-temp
The first, Getopt::Std, is based on the Perl module of the same name, and is useful when all you want are a few simple options.
The second, Getopt::Long, combines features from both the GetoptLong library (from Ruby's standard library) and the Perl module of the same name.
Installation: gem install getopt
|Visit the Forum|
|File a Bug|
|Make a Feature Request|