one

iteration_utilities.one(iterable, /)

Return the first value in the iterable and expects it only contains one element.

Parameters

iterableiterable

The iterable from which to get the one item.

Returns

oneany type

The first value.

Raises

ValueError :

If the iterable contains no items or more than one item.

Examples

Some basic examples:

>>> from iteration_utilities import one
>>> one([0])
0
>>> one('b')
'b'

Warning

one() will access the first two values of the iterable so it should only be used if the iterable must only contain one item!