Blog plugin failing with TypeError: can't compare offset-naive and offset-aware datetimes on 9.5.45

[mvelikikh]

Context

No response

Bug description

mkdocs build --strict fails on 9.5.45 with the error below:

mkdocs build -s
INFO    -  Cleaning site directory
INFO    -  Building documentation to directory: D:\temp\20241120\mkdocs\site
Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Scripts\mkdocs.exe\__main__.py", line 7, in <module>
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\click\core.py", line 1157, in __call__
    return self.main(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\click\core.py", line 1078, in main
    rv = self.invoke(ctx)
         ^^^^^^^^^^^^^^^^
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\click\core.py", line 1688, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\click\core.py", line 1434, in invoke
    return ctx.invoke(self.callback, **ctx.params)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\click\core.py", line 783, in invoke
    return __callback(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\mkdocs\__main__.py", line 288, in build_command
    build.build(cfg, dirty=not clean)
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\mkdocs\commands\build.py", line 292, in build
    files = config.plugins.on_files(files, config=config)
            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\mkdocs\plugins.py", line 593, in on_files
    return self.run_event('files', files, config=config)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\mkdocs\plugins.py", line 566, in run_event
    result = method(item, **kwargs)
             ^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Mikhail\AppData\Local\Programs\Python\Python312\Lib\site-packages\material\plugins\blog\plugin.py", line 133, in on_files
    self.blog.posts = sorted(
                      ^^^^^^^
TypeError: can't compare offset-naive and offset-aware datetimes

9.5.38 works fine.
I constructed a minimal reproduction test case, and based on this, the error is thrown when I have two formats of date.created:

1. yyyy-mm-dd (e.g. created: 2024-09-06)
2. yyyy-mm-ddThh:mi:ss (e.g. created: 2019-02-25T04:25:00)

Both formats are supported per the documentation: https://squidfunk.github.io/mkdocs-material/plugins/blog/#meta.date

If I remove any of the files and keep only one format, there is no error.

Related links

• Reporting a bug
• Blog plugin failing with TypeError: can't compare offset-naive and offset-aware datetimes #7705

Reproduction

9.5.45-typerror-cannot-compare-datetimes.zip

Steps to reproduce

1. pip install . (the reproduction file has pyproject.toml)
2. mkdocs build --strict - should fail ❌
3. pip install mkdocs-material==9.5.38
4. mkdocs build --strict - should work✔

Browser

Firefox

Before submitting

• I have read and followed the bug reporting guidelines.
• I have attached links to the documentation, and possibly related issues and discussions.
• I assure that I have removed all customizations before submitting this bug report.
• I have attached a .zip file with a minimal reproduction using the built-in info plugin.

[perpil]

I've got a PR to address this here: #7730

As a temporary workaround if you add a timezone i.e. -07:00 or Z to the end of your dates that have a time, that should get you unblocked.

[mvelikikh]

The workaround I use now is to use 9.5.38. Another workaround is to use dates with time because most of my dates are with times, and only one is yyyy-mm-dd which is causing issues in 9.5.45 that broke it.
There is no need for a time zone because I don't use it. It is not in the documentation either: https://squidfunk.github.io/mkdocs-material/plugins/blog/#meta.date

[squidfunk]

@mvelikikh #7730 is merged. Could you please check if the error is fixed for you now?

[perpil]

The workaround I use now is to use 9.5.38. Another workaround is to use dates with time because most of my dates are with times, and only one is yyyy-mm-dd which is causing issues in 9.5.45 that broke it. There is no need for a time zone because I don't use it. It is not in the documentation either: https://squidfunk.github.io/mkdocs-material/plugins/blog/#meta.date

Thanks @mvelikikh your workaround is the correct one. Sorry for the churn here, I believe #7730 should address all cases.

[mvelikikh]

@squidfunk I tested and can confirm that it works with the latest changes from eee4934
@perpil thanks for fixing this.

[squidfunk]

Thanks for your time, @perpil! I'll let that sit for 2-3 days to see if we catch another bug, and then issue the next release.

[practicalli-johnny]

FYI: I experienced the same issue using material for mkdocs 9.5.45 within the GtiHub action used to publish my journal.

My posts all use the yyyy-mm-dd date format.

Setting the mkdocs-material python package version to 9.5.44 in the GitHub actions workflow file resolves this issue, until the next release is available.

- run: pip install mkdocs-material=="9.5.44" mkdocs-callouts mkdocs-glightbox mkdocs-git-revision-date-localized-plugin mkdocs-redirects mkdocs-rss-plugin pillow cairosvg

Thank you for quickly creating a fix

[squidfunk]

Released as part of 9.5.46.