oslex

oslex is an OS-independent wrapper for shlex and mslex.

Its main purpose is to provide functions similar in functionality to shlex.quote(), shlex.split() and shlex.join() on both Windows and POSIX-compatible platforms.

This goal is achieved by simply forwarding the calls to either shlex (from the standard library) on POSIX-compatible systems, or the excellent mslex library (written by Lawrence D'Anna / @smoofra) on Windows.

In other words, oslex is to shlex/mslex what os.path is to posixpath/ntpath.

Reference

The three main interface functions are oslex.join(), oslex.quote() and oslex.split().

They all support taking a single positional argument, and a variety of optional keyword arguments. Keyword arguments starting with ms_ are passed to the underlying mslex function on Windows, and are ignored on non-Windows platforms. Keyword arguments starting with sh_ are passed to the underlying shlex function on non-Windows platforms, and are ignored on Windows. The default values of keyword arguments are the same as for the underlying libraries.

In addition, each function has two extra variants: one with the suffix _sh, and one with the suffix _ms. They have the exact same interface as the main variants, except they always call the shlex or mslex library functions instead of deciding based on platform. They can be useful in situations when a specific implementation is needed regardless of platform, but support for Path arguments is desirable.

oslex.join()

Quote arguments according to platform-specific rules, then join them to form a full command line. Returns str.

Calls mslex.join() on Windows, and shlex.join() on non-Windows platforms.

Arguments:

oslex.quote()

Quote argument according to platform-specific rules. Returns str.

Calls mslex.quote() on Windows, and shlex.quote() on non-Windows platforms.

Arguments:

oslex.split()

Split command line into arguments according to platform-specific rules. Returns list[str].

Calls mslex.split() on Windows, and shlex.split() on non-Windows platforms.

Arguments:

oslex.join_ms(), oslex.quote_ms(), oslex.split_ms()

Same as oslex.join(), oslex.quote() and oslex.split(), except they always call mslex regardless of platform.

See documentation of arguments at the respective function. (Keyword arguments starting with sh_ are always ignored.)

oslex.join_sh(), oslex.quote_sh(), oslex.split_sh()

Same as oslex.join(), oslex.quote() and oslex.split(), except they always call shlex regardless of platform.

See documentation of arguments at the respective function. (Keyword arguments starting with ms_ are always ignored.)

Licensing

This library itself is licensed under the MIT license.

oslex uses the mslex library, which is distributed under the Apache 2.0 license.