App::pathed - munge the Bash PATH environment variable
$ PATH=$(pathed --unique --delete rbenv) $ PATH=$(pathed --append /home/my/bin -a /some/other/bin) $ PATH=$(pathed --prepend /home/my/bin -p /some/other/bin) $ for i in $(pathed --split); do ...; done $ pathed --check $ pathed -u --var PERL5LIB $ pathed -u $PERL5LIB $ pathed -d two --sep ';' '/foo/one;foo/two' $ pathed --man
PATH environment variable contains a colon-separated list of paths. Platforms other than UNIX might use a different separator;
pathed uses the default separator for the current OS.
pathed - "path editor" - can split the path, append, prepend or remove elements, remove duplicates and reassemble it.
The result is then printed so you can assign it to the
PATH variable. If
--split is used, each path element is printed on a separate line, so you can iterate over them, for example.
The path elements can also be checked with
--check to make sure that the indicated paths are readable.
pathed isn't just for the
PATH variable. You can specify an environment variable to use with the
--var option, or just pass a value to be used directly after the options.
The following command-line options are supported:
Appends the given path to the list of path elements. This option can be specified several times; the paths are appended in the given order.
Prepends the given path to the list of path elements. This option can be specified several times; the paths are prepended in the given order. For example:
$ pathed -p first -p second -p third
will result in
Deletes those path elements which contain the given substring. This option can be specified several times; the path elements are deleted in the given order.
When options are mixed,
--appendis processed first, then
Removes duplicate path elements.
Prints each path element on its own line. If this option is not specified, the path elements are printed on one line, joined by the default path separator as reported by Config - usually a colon -, like you would normally specify the
Checks whether each path element is readable and prints warnings if necessary. Does not check whether the path element is a directory because
pathedcan also be used for specifying multiple files such as configuration files. Warnings are printed only once per path element, even if that element occurs several times in
--checkis used, the path is not printed.
--splitare mutually exclusive.
Use the indicated environment variable.
The default path separator is what Config reports - usually a colon - but with this option you can specify a different separator. It is used to split the input path and to join the output path.
Prints the synopsis.
Prints the whole documentation.
The initial motivation for writing
pathed came when I tried to install
rbenv was active.
vim wanted to be compiled with the system ruby, so I was looking for a quick way to remove
rbenv from the
$ PATH=$(pathed -d rbenv) brew install vim
The following person is the author of all the files provided in this distribution unless explicitly noted otherwise.
Marcel Gruenauer <email@example.com>, http://marcelgruenauer.com
COPYRIGHT AND LICENSE
The following copyright notice applies to all the files provided in this distribution, including binary files, unless explicitly noted otherwise.
This software is copyright (c) 2013 by Marcel Gruenauer.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.