set `__module__` on top-level public objects?

[mathause]

See pandas-dev/pandas#55178 for the discussion. This may help with the path of data handling functions https://mesmer-emulator.readthedocs.io/en/latest/generated/mesmer.core.grid.wrap_to_180.html#mesmer.core.grid.wrap_to_180

[veni-vidi-vici-dormivi]

Hm I see the benefit. I also had the problem of not being able to find things in numpy, but I agree that the user perspective is more important, and could help with #348

[mathause]

Unfortunately it does not help with the docs. vscode code jumping apparently still works

[mathause]

So the issue with the docs is that I want e.g. wrap_to_180 to be accessed as mesmer.grid while avoiding having a grid.py file in the mesmer folder. That is maybe exaggerated. So solutions would be

• make it a top-level function (mesmer.wrap_to_180)
• have a specific name for all data manipulation functions (e.g. mesmer.data.wrap_to_180)
• move grid.py from the core folder to the mesmer folder