Support Traversable for file= in config.get

[Copilot]

config.get(file=files("pkg.config").joinpath("sites.yaml")) raises a pyright reportArgumentType error because file only accepts str | Path, not Traversable.

Changes

• src/ruru/config.py: Widen file parameter type to str | Path | Traversable. When a Traversable is passed, it's used directly — find_config_file (parent directory search) is bypassed since it doesn't apply to package resources.
• tests/ruru/config/test_config.py: Add test exercising the Traversable code path via a concrete Traversable wrapper.

from importlib.resources import files
from ruru import config

# Now accepted by both runtime and type checkers
cfg = config.get(file=files("mypackage.config").joinpath("sites.yaml"))

Original prompt

---

This section details on the original issue you should resolve

<issue_title>config.get should support Traversable for file=</issue_title>
<issue_description>_sites_cfg = ruru_config.get(file=files("ghgmod.config").joinpath("sites.yaml"))

Give the pyright error

Argument of type "Traversable" cannot be assigned to parameter "file" of type "str | Path" in function "get"
  Type "Traversable" is not assignable to type "str | Path"
    "Traversable" is not assignable to "str"
    "Traversable" is not assignable to "Path"Pylance[reportArgumentType](https://github.com/microsoft/pylance-release/blob/main/docs/diagnostics/reportArgumentType.md)

Whereas this should be acceptable. We should add support for Traversable via the type annotation system.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes config.get should support Traversable for file= #49

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[nathanjmcdougall]

@copilot remove the type information from these docstrings

[Copilot]

Removed type references from the docstring in 4144ffe.

[t-t-sonarqube]

Quality Gate passed

Issues

• 0 New Issues
• 0 Fixed Issues
• 0 Accepted Issues

Measures

• 0 Security Hotspots
• 83.30% Coverage (93.00% Estimated after merge)
• 0.00% Duplicated Code (0.00% Estimated after merge)

Project ID: tonkintaylor_ruru_9df383a8-3ce9-4983-bccc-45fb680571e3

View in SonarQube