ImportError: cannot import name 'CombinedEvent' from 'mkdocs.plugins'

[mjordan]

Running mkdocs (with either the build and gh-deploy parameters) results in the following error:

Traceback (most recent call last):
  File "/home/mark/.local/bin/mkdocs", line 8, in <module>
    sys.exit(cli())
  File "/home/mark/.local/lib/python3.10/site-packages/click/core.py", line 1157, in __call__
    return self.main(*args, **kwargs)
  File "/home/mark/.local/lib/python3.10/site-packages/click/core.py", line 1078, in main
    rv = self.invoke(ctx)
  File "/home/mark/.local/lib/python3.10/site-packages/click/core.py", line 1688, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "/home/mark/.local/lib/python3.10/site-packages/click/core.py", line 1434, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/home/mark/.local/lib/python3.10/site-packages/click/core.py", line 783, in invoke
    return __callback(*args, **kwargs)
  File "/home/mark/.local/lib/python3.10/site-packages/mkdocs/__main__.py", line 247, in build_command
    cfg = config.load_config(**kwargs)
  File "/home/mark/.local/lib/python3.10/site-packages/mkdocs/config/base.py", line 363, in load_config
    errors, warnings = cfg.validate()
  File "/home/mark/.local/lib/python3.10/site-packages/mkdocs/config/base.py", line 228, in validate
    run_failed, run_warnings = self._validate()
  File "/home/mark/.local/lib/python3.10/site-packages/mkdocs/config/base.py", line 186, in _validate
    self[key] = config_option.validate(value)
  File "/home/mark/.local/lib/python3.10/site-packages/mkdocs/config/config_options.py", line 147, in validate
    return self.run_validation(value)
  File "/home/mark/.local/lib/python3.10/site-packages/mkdocs/config/config_options.py", line 939, in run_validation
    self.load_plugin_with_namespace(name, cfg)
  File "/home/mark/.local/lib/python3.10/site-packages/mkdocs/config/config_options.py", line 975, in load_plugin_with_namespace
    return (name, self.load_plugin(name, config))
  File "/home/mark/.local/lib/python3.10/site-packages/mkdocs/config/config_options.py", line 993, in load_plugin
    plugin_cls = self.installed_plugins[name].load()
  File "/usr/lib/python3.10/importlib/metadata/__init__.py", line 171, in load
    module = import_module(match.group('module'))
  File "/usr/lib/python3.10/importlib/__init__.py", line 126, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1050, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1027, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1006, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 688, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 883, in exec_module
  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
  File "/home/mark/.local/lib/python3.10/site-packages/mkdocs_exporter/plugin.py", line 7, in <module>
    from mkdocs.plugins import BasePlugin, CombinedEvent
ImportError: cannot import name 'CombinedEvent' from 'mkdocs.plugins' (/home/mark/.local/lib/python3.10/site-packages/mkdocs/plugins.py)

I'm running Python 3.10.12 and version 1.4.2. My config block is this:

plugins:
  - exporter:
      formats:
        pdf:
          enabled: !ENV [MKDOCS_EXPORTER_PDF, true]
          concurrency: 8
          stylesheets:
            - css/extra.css
          aggregator:
            enabled: true
            output: site.pdf
            covers: all

Any suggestions on how to resolve this?

[nbanyan]

What is your version of MkDocs? CombinedEvent was added in 1.6.0.
Alternatively, you could try using mkdocs-exporter v5.3.1.

[mjordan]

Thanks, I was running mkdocs 1.4.2, which satisfied the minimum version stated in the README.