Why Sponsor Oils? | source | all docs for version 0.22.0 | all versions | oilshell.org
Warning: Work in progress! Leave feedback on Zulip or Github if you'd like this doc to be updated.
YSH is a shell that lets you write correct programs. Programs often parse multiple records or strings sent over a pipe, i.e. the "framing problem". (This terminology is borrowed from network engineering.)
YSH provides a few solutions for that, and each solution is useful in certain contexts.
The traditional Unix solution. It doesn't work when the payload contains newlines.
Note that Unix filenames, argv
entries, and environ
entries can all
contain newlines, but not NUL
(\0
).
read -0
So naturally we also support the format that find -print0
emits, and
xargs -0
consumes.
QSN uses backslash escapes like \n
, \x00
, and \u{3bc}
to express
arbitrary bytes (and characters).
TODO: Implement this.
Like QSN, this format is "8-bit clean", but:
However, the encoded output may contain binary data, which is hard to view in a terminal.