When using Nuitka to package a project, an error occurred when reading the file: "KeyError: 'self'"

Describe the new feature or enhancement

I'm experiencing an issue when using Nuitka to package a project that relies on MNE-Python. The problem appears to be related to the _get_argvalues function in MNE, which attempts to access frame information but fails due to Nuitka's handling of frame dictionaries.

The related issue on Nuitka's GitHub is documented here: Nuitka Issue #2995.

Describe your proposed implementation

As mentioned:
One possible solution would be to modify _get_argvalues to ensure that the frame dictionary is populated correctly. Currently, the function relies on frame inspection through inspect.currentframe() and stack traversal. However, Nuitka does not populate the frame dictionary until an exception occurs, which makes this approach unreliable.

Here are two alternative methods:

1. Annotate functions: Annotate specific functions so that their frame dictionaries are always populated, even if no exception occurs. This would require a custom decorator or configuration within MNE to forcefully populate the frame.
2. Use locals() directly: Modify _get_argvalues to use {locals()[var_name] for var_name in inspect.getargvalues(inspect.currentframe())[0]} to access argument values directly from locals() instead of relying on stack inspection. This approach avoids the need to traverse the frame hierarchy and should work more reliably with Nuitka.

Describe possible alternatives

Another possible alternative is to inject __import__("inspect").currentframe().f_locals.update(locals()) before calling the base class. This workaround could populate f_locals to ensure that derived classes have access to necessary parameters. However, this would require changes in all derived classes and may not be feasible in the long term due to maintenance concerns.

Among the approaches, using locals() directly appears to be the most efficient and portable solution.

Additional context

No response

Start by reading the _get_argvalues function and reproducing the MNE packaging failure under Nuitka, using Nuitka Issue #2995 for context. Compare frame inspection with the proposed locals() approach and determine a maintainable solution; done means packaged projects no longer fail with KeyError: 'self' when reading argument values.