invoke-toolkit 0.0.65__tar.gz → 0.0.66__tar.gz

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: invoke-toolkit
-Version: 0.0.65
+Version: 0.0.66
 Summary: Extended APIs for PyInvoke: composable task plugins, typed CLI args, Rich output, shell completion, and PEP 723 script support
 Project-URL: Documentation, https://github.com/D3f0/invoke-toolkit#readme
 Project-URL: Issues, https://github.com/D3f0/invoke-toolkit/issues
@@ -167,6 +167,74 @@ To enable caching, install with the cache extra:
 pip install invoke-toolkit[cache]
 ```
 
+## Dynamic task defaults
+
+Use `Field` when an argument default must be computed from the final task
+context or resolved from a URI. Explicit command-line values always take
+precedence.
+
+Bind a resolver once, then reuse the resulting callable for scalar and file
+defaults. A local resolver always returns one string value per request. The
+resolver receives every URI using that callback and scheme in one batch.
+
+```python
+from invoke_toolkit import Context, Field, FilePath, task
+
+
+def resolve_bw(ctx: Context, requests: list) -> dict[str, str]:
+    return {
+        request.parameter: ctx.run("bw get password ...", hide=True).stdout.strip()
+        for request in requests
+    }
+
+
+BitwardenField = Field(resolver=resolve_bw)
+ExistingFile = FilePath(exists=True, dir_okay=False)
+
+
+@task
+def deploy(
+    ctx: Context,
+    password: str = BitwardenField(default="bw://PASSWORD_ID"),
+    config: ExistingFile = BitwardenField(
+        default="bw://CONFIG_ID", cleanup="task"
+    ),
+) -> None:
+    ...
+```
+
+For `str` fields, the resolver string reaches the task unchanged. For `Path` or
+`FilePath` fields, `Field.create_temporary_file()` writes that string to a
+managed temporary file and passes its `Path` to the task. Override that method
+in a `Field` subclass to control file creation; resolvers do not return paths.
+
+For omitted arguments, lookup precedence is explicit CLI/Python/call value,
+then `INVOKE_<PARAMETER>` environment value, then the resolved `ctx.config`
+value, then the declared `Field` default or factory. URI values from config use
+the same local or entry-point resolver dispatch as declared URI defaults.
+
+`Field(default_factory=callback)` runs only if no higher-precedence value is
+available. Factories and resolvers never run during help, listing, or shell
+completion; `Path`/`FilePath` completion continues to work normally for
+explicit values.
+
+Temporary `Path` files from resolver-bound `Field` instances are owned by
+invoke-toolkit. `cleanup="pipeline"` is the default and keeps the file through
+expanded pre/main/post execution; `cleanup="task"` removes it when that task
+returns. Cleanup runs after failures and cancellation.
+
+Installed `invoke_toolkit.field_resolver` entry points remain supported for
+compatibility but issue a warning recommending a task-local resolver. Generate a
+resolver-only provider package with:
+
+```console
+intk -x create.package --provider op
+```
+
+Provider packages expose no task collection. Providers return text only; for
+`Path` fields invoke-toolkit materializes and cleans the resulting temporary
+file according to that Field's cleanup lifetime.
+
 ## Development
 
 This project utilizes the `pre-commit` framework, make sure you run:

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/README.md

@@ -106,6 +106,74 @@ To enable caching, install with the cache extra:
 pip install invoke-toolkit[cache]
 ```
 
+## Dynamic task defaults
+
+Use `Field` when an argument default must be computed from the final task
+context or resolved from a URI. Explicit command-line values always take
+precedence.
+
+Bind a resolver once, then reuse the resulting callable for scalar and file
+defaults. A local resolver always returns one string value per request. The
+resolver receives every URI using that callback and scheme in one batch.
+
+```python
+from invoke_toolkit import Context, Field, FilePath, task
+
+
+def resolve_bw(ctx: Context, requests: list) -> dict[str, str]:
+    return {
+        request.parameter: ctx.run("bw get password ...", hide=True).stdout.strip()
+        for request in requests
+    }
+
+
+BitwardenField = Field(resolver=resolve_bw)
+ExistingFile = FilePath(exists=True, dir_okay=False)
+
+
+@task
+def deploy(
+    ctx: Context,
+    password: str = BitwardenField(default="bw://PASSWORD_ID"),
+    config: ExistingFile = BitwardenField(
+        default="bw://CONFIG_ID", cleanup="task"
+    ),
+) -> None:
+    ...
+```
+
+For `str` fields, the resolver string reaches the task unchanged. For `Path` or
+`FilePath` fields, `Field.create_temporary_file()` writes that string to a
+managed temporary file and passes its `Path` to the task. Override that method
+in a `Field` subclass to control file creation; resolvers do not return paths.
+
+For omitted arguments, lookup precedence is explicit CLI/Python/call value,
+then `INVOKE_<PARAMETER>` environment value, then the resolved `ctx.config`
+value, then the declared `Field` default or factory. URI values from config use
+the same local or entry-point resolver dispatch as declared URI defaults.
+
+`Field(default_factory=callback)` runs only if no higher-precedence value is
+available. Factories and resolvers never run during help, listing, or shell
+completion; `Path`/`FilePath` completion continues to work normally for
+explicit values.
+
+Temporary `Path` files from resolver-bound `Field` instances are owned by
+invoke-toolkit. `cleanup="pipeline"` is the default and keeps the file through
+expanded pre/main/post execution; `cleanup="task"` removes it when that task
+returns. Cleanup runs after failures and cancellation.
+
+Installed `invoke_toolkit.field_resolver` entry points remain supported for
+compatibility but issue a warning recommending a task-local resolver. Generate a
+resolver-only provider package with:
+
+```console
+intk -x create.package --provider op
+```
+
+Provider packages expose no task collection. Providers return text only; for
+`Path` fields invoke-toolkit materializes and cleans the resulting temporary
+file according to that Field's cleanup lifetime.
+
 ## Development
 
 This project utilizes the `pre-commit` framework, make sure you run:

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/pyproject.toml

@@ -126,6 +126,14 @@ exclude_lines = [
 ]
 
 
+[tool.ruff]
+target-version = "py310"
+extend-exclude = ["tests/original_invoke"]
+
+[tool.ruff.lint]
+extend-select = ["UP"]
+
+
 [tool.ruff.lint.per-file-ignores]
 "*tasks*" = ["ARG001"]
 "__init__.py" = ["E402"]
@@ -158,7 +166,6 @@ ci = [
     "nox>=2025.10.16",
 ]
 dev = [
-
     "copier>=9.16.0",
     "diskcache>=5.6.0",
     "hunter>=3.7.0",
@@ -167,6 +174,7 @@ dev = [
     "pre-commit-uv>=4.2.0",
     "pylint>=3.2.7",
     "pylint-per-file-ignores>=1.0.0",
+    "pyright>=1.1.404",
     "pytest>=9.1.1",
     "pytest-cov>=5.0.0",
     "pytest-html>=4.1.1",
@@ -212,7 +220,7 @@ disable = [
 
 per-file-ignores = [
     "tasks.py:missing-function-docstring,missing-class-docstring,missing-module-docstring,invalid-name,too-many-branches",
-    "src/invoke_toolkit/tasks/tasks.py:too-many-arguments,reimported,import-outside-toplevel,too-many-locals",
+    "src/invoke_toolkit/tasks/tasks.py:too-many-arguments,reimported,import-outside-toplevel,too-many-locals,too-many-lines,unidiomatic-typecheck,protected-access",
     "src/invoke_toolkit/tasks/types.py:invalid-name,import-outside-toplevel,unidiomatic-typecheck",
     "src/invoke_toolkit/completion.py:too-many-locals,too-many-branches,too-many-statements",
     "src/invoke_toolkit/program/program.py:ungrouped-imports,redefined-builtin,raise-missing-from,attribute-defined-outside-init,redefined-builtin,possibly-used-before-assignment,no-else-raise",
@@ -232,6 +240,11 @@ per-file-ignores = [
     "src/invoke_toolkit/config/config.py:import-outside-toplevel",
     "src/invoke_toolkit/config/registry.py:import-outside-toplevel,unidiomatic-typecheck",
     "src/invoke_toolkit/extensions/tasks/config.py:too-many-locals,import-outside-toplevel",
+    "src/invoke_toolkit/extensions/tasks/create.py:too-many-locals,too-many-branches",
+    "src/invoke_toolkit/executor.py:too-many-locals,protected-access,duplicate-code",
+    "src/invoke_toolkit/field_resolvers.py:too-many-locals,too-many-branches",
+    "src/invoke_toolkit/tasks/fields.py:invalid-name,too-few-public-methods",
+    "tests/typecheck/fields.py:invalid-name",
 ]
 
 

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/src/invoke_toolkit/__init__.py

@@ -16,6 +16,9 @@ from invoke_toolkit.tasks import (  # noqa
     CacheConfig,
     cache_stats,
     cached,
+    Field,
+    FieldResolutionRequest,
+    FieldResolver,
     call,
     clear_task_cache,
     task,

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/src/invoke_toolkit/collections.py

@@ -1,13 +1,15 @@
 """Extended collection with package inspection"""
 
+# pylint: disable=ungrouped-imports
 import hashlib
 import importlib.util
 import pkgutil
 import sys
+from collections.abc import Callable
 from logging import getLogger
 from pathlib import Path
 from types import ModuleType
-from typing import TYPE_CHECKING, Any, Callable, overload
+from typing import TYPE_CHECKING, Any, overload
 
 try:
     from typing import override  # type: ignore[attr-defined]
@@ -288,17 +290,19 @@ class ToolkitCollection(Collection):
             )
 
     @override
+    # pylint: disable=arguments-renamed
     def configure(
         self,
         mapping: dict[str, Any] | None = None,
         *,
         schema: "type[ConfigSchema] | ConfigSchema | None" = None,
+        **kwargs: Any,
     ) -> None:
         """Configure collection with optional attrs schema.
-
         Args:
             mapping: Traditional dict config (existing behavior)
             schema: Attrs class (uses defaults) or instance (uses provided values)
+            **kwargs: Additional compatibility keyword arguments.
 
         Examples:
             # Traditional dict
@@ -337,9 +341,14 @@ class ToolkitCollection(Collection):
             if self.name and self._config_schema:
                 register_schema(self.name, self._config_schema)
 
-        if mapping:
-            # Merge mapping over schema defaults (mapping wins)
-            self._deep_merge(final_mapping, mapping)
+        options = kwargs.pop("options", mapping)
+        if kwargs:
+            unexpected = next(iter(kwargs))
+            raise TypeError(f"unexpected keyword argument: {unexpected!r}")
+
+        if options:
+            # Merge options over schema defaults (options wins)
+            self._deep_merge(final_mapping, options)
 
         if final_mapping:
             super().configure(final_mapping)
@@ -395,7 +404,7 @@ class ToolkitCollection(Collection):
                 register_schema(name, schema)
 
             config = getattr(module, "config", None)
-            collection: "ToolkitCollection" = ns.from_module(module)
+            collection: ToolkitCollection = ns.from_module(module)
             clean_collection(collection=collection)
             # TODO: Namespaced configuration seems to be an not present when merged!§
             # if config and isinstance(config, (dict, )):

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/src/invoke_toolkit/completion.py

@@ -11,7 +11,6 @@ import re
 import shlex
 from concurrent.futures import ThreadPoolExecutor
 from concurrent.futures import TimeoutError as FuturesTimeoutError
-from typing import List
 
 from invoke.completion.complete import (
     debug,
@@ -32,7 +31,7 @@ from invoke_toolkit.tasks.types import _FileCompletionMarker
 def _get_file_completions(
     marker: "_FileCompletionMarker",
     incomplete: str,
-) -> List[str]:
+) -> list[str]:
     """
     Get file completions based on marker configuration.
 
@@ -96,7 +95,7 @@ def _get_file_completions(
     # Determine prefix to prepend to results
     dir_prefix = "" if base_dir == "." else base_dir + "/"
 
-    files: List[str] = []
+    files: list[str] = []
 
     try:
         if marker.pattern:
@@ -148,7 +147,7 @@ def get_choices_for_argument(
     arg_name: str,
     incomplete: str = "",
     config: "ToolkitConfig | None" = None,
-) -> List[str]:
+) -> list[str]:
     """
     Get available choices for an argument in a task.
 
@@ -244,7 +243,7 @@ def get_choices_for_argument(
     return []
 
 
-def _strip_program_name(names: List[str], remainder: str) -> str:
+def _strip_program_name(names: list[str], remainder: str) -> str:
     """
     Strip the program name from the invocation string.
 
@@ -274,7 +273,7 @@ def _strip_program_name(names: List[str], remainder: str) -> str:
     return invocation
 
 
-def _get_directory_completions(incomplete: str) -> List[str]:
+def _get_directory_completions(incomplete: str) -> list[str]:
     """
     Get directory completions for path arguments like --search-root.
 
@@ -310,7 +309,7 @@ def _get_directory_completions(incomplete: str) -> List[str]:
     else:
         dir_prefix = base_dir + "/"
 
-    directories: List[str] = []
+    directories: list[str] = []
 
     try:
         if not os.path.isdir(base_dir):
@@ -399,7 +398,7 @@ def _handle_flag_completion(
 
 
 def _try_complete_flag_value(
-    tokens: List[str],
+    tokens: list[str],
     completing_new_token: bool,
     initial_context: ParserContext,
     collection,
@@ -441,7 +440,7 @@ def _try_complete_flag_value(
     )
 
 
-def _get_positional_arg_index(context: ParserContext, tokens: List[str]) -> int:
+def _get_positional_arg_index(context: ParserContext, tokens: list[str]) -> int:
     """
     Determine which positional argument we're completing based on tokens.
 
@@ -546,7 +545,7 @@ def _handle_positional_completion(
 
 
 def complete_with_choices(
-    names: List[str],
+    names: list[str],
     core,
     initial_context: ParserContext,
     collection,
@@ -572,7 +571,7 @@ def complete_with_choices(
     """
     # Strip out program name
     invocation = _strip_program_name(names, core.remainder)
-    debug("Completing for invocation: {!r}".format(invocation))
+    debug(f"Completing for invocation: {invocation!r}")
 
     # Check if invocation ends with space (user wants to complete next token)
     completing_new_token = invocation.rstrip() != invocation
@@ -583,32 +582,28 @@ def complete_with_choices(
     # Handle flags (partial or otherwise)
     if tokens and tokens[-1].startswith("-"):
         tail = tokens[-1]
-        debug("Invocation's tail {!r} is flag-like".format(tail))
+        debug(f"Invocation's tail {tail!r} is flag-like")
 
         # Parse invocation to obtain current context
-        contexts: List[ParserContext]
+        contexts: list[ParserContext]
         try:
-            debug("Seeking context name in tokens: {!r}".format(tokens))
+            debug(f"Seeking context name in tokens: {tokens!r}")
             contexts = parser.parse_argv(tokens)
         except ParseError as e:
-            debug(
-                "Got parser error ({!r}), grabbing last-seen context {!r}".format(
-                    e, e.context
-                )
-            )
+            debug(f"Got parser error ({e!r}), grabbing last-seen context {e.context!r}")
             contexts = [e.context] if e.context is not None else []
 
         # Fall back to core context if no context seen
-        debug("Parsed invocation, contexts: {!r}".format(contexts))
+        debug(f"Parsed invocation, contexts: {contexts!r}")
         if not contexts or not contexts[-1]:
             context = initial_context
         else:
             context = contexts[-1]
 
-        debug("Selected context: {!r}".format(context))
+        debug(f"Selected context: {context!r}")
 
         # Check if this flag is known
-        debug("Looking for {!r} in {!r}".format(tail, context.flags))
+        debug(f"Looking for {tail!r} in {context.flags!r}")
         if tail not in context.flags:
             debug("Not found, completing with flag names")
             # Long flags - partial or just the dashes
@@ -633,16 +628,12 @@ def complete_with_choices(
             raise Exit
 
         # Try to parse to get the current context
-        contexts: List[ParserContext] = []
+        contexts: list[ParserContext] = []
         try:
-            debug("Parsing tokens for positional completion: {!r}".format(tokens))
+            debug(f"Parsing tokens for positional completion: {tokens!r}")
             contexts = parser.parse_argv(tokens)
         except ParseError as e:
-            debug(
-                "Got parser error ({!r}), grabbing last-seen context {!r}".format(
-                    e, e.context
-                )
-            )
+            debug(f"Got parser error ({e!r}), grabbing last-seen context {e.context!r}")
             contexts = [e.context] if e.context is not None else []
 
         # Check if we have a task context (not just core context)

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/src/invoke_toolkit/config/config.py

@@ -4,7 +4,7 @@ This module defines some functions/callables
 """
 
 import inspect as frame_inspect
-from typing import TYPE_CHECKING, Any, Dict, NoReturn, Optional, TypeVar, overload
+from typing import TYPE_CHECKING, Any, NoReturn, TypeVar, overload
 
 from invoke.config import Config
 from invoke.util import debug
@@ -52,10 +52,10 @@ class ToolkitConfig(Config):
 
     def __init_subclass__(
         cls,
-        prefix: Optional[str] = None,
-        file_prefix: Optional[str] = None,
-        env_prefix: Optional[str] = None,
-        extra_defaults: Optional[Dict[str, Any]] = None,
+        prefix: str | None = None,
+        file_prefix: str | None = None,
+        env_prefix: str | None = None,
+        extra_defaults: dict[str, Any] | None = None,
         **kwargs,
     ):
         super().__init_subclass__(**kwargs)
@@ -70,13 +70,13 @@ class ToolkitConfig(Config):
         else:
             cls.extra_defaults = None
 
-    extra_defaults: Optional[Dict[str, Any]]
+    extra_defaults: dict[str, Any] | None
 
     # This method is a static method in the super class
     # but it's converted to class method here, so we can
     # a reference to the attribute set by __init_subclass__
     @classmethod
-    def global_defaults(cls) -> Dict[str, Any]:
+    def global_defaults(cls) -> dict[str, Any]:
         """
         Return the core default settings for Invoke.
 
@@ -89,7 +89,7 @@ class ToolkitConfig(Config):
 
         .. versionadded:: 1.0
         """
-        ret: Dict[str, Any] = Config.global_defaults()
+        ret: dict[str, Any] = Config.global_defaults()
         extra_defaults = getattr(cls, "extra_defaults", None)
         if extra_defaults:
             debug(f"Using {cls} extra defaults: {extra_defaults}")
@@ -239,7 +239,7 @@ def _navigate_config_path(config: "ToolkitConfig", path: str) -> tuple[Any, bool
     return current, True
 
 
-def _get_task_argument_name(path: str, depth: int = 3) -> Optional[str]:  # pylint: disable=too-many-return-statements
+def _get_task_argument_name(path: str, depth: int = 3) -> str | None:  # pylint: disable=too-many-return-statements
     """
     Try to infer the task argument name from the call stack.
 
@@ -324,7 +324,7 @@ def get_config_value(
     path: str,
     default: Any = _UNDEFINED_DEFAULT,
     exit_message: str = ...,
-    exit_code: Optional[int] = None,
+    exit_code: int | None = None,
     required: bool = False,
 ) -> Any | NoReturn: ...
 
@@ -347,8 +347,8 @@ def get_config_value(
     ctx: "ToolkitContext",
     path: str,
     default: Any = _UNDEFINED_DEFAULT,
-    exit_message: Optional[str] = None,
-    exit_code: Optional[int] = None,
+    exit_message: str | None = None,
+    exit_code: int | None = None,
     required: bool = True,
 ) -> Any | NoReturn: ...
 
@@ -357,8 +357,8 @@ def get_config_value(  # pylint: disable=inconsistent-return-statements
     ctx: "ToolkitContext",
     path: str,
     default: Any = _UNDEFINED_DEFAULT,
-    exit_message: Optional[str] = None,
-    exit_code: Optional[int] = None,
+    exit_message: str | None = None,
+    exit_code: int | None = None,
     required: bool = False,
 ) -> Any:
     """

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/src/invoke_toolkit/config/registry.py

@@ -2,7 +2,8 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, Union
+import types
+from typing import TYPE_CHECKING, Any, Union, get_origin
 
 import attrs
 
@@ -187,12 +188,12 @@ def _unwrap_optional_type(type_hint: Any) -> type | None:
     Returns:
         The unwrapped type, or the original if not Optional/Union
     """
-    origin = getattr(type_hint, "__origin__", None)
+    origin = get_origin(type_hint)
     if origin is None:
         return type_hint
 
     # Handle Union types (including Optional which is Union[X, None])
-    if origin is Union:
+    if origin in (Union, types.UnionType):
         args = getattr(type_hint, "__args__", ())
         # Filter out NoneType and return the first non-None type
         non_none_args = [a for a in args if a is not type(None)]

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/src/invoke_toolkit/config/schema.py

@@ -3,7 +3,8 @@
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Any, Callable, Type, TypeVar, overload
+from typing import Any, TypeVar, overload
+from collections.abc import Callable
 
 import attrs
 import cattrs
@@ -49,7 +50,7 @@ class ConfigSchema:
     __config_description__: str | None = None
 
     @classmethod
-    def from_dict(cls: Type[T], data: dict[str, Any]) -> T:
+    def from_dict(cls: type[T], data: dict[str, Any]) -> T:
         """Create instance from dict using cattrs.
 
         Args:

{invoke_toolkit-0.0.65 → invoke_toolkit-0.0.66}/src/invoke_toolkit/config/status_helper.py

@@ -2,9 +2,10 @@
 Class that implements the ctx.status through the config class
 """
 
+# pylint: disable=ungrouped-imports
 from collections import deque
+from collections.abc import Generator
 from contextlib import contextmanager
-from typing import Generator, Optional, Union
 
 from rich.console import Console, Group, RenderableType
 from rich.live import Live
@@ -24,8 +25,8 @@ class NoOpStatus:
 
     def __init__(
         self,
-        status: Optional[RenderableType] = None,
-        console: Optional[Console] = None,
+        status: RenderableType | None = None,
+        console: Console | None = None,
     ):
         self.status = status
         self.console = console or get_console()
@@ -43,11 +44,11 @@ class NoOpStatus:
 
     def update(
         self,
-        status: Optional[RenderableType] = None,
+        status: RenderableType | None = None,
         *,
-        spinner: Optional[str] = None,
-        spinner_style: Optional[StyleType] = None,
-        speed: Optional[float] = None,
+        spinner: str | None = None,
+        spinner_style: StyleType | None = None,
+        speed: float | None = None,
     ) -> None:
         """No-op update"""
 
@@ -65,7 +66,7 @@ class VerboseStatus:  # pylint: disable=too-many-instance-attributes
         self,
         status: RenderableType,
         *,
-        console: Optional[Console] = None,
+        console: Console | None = None,
         spinner: str = "dots",
         spinner_style: StyleType = "status.spinner",
         speed: float = 1.0,
@@ -105,11 +106,11 @@ class VerboseStatus:  # pylint: disable=too-many-instance-attributes
 
     def update(
         self,
-        status: Optional[RenderableType] = None,
+        status: RenderableType | None = None,
         *,
-        spinner: Optional[str] = None,
-        spinner_style: Optional[StyleType] = None,
-        speed: Optional[float] = None,
+        spinner: str | None = None,
+        spinner_style: StyleType | None = None,
+        speed: float | None = None,
     ) -> None:
         """Update the status text or spinner parameters."""
         if status is not None:
@@ -150,7 +151,7 @@ class StatusHelper:
     it can be accessed from the task's context
     """
 
-    _current_status: Optional[Union[Status, VerboseStatus]]
+    _current_status: Status | VerboseStatus | None
     _disabled: bool
     _show_command_output: bool
 
@@ -174,7 +175,7 @@ class StatusHelper:
         spinner_style: StyleType = "status.spinner",
         speed: float = 1.0,
         refresh_per_second: float = 12.5,
-    ) -> Generator[Union[Status, VerboseStatus], None, None]:
+    ) -> Generator[Status | VerboseStatus, None, None]:
         """Context manager for status management"""
         if self._disabled:
             with NoOpStatus(status=status, console=self.console) as noop:
@@ -222,11 +223,11 @@ class StatusHelper:
 
     def status_update(
         self,
-        status: Optional[RenderableType] = None,
+        status: RenderableType | None = None,
         *,
-        spinner: Optional[str] = None,
-        spinner_style: Optional[StyleType] = None,
-        speed: Optional[float] = None,
+        spinner: str | None = None,
+        spinner_style: StyleType | None = None,
+        speed: float | None = None,
     ) -> None:
         """Wrapper on Status.update"""
         if self._disabled: