Streams
@CrabDude ya está trabajando en esto.
Desde el 5/5/2015.
Evaluación
Este issue todavía no se ha evaluado.
Descripción
- Break the below into coherent sections
- Explain unix pipes and their corollary with node.js streams (explaining the concept of node.js streams as well)
- Explain the need for streams (memory pressure, decreased latency, CPU amortization & convenience)
- Lead with
.pipeexamples- Emphasize that source streams can be piped to multiple destination streams
- Show example of piping from multiple source streams (
readable.pipe(writable, {end: false}))
- Cover the basics: .read(), .write(), .pause(), .resume & events: 'data', 'close', 'error'
- Mention briefly push vs pull-based streams and how Streams 2/3 uses pull streams
- Mention how back-pressure is handled
- Briefly explain buffers, link to a reference (docs or blog post or guide), and show
String(buffer) - Show 2 simple as possible examples of consuming (read: piping) each of the 4 stream types. You should use the most common examples e.g., req/res, through, fs read/write.
- Provide a common use case (e.g., A common type of duplex stream would be a WebSocket).
- Strongly recommend working through the stream-adventure nodeschool.io workshop and provide a screen shot of the stream-adventure exercise selection menu.
Advanced section:
- Explain object mode briefly, provide minimalist example and provide link to a more comprehensive explanation
- Provide code samples on how to create your own streams (i.e., .push, _read, _write & _transform) and additional links
- Show of JSON streaming example & explain !!LOUDLY!! how JSON.parse/stringify are the #1 cause of CPU blocking in node.js
The stream handbook is nice, but it's too verbose and needs more structure. In general the examples are good, so use them.
What success looks like: Succinctness and clarity. Less is more.
Reference Wikis: Authentication & Authorization, Setup
Open separate issues for required links to community sources if you're having trouble finding any.
Please assign to yourself before working on this.
/cc @NinjaSudo @philster @azoff @DiyahM
- Lenguaje dominante
- Sin datos de lenguaje
- Estrellas
- 74
- Forks
- 18
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
Aún no hemos revisado los archivos de configuración de este proyecto. Empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de codepath/nodejs_guides
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 20/100
codepath/nodejs_guides#21 · 1 comentario ·
-
Improve Javascript/Node markdown syntax highlightingQuizá libre de nuevo @nesquena la tomó hace 4169 días y no hay ningún pull request abierto. Abiertoenhancement
codepath/nodejs_guides#19 · 1 comentario · 1 asignado ·
-
Project Generator/Workflow GuideAbiertohelp wanted
Dificultad 4/5 3-5 días Aptitud para principiantes 35/100
codepath/nodejs_guides#18 · 3 comentarios ·
-
Design PatternsQuizá libre de nuevo @pixelknitter la tomó hace 4054 días y no hay ningún pull request abierto. Abiertohelp wanted
codepath/nodejs_guides#16 · 1 asignado ·
-
JavaScript: InheritanceQuizá libre de nuevo @pixelknitter la tomó hace 4162 días y no hay ningún pull request abierto. Abiertohelp wanted
codepath/nodejs_guides#14 · 1 asignado ·