Improve cli help somewhat, creating an Experimental group#19073
Open
wyattscarpenter wants to merge 50 commits intopython:masterfrom
Open
Improve cli help somewhat, creating an Experimental group#19073wyattscarpenter wants to merge 50 commits intopython:masterfrom
wyattscarpenter wants to merge 50 commits intopython:masterfrom
Conversation
for more information, see https://pre-commit.ci
for more information, see https://pre-commit.ci
for more information, see https://pre-commit.ci
for more information, see https://pre-commit.ci
… from being ungrouped also, take another experimental group from the misc group into this group, and rename the misc group to misc
…re optional although, arguably, they all provide Utility as well. wait, was this 'Optional arguments' header supposed to introduce *all* of the arguments, and just has a couple misc ones under it, as a sort of pun? Well, whatever.
…ve to explicitly display them.
for more information, see https://pre-commit.ci
for more information, see https://pre-commit.ci
This comment has been minimized.
This comment has been minimized.
wyattscarpenter
commented
Sep 14, 2025
This comment has been minimized.
This comment has been minimized.
…move it down, pt1
for more information, see https://pre-commit.ci
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
…to Incremental group" This reverts commit 742db15.
This comment has been minimized.
This comment has been minimized.
wyattscarpenter
changed the title
This comment has been minimized.
This comment has been minimized.
Contributor
|
According to mypy_primer, this change doesn't affect type check results on a corpus of open source code. ✅ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This improves a couple of things relating to the cli help. It changes some verbiage and also invents the Experimental group. Having an experimental group fixes the awkward situation where the
--enable-incomplete-featurewould just float randomly at the top of the cli help, not in a group. For this Experimental group, I ignored--allow-redefinition-new, because it's better where it is currently, right next to--allow-redefinition.Old description of PR, no longer relevant, but referenced later in discussion.
This PR rearranges a couple of command line flag categorizations to make more sense and not leave any uncategorized — which is debatable, if someone really liked how the current top of
mypy --helpisinstead of
This PR also programmatically enforces the cli help style guide (from which it removes the advice about links that seemed misguided).
This PR builds on #19062, to save time fixing merge conflicts later, and so you should probably merge that first!
This PR has a long history because it used to contain many other changes, but that history can be ignored as I broke most of those changes out into different PRs.