Skip to content

Document require("stream/promises").pipelineend option - #48970

Merged
aduh95 merged 2 commits into
nodejs:mainfrom
aloisklink:document-pipeline-end-option
May 12, 2024
Merged

Document require("stream/promises").pipelineend option#48970
aduh95 merged 2 commits into
nodejs:mainfrom
aloisklink:document-pipeline-end-option

Conversation

@aloisklink

Copy link
Copy Markdown
Contributor

Add documentation for the require("stream/promises").pipeline(...streams, {end: false}) option, that was added in #40886.

The lacking documentation has been mentioned before (see #34805 (comment), and #45821), but although #45832 did document that the end option existed, it didn't document what the end option did.

I've also added a test to sanity check that setting end: false doesn't stop ending transform streams when calling pipeline(), since this behavior seems a bit unintuitive to me.

@nodejs-github-botnodejs-github-bot added the needs-ci PRs that need a full CI run. label Jul 30, 2023
@aloisklinkaloisklink changed the title Document pipeline end optionDocument require("stream/promises").pipelineend optionJul 30, 2023
@aloisklink

Copy link
Copy Markdown
ContributorAuthor

Pinging @ronag, just to make sure they get a notification in case they want to give a review, since they were the original person that added the end option to pipeline in #40886.

@lpincalpinca added the request-ci Add this label to start a Jenkins CI on a PR. label Aug 10, 2023
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 10, 2023
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@aloisklink

aloisklink commented Aug 20, 2023

Copy link
Copy Markdown
ContributorAuthor

CI seems to have failed due to a Backing channel 'JNLP4-connect connection from ... is disconnected. error (see nodejs/reliability#634).

It sounds like this is just a random error unrelated to this PR due to a CI worker dying/losing connection.

Can a maintainer re-add a request-ci label?

Edit: It may also be worth labeling this PR as doc (and maybe test too)

@lpincalpinca added the request-ci Add this label to start a Jenkins CI on a PR. label Aug 26, 2023
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 26, 2023
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@lpincalpinca added the commit-queue-rebase Add this label to allow the Commit Queue to land a PR in several commits. label Sep 7, 2023
@aduh95
aduh95force-pushed the document-pipeline-end-option branch from 7a279a1 to 7ea65beCompareMay 11, 2024 14:15
@aduh95aduh95 added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label May 11, 2024
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Add test that confirms that
`stream.promises.pipeline(source, transform, dest, {end: false});`
only skips ending the destination stream.
`{end: false}` should still end any transform streams.
PR-URL: nodejs#48970
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
There is currently no documentation about what the `end` option in
`stream.promises.pipeline` does.
Refs: nodejs#40886
Refs: nodejs#34805 (comment)Fixes: nodejs#45821
PR-URL: nodejs#48970
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
@aduh95
aduh95force-pushed the document-pipeline-end-option branch from 7ea65be to ca2f874CompareMay 12, 2024 09:19
@aduh95

Copy link
Copy Markdown
Contributor

Landed in 1223294...ca2f874

@aduh95
aduh95 merged commit ca2f874 into nodejs:mainMay 12, 2024
targos pushed a commit that referenced this pull request May 12, 2024
Add test that confirms that
`stream.promises.pipeline(source, transform, dest, {end: false});`
only skips ending the destination stream.
`{end: false}` should still end any transform streams.
PR-URL: #48970
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
targos pushed a commit that referenced this pull request May 12, 2024
There is currently no documentation about what the `end` option in
`stream.promises.pipeline` does.
Refs: #40886
Refs: #34805 (comment)Fixes: #45821
PR-URL: #48970
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
@aloisklink
aloisklink deleted the document-pipeline-end-option branch May 13, 2024 06:05
@targostargos mentioned this pull request May 13, 2024
@marco-ippolitomarco-ippolito mentioned this pull request Jun 17, 2024
marco-ippolito pushed a commit that referenced this pull request Jun 17, 2024
Add test that confirms that
`stream.promises.pipeline(source, transform, dest, {end: false});`
only skips ending the destination stream.
`{end: false}` should still end any transform streams.
PR-URL: #48970
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
marco-ippolito pushed a commit that referenced this pull request Jun 17, 2024
There is currently no documentation about what the `end` option in
`stream.promises.pipeline` does.
Refs: #40886
Refs: #34805 (comment)Fixes: #45821
PR-URL: #48970
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
eliphazbouye pushed a commit to eliphazbouye/node that referenced this pull request Jun 20, 2024
Add test that confirms that
`stream.promises.pipeline(source, transform, dest, {end: false});`
only skips ending the destination stream.
`{end: false}` should still end any transform streams.
PR-URL: nodejs#48970
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
eliphazbouye pushed a commit to eliphazbouye/node that referenced this pull request Jun 20, 2024
There is currently no documentation about what the `end` option in
`stream.promises.pipeline` does.
Refs: nodejs#40886
Refs: nodejs#34805 (comment)Fixes: nodejs#45821
PR-URL: nodejs#48970
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs that have at least one approval, no pending requests for changes, and a CI started.commit-queue-rebaseAdd this label to allow the Commit Queue to land a PR in several commits.needs-ciPRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@aloisklink@nodejs-github-bot@aduh95@lpinca