RobertOstermann / vscode-inline-parameters

An Visual Studio Code extension that adds inline parameter annotations.
https://marketplace.visualstudio.com/items?itemName=RobertOstermann.inline-parameters-extended
MIT License
29 stars 6 forks source link
vscode vscode-extension

Inline Parameters Extended for VSCode

Inline Parameters for VSCode

VS Marketplace Version VS Marketplace Installs VS Marketplace Rating

Now with Golang and Python support! This extension implements the new Inlay Hints API to add Inline Parameters for Golang, Java, Lua, PHP, and Python.

Example of extension

This is a feature that was popularized by JetBrains' IDEs that can give you additional context when reading your code, making it easier to understand what different function parameters refer to by showing the parameter's name inline.

Speed up your development with parameter hints!

Language Support

Currently, this extension supports the following languages:

Inlay Hint Settings

This extension utilizes the Inlay-Hints API provided by VSCode. Here are some additional settings provided by VSCode.

Name Description Default
editor.inlayHints.enabled Enables Inlay Hints for the editor. true
editor.inlayHints.fontFamily Controls font family of inlay hints in the editor. When set to empty, the #editor.fontFamily# is used. ""
editor.inlayHints.fontSize Controls font size of inlay hints in the editor. A default of 90% of #editor.fontSize# is used when the configured value is less than 5 or greater than the editor font size. 0

There are also several settings to enable Inlay Hints for both JavaScript and TypeScript. These settings are available in the following setting sections.

javascript.inlayHints typescript.inlayHints

Contributions

Additional language support is welcome as pull requests, and highly encouraged. You can see the source code to see how existing languages have been implemented.

Currently, the extension has 2 major steps that all language drivers must implement:

  1. Parsing the source code of the currently active file (Using an AST library - AST Explorer can assist in navigating it) to retrieve a list of positions where annotations should be inserted.
  2. Getting the name of the parameters to use as the annotations. Existing language drivers do this by triggering the hover providers for the function being called, and extracting the parameter names from the description.

Credits / Links

License

The MIT License (MIT). Please see the license file for more information.