Add a WriteTo
method that implements the io.WriterTo
interface
#260
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
When reading the docs looking for a way of streaming the PDF as an HTTP response I actually skipped over the
Write(io.Reader) error
function because the name made me think it was an implementation of theio.Writer
interface.But it is not and its behavior actually is the behavior described by the
io.WriterTo
interface.So I thought it was worth submitting this PR that basically renames the
Write
function toWriteTo
changing its signature slightly to match theio.WriterTo
interface.The main goal here is to make the code easier to use for new comers by using a more canonical name for this function.
In order to keep retro-compatibility the old
Writer
method was not deleted but I've added a deprecation note.It was also necessary to change the countingWriter.offset variable from
int
toint64
to comply with theio.WriterTo
interface. A less intrusive implementation could be written where we could just convert fromint
toint64
when returning on theWriteTo
method, but this could potentially cause an overflow of that integer eventually.Feel free to ask me for any changes or even to change it yourself. I am all in favor of productivity and I know how little time we have to maintain these open-source projects.