a oe@sJddlZddlZddZejddZejejjdddZ d d Z dS) Ncstfdd}|S)z Wrap func so it's not called if its first param is None >>> print_text = pass_none(print) >>> print_text('text') text >>> print_text(None) cs"|dur|g|Ri|SdS)N)ZparamargskwargsfuncrAC:\Program Files\Certbot\pkgs\setuptools\_distutils\_functools.pywrapperszpass_none..wrapper) functoolswraps)rrrrr pass_nones r cCs||S)zSplat args to func.rrrrrr _splat_innersr )rcCs|fi|S)zSplat kargs to func as kwargs.rr rrr_srcCst|tjt|dS)a Wrap func to expect its parameters to be passed positionally in a tuple. Has a similar effect to that of ``itertools.starmap`` over simple ``map``. >>> import itertools, operator >>> pairs = [(-1, 1), (0, 2)] >>> _ = tuple(itertools.starmap(print, pairs)) -1 1 0 2 >>> _ = tuple(map(splat(print), pairs)) -1 1 0 2 The approach generalizes to other iterators that don't have a "star" equivalent, such as a "starfilter". >>> list(filter(splat(operator.add), pairs)) [(0, 2)] Splat also accepts a mapping argument. >>> def is_nice(msg, code): ... return "smile" in msg or code == 0 >>> msgs = [ ... dict(msg='smile!', code=20), ... dict(msg='error :(', code=1), ... dict(msg='unknown', code=0), ... ] >>> for msg in filter(splat(is_nice), msgs): ... print(msg) {'msg': 'smile!', 'code': 20} {'msg': 'unknown', 'code': 0} r)r r partialr rrrrsplat%s$r) collections.abc collectionsr r singledispatchr registerabcMappingrrrrrrs