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

Add support for silencing only one of the outputs of a test #1707

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

Kriskras99
Copy link

@Kriskras99 Kriskras99 commented Sep 12, 2024

The old syntax is still supported, the new complete syntax is:

  • "{value}": where value is one of [immediate, immediate-final, final, never]
  • "{stream}={value}": where {stream} is one of [stdout, stderr]
  • "{stream}={value},{stream=value}": where the two {stream} keys cannot be the same

For tests where the output is combined (currently only used for libtest-json output), only the stdout value is used.

There is a small regression where the CLI won't suggest values that are close to the incorrect input, i.e. if you input 'imediate' it won't suggest 'immediate'.

I've not added tests yet, I first wanted to make sure that the implementation is acceptable for inclusion into nextest.

Closes #1688

The old syntax is still supported, the new complete syntax is:
 - "{value}":                         where value is one of [immediate, immediate-final, final, never]
 - "{stream}={value}":                where {stream} is one of [stdout, stderr]
 - "{stream}={value},{stream=value}": where the two {stream} keys cannot be the same

For tests where the output is combined (currently only used for
libtest-json output), only the stdout value is used.

There is a small regression where the CLI won't suggest values that
are close to the incorrect input, i.e. if you input 'imediate' it won't
suggest 'immediate'.
Copy link

codecov bot commented Sep 12, 2024

Codecov Report

Attention: Patch coverage is 59.56522% with 93 lines in your changes missing coverage. Please review.

Project coverage is 79.03%. Comparing base (ba8872f) to head (10f3da9).
Report is 418 commits behind head on main.

Files with missing lines Patch % Lines
nextest-runner/src/reporter/displayer.rs 60.23% 68 Missing ⚠️
cargo-nextest/src/dispatch.rs 40.47% 25 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1707      +/-   ##
==========================================
- Coverage   79.23%   79.03%   -0.20%     
==========================================
  Files          79       79              
  Lines       19798    19982     +184     
==========================================
+ Hits        15686    15792     +106     
- Misses       4112     4190      +78     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@sunshowers
Copy link
Member

Thanks for the PR! I'm currently quite sick but will look when I'm better.

@Kriskras99
Copy link
Author

No worries, get well soon!

Copy link
Member

@sunshowers sunshowers left a comment

Choose a reason for hiding this comment

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

Yeah I really like the overall direction. Thanks!

Comment on lines +996 to +1006
match (left, right) {
(Some(("stderr", Ok(stderr))), Some(("stdout", Ok(stdout)))) => (Some(stdout), Some(stderr)),
(Some(("stdout", Ok(stdout))), Some(("stderr", Ok(stderr)))) => (Some(stdout), Some(stderr)),
(Some((stream @ "stdout" | stream @ "stderr", Err(_))), _) => return Err(format!("\n unrecognized setting for {stream}: [possible values: immediate, immediate-final, final, never]")),
(_, Some((stream @ "stdout" | stream @ "stderr", Err(_)))) => return Err(format!("\n unrecognized setting for {stream}: [possible values: immediate, immediate-final, final, never]")),
(Some(("stdout", _)), Some(("stdout", _))) => return Err("\n stdout specified twice".to_string()),
(Some(("stderr", _)), Some(("stderr", _))) => return Err("\n stderr specified twice".to_string()),
(Some((stream, _)), Some(("stdout" | "stderr", _))) => return Err(format!("\n unrecognized output stream '{stream}': [possible values: stdout, stderr]")),
(Some(("stdout" | "stderr", _)), Some((stream, _))) => return Err(format!("\n unrecognized output stream '{stream}': [possible values: stdout, stderr]")),
(_, _) => return Err("\n [possible values: immediate, immediate-final, final, never], or specify one or both output streams: stdout={}, stderr={}, stdout={},stderr={}".to_string()),
}
Copy link
Member

Choose a reason for hiding this comment

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

Hmm, can this be shortened? This feels excessive.

I'd probably do something like:

  • split with , if possible, getting 1 or 2 entries from this (more than 2 should error out)
  • if one entry, try parsing via <stream>=<setting> or then just <setting>
  • if two entries, always try parsing as <stream>=<setting>, then at the end ensure that the streams are different

Copy link
Author

Choose a reason for hiding this comment

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

It can be reduced to the two first lines and the last line, but that would result in significantly less helpful error messages.
I also don't see a way to reduce it without degrading the error messaging.

I could do a priority inversion by first checking if the value is a valid TestOutputDisplayOpt, which should be the most common case. And only then dealing with commas and equal signs.

Copy link
Member

Choose a reason for hiding this comment

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

Yeah, trying to parse it first that way makes sense.


/// Which output streams should be output immediately
///
/// # Returns
Copy link
Member

Choose a reason for hiding this comment

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

We generally don't use a # Returns header here.

Also I'd rather this return a DisplayOutput rather than Option<DisplayOutput>, to avoid representing the invalid state where DisplayOutput is set to false for both.

serde::de::Unexpected::Str(value),
&"'never', 'immediate', 'immediate-final', or 'final'",
)
})?);
Copy link
Member

Choose a reason for hiding this comment

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

As the warnings suggest, for a manual deserialize impl it would be good to have tests for all the error cases. (I know you haven't written tests yet, just wanted to mention this.)

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

Successfully merging this pull request may close these issues.

Allow only showing stdout or stderr when using --success-output and --failure-output
2 participants