= wordexp - perform word expansion like a POSIX shell This is a trivial C extension which allows access to the wordexp(3) POSIX function. See the wordexp(3) manpage for details. For implementations with a GVL (Global VM Lock), this releases the GVL when using command expansion. Long-running commands do not freeze the entire VM. Compared to the Shellwords.split method in the Ruby standard library, wordexp is also capable of shell string operations in POSIX shell syntax, (environment) variable substitution, tilde path expansion, command substition ($(command) or `command`), arithmetic expansion, wildcard expansion, and respects the IFS environment variable. Requirements ------------ * a Free, Unix-like operating system with the wordexp(3) POSIX function * a C compiler and standard development environment * Ruby 1.9.3 or later (any Ruby implementation compatible with C extensions) Usage ----- Online: http://bogomips.org/ruby-wordexp/api.txt Or once installed: ri Wordexp ri Wordexp#wordexp Install ------- Installation is easy using RubyGems: gem install wordexp If you do not use RubyGems, you may also install from the tarball: wget http://bogomips.org/ruby-wordexp/files/wordexp-1.0.0.tgz tar zxvf wordexp-1.0.0.tgz cd wordexp-1.0.0 ruby setup.rb Source ------ git clone git://bogomips.org/ruby-wordexp.git Also viewable with a browser via cgit or gitweb: http://bogomips.org/ruby-wordexp.git It is also mirrored on repo.or.cz git clone git://repo.or.cz/ruby-wordexp.git And viewable with gitweb: http://repo.or.cz/w/ruby-wordexp.git Contact ------- Bug reports, user/development discussion, patches, pull requests are greatly appreciated via plain-text email. Please use "git format-patch -M" to format your patches and "git send-email" to send patches. Pull requests should be formatted using the "git request-pull" command. The public mailing list is at: ruby-wordexp-public@bogomips.org Archives are available at: http://bogomips.org/ruby-wordexp-public/ If you have an issue you wish to keep private, feel free to contact Eric Wong directly at: bofh@bogomips.org HTML email will be mercilessly deleted. Links ----- homepage - http://bogomips.org/ruby-wordexp/README Atom feed - http://bogomips.org/ruby-wordexp/NEWS.atom.xml License ------- Ruby wordexp is copyrighted Free Software by all contributors, see logs in revision control for names and email addresses of all of them. You can redistribute Ruby wordexp and/or modify it under the terms of the GNU Lesser General Public License, version 2.1 or later as published by the Free Software Foundation. Ruby wordexp is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with Ruby wordexp; if not, see https://www.gnu.org/licenses/lgpl-2.1.txt or https://www.gnu.org/licenses/lgpl-3.0.txt