The function PyImport_AddModuleRef, which was recently added to the stable ABI, is questionable.

It returns an already loaded module, or a new empty module, but doesn't give any indication of which one of those it did. IMO, that means you can't really use it for anything except a module that's supposed to stay empty.

It is not clear to me if this function actually useful for anything except the __main__ module.
Maybe it would be more useful as a recipe in the docs that users could adapt to their needs, rather than API. Or it should be changed to make it easier to use safely.

Linked PRs

• gh-106915: Add PyImport_ImportOrAddModule() function #111559