mslex icon indicating copy to clipboard operation
mslex copied to clipboard

like shlex, but for windows

===== mslex

.. 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

  • Free software: Apache Software License 2.0
  • Documentation: https://mslex.readthedocs.io.

Features

This is the missing shlex package for windows shell quoting. It provides three functions -- split, quote, and join -- just like shlex.

Windows Quoting

These are excellent articles to read if you really want to face the sanity-melting reality buried under the surface of how windows passes command line arguments to your programs. I recommend you read something else.

  • 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/

Automatic selection between mslex and shlex

If you want to automatically use mslex on Windows, and shlex otherwise, check out the oslex_ package.

.. _oslex: https://pypi.org/project/oslex/