Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.2.0 - 2026-07-24

comments: true option for ShellWords.split/2 and ShellWords.split!/2. An unquoted, unescaped # starts a comment only at the start of a word; echo hello#world remains one word.
Compatibility tests for supported behavior shared with Python shlex and Ruby Shellwords.

Documented that invalid UTF-8 bytes are preserved by split/2.
Documented that backslash-newline is preserved literally rather than treated as line continuation.

ShellWords.split/2 and ShellWords.split!/2: POSIX-like word splitting with single quotes, double quotes (POSIX backslash semantics), backslash escaping outside quotes, empty quoted words, and adjacent segment concatenation.
ShellWords.escape/1: shlex.quote-style escaping with an exact ASCII safe-word whitelist.
ShellWords.join/1: escape and join argv into one shell-safe string.
ShellWords.ParseError with reason, 0-based byte position, and message (reasons: :unterminated_single_quote, :unterminated_double_quote, :trailing_escape).
StreamData property tests for the split(join(argv)) == {:ok, argv} round-trip guarantee.