Python module importing itself with leading underscore but there is no corresponding .py file

Question

In the PyBluez source code I've noticed a couple things I haven't seen before. This file named widcomm.py starts with the following:

from .btcommon import *
import socket
import struct
import threading
import os
import _widcomm

In the previous directory, there is no _widcomm.py or another widcomm.py. I've read that modules with a leading underscore might be "private" or accelerated, but I can't find anything about a module seemingly importing itself with an underscore.

A few lines under that you get this interesting function:

def dbg (*args):
    return
    sys.stdout.write (*args)
    sys.stdout.write ("\n")

Am I correct in thinking the code under return has no way of ever being executed? As far as I can tell this function serves no purpose.

What exactly is going on here?

Answer 1

According to the setup file of this Python package,

ext_modules.append(Extension('bluetooth._widcomm',
        include_dirs=["%s\\Inc" % WC_BASE],
        define_macros=[('_BTWLIB', None)],
        library_dirs=["%s\\Release" % WC_BASE],
        libraries=["WidcommSdklib", "ws2_32", "version", "user32",
                   "Advapi32", "Winspool", "ole32", "oleaut32"],
        sources=["widcomm\\_widcomm.cpp",
                 "widcomm\\inquirer.cpp",
                 "widcomm\\rfcommport.cpp",
                 "widcomm\\rfcommif.cpp",
                 "widcomm\\l2capconn.cpp",
                 "widcomm\\l2capif.cpp",
                 "widcomm\\sdpservice.cpp",
                 "widcomm\\util.cpp"]))

the _widcomm import refers to an extension module which is built from the _widcomm.cpp and related C++ source files.