Lexical analyzer for simple shell-like syntax.

cl-shlex

A lexer for syntaxes that use shell-like rules for quoting and commenting. It is a port of the `shlex` module from Python’s standard library.

The point of entry is `split`:

    (shlex:split "a 'b c' \"d e\" \"f ' g\"")
    => '("a" "b c" "d e" "f ' g")

For a parse that is closer to a shell, you can pass the `:punctuation-chars` keyword:

    ;; Not what you want.
    (shlex:split "a && b; c && d || e; f >'abc'; (def \"ghi\")")
    => '("a" "&&" "b;" "c" "&&" "d" "||" "e;" "f" ">abc;" "(def" "ghi)")

    (shlex:split "a && b; c && d || e; f >'abc'; (def \"ghi\")" :punctuation-chars t)
    => ("a" "&&" "b" ";" "c" "&&" "d" "||" "e" ";" "f" ">" "abc" ";" "(" "def" "ghi" ")")

If you would rather iterate over each token in turn, you can use `shlex:map-tokens` or `shlex:do-tokens` instead.

    ;; Print each token in STRING.
    (shlex:map-tokens #'print string :punctuation-chars t)

    ;; Do the same thing with a macro.
    (shlex:do-tokens (token (string :punctuation-chars t))
      (print token))


cl-shlex

Upstream URL

Author

License

shlex

License:

Authors:

Dependencies:

shlex/test

License:

Authors:

Dependencies:

Dependencies (5)

Dependents (3)