.. image:: https://img.shields.io/pypi/v/mslex.svg :target: https://pypi.python.org/pypi/mslex
.. image:: https://img.shields.io/travis/com/smoofra/mslex.svg :target: https://travis-ci.org/smoofra/mslex
.. image:: https://readthedocs.org/projects/mslex/badge/?version=latest :target: https://mslex.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status
shlex for windows
This is the missing shlex package for windows shell quoting. It provides three functions -- split, quote, and join -- just like shlex.
Since time immemorial, windows quoting behavior has been strange. Prior to
(I think) Visual Studio 2005, it exhibited the extremely strange modulo 3
periodic behavior which is emulated here in split_msvcrt(). Programs
compiled with the C runtime from Visual Studio 2005 and later exhibit the
somewhat less strange behavior emulated in split_ucrt().
Microsoft still ships a dll called msvcrt.dll as part of Windows,
for compatibility reasons. And even though they have been very clear in
their documentation that nobody should ever link against this dll, people
still do, either for compatibility reasons of their own, or because it
is universally available on any version of windows you might care about
without needing to run an installer. And msvcrt.dll preserves the
extremely strange argument parsing behavior from prior to VS 2005.
You can can download the latest version of msys2_ today and build an
executable linking msvcrt.dll on Windows 11, and it will parse
arguments like Windows 95.
mslex will produce quoted strings that will be parsed correctly by
either modern C runtimes or by msvcrt.dll. When parsing, mslex
parses it both ways and raises an error if they disagree. This can
be overridden by passing ucrt=True or ucrt=False to split.
See also:
Parsing C Command Line Arguments_
Windows is not a Microsoft Visual C/C++ Run-Time delivery channel_
How a Windows Program Splits Its Command Line Into Individual Arguments_
Everyone quotes command line arguments the wrong way_
.. _How a Windows Program Splits Its Command Line Into Individual Arguments:
https://web.archive.org/web/20220629212422/http://www.windowsinspired.com/how-a-windows-programs-splits-its-command-line-into-individual-arguments/
.. _Everyone quotes command line arguments the wrong way:
https://blogs.msdn.microsoft.com/twistylittlepassagesallalike/2011/04/23/everyone-quotes-command-line-arguments-the-wrong-way/
.. _Windows is not a Microsoft Visual C/C++ Run-Time delivery channel: https://devblogs.microsoft.com/oldnewthing/20140411-00/?p=1273
.. _msys2: https://www.msys2.org/docs/environments/
.. _Parsing C Command Line Arguments: https://learn.microsoft.com/en-us/cpp/c-language/parsing-c-command-line-arguments?view=msvc-170
If you want to automatically use mslex on Windows, and shlex otherwise, check out the oslex_ package.
.. _oslex: https://pypi.org/project/oslex/
.. _msvcrt: https://devblogs.microsoft.com/oldnewthing/20140411-00/?p=1273
.. _UCRT: https://learn.microsoft.com/en-us/cpp/porting/upgrade-your-code-to-the-universal-crt?view=msvc-170
FAQs
shlex for windows
We found that mslex demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
