tomerfiliba / plumbum / 26777869948

88%

push

github

refactor(typing): tighten loose annotations across the public API (#810)

- path/base: `parent`/`parents` are annotated `Self`/`tuple[Self, ...]`
  (they return Path objects, not `str` as previously declared)
- machines/env: fix `items()` return type to `ItemsView[str, str]`
  (it had a single type arg, masked with a `type: ignore`)
- machines/local, remote, ssh_machine: the async machine wrappers now
  declare concrete return types instead of `Any` — `__getitem__` returns
  the wrapping async command, and `cwd`/`env`/`path` return their real
  types. This also makes the cast in `async_cmd.__getattr__` redundant
  (removed)
- commands/async_: type the `read_stream`/`drain_stream` `target`
  parameters as `TextIO` instead of `Any`
- cli/terminal: drop the duplicate `get_terminal_size` entry in `__all__`
- examples/async_example: use a distinct variable for the `AsyncResult`
  from `.run()` (it was reusing the `str` result variable, which only
  type-checked because the command was previously `Any`)

Assisted-by: ClaudeCode:claude-opus-4.8

1264 of 1714 branches covered (73.75%)

16 of 16 new or added lines in 7 files covered. (100.0%)

5365 of 6156 relevant lines covered (87.15%)

11.47 hits per line