o wi @sddlmZddlmZmZddlmZmZmZm Z m Z er6edZ ededZ e e e ee e dffZe ddddZe dd ddZeeffd!ddZd"ddZ  d#d$ddZdS)%) annotations)HashableIterable) TYPE_CHECKINGAnyTypeVarUnionoverloadT HashableT)bound.obj Iterable[T] base_type ClassInforeturnlist[T]cCdSNr rrrD/home/ubuntu/.local/lib/python3.10/site-packages/wandb/_iterutils.py always_list rcCrrrrrrrrrrcCst||r|gSt|S)akReturn a guaranteed list of objects from one instance OR an iterable of such items. By default, assume the returned list should have string-like elements (`str`/`bytes`). Adapted from `more_itertools.always_iterable`, but simplified for internal use. See: https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.always_iterable ) isinstancelistrrrrrsiterableIterable[HashableT]list[HashableT]cCstt|S)zNReturn a deduplicated list of items from the given iterable, preserving order.)rdictfromkeys)rrrr unique_listsr!N too_short"type[Exception] | Exception | Nonetoo_longcCsdt|}zt|}Wnty|ptddwzt|}Wn ty*|YSw|p0tdd)aReturn the only item in the iterable. Note: This is intended **only** as an internal helper/convenience function, and its implementation is directly adapted from `more_itertools.one`. Users needing similar functionality are strongly encouraged to use that library instead: https://more-itertools.readthedocs.io/en/stable/api.html#more_itertools.one Args: iterable: The iterable to get the only item from. too_short: Custom exception to raise if the iterable has no items. too_long: Custom exception to raise if the iterable has multiple items. Raises: ValueError or `too_short`: If the iterable has no items. ValueError or `too_long`: If the iterable has multiple items. z"Expected 1 item in iterable, got 0Nz)Expected 1 item in iterable, got multiple)iternext StopIteration ValueError)rr"r$itr _rrrone!s     r+).)r rrrrr)r r rrrr)r rrrrr)rrrr)NN)rrr"r#r$r#rr ) __future__rcollections.abcrrtypingrrrrr r r typetuplerrstrbytesr!r+rrrrs