src/pyams_utils/list.py
changeset 380 c062ab4db6cd
parent 337 d4e617c7e37a
child 408 cf2304af0fab
equal deleted inserted replaced
379:07fe5bb08599 380:c062ab4db6cd
     7 # THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
     7 # THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
     8 # WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
     8 # WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
     9 # WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
     9 # WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
    10 # FOR A PARTICULAR PURPOSE.
    10 # FOR A PARTICULAR PURPOSE.
    11 #
    11 #
       
    12 
       
    13 """PyAMS_utils list module
       
    14 
       
    15 This module is dedicated to lists and iterators management. It provides function to extract
       
    16 unique values from a list or iterator in their original order, or to iterate over an iterator in
       
    17 random order; it also provides a "boolean_iter" function (usable as TALES extension) to check if
       
    18 an iterator returns at least one value, without consuming this iterator (the function returns a
       
    19 tuple containing a boolean value to specify if iterator is empty or not, and the original
       
    20 iterator).
       
    21 """
    12 
    22 
    13 __docformat__ = 'restructuredtext'
    23 __docformat__ = 'restructuredtext'
    14 
    24 
    15 from itertools import filterfalse, tee
    25 from itertools import filterfalse, tee
    16 from random import random, shuffle
    26 from random import random, shuffle