comex/rust-shlex

Split a string into shell words, like Python's shlex.

156

stars

63

commits

Rust

primary language

Jun 12, 2026

updated

crates.io/crates/shlex

README

ci badge crates.io badge docs.rs badge

Same idea as (but implementation not directly based on) the Python shlex module. However, this implementation does not support any of the Python module's customization because it makes parsing slower and is fairly useless. You only get the default settings of shlex.split, which mimic the POSIX shell: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html

This implementation also deviates from the Python version in not treating \r specially, which I believe is more compliant.

This crate can be used on either normal Rust strings, or on byte strings with the bytes module. The algorithms used are oblivious to UTF-8 high bytes, so internally they all work on bytes directly as a micro-optimization.

Disabling the std feature (which is enabled by default) will allow the crate to work in no_std environments, where the alloc crate, and a global allocator, are available.

LICENSE

The source code in this repository is Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Contributors

fenhl

37 commits

comex

12 commits

u1f408

5 commits

atouchet

2 commits

comex/rust-shlex

Split a string into shell words, like Python's shlex.

156

stars

63

commits

Rust

primary language

Jun 12, 2026

updated

crates.io/crates/shlex

README

ci badge crates.io badge docs.rs badge

Same idea as (but implementation not directly based on) the Python shlex module. However, this implementation does not support any of the Python module's customization because it makes parsing slower and is fairly useless. You only get the default settings of shlex.split, which mimic the POSIX shell: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html

This implementation also deviates from the Python version in not treating \r specially, which I believe is more compliant.

This crate can be used on either normal Rust strings, or on byte strings with the bytes module. The algorithms used are oblivious to UTF-8 high bytes, so internally they all work on bytes directly as a micro-optimization.

Disabling the std feature (which is enabled by default) will allow the crate to work in no_std environments, where the alloc crate, and a global allocator, are available.

LICENSE

The source code in this repository is Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Contributors

fenhl

37 commits

comex

12 commits

u1f408

5 commits

atouchet

2 commits

Languages

Rust

93.1%

Shell

5.4%

C

1.2%