stream: add auto-destroy mode by mafintosh · Pull Request #22795 · nodejs/node

mafintosh · 2018-09-10T15:44:15Z

Checklist

make -j4 test (UNIX), or vcbuild test (Windows) passes
tests and/or benchmarks are included
documentation is changed or added
commit message follows commit guidelines

This adds a new options to the stream constructor called autoDestroy that is default false.
When autoDestroy is enabled .destroy() will automatically be called when the stream has ended and/or finished depending on whether it's a readable/writable/duplex.

This simplifies error handling / resource management for users as you can then always do your teardown logic in the destroy method.

nodejs-github-bot · 2018-09-10T15:44:18Z

@mafintosh build started: https://ci.nodejs.org/blue/organizations/jenkins/node-test-pull-request-lite-pipeline/detail/node-test-pull-request-lite-pipeline/852/pipeline

mcollina · 2018-09-10T16:05:57Z

@mafintosh I think it needs to call .destroy(err) whenever there is a emit('error'), at least in the streams classes and the option is enabled.

I think this is the first step to implement #20096, right?

vsemozhetbyt · 2018-09-10T16:16:26Z

doc/api/stream.md

.destroy() -> `.destroy()`?

Can you provide the default value explicitly here?

vsemozhetbyt · 2018-09-10T16:16:49Z

doc/api/stream.md

mscdex · 2018-09-10T16:24:02Z

lib/_stream_readable.js

Can't this just be inlined?

targos · 2018-09-10T16:25:03Z

It looks like the code in _stream_readable.js should be in _stream_writable.js and vice versa.

addaleax · 2018-09-11T10:44:09Z

doc/api/stream.md

Can you provide the default value explicitly here?

addaleax · 2018-09-11T10:45:40Z

test/parallel/test-stream-auto-destroy.js

Can we maybe check the order of the events/destroy callback as well?

addaleax · 2018-09-14T16:34:57Z

Gentle ping @mafintosh :)

@targos I think it’s this way around in order to support shutting down Duplex streams?

mafintosh · 2018-09-17T13:20:17Z

@addaleax i'll fix up the nits+comments

Fishrock123 · 2018-09-17T15:47:13Z

Seems like a good addition to me, minus others' comments.

tniessen · 2018-09-19T14:39:40Z

semver-minor commits should contain metadata in the YAML changes section of the affected API.

addaleax · 2018-09-22T21:17:42Z

lib/internal/http2/compat.js

Just to make sure I’m not missing anything – how does this change relate to the others?

mcollina

LGTM

mafintosh · 2018-10-29T11:00:26Z

Fixed all the nits @addaleax @targos @vsemozhetbyt @Fishrock123

mafintosh · 2018-10-29T11:01:24Z

CI: https://ci.nodejs.org/view/Node.js/job/node-test-pull-request/18202/

mcollina

LGTM but I would like to see a CITGM run.

mcollina · 2018-10-29T11:21:27Z

doc/api/stream.md

    pr-url: https://github.com/nodejs/node/pull/18438
    description: >
      Add `emitClose` option to specify if `'close'` is emitted on destroy
+  - version: TBD


is the value we put here TBD? I never remember.

REPLACEME :)

Ah right! Thanks, will fix

mafintosh · 2018-10-29T12:20:29Z

CITGM: https://ci.nodejs.org/view/Node.js-citgm/job/citgm-smoker/1604/
CITGM master: https://ci.nodejs.org/view/Node.js-citgm/job/citgm-smoker/1603/

mafintosh · 2018-10-30T11:47:13Z

One more CITGM with readable-stream enabled

master: https://ci.nodejs.org/view/Node.js-citgm/job/citgm-smoker/1606/
pr: https://ci.nodejs.org/view/Node.js-citgm/job/citgm-smoker/1607/

mafintosh · 2018-10-30T14:15:29Z

The CITGM runs seem to report similar errors on master + this PR, landing ...

PR-URL: nodejs#22795 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Matteo Collina <matteo.collina@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Jeremiah Senkpiel <fishrock123@rocketmail.com>

mafintosh · 2018-10-30T14:19:24Z

Landed in f24b070

PR-URL: #22795 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Matteo Collina <matteo.collina@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Jeremiah Senkpiel <fishrock123@rocketmail.com>

nodejs-github-bot added dont-land-on-v6.x http2 Issues or PRs related to the http2 subsystem. stream Issues and PRs related to the stream subsystem. labels Sep 10, 2018

mcollina added semver-minor PRs that contain new features and should be released in the next minor version. dont-land-on-v8.x labels Sep 10, 2018

vsemozhetbyt reviewed Sep 10, 2018

View reviewed changes

doc/api/stream.md Outdated

Copy link

Contributor

vsemozhetbyt Sep 10, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ditto.

mscdex reviewed Sep 10, 2018

View reviewed changes

lib/_stream_readable.js Outdated

Copy link

Contributor

mscdex Sep 10, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can't this just be inlined?

jasnell approved these changes Sep 10, 2018

View reviewed changes

addaleax reviewed Sep 11, 2018

View reviewed changes

addaleax reviewed Sep 22, 2018

View reviewed changes

lib/internal/http2/compat.js Outdated

Copy link

Member

addaleax Sep 22, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just to make sure I’m not missing anything – how does this change relate to the others?

mcollina mentioned this pull request Oct 5, 2018

pipeline does not wait for full stream destruction #23214

Closed

mafintosh force-pushed the auto-destroy-stream branch 2 times, most recently from bb2cb3c to 387516c Compare October 26, 2018 14:08

stream: add auto-destroy mode

ccc94a9

mafintosh force-pushed the auto-destroy-stream branch from 387516c to ccc94a9 Compare October 26, 2018 14:13

mafintosh added 2 commits October 26, 2018 16:22

inline duplex autodestroy logic

38077e6

move errorOrDestroy to destroyImpl

294e10c

mcollina approved these changes Oct 26, 2018

View reviewed changes

mafintosh added 3 commits October 26, 2018 18:05

test ordering of events

a6eb82e

fix docs

c40028a

add to changes: section

7eb4e64

mcollina approved these changes Oct 29, 2018

View reviewed changes

TDB -> REPLACEME

713a808

addaleax approved these changes Oct 29, 2018

View reviewed changes

Fishrock123 approved these changes Oct 29, 2018

View reviewed changes

mcollina mentioned this pull request Oct 30, 2018

fs: read/write streams don't emit close after error #23338

Closed

mafintosh closed this Oct 30, 2018

mafintosh deleted the auto-destroy-stream branch October 30, 2018 14:19

watilde mentioned this pull request Nov 6, 2018

test: add test for autoDestroy in stream #24127

Closed

3 tasks

BridgeAR mentioned this pull request Nov 14, 2018

Release proposal: v11.2 #24350

Merged

BethGriggs mentioned this pull request May 1, 2019

v10.16.0 proposal #27514

Merged

Uh oh!

Conversation

mafintosh commented Sep 10, 2018

Checklist

Uh oh!

nodejs-github-bot commented Sep 10, 2018

Uh oh!

mcollina commented Sep 10, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

targos commented Sep 10, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

addaleax commented Sep 14, 2018

Uh oh!

mafintosh commented Sep 17, 2018

Uh oh!

Fishrock123 commented Sep 17, 2018

Uh oh!

tniessen commented Sep 19, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mcollina left a comment

Choose a reason for hiding this comment

Uh oh!

mafintosh commented Oct 29, 2018

Uh oh!

mafintosh commented Oct 29, 2018

Uh oh!

mcollina left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mafintosh commented Oct 29, 2018

Uh oh!

mafintosh commented Oct 30, 2018

Uh oh!

mafintosh commented Oct 30, 2018

Uh oh!

mafintosh commented Oct 30, 2018

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

targos commented Sep 10, 2018 •

edited

Loading