• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1[![ci badge]][ci link] [![crates.io badge]][crates.io link] [![docs.rs badge]][docs.rs link]
2
3[crates.io badge]: https://img.shields.io/crates/v/shlex.svg?style=flat-square
4[crates.io link]: https://crates.io/crates/shlex
5[docs.rs badge]: https://img.shields.io/badge/docs-online-dddddd.svg?style=flat-square
6[docs.rs link]: https://docs.rs/shlex
7[ci badge]: https://img.shields.io/github/actions/workflow/status/comex/rust-shlex/test.yml?branch=master&style=flat-square
8[ci link]: https://github.com/comex/rust-shlex/actions
9
10Same idea as (but implementation not directly based on) the Python shlex
11module. However, this implementation does not support any of the Python
12module's customization because it makes parsing slower and is fairly useless.
13You only get the default settings of shlex.split, which mimic the POSIX shell:
14<https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html>
15
16This implementation also deviates from the Python version in not treating \r
17specially, which I believe is more compliant.
18
19The algorithms in this crate are oblivious to UTF-8 high bytes, so they iterate
20over the bytes directly as a micro-optimization.
21
22Disabling the `std` feature (which is enabled by default) will allow the crate
23to work in `no_std` environments, where the `alloc` crate, and a global
24allocator, are available.
25
26# LICENSE
27
28The source code in this repository is Licensed under either of
29- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
30  https://www.apache.org/licenses/LICENSE-2.0)
31- MIT license ([LICENSE-MIT](LICENSE-MIT) or
32  https://opensource.org/licenses/MIT)
33
34at your option.
35
36Unless you explicitly state otherwise, any contribution intentionally submitted
37for inclusion in the work by you, as defined in the Apache-2.0 license, shall
38be dual licensed as above, without any additional terms or conditions.
39