iKjd9 UddlZddlZddlZddlmZddlmZmZmZddl m Z ddl m Z ddl mZmZmZmZmZmZddlmZddlmZmZdd lmZmZdd lmZdd lmZdd l m!Z!dd l"m#Z#ddl$m%Z%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,m-Z-m.Z.m/Z/de0dede0fdZ1dede0fdZ2defdZ3ededdzdefdZ4ede5dedfdZ4de5dedfdZ4e*eddZ6de7fdZ8d9d Z9e d!e0d"eded#fd$Z:Gd%dZ;d&egefddfd'Zd:d)e0d,eddfd-Z?eZ@eee0feAd.<e0fd/d0ed1eBeCd2fd3e7defd4ZDd+d5d6eEeFzd7e0deEeFzfd8ZGy);N) defaultdict)Callable GeneratorSequence)contextmanager) TracebackType)AnyLiteralNoReturnOptionalSelfoverload)WeakKeyDictionary) Verbositysettings)InvalidArgumentUnsatisfiedAssumption)ConjectureData)observability_enabled)get_pretty_function_description) check_type)reportverbose_report)note_deprecation)DynamicVariable) ArgLabelsTIDKeyPrettyPrintFunctionprettywhatframereturncl|j}|d|jjd|jdS)Nz() in z (line ))f_backf_codeco_namef_lineno)r r!wheres W/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/hypothesis/control.py_calling_function_locationr+!s4 LLEV6%,,../wu~~6Fa HHcd|j}|jjd|jS)N:)r%r& co_filenamer()r!r)s r*_calling_frame_locationr0&s, LLEll&& 'q(8 99r,c$tjtdddtj}t d|}t r3tjj|}|jdt|t|)Nz:Using `reject` outside a property-based test is deprecated 2023-09-25Fsince has_codemodreject conditionlocation) _current_build_contextvaluerinspect currentframer+currently_in_test_contextcurrent_build_contextdata_observability_predicates update_countrr0)r!r)countss r*r6r6+s~##+ H  "E &x 7E "&(--GGNe, 0G0N OOr,r8FcyNr7s r*assumerH:s:=r,TcyrFrGr7s r*rHrH<s03r,cntjtdddts|st j }t d|}trFtr` that marks the |test case| as bad, rather than failing the test. This allows you to specify properties that you *assume* will be true, and let Hypothesis try to avoid similar test cases in future. z:Using `assume` outside a property-based test is deprecatedr2Fr3rHr7zfailed to satisfy r9T)r;r<rrr=r>r+r?r@rArBrCboolrr0)r8r!r)rDs r*rHrH@s##+ H i$$&*8U; "'@'B*,11KKERF   $y/  :'$UG,07  r, BuildContextc&tjduS)adReturn ``True`` if the calling code is currently running inside an |@given| or :ref:`stateful ` test, and ``False`` otherwise. This is useful for third-party integrations and assertion helpers which may be called from either traditional or property-based tests, and can only use e.g. |assume| or |target| in the latter case. N)r;r<rGr,r*r?r?^s " ' 't 33r,c@tj}| td|S)NzNo build context registered)r;r<rcontexts r*r@r@is#$**G;<< Nr,fmtargs)NNNc'Kddlm}tj}dtj}||k7r8t ||j vr t d|j|zdddyyyw)Nr)entropyznDo not use the `random` module inside strategies; instead consider `st.randoms()`, `st.sampled_from()`, etc. z 2024-02-05F)r4r5 stacklevel)hypothesis.internalrTrandomgetstatehash_known_random_state_hashesrformat)rQrRrT state_before state_afters r*deprecate_random_in_strategyr_psx+??$L //#K( |#  W%G%G G CEOSZZQUEV W   H $sA1A3c eZdZdddedededdfdZdd d ed ed eed e e efde dzddf dZ de e e fdee e e fe ffdZddZdeedzdedzdedzddfdZy)rLF)is_finalrAra wrapped_testr"Ncd||_g|_||_||_t t |_yrF)rAtasksrarbrlistknown_object_printers)selfrArarbs r*__init__zBuildContext.__init__s3 .0   (   "r, arg_labelsobjfuncrRkwargsrjcf|jt|j||dfd y)N)_func _arg_labelscD|j||t||S)Nri)maybe_repr_known_object_as_callr)rkpcyclerorprRrms r*z*BuildContext.record_call..s1IjIj/6& JkJr,)rfrappend)rgrkrlrRrmrjs `` r* record_callzBuildContext.record_calls, ""5:.55+/Z  r,kwarg_strategiesc6i}i}|jD]g\}}|jj|5}td||5|jj |d|||<dddddd|z}i||fS#1swYxYw#1swY xYw)Nz from {}={!r}z generate:) observe_as)itemsrAtrack_arg_labelr_draw)rgrxrjrmks arg_labels r* prep_args_kwargs_from_strategiesz-BuildContext.prep_args_kwargs_from_strategiess"$ !#$**, $DAq ))!, J09,^QB J!IINN19QCNIq  J J ) #J  $z!! J J J Js#B$B(BB BB cntj||_|jj|SrF)r; with_valueassign_variable __enter__)rgs r*rzBuildContext.__enter__s,5@@F &&( r,exc_type exc_valuetbc|jj|||g}|jD] } | |r!t |dk(r|d|t d||y#t$r}|j |Yd}~Pd}~wwxYw)NrUrzCleanup failed)r__exit__rd BaseExceptionrvlenBaseExceptionGroup)rgrrrerrorstaskerrs r*rzBuildContext.__exit__s %%h 2>JJ #D # # 6{aQiY.$%5v>I M ! # c"" #sA B&A<<B)r"r )__name__ __module__ __qualname__rrKrrhobjectrdictstrrrwr tuplerrtyperrrrGr,r*rLrLs          4)-   v  S&[!  %   ("sCx." tCH~z) *"" N}%,N!4'N D N  Nr,teardowncttj}| td|jj |y)auRegister a function to be called when the current test has finished executing. Any exceptions thrown in teardown will be printed but not rethrown. Inside a test this isn't very interesting, because you can just use a finally block, but note that you can use this inside map, flatmap, etc. in order to e.g. insist that a value is closed at the end. Nz0Cannot register cleanup outside of build context)r;r<rrdrv)rrPs r*cleanuprs2%**GPQQ MM"r,ctj}| tdtjJ|j xs+tjj tjk\S)Nz#Cannot make notes outside of a test) r;r<rrdefaultra verbosityrverboserOs r* should_notersX$**GCDD    '' '    Nx//99Y=N=NNNr,r<ct}|s trct|ts t |}t j }|Jtr|jj||r t|yyy)al Record a note on this |test case|. Non-string values will be automatically converted to a string. This value is reported for the |minimal failing test case|, and on |Verbosity.verbose| or higher. Notes are also recorded in the ``metadata.notes`` key of each test case observation, if :ref:`observability ` is enabled. N) rr isinstancerrr;r<rAnoter)r< should_reportrPs r*rrsj MM-/%%5ME(..""" " LL  e $  5M 0r,payloadctj}| td|jjj }t |tttf|}t ||}||jj|<y)a]Record an event that occurred during this test. Statistics on the number of test runs with each event will be reported at the end if you run Hypothesis in statistics reporting mode. Event values should be strings or convertible to them. If an optional payload is given, it will be included in the string for :ref:`statistics`. Nz&Cannot record events outside of a test) allowed_typesavoid_realization)r) r;r<rrAproviderr_serialize_eventrintfloatevents)r<rrPrs r*eventrsr%**GFGG --??S%0DUG U6G HE!(GLLr,_events_to_strings)rrr.rct||r|S|r t|S t|S#ttf$rYnwxYwt|} |t|<|S#t$rY|SwxYwrF)rrrKeyError TypeError)rrrresults r*rr,s%' 5z !%(( i    ZF $*5! M   M s&88 A AA)label observationrc tttf|dtj|st d|dtt |dtj}| t d|jjjr|Std|d|d||jjvr/t d |d|d |jj|d|d ||jj|<|S) ajCalling this function with an ``int`` or ``float`` observation gives it feedback with which to guide our search for inputs that will cause an error, in addition to all the usual heuristics. Observations must always be finite. Hypothesis will try to maximize the observed value over several |test cases|; almost any metric will work so long as it makes sense to increase it. For example, ``-abs(error)`` is a metric that increases as ``error`` approaches zero. Example metrics: - Number of elements in a collection, or tasks in a queue - Mean or maximum runtime of a task (or both, if you use ``label``) - Compression ratio for data (perhaps per-algorithm or per-level) - Number of steps taken by a state machine The optional ``label`` argument can be used to distinguish between and therefore separately optimise distinct observations, such as the mean and standard deviation of a dataset. It is an error to call ``target()`` with any label more than once per test case. .. note:: The more test cases you run, the better this technique works. As a rule of thumb, the targeting effect is noticeable above :obj:`max_examples=1000 `, and immediately obvious by around ten thousand test cases *per label* used by your test. :ref:`statistics` include the best score seen for each label, which can help avoid `the threshold problem `__ when the minimal test case shrinks right down to the threshold of failure (:issue:`2180`). rz observation=z must be a finite float.rzvCalling target() outside of a test is invalid. Consider guarding this call with `if currently_in_test_context(): ...`z Saw target(z, label=r$zCalling target(z) would overwrite target()rrrmathisfiniterrr;r<rArrrtarget_observations)rrrPs r*targetrEs FU|[-8 == %.FGHHsE7#$**G U      0 0[y%;<  000k_Iuh7ll66u=@ 5(! M  3> ((/ r,)r"rL)r)Hr=rrX collectionsrcollections.abcrrr contextlibrtypesrtypingr r r r r rweakrefr hypothesisrrhypothesis.errorsrr#hypothesis.internal.conjecture.datar!hypothesis.internal.observabilityrhypothesis.internal.reflectionrhypothesis.internal.validationrhypothesis.reportingrrhypothesis.utils.deprecationr!hypothesis.utils.dynamicvariablesrhypothesis.vendor.prettyrrrrrr+r0r6rHrr;rKr?r@r_rLrrrrr__annotations__rrrrrrrGr,r*rs #99%CC%*D>CJ579=SSISIII :3:3: P P =gent+== = 3f33 3f6C.)AB4H444" c" #" )DT:U" " JNNNNb #hr3w' #D #OTO4.))s)D)(3D2E%c3h/E7:V "'c "2PT268=e =s=C%K=r,