ó {G_Tc@sdZddlZddlmZddlmZddlmZddlm Z dZ d„Z d ej fd „ƒYZ d e fd „ƒYZd e fd„ƒYZde fd„ƒYZde fd„ƒYZde fd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd „ƒYZd!e fd"„ƒYZd#e fd$„ƒYZd%efd&„ƒYZd'efd(„ƒYZd)efd*„ƒYZd+ej fd,„ƒYZd-„Z e!d.kre ƒndS(/sž Test Iterator Length Transparency Some functions or methods which accept general iterable arguments have optional, more efficient code paths if they know how many items to expect. For instance, map(func, iterable), will pre-allocate the exact amount of space required whenever the iterable can report its length. The desired invariant is: len(it)==len(list(it)). A complication is that an iterable and iterator can be the same object. To maintain the invariant, an iterator needs to dynamically update its length. For instance, an iterable such as xrange(10) always reports its length as ten, but it=iter(xrange(10)) starts at ten, and then goes to nine after it.next(). Having this capability means that map() can ignore the distinction between map(func, iterable) and map(func, iter(iterable)). When the iterable is immutable, the implementation can straight-forwardly report the original length minus the cumulative number of calls to next(). This is the case for tuples, xrange objects, and itertools.repeat(). Some containers become temporarily immutable during iteration. This includes dicts, sets, and collections.deque. Their implementation is equally simple though they need to permanently set their length to zero whenever there is an attempt to iterate after a length mutation. The situation slightly more involved whenever an object allows length mutation during iteration. Lists and sequence iterators are dynamically updatable. So, if a list is extended during iteration, the iterator will continue through the new items. If it shrinks to a point before the most recent iteration, then no further items are available and the length is reported at zero. Reversed objects can also be wrapped around mutable objects; however, any appends after the current position are ignored. Any other approach leads to confusion and possibly returning the same item more than once. The iterators not listed above, such as enumerate and the other itertools, are not length transparent because they have no way to distinguish between iterables that report static length and iterators whose length changes with each call (i.e. the difference between enumerate('abc') and enumerate(iter('abc')). iÿÿÿÿN(t test_support(trepeat(tdeque(tleni cCsNyt|ƒSWn9tk rIy|jƒSWqJtk rEt‚qJXnXdS(N(t_lent TypeErrort__length_hint__tAttributeError(tobj((s-/usr/local/lib/python2.7/test/test_iterlen.pyR4s  tTestInvariantWithoutMutationscBseZd„ZRS(cCs|j}xAttdtdƒƒD]&}|jt|ƒ|ƒ|jƒq#W|jt|ƒdƒ|jt|jƒ|jt|ƒdƒdS(Nii( tittreversedtxrangetnt assertEqualRtnextt assertRaisest StopIteration(tselfR ti((s-/usr/local/lib/python2.7/test/test_iterlen.pyttest_invariantAs  (t__name__t __module__R(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR ?stTestTemporarilyImmutablecBseZd„ZRS(cCsz|j}|jt|ƒtƒ|jƒ|jt|ƒtdƒ|jƒ|jt|jƒ|jt|ƒdƒdS(Nii(R RRR RtmutateRt RuntimeError(RR ((s-/usr/local/lib/python2.7/test/test_iterlen.pyttest_immutable_during_iterationLs   (RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyRJst TestRepeatcBseZd„Zd„ZRS(cCstdtƒ|_dS(N(RtNoneR R (R((s-/usr/local/lib/python2.7/test/test_iterlen.pytsetUp\scCs|jtttdƒƒdS(N(RRRRR(R((s-/usr/local/lib/python2.7/test/test_iterlen.pyttest_no_len_for_infinite_repeat_s(RRRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyRZs t TestXrangecBseZd„ZRS(cCstttƒƒ|_dS(N(titerR R R (R((s-/usr/local/lib/python2.7/test/test_iterlen.pyRes(RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyRcstTestXrangeCustomReversedcBseZd„ZRS(cCstttƒƒ|_dS(N(R R R R (R((s-/usr/local/lib/python2.7/test/test_iterlen.pyRjs(RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR!hst TestTuplecBseZd„ZRS(cCsttttƒƒƒ|_dS(N(R ttupleR R R (R((s-/usr/local/lib/python2.7/test/test_iterlen.pyRos(RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR"mst TestDequecBseZd„ZRS(cCs1tttƒƒ}t|ƒ|_|j|_dS(N(RR R R R tpopR(Rtd((s-/usr/local/lib/python2.7/test/test_iterlen.pyRvs(RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR$tstTestDequeReversedcBseZd„ZRS(cCs1tttƒƒ}t|ƒ|_|j|_dS(N(RR R R R R%R(RR&((s-/usr/local/lib/python2.7/test/test_iterlen.pyR}s(RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR'{st TestDictKeyscBseZd„ZRS(cCs4tjttƒƒ}t|ƒ|_|j|_dS(N(tdicttfromkeysR R R R tpopitemR(RR&((s-/usr/local/lib/python2.7/test/test_iterlen.pyR„s(RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR(‚st TestDictItemscBseZd„ZRS(cCs4tjttƒƒ}|jƒ|_|j|_dS(N(R)R*R R t iteritemsR R+R(RR&((s-/usr/local/lib/python2.7/test/test_iterlen.pyR‹s(RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR,‰stTestDictValuescBseZd„ZRS(cCs4tjttƒƒ}|jƒ|_|j|_dS(N(R)R*R R t itervaluesR R+R(RR&((s-/usr/local/lib/python2.7/test/test_iterlen.pyR’s(RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR.stTestSetcBseZd„ZRS(cCs1tttƒƒ}t|ƒ|_|j|_dS(N(tsetR R R R R%R(RR&((s-/usr/local/lib/python2.7/test/test_iterlen.pyR™s(RRR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR0—stTestListcBseZd„Zd„ZRS(cCstttƒƒ|_dS(N(R trangeR R (R((s-/usr/local/lib/python2.7/test/test_iterlen.pyR¢scCsÐttƒ}t|ƒ}|jƒ|jƒ|jt|ƒtdƒ|jtƒ|jt|ƒtdƒg|d)|jt|ƒdƒ|jt|ƒgƒ|jt dƒƒ|jt|ƒdƒdS(Niiii( R3R R RRRtappendtlisttextendR (RR&R ((s-/usr/local/lib/python2.7/test/test_iterlen.pyt test_mutation¥s      (RRRR7(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR2 s tTestListReversedcBseZd„Zd„ZRS(cCstttƒƒ|_dS(N(R R3R R (R((s-/usr/local/lib/python2.7/test/test_iterlen.pyRµscCsÐttƒ}t|ƒ}|jƒ|jƒ|jt|ƒtdƒ|jtƒ|jt|ƒtdƒg|d)|jt|ƒdƒ|jt|ƒgƒ|jt dƒƒ|jt|ƒdƒdS(Niiii( R3R R RRRR4R5R6R (RR&R ((s-/usr/local/lib/python2.7/test/test_iterlen.pyR7¸s      (RRRR7(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR8³s tBadLencBseZd„Zd„ZRS(cCsttdƒƒS(Ni (R R3(R((s-/usr/local/lib/python2.7/test/test_iterlen.pyt__iter__ÊscCstdƒ‚dS(Nthello(R(R((s-/usr/local/lib/python2.7/test/test_iterlen.pyt__len__Ës(RRR:R<(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR9És t BadLengthHintcBseZd„Zd„ZRS(cCsttdƒƒS(Ni (R R3(R((s-/usr/local/lib/python2.7/test/test_iterlen.pyR:ÏscCstdƒ‚dS(NR;(R(R((s-/usr/local/lib/python2.7/test/test_iterlen.pyRÐs(RRR:R(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR=Îs tNoneLengthHintcBseZd„Zd„ZRS(cCsttdƒƒS(Ni (R R3(R((s-/usr/local/lib/python2.7/test/test_iterlen.pyR:ÔscCsdS(N(R(R((s-/usr/local/lib/python2.7/test/test_iterlen.pyRÕs(RRR:R(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR>Ós tTestLengthHintExceptionscBseZd„Zd„ZRS(cCs6|jtttƒƒ|jtttƒƒ|jtgjtƒƒ|jtgjtƒƒ|jtttƒƒ|jtttƒƒ|jttdtƒƒ|jttdtƒƒ|jtt t tƒƒ|jtt t tƒƒt t dƒƒ}|jt|jtƒƒ|jt|jtƒƒdS(Ni ( RRR5R9R=R6tziptfilterRtmaptchrt bytearrayR3(Rtb((s-/usr/local/lib/python2.7/test/test_iterlen.pyttest_issue1242657ÚscCs)|jttƒƒttdƒƒƒdS(Ni (RR5R>R3(R((s-/usr/local/lib/python2.7/test/test_iterlen.pyttest_invalid_hintés(RRRFRG(((s-/usr/local/lib/python2.7/test/test_iterlen.pyR?Øs c Cs>tttttttttt t t t g }t j|ŒdS(N(RRR!R"R$R'R(R,R.R0R2R8R?Rt run_unittest(t unittests((s-/usr/local/lib/python2.7/test/test_iterlen.pyt test_mainîs t__main__("t__doc__tunittestttestRt itertoolsRt collectionsRt __builtin__RRR tTestCaseR RRRR!R"R$R'R(R,R.R0R2R8tobjectR9R=R>R?RJR(((s-/usr/local/lib/python2.7/test/test_iterlen.pyt*s8