*h+SrSSKJr SSKrSSKrSSKrSSKJrJr SSK J r \"S5r Sr Sr S rS r"S S 5rSS jrS\ S\ 4SjrSrSS.Sjrg)zUseful utility decorators. )TypeVarN)wrapsupdate_wrappersympy_deprecation_warningTcd^^^^^SSKJm SSKJm SSKJm [ T5UUUUU4Sj5nU$)z'A factory for ``threaded`` decorators. r)sympify) MatrixBase)iterablec Z>^^[UT5(aURUUU4Sj5$T"U5(a-URUVs/sHnT"U/TQ70TD6PM sn5$T"U5nT(aEUR(a4UR"UR Vs/sHnT"U/TQ70TD6PM sn6$UR (a:URT"UR/TQ70TD6T"UR/TQ70TD65$T"U/TQ70TD6$s snf![a Us$f=fs snf)Nc>T"U/TQ70TD6$N)fargsfunckwargss V/home/mande/repo/quber/.venv/lib/python3.13/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 `` 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 DD D(D D%$D%) sympy.corer sympy.matricesr sympy.utilities.iterablesr r)rr"r#r r r s`` @@@rthreaded_factoryr(s/")2 4[333& rc[US5$)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[US5$)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% ((rc8^^SSKmUU4Sjn[UT5nU$)zsAfter the function finishes, resets the value of ``mpmath.mp.dps`` to the value it had before the function was run.rNc>TRRnT"U0UD6UTRl$!UTRlf=fr)mpdps)rrr2rmpmaths r func_wrapper)conserve_mpmath_dps..func_wrapperZs9iimm ((FIIMCFIIMs 2A)r3r)rr4r3s` @rconserve_mpmath_dpsr6Us! ",5L rc(\rSrSrSrSrSSjrSrg)no_attrs_in_subclasseaDon'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 cXlX lgrclsr)selfr<rs r__init__no_attrs_in_subclass.__init__xs rNcX R:XaB[URS5(aURRX5$UR$[e)N__get__)r<hasattrrrAAttributeError)r=instanceowners rrAno_attrs_in_subclass.__get__|s? HH tvvy))vv~~h6666Mrr;r)__name__ __module__ __qualname____firstlineno____doc__r>rA__static_attributes__rrrr8r8es$rr8cx^^0mUbUTS'UbUTS'UbUTS'UbUTS'UbUTS'U4SjmUU4SjnU$)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_typescx>SSKJnJnJn U"5nU"US5nUR"S0TD6 g!Ua gf=f)Nr)DependencyError SymPyDocTestsPyTestReporterFTr)sympy.testing.runtestsrTrUrV_check_dependencies)rTrUrVrt dependenciess r skiptests%doctest_depends_on..skiptestssLYY   !T "  ! ! 1L 1  s 099c>TUlTUl[R"U5(a4[ XR5Ul[ XR5UlU$r)_doctest_depends_on__doctest_skip__inspectisclassr8_doctest_depdends_on)fnr[r\s rdepends_on_deco+doctest_depends_on..depends_on_decosS!-' ??2  &:**',B #"6''#)B  rr)exerOrPrQrRrer[r\s @@rdoctest_depends_onrhsmL &) ]#") Y"*9 &'!)7 %&'3 ^$   robjreturnc[U[R5(aURnURnOf[U[ [ 5[ 45(a4[ RURRnURnO[SU-5eSU;aU/US'U$USRU5 U$)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__rGtypesysrOrH__dict__rappend)rinsnames rpublicrvs@#u))** __|| C$t*d+ , , [[ ( 1 1||@3FGG9  J 9 T" Jrc|^^^STR-m[5m[T5UUU4Sj5n[U5$)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._cV>[UTT5nUTLaT"U5n[UTU5 U$r)getattrsetattr)r=valattrnamepropfuncsentinels raccessor"memoize_property..accessors2dHh/ (?4.C D(C ( r)rGobjectrproperty)r~rr}rs` @@rmemoize_propertyrs?X&&&HxH 8_ H r) stacklevelc&^^^UUS.mUUU4SjnU$)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>^[TS5(a$"UUUU4SjST5nTRUlU$[T5UUUU4Sj5nTUlU$)N__mro__c>^\rSrSrYRrYRrYrSYR ;aUUUU4SjrSr U=r $UUUU4SjrSr U=r $)9deprecated..deprecated_decorator..wrapperi?__new__cL>[T40TDST0D6 [TU]"U/UQ70UD6$Nr)rsuperr)r<rrrdecorator_kwargsmessagers rrAdeprecated..deprecated_decorator..wrapper.__new__Ds01'e=MeZde$wsDTDVDDrcF>[T40TDST0D6 [TU]"U0UD6 gr)rrr>)r=rrrrrrs rr>Bdeprecated..deprecated_decorator..wrapper.__init__Hs)1'e=MeZde($9&9rr) rGrHrIrJrK_sympy_deprecated_funcrrrr>rL __classcell__)rrrrwrappeds@rwrapperr?sA!//$// )0& 0 00EE::rrc4>[T40TDST0D6 T"U0UD6$rr)rrrrrrs rrrMs')']5E]R\]///r)rBrGrr)rrrrrs` rdeprecated_decorator(deprecated..deprecated_decorator=s_ 7I & & : :' : '//G  7^ 0 0.5G *rr)rrrrrrs` ` @r deprecatedrs#@5M-GI, r)NNNNN)rKtypingrrqrmra functoolsrrsympy.utilities.exceptionsrrr(r,r.r6r8rhrvrrrrrrsz! +@ CL:(()(  >@D9=1h..a.b&78X r