view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    Instead of generating a shell configuration, list the directories in
    the given path style variable

 --login

    Use the your default login shell (as determined by Shell::Guess) On
    Unix style systems this consults the GECOS field in the /etc/passwd
    file or uses NIS. On other platforms it may use another means to
    determine your login shell, or simply make an informed guess based on
    the platform.

 --no-cygwin

    Remove any cygwin paths. Has no affect on non cygwin platforms.

 --power

    Generate Power shell configuration

 --sh

    Generate bourne shell configuration

 --sep char | --sep-in char | --sep-out char

    You can use these options to change the path separator character.
    Normally you do not need to set this. the Platform default is used for
    input (: for Unix and cygwin, and ; for Windows) and the shell default
    is used for output (: for sh and csh, and ; for command.com and
    cmd.exe). But in some situation you might want a UNIX style path in a
    cmd.exe script. Any character may be specified, but keep in mind that
    not all characters are supported by Shell::Config::Generate.

 --squash | -s

    Remove duplicate paths from the given path style variable.

 --trim | -t

    Trim non-existing directories. This is a good idea since such
    directories can sometimes cause spaceless to die.

 --version | v

    Print version number and exit

EXAMPLES

 Removing spaces from the PATH on Cygwin

    My motivation for writing this script was trying to get perlbrew to
    work on Cygwin. Since Windows frequently includes spaces in its %PATH%
    environment variable, and cygwin inherits them.

     xian-x86_64% source ~/perl5/perlbrew/etc/cshrc
     setenv: Too many arguments.
     xian-x86_64% eval `spaceless PATH`
     xian-x86_64% source ~/perl5/perlbrew/etc/cshrc
     xian-x86_64%

    I could have manually updated my %PATH% to not include spaces, or
    better yet submitted a patch to perlbrew to fix its spacing problem.
    This probably won't be the last script that I will have the spaces in
    the %PATH% problem with.

 Visualizing the PATH

    Reading the %PATH% variable can be difficult, especially if you have
    already removed the spaces and are using the short version.

     C:\> echo %PATH%
     N:\lang\perl\strawberry\x86\5.18.2\c\bin;N:\lang\perl\strawberry
     \x86\5.18.2\perl\site\bin;N:\lang\perl\strawberry\x86\5.18.2\per
     l\bin;n:\program32\GnuWin32\bin;C:\PROGRA~2\NVIDIA~1\PhysX\Commo
     n;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Win
     dows\System32\WindowsPowerShell\v1.0\;C:\PROGRA~1\MICROS~3\110\T
     ools\Binn\;C:\PROGRA~2\Git\cmd;N:\lang\tcl\x86\8.6.1.0\bin;C:\PR
     OGRA~2\NVIDIA~1\PhysX\Common;C:\PROGRA~2\Intel\ICLSCL~1\;C:\PROG
     RA~1\Intel\ICLSCL~1\;C:\Windows\system32;C:\Windows;C:\Windows\S
     ystem32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;

    You can use the -l (short for --list) and -x (short for --expand)
    options to make it a little more readable

     C:\> spaceless -l -x
     N:\lang\perl\strawberry\x86\5.18.2\c\bin
     N:\lang\perl\strawberry\x86\5.18.2\perl\site\bin
     N:\lang\perl\strawberry\x86\5.18.2\perl\bin
     N:\program32\GnuWin32\bin
     C:\Program Files (x86)\NVIDIA Corporation\PhysX\Common
     ...

 Remove duplicate directories in the path

    You can use the -s (short for --squeeze) option to squeeze out
    duplicate paths. It keeps the first instance of a directory in a path
    style variable, which is usually what you want.

     % spaceless -l
     /usr/local/bin
     /usr/bin
     /bin
     /usr/local/bin
     % spaceless -s -l
     /usr/local/bin
     /usr/bin
     /bin

    You can then update the PATH with the eval trick:

     % eval `spaceless -s`

CAVEATS

    Short names with the 8.3 spaceless naming convention can be turned off
    using tweaks to the windows registry (see
    https://technet.microsoft.com/en-us/library/cc959352.aspx). This
    program would not be of much use on such a system.

AUTHOR