- COPYRIGHT AND LICENSE
spaceless - Remove spaces and other hazards from your PATH
Convert PATH (by default):
cygwin% spaceless PATH=/usr/bin:/cygdrive/c/PROGRA~2/NVIDIA~1/PhysX/Common:... export PATH
Convert another PATH style environment variable
cygwin% spaceless PERL5LIB PERL5LIB=/PERL~1/lib:/PERL~2/lib export PERL5LIB
Update the PATH in the current shell (works with both sh and csh):
cygwin% eval `spaceless PATH`
Same thing from
C:\> spaceless PATH -f path.bat C:\> path.bat
Although legal in most modern operating system directory names, spaces are only frequently encountered in Windows. This can be troublesome for some tools that do not take such antics into account. Fortunately, Windows provides alternate file and directory names for any name that is not compatible with MS DOS. Since spaces were never supported by MS DOS we can use these alternate names for tools that don't take spaces into account.
spaceless converts PATH style environment variables on windows into equivalents that do not have spaces. By default it uses Shell::Guess to make a reasonable guess as to the shell you are currently using (not your login shell). You may alternately specify a specific shell type using one of the options below.
spaceless will not convert long directory (non 8.3 format) names that do not have spaces, as these are usually handled gracefully by scripts that are space challenged.
Generate cmd.exe configuration
Generate command.com configuration
Generate c shell configuration
Write configuration to filename instead of standard output
Expand short paths to long paths (adding any spaces that may be back in)
Generate fish shell configuration
Print help message and exit
Generate korn shell configuration
Instead of generating a shell configuration, list the directories in the given path style variable
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.
Remove any cygwin paths. Has no affect on non cygwin platforms.
Generate Power shell configuration
Generate bourne shell configuration
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
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.
Remove duplicate paths from the given path style variable.
Trim non-existing directories. This is a good idea since such directories can sometimes cause spaceless to die.
Print version number and exit
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.
%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\184.108.40.206\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
-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 ...
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`
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.
Graham Ollis <email@example.com>
This software is copyright (c) 2014 by Graham Ollis.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.