Add as_optional_path accessor

[snejus]

As I've been migrating beets to pathlib I realised that I use this pattern a lot:

$ grep -RiC1 'Optional.*Path' beets*
beetsplug/convert.py-    def tmpdir(self) -> Path | None:
beetsplug/convert.py:        return self.config["tmpdir"].get(confuse.Optional(confuse.Path()))
beetsplug/convert.py-
--
beetsplug/duplicates.py-        checksum = self.config["checksum"].get(str)
beetsplug/duplicates.py:        copy = self.config["copy"].get(confuse.Optional(confuse.Path()))
beetsplug/duplicates.py-        count = self.config["count"].get(bool)
--
beetsplug/duplicates.py-        merge = self.config["merge"].get(bool)
beetsplug/duplicates.py:        move = self.config["move"].get(confuse.Optional(confuse.Path()))
beetsplug/duplicates.py-        path = self.config["path"].get(bool)
--
beetsplug/fetchart.py-        return self.config["fallback"].get(
beetsplug/fetchart.py:            confuse.Optional(confuse.templates.Path())
beetsplug/fetchart.py-        )
--
beetsplug/importfeeds.py-        if feeds_dir := self.config["dir"].get(
beetsplug/importfeeds.py:            confuse.Optional(confuse.Path())
beetsplug/importfeeds.py-        ):
--
beetsplug/importfeeds.py-        if relative_to := self.config["relative_to"].get(
beetsplug/importfeeds.py:            confuse.Optional(confuse.Path())
beetsplug/importfeeds.py-        ):
--
beetsplug/play.py-        if relative_to := config["play"]["relative_to"].get(
beetsplug/play.py:            confuse.Optional(confuse.Path())
beetsplug/play.py-        ):
--
beetsplug/smartplaylist.py-        if relative_to := self.config["relative_to"].get(
beetsplug/smartplaylist.py:            confuse.Optional(confuse.Path())
beetsplug/smartplaylist.py-        ):

[github-actions]

Thank you for the PR! The changelog has not been updated, so here is a friendly reminder to check if you need to add an entry.

[Copilot]

Pull request overview

This pull request adds a convenience accessor to retrieve optional path configuration values as pathlib.Path | None, aligning with common usage patterns during pathlib migration work.

Changes:

• Add as_optional_path() accessor implemented via Optional(Path()).
• Update validation tests to cover the new accessor and simplify as_path() testing now that pathlib is unconditionally available.
• Document the change in the changelog and tune Ruff’s flake8-pytest-style configuration.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File	Description
confuse/core.py	Adds the new as_optional_path() accessor (wrapper around Optional(Path())).
test/test_validation.py	Adds tests for as_optional_path() and simplifies as_path() test logic.
docs/changelog.rst	Notes the new accessor in the Unreleased changelog.
pyproject.toml	Adds Ruff flake8-pytest-style configuration adjustments.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.