Auditing import hook to see who is importing what and when

audit.py

"""
this code prints something like this:

Hello I'm about to import a module.
2014-07-04 19:01:12,321 [irmen@Neptune] importing /cgi
2014-07-04 19:01:12,323 [irmen@Neptune] importing /urlparse
2014-07-04 19:01:12,328 [irmen@Neptune] importing /mimetools
[... and some more modules...]
Bye.

"""

import sys
import logging
import socket
import os
import getpass


def setup_import_logging():
    class ContextFilter(logging.Filter):
        def filter(self, record):
            record.hostname = socket.gethostname()
            if sys.version_info < (3, 0):
                record.username = getpass.getuser()
            else:
                record.username = os.getlogin()
            return True

    # configure the logger, adapt as desired:
    logging.basicConfig(level=logging.DEBUG, format="%(asctime)s [%(username)s@%(hostname)s] %(message)s")

    class AuditingImporter(object):
        log = logging.getLogger("auditingimporter")
        log.setLevel(logging.DEBUG)
        log.addFilter(ContextFilter())

        def find_module(self, fullname, path):
            return self.find_spec(fullname, path)

        def find_spec(self, fullname, path, target=None):
            self.log.debug("importing {path}/{fullname}".format(path=path or "", fullname=fullname))
            return None

    sys.meta_path.insert(0, AuditingImporter())


setup_import_logging()

print("Hello I'm about to import a module.")

import cgi      # will generate a load of logging entries

print("Bye.")