-
Notifications
You must be signed in to change notification settings - Fork 14.3k
[llvm][llvm-lit] Hide --use-unique-output-file-name from --help #114812
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
Conversation
I was too hasty landing an option whose only known use at this time is LLVM's own CI. We may be able to remove it before the next branch that would be the next llvm-lit release outside of llvm, but the timing may not work out. So I am hiding the option in case that were to happen.
@llvm/pr-subscribers-testing-tools Author: David Spickett (DavidSpickett) ChangesI was too hasty landing an option whose only known use at this time is LLVM's own CI. We may be able to remove it before the next branch that would be the next llvm-lit release outside of llvm, but the timing may not work out. So I am hiding the option in case that were to happen. Full diff: https://github.com/llvm/llvm-project/pull/114812.diff 1 Files Affected:
diff --git a/llvm/utils/lit/lit/cl_arguments.py b/llvm/utils/lit/lit/cl_arguments.py
index 3e5488f388ccfa..a401c9a09e081b 100644
--- a/llvm/utils/lit/lit/cl_arguments.py
+++ b/llvm/utils/lit/lit/cl_arguments.py
@@ -175,12 +175,15 @@ def parse_args():
type=lit.reports.TimeTraceReport,
help="Write Chrome tracing compatible JSON to the specified file",
)
+ # This option only exists for the benefit of LLVM's Buildkite CI pipelines.
+ # As soon as it is not needed, it should be removed. Its help text would be:
+ # When enabled, lit will add a unique element to the output file name,
+ # before the extension. For example "results.xml" will become
+ # "results.<something>.xml". The "<something>" is not ordered in any
+ # way and is chosen so that existing files are not overwritten. [Default: Off]
execution_group.add_argument(
"--use-unique-output-file-name",
- help="When enabled, lit will add a unique element to the output file name, "
- 'before the extension. For example "results.xml" will become '
- '"results.<something>.xml". The "<something>" is not ordered in any '
- "way and is chosen so that existing files are not overwritten. [Default: Off]",
+ help=argparse.SUPPRESS,
action="store_true",
)
execution_group.add_argument(
|
Has there been some opposition to the option being public, or was your intention always for it to be internal to LLVM only? |
It's a bit of both, I shouldn't have merged it as soon as I did. My intention was that it would be broadly useful but at this time there is only one known user of it, which would be us i the Buildkite CI. This was raised on follow up patches: #113447 (comment) My survey of use on GitHub showed that while it has been a problem for external lit users, they have usually solved it by refactoring the pipeline which brings other benefits with it (#113447 (comment)). This is something LLVM should do as well, but I'm told we may be moving the CI soon, so if I want to improve things in the short term I needed something low impact. I went through a bunch of alternatives that didn't need a new option, but there was only one other viable option which is wrapping lit in another script. Small chance we go with that and I revert the option altogether, still waiting for confirmation either way on that. So this time I will not be so hasty merging this :) If this goes ahead, my plan would be to remove this option as soon as LLVM's own CI does not need it. Hiding it means if it ends up in lit 20 on pypi then we have done as much as we can to make sure external users don't rely on it. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks. LGTM.
LLVM Buildbot has detected a new failure on builder Full details are available at: https://lab.llvm.org/buildbot/#/builders/183/builds/6149 Here is the relevant piece of the build log for the reference
|
…#114812) I was too hasty landing an option whose only known use at this time is LLVM's own CI. We may be able to remove it before the next branch that would be the next llvm-lit release outside of llvm, but the timing may not work out. So I am hiding the option in case that were to happen.
I was too hasty landing an option whose only known use at this time is LLVM's own CI.
We may be able to remove it before the next branch that would be the next llvm-lit release outside of llvm, but the timing may not work out.
So I am hiding the option in case that were to happen.