Bump the required group across 1 directory with 5 updates

[dependabot]

Bumps the required group with 5 updates in the / directory:

Package	From	To
setuptools	75.6.0	75.8.0
pylint	3.3.3	3.3.4
pydoclint	0.5.14	0.6.0
mkdocs-material	9.5.49	9.6.2
mkdocstrings[python]	0.27.0	0.28.0

Updates setuptools from 75.6.0 to 75.8.0

Changelog

Sourced from setuptools's changelog.

v75.8.0

Features

• Implemented Dynamic field for core metadata (as introduced in PEP 643). The existing implementation is currently experimental and the exact approach may change in future releases. (#4698)

v75.7.0

Features

• pypa/distutils#310#4478)
• Synced with pypa/distutils@ff11eed0c including bugfix for duplicate CFLAGS and adaption to support Python 3.13 is_abs in the C compiler (#4669). (#4790)

Commits

• 5c9d980 Bump version: 75.7.0 → 75.8.0
• 72c4222 Avoid using Any in function
• 1c61d47 Add news fragments for PEP 643
• f285d01 Implement PEP 643 (Dynamic field for core metadata) (#4698)
• a50f6e2 Fix _static.Dict.ior for Python 3.8
• b055895 Add extra tests for static/dynamic metadata
• 770b4fc Remove test workaround for unmarked static values from pyproject.toml
• 8b22d73 Mark values from pyproject.toml as static
• f699fd8 Fix spelling error
• 8b4c8a3 Add tests for static 'attr' directive
• Additional commits viewable in compare view

Updates pylint from 3.3.3 to 3.3.4

Commits

• c2b01c3 Bump pylint to 3.3.4, update changelog
• 023cd43 [isort] Permit to use isort 6 (#10204)
• 050acfe Calculate linter.config.jobs in cgroupsv2 environments (#10089) (#10169)
• d6992b8 fix "skipped files" count calculation (#10141)
• See full diff in compare view

Updates pydoclint from 0.5.14 to 0.6.0

Release notes

Sourced from pydoclint's releases.

0.6.0

What's Changed

• Add DOC003 to check docstring style mismatch by @​jsh9 in jsh9/pydoclint#207

Full Changelog: jsh9/pydoclint@0.5.19...0.6.0

0.5.19

What's Changed

• Fix false positive DOC405 & DOC201 for bare returns by @​jsh9 in jsh9/pydoclint#205
• Add new config option for documenting star arguments by @​jsh9 in jsh9/pydoclint#206

Full Changelog: jsh9/pydoclint@0.5.18...0.5.19

0.5.18

What's Changed

• Fix parsing and comparison of chained custom exceptions by @​jsh9 in jsh9/pydoclint#203
• Fix wording in DOC503 violation message by @​jsh9 in jsh9/pydoclint#204

Full Changelog: jsh9/pydoclint@0.5.17...0.5.18

0.5.17

What's Changed

• Add an option to auto regenerate baseline by @​jsh9 in jsh9/pydoclint#202

Full Changelog: jsh9/pydoclint@0.5.16...0.5.17

0.5.16

What's Changed

• 👌 Add pre-commit-hook to run pydoclint via flake8 by @​s-weigand in jsh9/pydoclint#200

Full Changelog: jsh9/pydoclint@0.5.15...0.5.16

0.5.15

What's Changed

• Throw DOC001 when docstring sections can't be parsed (numpy style) by @​jsh9 in jsh9/pydoclint#199

Full Changelog: jsh9/pydoclint@0.5.14...0.5.15

Changelog

Sourced from pydoclint's changelog.

[0.6.0] - 2025-01-13

• Added
  • A new violation code, DOC003, to detect docstring style mismatch (when docstrings are written in the style different from specified)
• Full diff
  • jsh9/pydoclint@0.5.19...0.6.0

[0.5.19] - 2025-01-12

• Fixed
  • False positive DOC405 and DOC201 when we have bare return statements together with yield statements
• Added
  • A new config option --should-document-star-arguments (if False, star arguments such as *args and **kwargs should not be documented in the docstring)
  • A pre-commit step to check that "Full diff" is always added in CHANGELOG.md
• Full diff
  • jsh9/pydoclint@0.5.18...0.5.19

[0.5.18] - 2025-01-12

• Fixed
  • An issue where custom exceptions such as a.b.c.MyException.from_str cannot be properly parsed and compared
  • A minor wording issue in DOC503 violation message
• Full diff
  • jsh9/pydoclint@0.5.17...0.5.18

[0.5.17] - 2025-01-12

• Added
  • A new config option --auto-regenerate-baseline to automatically regenerate the baseline file for every successful pydoclint run
• Full diff
  • jsh9/pydoclint@0.5.16...0.5.17

[0.5.16] - 2025-01-11

• Added

  • A pre-commit hook for using pydoclint as a flake8 plugin

• Full diff

  • jsh9/pydoclint@0.5.15...0.5.16

[0.5.15] - 2025-01-10

• Changed

... (truncated)

Commits

• 2e8af22 Add DOC003 to check docstring style mismatch (#207)
• 94039b2 Add new config option for documenting star arguments (#206)
• 22b9b37 Fix false positive DOC405 & DOC201 for bare returns (#205)
• 1f2ea57 Fix wording in DOC503 violation message (#204)
• 91263b8 Fix parsing and comparison of chained custom exceptions (#203)
• 64ef923 Add tips, tricks, and pitfalls to README
• fe188f4 Add an option to auto regenerate baseline (#202)
• 7282eb6 👌 Add pre-commit-hook to run pydoclint via flake8 (#200)
• 4021d8d Throw DOC001 when docstring sections can't be parsed (numpy style) (#199)
• See full diff in compare view

Updates mkdocs-material from 9.5.49 to 9.6.2

Release notes

Sourced from mkdocs-material's releases.

mkdocs-material-9.6.2

• Fixed #7955: Excessively long words don't break on narrow screens
• Fixed #7947: Scope setting interferes with outdated version banner

mkdocs-material-9.6.1

• Fixed #7943: Tags plugin crashing due to merge error

mkdocs-material-9.6.0

• Added meta plugin
• Rewrite of the tags plugin
• Added support for allow lists in tags plugin
• Added support for and custom sorting in tags plugin
• Added support for related links in blog plugin
• Added support for custom index pages in blog plugin
• Added support for navigation subtitles
• Fixed #7924: Anchors might require two clicks when using instant navigation

mkdocs-material-9.5.50

• Fixed #7913: Social plugin renders attribute lists in page title

Changelog

Sourced from mkdocs-material's changelog.

mkdocs-material-9.6.2 (2025-02-03)

• Fixed #7955: Excessively long words don't break on narrow screens
• Fixed #7947: Scope setting interferes with outdated version banner

mkdocs-material-9.6.1 (2025-01-31)

• Fixed #7943: Tags plugin crashing due to merge error

mkdocs-material-9.6.0 (2025-01-31)

• Added meta plugin
• Rewrite of the tags plugin
• Added support for allow lists in tags plugin
• Added support for and custom sorting in tags plugin
• Added support for related links in blog plugin
• Added support for custom index pages in blog plugin
• Added support for navigation subtitles
• Fixed #7924: Anchors might require two clicks when using instant navigation

mkdocs-material-9.5.50 (2025-01-18)

• Fixed #7913: Social plugin renders attribute lists in page title

mkdocs-material-9.5.49+insiders-4.53.15 (2025-01-15)

• Fixed #7896: Scoped tags listings not rendering in subsections

mkdocs-material-9.5.49 (2024-12-16)

• Adjusted title color in dark mode for all supported Mermaid.js diagrams
• Fixed #7803: Privacy plugin crashes on generated files
• Fixed #7781: Mermaid.js flow chart title not visible in dark mode

mkdocs-material-9.5.48 (2024-12-08)

• Fixed #7774: Disabling social cards doesn't work

mkdocs-material-9.5.47 (2024-12-01)

• Fixed #7750: Numeric tags break search
• Fixed #7748: Blog plugin breaks when using future drafts (9.5.45 regression)

mkdocs-material-9.5.46 (2024-11-25)

• Added support for removing preload hints in privacy plugin
• Fixed #7734: Code blocks in h5 headlines are uppercased
• Fixed #7725: Blog plugin crashing on missing timezone (9.5.45 regression)

mkdocs-material-9.5.45 (2024-11-20)

... (truncated)

Commits

• 1648d56 Prepare 9.6.2 release
• cf46186 Fixed side effect of scope on outdated banner (#7959)
• 26a32ea Documentation (#7957)
• 66f1fc6 Added demo repository badge (#7915)
• 2c52fa2 Fixed word breaks for excessively long words
• 454af62 Prepare 9.6.1 release
• 2d147c7 Fixed crashing tags plugin
• 34dc4fe Updated Premium sponsors
• 8edc6f8 Updated Premium sponsors
• 0be1d6b Documentation
• Additional commits viewable in compare view

Updates mkdocstrings[python] from 0.27.0 to 0.28.0

Release notes

Sourced from mkdocstrings[python]'s releases.

0.28.0

0.28.0 - 2025-02-03

Compare with 0.27.0

Breaking Changes

Although the following changes are "breaking" in terms of public API, we didn't find any public use of these classes and methods on GitHub.

• mkdocstrings.extension.AutoDocProcessor.__init__(parser): Parameter was removed
• mkdocstrings.extension.AutoDocProcessor.__init__(md): Positional parameter was moved
• mkdocstrings.extension.AutoDocProcessor.__init__(config): Parameter was removed
• mkdocstrings.extension.AutoDocProcessor.__init__(handlers): Parameter kind was changed: positional or keyword -> keyword-only
• mkdocstrings.extension.AutoDocProcessor.__init__(autorefs): Parameter kind was changed: positional or keyword -> keyword-only
• mkdocstrings.extension.MkdocstringsExtension.__init__(config): Parameter was removed
• mkdocstrings.extension.MkdocstringsExtension.__init__(handlers): Positional parameter was moved
• mkdocstrings.extension.MkdocstringsExtension.__init__(autorefs): Positional parameter was moved
• mkdocstrings.handlers.base.Handlers.__init__(config): Parameter was removed
• mkdocstrings.handlers.base.Handlers.__init__(theme): Parameter was added as required
• mkdocstrings.handlers.base.Handlers.__init__(default): Parameter was added as required
• mkdocstrings.handlers.base.Handlers.__init__(inventory_project): Parameter was added as required
• mkdocstrings.handlers.base.Handlers.__init__(tool_config): Parameter was added as required

Similarly, the following parameters were renamed, but the methods are only called from our own code, using positional arguments.

• mkdocstrings.handlers.base.BaseHandler.collect(config): Parameter was renamed options
• mkdocstrings.handlers.base.BaseHandler.render(config): Parameter was renamed options

Finally, the following method was removed, but this is again taken into account in our own code:

• mkdocstrings.handlers.base.BaseHandler.get_anchors: Public object was removed

For these reasons, and because we're still in v0, we do not bump to v1 yet. See following deprecations.

Deprecations

mkdocstrings 0.28 will start emitting these deprecations warnings:

The handler argument is deprecated. The handler name must be specified as a class attribute.

Previously, the get_handler function would pass a handler (name) argument to the handler constructor. This name must now be set on the handler's class directly.

class MyHandler:
name = "myhandler"

The domain attribute must be specified as a class attribute.

The domain class attribute on handlers is now mandatory and cannot be an empty string.

... (truncated)

Changelog

Sourced from mkdocstrings[python]'s changelog.

0.28.0 - 2025-02-03

Compare with 0.27.0

Breaking Changes

Although the following changes are "breaking" in terms of public API, we didn't find any public use of these classes and methods on GitHub.

• mkdocstrings.extension.AutoDocProcessor.__init__(parser): Parameter was removed
• mkdocstrings.extension.AutoDocProcessor.__init__(md): Positional parameter was moved
• mkdocstrings.extension.AutoDocProcessor.__init__(config): Parameter was removed
• mkdocstrings.extension.AutoDocProcessor.__init__(handlers): Parameter kind was changed: positional or keyword -> keyword-only
• mkdocstrings.extension.AutoDocProcessor.__init__(autorefs): Parameter kind was changed: positional or keyword -> keyword-only
• mkdocstrings.extension.MkdocstringsExtension.__init__(config): Parameter was removed
• mkdocstrings.extension.MkdocstringsExtension.__init__(handlers): Positional parameter was moved
• mkdocstrings.extension.MkdocstringsExtension.__init__(autorefs): Positional parameter was moved
• mkdocstrings.handlers.base.Handlers.__init__(config): Parameter was removed
• mkdocstrings.handlers.base.Handlers.__init__(theme): Parameter was added as required
• mkdocstrings.handlers.base.Handlers.__init__(default): Parameter was added as required
• mkdocstrings.handlers.base.Handlers.__init__(inventory_project): Parameter was added as required
• mkdocstrings.handlers.base.Handlers.__init__(tool_config): Parameter was added as required

Similarly, the following parameters were renamed, but the methods are only called from our own code, using positional arguments.

• mkdocstrings.handlers.base.BaseHandler.collect(config): Parameter was renamed options
• mkdocstrings.handlers.base.BaseHandler.render(config): Parameter was renamed options

Finally, the following method was removed, but this is again taken into account in our own code:

• mkdocstrings.handlers.base.BaseHandler.get_anchors: Public object was removed

For these reasons, and because we're still in v0, we do not bump to v1 yet. See following deprecations.

Deprecations

mkdocstrings 0.28 will start emitting these deprecations warnings:

The handler argument is deprecated. The handler name must be specified as a class attribute.

Previously, the get_handler function would pass a handler (name) argument to the handler constructor. This name must now be set on the handler's class directly.

class MyHandler:
    name = "myhandler"

The domain attribute must be specified as a class attribute.

The domain class attribute on handlers is now mandatory and cannot be an empty string.

... (truncated)

Commits

• 6ef1412 chore: Prepare release 0.28.0
• 936275e Merge branch 'main' of github.com:mkdocstrings/mkdocstrings
• 3cf7d51 fix: Update handlers in JSON schema to be an object instead of an array
• f3ecf58 chore: Ignore autorefs fallback deprecation warning
• 9618e17 docs: Mention mkdocs-api-autonav in recipe
• 52ea2f2 ci: Upgrade dev-deps to prevent warnings in tests
• 8c476ee refactor: Pass config_file_path to get_handler if it expects it
• 053ef23 Merge branch 'main' of github.com:mkdocstrings/mkdocstrings
• 48625a2 chore: Fix inventory loading error log message
• 060e437 docs: Fix link to arithmatex docs in Material for MkDocs
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore <dependency name> major version will close this group update PR and stop Dependabot creating any more for the specific dependency's major version (unless you unignore this specific dependency's major version or upgrade to it yourself)
• @dependabot ignore <dependency name> minor version will close this group update PR and stop Dependabot creating any more for the specific dependency's minor version (unless you unignore this specific dependency's minor version or upgrade to it yourself)
• @dependabot ignore <dependency name> will close this group update PR and stop Dependabot creating any more for the specific dependency (unless you unignore this specific dependency or upgrade to it yourself)
• @dependabot unignore <dependency name> will remove all of the ignore conditions of the specified dependency
• @dependabot unignore <dependency name> <ignore condition> will remove the ignore condition of the specified dependency and ignore conditions

[llucax]

Added a few commits to fix issues with the new dependencies.

We are going to have this issue with all repos, as it is in a file that is part of the templates. We need to move as much code as possible to repo-config to avoid having to update templates in all projects 😢

• Move mkdocs-macros boilerplate from the template to the library #179

[llucax]

We need to include a migration script for the release, but I hope we can move the code first so the migration script would be removing code instead of fixing it, this is why it is not included in this PR.

[llucax]

Needs approval from someone else.

[llucax]

Will force-merge, I want to move forward with this and #179, as it will start hitting every other project.