Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify the uses of ByteStream vs Builder #8

Open
andrewthad opened this issue Oct 17, 2018 · 0 comments
Open

Clarify the uses of ByteStream vs Builder #8

andrewthad opened this issue Oct 17, 2018 · 0 comments

Comments

@andrewthad
Copy link
Owner

These two types are sort of similar, but they are different. ByteStream is effectful. Consuming it often causes file handles to move. Its main purpose is reading bytes from disk or from the network into memory, and these bytes will typically be parsed as they arrive. Builder is, in a sense, the opposite. It's for serializing objects that live in the heap. The builder type itself is not effectful, but it can be interpreted effectfully. This can be used, for example, to stream bytes to disk as they are produced. I need to add this information to the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant