Settings Reference¶
All BetterPy features can be toggled in Settings → Tools → BetterPy. This page lists every feature organized by settings group.
Typing & Type Hints¶
| Feature | Maturity | Description |
|---|---|---|
| Copy method annotations from parent | Incubating | Copies type annotations from a parent method to its overrides |
| Missing |None annotation inspection | Incubating | Adds a quickfix for PyCharm's missing | None annotation inspection |
| NewType/TypeVar/ParamSpec reference & rename | Stable | Adds references for NewType/TypeVar/ParamSpec name literals, keeps the name string in sync on rename, and repairs manual NewType drift |
| Overridden method missing type annotations inspection | Incubating | Reports overrides missing type annotations present in parent methods |
| Strip signature type annotations | Stable | Removes type annotations from a function signature |
Refactoring & Code Transformations¶
| Feature | Maturity | Description |
|---|---|---|
| Change visibility | Stable | Toggles a Python symbol between public and private naming |
| Dict access conversion | Incubating | Converts between dict bracket access and .get() method calls |
| Make parameter mandatory | Incubating | Converts an optional parameter to a required one by removing the default value |
| Make parameter optional | Incubating | Converts a required parameter to an optional one with a default value |
| Parameter object MCP tool | Stable | Enables MCP (Model Context Protocol) tools for parameter object refactoring |
| Parameter object refactoring | Incubating | Enables introduce/inline parameter object refactoring actions |
| Toggle enum member value | Stable | Toggles enum member references with their literal values |
| Top-level extract function | Incubating | Extracts top-level Python statements into a function with parameters and explicit return values instead of globals |
Testing (Pytest)¶
| Feature | Maturity | Description |
|---|---|---|
| Pytest failed line inspection | Incubating | Marks the line where a pytest test failed |
| Pytest fixture documentation | Stable | Enhances Quick Documentation and member type inference for pytest fixtures across files |
| Pytest parametrized case run gutter icon | Incubating | Shows run gutter icons for individual pytest parametrized cases when each case is on its own line |
| Use actual test outcome | Incubating | Replaces assertion expected values with the actual value from the last failed test run |
Imports & Module Boundaries¶
| Feature | Maturity | Description |
|---|---|---|
| Export symbol to target | Stable | Exports a symbol to a specified target module's all |
Navigation & Discovery¶
| Feature | Maturity | Description |
|---|---|---|
| Class implementations code vision | Incubating | Shows an inline code vision hint above each Python class with the number of implementations (subclasses) and lets you navigate to them |
| Module assignment usages code vision | Incubating | Shows an inline code vision hint above each module-level assignment with the number of project-scope usages and lets you navigate to them |
| Property usages code vision | Incubating | Shows an inline code vision hint above each Python property with the number of project-scope usages and lets you navigate to them |
| Return path highlighting | Incubating | Highlights explicit return statements when the caret is on a function return annotation |
Code Quality & Safety¶
| Feature | Maturity | Description |
|---|---|---|
| Constant should be Final inspection | Stable | Reports module-level constants that should be annotated with Final |
| Private module import inspection | Stable | Reports private-module imports that should use public package exports |
| Shadowing stdlib module inspection | Stable | Reports project modules that shadow Python standard library modules |
| Suppress missing docstrings on overloads | Incubating | Suppresses PyCharm's missing docstring inspection for typing overload signatures. |
| Usage filtering | Stable | Adds Find Usages filters for type annotations and test-source references |
Productivity Actions¶
| Feature | Maturity | Description |
|---|---|---|
| Attribute Docstring in Quick Documentation | Stable | Shows the string literal below a class attribute (attribute docstring) in Quick Documentation. Fixes PY-63878. |
| Copy with imports | Incubating | Copies selected Python code together with the import statements referenced by that selection |
| Docstring Example Rendering | Incubating | Renders doctests and fenced Python examples in Quick Documentation docstrings. |
| Generate class actions | Stable | Adds Generate menu actions for dataclass, frozen dataclass, and pydantic model |
IDE Customization¶
| Feature | Maturity | Description |
|---|---|---|
| Enhanced Go to Implementation presentation | Stable | Prepends class name to method name in Go to Implementation popup when names are identical |
| Message console filter | Stable | Filters and formats Python messages in the console |
| Python navigation bar | Stable | Enables enhanced Python navigation bar with module path display |
| Structural Search Profile (Python) | Incubating | Adds a Python Structural Search profile integration for pattern matching and constraints |
| Test/Production editor tabs | Incubating | Keeps test and production files in separate editor splits with configurable alignment |