+ j+Rt^RIHt^RIt^RIt^RIt^RIHtHt^RI H t ]!R4t Rt Rt RtR t!R R 4tRR ltR RltRtR^/RltR#)zUseful utility decorators. )TypeVarN)wrapsupdate_wrappersympy_deprecation_warningTcdaaaaa^RIHo^RIHo^RIHo\ S4VVVVV3Rl4pV#)z'A factory for ``threaded`` decorators. )sympify) MatrixBase)iterablec d<aa\VS4'dVPVVV3Rl4#S!V4'd-TPVUu.uFpS!V.SO5/SBNK up4#S!V4pS'dGVP'd5VP!VP Uu.uFpS!V.SO5/SBNK up!#VP 'd;VPS!VP.SO5/SBS!VP.SO5/SB4#S!V.SO5/SB#uupi \dTu#i;iuupi)c<S!V.SO5/SB#N)fargsfunckwargss&Z/home/luca/screen-checking/.venv/lib/python3.14/site-packages/sympy/utilities/decorator.py9threaded_factory..threaded_func..sD,DT,DV,D) isinstance applyfunc __class__ TypeErroris_Addr is_Relationallhsrhs) exprrrrr rr r use_adds &jl r threaded_func'threaded_factory..threaded_funcs" dJ ' '>>"DE E d^^ ~~&NAtA'?'?'?&NOO4=D4;;;~~499'V9aa)A$)A&)A9'VWW###~~d488&Ed&Ef&E&*488&Ed&Ef&EGGD242622'O    (Ws)D D D#D-D D*)D*) sympy.corer sympy.matricesr sympy.utilities.iterablesr r)rr!r"r r r sff @@@rthreaded_factoryr's/")2 4[333& rc\VR4#)a-Apply ``func`` to sub--elements of an object, including :class:`~.Add`. This decorator is intended to make it uniformly possible to apply a function to all elements of composite objects, e.g. matrices, lists, tuples and other iterable containers, or just expressions. This version of :func:`threaded` decorator allows threading over elements of :class:`~.Add` class. If this behavior is not desirable use :func:`xthreaded` decorator. Functions using this decorator must have the following signature:: @threaded def function(expr, *args, **kwargs): Tr'rs&rthreadedr+-s" D$ ''rc\VR4#)a0Apply ``func`` to sub--elements of an object, excluding :class:`~.Add`. This decorator is intended to make it uniformly possible to apply a function to all elements of composite objects, e.g. matrices, lists, tuples and other iterable containers, or just expressions. This version of :func:`threaded` decorator disallows threading over elements of :class:`~.Add` class. If this behavior is not desirable use :func:`threaded` decorator. Functions using this decorator must have the following signature:: @xthreaded def function(expr, *args, **kwargs): Fr)r*s&r xthreadedr-As" D% ((rc8aa^RIoVV3Rlp\VS4pV#)zsAfter the function finishes, resets the value of ``mpmath.mp.dps`` to the value it had before the function was run.Nc<SPPpS!V/VBVSPn# TSPni;ir)mpdps)rrr1rmpmaths*, r func_wrapper)conserve_mpmath_dps..func_wrapperZs9iimm ((FIIMCFIIMs 2A)r2r)rr3r2sf @rconserve_mpmath_dpsr5Us! ",5L rc4a]tRt^etoRtRtRRltRtVtR#)no_attrs_in_subclassaDon't 'inherit' certain attributes from a base class >>> from sympy.utilities.decorator import no_attrs_in_subclass >>> class A(object): ... x = 'test' >>> A.x = no_attrs_in_subclass(A, A.x) >>> class B(A): ... pass >>> hasattr(A, 'x') True >>> hasattr(B, 'x') False cWnW nR#rclsr)selfr:rs&&&r__init__no_attrs_in_subclass.__init__xs rNcW P8XdD\VPR4'dVPPW4#VP#\h)__get__)r:hasattrrr?AttributeError)r;instanceowners&&&rr?no_attrs_in_subclass.__get__|s? HH tvvy))vv~~h6666Mrr9r) __name__ __module__ __qualname____firstlineno____doc__r<r?__static_attributes____classdictcell__) __classdict__s@rr7r7es$rr7caa/oVeVSR&VeVSR&VeVSR&VeVSR&VeVSR&V3RloVV3RlpV#)a Adds metadata about the dependencies which need to be met for doctesting the docstrings of the decorated objects. ``exe`` should be a list of executables ``modules`` should be a list of modules ``disable_viewers`` should be a list of viewers for :func:`~sympy.printing.preview.preview` to disable ``python_version`` should be the minimum Python version required, as a tuple (like ``(3, 0)``) executablesmodulesdisable_viewerspython_version ground_typesc~<^RIHpHpHpV!4pV!VR4pVP!R/SBR# TdR#i;i))DependencyError SymPyDocTestsPyTestReporterNFTr)sympy.testing.runtestsrUrVrW_check_dependencies)rUrVrWrt dependenciess r skiptests%doctest_depends_on..skiptestssLYY   !T "  ! ! 1L 1  s 1<<c<SVnSVn\P!V4'd5\ WP4Vn\ WP4VnV#r)_doctest_depends_on__doctest_skip__inspectisclassr7_doctest_depdends_on)fnr\r]s&rdepends_on_deco+doctest_depends_on..depends_on_decosS!-' ??2  &:**',B #"6''#)B  rr)exerOrPrQrRrfr\r]s&&&&& @@rdoctest_depends_onrismL &) ]#") Y"*9 &'!)7 %&'3 ^$   rc0V^8dQhR\R\/#)objreturn)r)formats"r __annotate__ros...a.rc\V\P4'dVPpVPpMo\V\ \ 4\ 34'd9\ PVP,PpVPpM\RV,4hRV9d V.VR&V#VR,PV4V#)a Append ``obj``'s name to global ``__all__`` variable (call site). By using this decorator on functions or classes you achieve the same goal as by filling ``__all__`` variables manually, you just do not have to repeat yourself (object's name). You also know if object is public at definition site, not at some random location (where ``__all__`` was set). Note that in multiple decorator setup (in almost all cases) ``@public`` decorator must be applied before any other decorators, because it relies on the pointer to object's global namespace. If you apply other decorators first, ``@public`` may end up modifying the wrong namespace. Examples ======== >>> from sympy.utilities.decorator import public >>> __all__ # noqa: F821 Traceback (most recent call last): ... NameError: name '__all__' is not defined >>> @public ... def some_function(): ... pass >>> __all__ # noqa: F821 ['some_function'] z&expected a function or a class, got %s__all__) rtypes FunctionType __globals__rEtypesysrOrF__dict__rappend)rlnsnames& rpublicr{s@#u))** __|| C$t*d+ , , [[ ( 1 1||@3FGG9  J 9 T" JrcaaaRSP,o\4o\S4VVV3Rl4p\V4#)zProperty decorator that caches the value of potentially expensive ``propfunc`` after the first evaluation. The cached value is stored in the corresponding property name with an attached underscore._cX<\VSS4pVSJdS!V4p\VSV4V#r)getattrsetattr)r;valattrnamepropfuncsentinels& raccessor"memoize_property..accessors2dHh/ (?4.C D(C ( r)rEobjectrproperty)rrrrsf @@rmemoize_propertyrs?X&&&HxH 8_ H r stacklevelc(aaaRVRV/oVVV3RlpV#)a Mark a function as deprecated. This decorator should be used if an entire function or class is deprecated. If only a certain functionality is deprecated, you should use :func:`~.warns_deprecated_sympy` directly. This decorator is just a convenience. There is no functional difference between using this decorator and calling ``warns_deprecated_sympy()`` at the top of the function. The decorator takes the same arguments as :func:`~.warns_deprecated_sympy`. See its documentation for details on what the keywords to this decorator do. See the :ref:`deprecation-policy` document for details on when and how things should be deprecated in SymPy. Examples ======== >>> from sympy.utilities.decorator import deprecated >>> from sympy import simplify >>> @deprecated(""" ... The simplify_this(expr) function is deprecated. Use simplify(expr) ... instead.""", deprecated_since_version="1.1", ... active_deprecations_target='simplify-this-deprecation') ... def simplify_this(expr): ... """ ... Simplify ``expr``. ... ... .. deprecated:: 1.1 ... ... The ``simplify_this`` function is deprecated. Use :func:`simplify` ... instead. See its documentation for more information. See ... :ref:`simplify-this-deprecation` for details. ... ... """ ... return simplify(expr) >>> from sympy.abc import x >>> simplify_this(x*(x + 1) - x**2) # doctest: +SKIP :1: SymPyDeprecationWarning: The simplify_this(expr) function is deprecated. Use simplify(expr) instead. See https://docs.sympy.org/latest/explanation/active-deprecations.html#simplify-this-deprecation for details. This has been deprecated since SymPy version 1.1. It will be removed in a future version of SymPy. simplify_this(x) x See Also ======== sympy.utilities.exceptions.SymPyDeprecationWarning sympy.utilities.exceptions.sympy_deprecation_warning sympy.utilities.exceptions.ignore_warnings sympy.testing.pytest.warns_deprecated_sympy deprecated_since_versionactive_deprecations_targetc<a\SR4'd%!VVVV3RlRS4pSPVnV#\S4VVVV3Rl4pSVnV#)__mro__c<aa]tRtRtoZPtZPtZtRZP 9dVVVV3RltRt Vt V;t #VVVV3RltRt Vt V;t #)9deprecated..deprecated_decorator..wrapperi?__new__cL<\S3/SBRS/B\SV`!V.VO5/VB#r)rsuperr)r:rrrdecorator_kwargsmessagers&*,rrAdeprecated..deprecated_decorator..wrapper.__new__Ds01'e=MeZde$wsDTDVDDrcH<\S3/SBRS/B\SV`!V/VBR#)rN)rrr<)r;rrrrrrs&*,rr<Bdeprecated..deprecated_decorator..wrapper.__init__Hs)1'e=MeZde($9&9rr) rErFrGrHrI_sympy_deprecated_funcrwrr<rJrK __classcell__)rrLrrrwrappeds@@rwrapperr?sN!//$// )0& 0 00EEE:::rrc4<\S3/SBRS/BS!V/VB#rr)rrrrrrs*,rrrMs')']5E]R\]///r)r@rErr)rrrrrsf rdeprecated_decorator(deprecated..deprecated_decorator=s_ 7I & & : :' : '//G  7^ 0 0.5G *rr)rrrrrrsf$$d @r deprecatedrs(@34L+-GI, r)NNNNN)rItypingrrvrrrb functoolsrrsympy.utilities.exceptionsrrr'r+r-r5r7rir{rrrrrrsf! +@ CL:(()(  >1h.b$X 67X r