More full example please

[kenokabe]

I know this is a great library, but feel underestimated by the community.
The reason I think is that lack of the demonstration.
Probably @dominictarr the author have a complete picture in his mind, but the readers cannot follow the concept well.

Actually, I git cloned and tried the example, but completely had no idea what is going on.

The other thing is I feel this can be a great alternative for a very popular caolan/async library, and if possible I would like to use this one; however due to my poor understanding for stream and this library, it can't be done.

Please populate the concise example and documentation more.

Thanks for the great work!

[dominictarr]

Hmm, can you be more specific about what you do not understand?
merely asking for "more documentation" is giving me a very difficult job.
like, having read the current documentation, what questions do you still have?
what problems are you trying to solve?

Also: I recommend checking out these resources
https://github.com/substack/stream-adventure
https://github.com/substack/stream-handbook

[kenokabe]

dominictarr, Thanks for your reply. I have read stream-handbook pretty much, but didn't know stream-adventure, so I will study.
I've always thought that the most of the trick node async library such as caolan/async perform can be done and unified in stream paradigm; and I have a strong feeling your library event-stream is the most promissing one.
Since you have the deep understanding of stream, I would like to ask this aspect.
Usually, do you use caolan/async library? or you manage whole async issue in Stream paradigm?

[dominictarr]

Thank you, that is a much better question!

The answer is "sometimes".

Also, I don't really use caolan/async, I don't have anything against it, but I do things differently.

But basically, yes, it is possible to use streams to model the same sort of ideas as async,
in fact, that idea was what originally caused me to implement event-stream.

However, streams arn't always the simplest way to do things, and fairly often I still use callbacks without any libraries.
I think it's important to understand how to do this, of course, calling one thing after another is easy,
the useful trick is calling multiple things in parallel, and then doing one thing after everything.

example: https://github.com/DamonOehlman/async-comparison/blob/master/child-dirs/nude/index.js

When I do use an async library, I like https://npmjs.org/package/continuable

I often use streams to do async stuff too,
but I use http://npm.im/pull-stream for that, because it's simpler and flexible than node streams,
and better for streams of objects (rather than streams of text/binary)

Here is an example:
https://github.com/DamonOehlman/async-comparison/blob/master/child-dirs/pull-streams/index.js

And a more interesting example:
https://github.com/dominictarr/npmd-resolve/blob/master/index.js#L101-L130

and:
https://github.com/dominictarr/level-replicate/blob/master/inject.js#L141-L180

I have used pull-streams through out many modules I have written recently.

[kenokabe]

Great great great.How innovative you are, dominictarr. You are awesome!

I'm already a heavy user of through stream you have created for much better abstraction I thought, and now pull-stream.
I really think these are better implementations of stream of node, and guys shall marge these to the official repo and release as node Stream3.
So far lots of good resources to learn from your post. I have searched for Stream resources, but links you gave are exactly what I need that I would not find by myself. Thank you very much.

Usually, I should be careful to depends on much NPMs in terms of the maintenance and simplicity of my project; however the works you and substack have done are excellent, and well-worth to follow and fully depends upon. Great abstraction as it should be.

My gratitude to whole of your work, and your dedicated reply. You are great.

[kenokabe]

Just want to say thank you.
I have just released
MarkdownLive
Markdown Streaming Live View for SublimeText3

Heavily depends on your library and browserify.

[dominictarr]

you are welcome! no problem!