Method from_values

cmd2/completion.py:226–233

Create a CompletionItem instance from arbitrary objects. :param values: the raw objects (e.g. strs, ints, Paths) to be converted into CompletionItems. :param is_sorted: whether the values are already in the desired order.

(cls, values: Iterable[Any], *, is_sorted: bool = False)

    @classmethod
    def from_values(cls, values: Iterable[Any], *, is_sorted: bool = False) -> Self:
        """Create a CompletionItem instance from arbitrary objects.

        :param values: the raw objects (e.g. strs, ints, Paths) to be converted into CompletionItems.
        :param is_sorted: whether the values are already in the desired order.
        """
        items = [v if isinstance(v, CompletionItem) else CompletionItem(value=v) for v in values]
        return cls(items=items, is_sorted=is_sorted)

    def to_strings(self) -> tuple[str, ...]:
        """Return a tuple of the completion strings (the 'text' field of each item)."""