xonsh.lib.itertools

xonsh.lib.itertools.as_iterable(iterable_or_scalar)

Utility for converting an object to an iterable. Parameters ———- iterable_or_scalar : anything

Returns

literable

If obj was None, return the empty tuple. If obj was not iterable returns a 1-tuple containing obj. Otherwise return obj

Notes

Although string types are iterable in Python, we are treating them as not iterable in this method. Thus, as_iterable(string) returns (string, )

Examples

>>> as_iterable(1)
(1,)
>>> as_iterable([1, 2, 3])
[1, 2, 3]
>>> as_iterable("my string")
("my string", )