Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

help(): Display complex signatures in multiple lines #112139

Closed
Labels
3.13bugs and security fixesstdlibStandard Library Python modules in the Lib/ directorytype-featureA feature request or enhancement
@JelleZijlstra

Description

@JelleZijlstra

Feature or enhancement

Proposal:

Here's the help() output for a reasonably complex typed method (link):

Help on function __init__ in module pyanalyze.name_check_visitor:__init__(self, filename: str, contents: str, tree: ast.Module, *, settings: Optional[Mapping[pyanalyze.error_code.ErrorCode, bool]] = None, fail_after_first: bool = False, verbosity: int = 50, unused_finder: Optional[pyanalyze.find_unused.UnusedObjectFinder] = None, module: Optional[module] = None, attribute_checker: Optional[pyanalyze.name_check_visitor.ClassAttributeChecker] = None, collector: Optional[pyanalyze.name_check_visitor.CallSiteCollector] = None, annotate: bool = False, add_ignores: bool = False, checker: pyanalyze.checker.Checker, is_code_only: bool = False) -> None    Constructor.        filename: name of the file to run on (to show in error messages)    contents: code that the visitor is run on    fail_after_first: whether to throw an error after the first problem is detected    verbosity: controls how much logging is emitted

It would be much easier to read if each parameter was on its own line, something like this:

Help on function __init__ in module pyanalyze.name_check_visitor:__init__(    self,    filename: str,    contents: str,    tree: ast.Module,    *,    settings: Optional[Mapping[pyanalyze.error_code.ErrorCode, bool]] = None,    fail_after_first: bool = False,    verbosity: int = 50,    unused_finder: Optional[pyanalyze.find_unused.UnusedObjectFinder] = None,    module: Optional[module] = None,    attribute_checker: Optional[pyanalyze.name_check_visitor.ClassAttributeChecker] = None,    collector: Optional[pyanalyze.name_check_visitor.CallSiteCollector] = None,    annotate: bool = False,    add_ignores: bool = False,    checker: pyanalyze.checker.Checker,    is_code_only: bool = False,) -> None    Constructor.        filename: name of the file to run on (to show in error messages)    contents: code that the visitor is run on    fail_after_first: whether to throw an error after the first problem is detected    verbosity: controls how much logging is emitted

help() should switch to this output format only for reasonably complex signatures, perhaps if the signature line would otherwise be >80 characters.

Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

Links to previous discussion of this feature:

No response

Linked PRs

Metadata

Metadata

Assignees

No one assigned

    Labels

    3.13bugs and security fixesstdlibStandard Library Python modules in the Lib/ directorytype-featureA feature request or enhancement

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions


      [8]ページ先頭

      ©2009-2025 Movatter.jp