dwarvish.git/src/poem/elements, branch docs a (mostly) posix compliant shell and tiny functional programming language Capture STDOUT as bytes, and convert to string when necessary 2024-04-07T05:32:30+00:00 Rory Dudley 2024-04-07T05:32:30+00:00 f5db8d64828db756b80b6022322265a2b4f1c11b Previously, the recite() function created the 'out' variable, which was a String, that got passed to the various incant functions, in order to capture STDOUT in certain situations. In cases where STDOUT was captured, it was first converted to a String, and then appended to the 'out' variable, by means of String::from_utf8_lossy(). This works for basic text, however, does NOT work for binary data. This becomes problematic, when for example, downling a tar file with curl/wget, that is then piped ('|') to the tar program. Using from_utf8_lossy() in this case can corrupt the tar file. This patch makes it so that out is stored as bytes by default, and only converted to a String when necessary. 
Previously, the recite() function created the 'out' variable, which was
a String, that got passed to the various incant functions, in order to
capture STDOUT in certain situations. In cases where STDOUT was
captured, it was first converted to a String, and then appended to the
'out' variable, by means of String::from_utf8_lossy(). This works for
basic text, however, does NOT work for binary data. This becomes
problematic, when for example, downling a tar file with curl/wget, that
is then piped ('|') to the tar program. Using from_utf8_lossy() in this
case can corrupt the tar file. This patch makes it so that out is stored
as bytes by default, and only converted to a String when necessary.
Add comments (`#`) to the parser 2024-03-29T03:01:49+00:00 Rory Dudley 2024-03-29T03:01:49+00:00 527cc04ffb9ea627ca678fe8fb07fe9330420eab The parser will now interpret the '#' character as a single-line comment string, which works on it's own line, or at the end of an existing line. 
The parser will now interpret the '#' character as a single-line comment
string, which works on it's own line, or at the end of an existing line.
Documentation for incant_ 2024-03-25T04:39:22+00:00 Rory Dudley 2024-03-25T04:39:22+00:00 443c5fad55c6f81f5dc81585ab350de452e47260 Add docstring for `incant_quiet_io`. 
Add docstring for `incant_quiet_io`.
read() and recite() overhaul 2024-03-23T08:45:54+00:00 Rory Dudley 2024-03-23T08:45:54+00:00 5a7718698373d07a29fffcb792acdb81aa7712d7 Rebuilt the LR parser (i.e. read()) from the ground up. This required that some changes be made to recite(), in order to accomodate the new data structures. These data structures were each split out into their own file, in order to make working with each component a bit easier. In addition to reworking the parts of the parser already present, some new features were also added, such as: - Support for strings (' and ") - Support for environment variables ($) - Support for interpreting tild as $HOME (~) - Support for sub-reading and sub-reciting (`) 
Rebuilt the LR parser (i.e. read()) from the ground up. This required
that some changes be made to recite(), in order to accomodate the new
data structures. These data structures were each split out into their
own file, in order to make working with each component a bit easier.

In addition to reworking the parts of the parser already present, some
new features were also added, such as:
  - Support for strings (' and ")
  - Support for environment variables ($)
  - Support for interpreting tild as $HOME (~)
  - Support for sub-reading and sub-reciting (`)