It's similar to the existing PUT-FOO stuff, but I figured it would
make sense to add a few keyword args to put only a subset of the
stream. So, with START and END keyword args, ZS3 will skip to START,
read octets between START and END, and upload them as an object. If
END is omitted, everything from START to end-of-file is uploaded.
There are a few wrinkles. START and END are offsets from the *current*
stream position, not from the theoretical start of the stream. It's
not always possible to seek backwards in a stream, and I didn't want
to limit the interface only to file streams.
Since it was easy to add, I also updated PUT-FILE and PUT-VECTOR to
take START and END keyword args, to upload only a subset of a the
respective objects. I intend to do the same for PUT-STRING. PUT-STRING
gets into minor issues of whether the bounding index designators
should apply to the character indexes or the translated octet indexes;
I'm going with the former.
These so-far-undocumented changes are pushed out to the "put-stream"
branch at git://git.xach.com/zs3.git ... any thoughts?
Zach
This has been committed and released as version 1.0.4.
Zach