?j-dZddlmZddlZddlZddlZddlmZmZddl m Z edZ dZ dZ d Zd ZGd d Z dd Zde de fdZdZdddZdS)zUseful utility decorators. )TypeVarN)wrapsupdate_wrappersympy_deprecation_warningTcpddlmddlmddlmt fd}|S)z'A factory for ``threaded`` decorators. r)sympify) MatrixBase)iterablect|r|fdS|r6 |fd|DS#t$r|cYSwxYw|}r$|jr|jfd|jDS|jr4||jgRi|jgRiS|gRiS)Nc|gRiSN)fargsfunckwargss GC:\Projects\DSCons\.venv\Lib\site-packages\sympy\utilities\decorator.pyz9threaded_factory..threaded_func..s!DD,DT,D,D,DV,D,Dc(g|]}|gRiSrr.0rrrrs r z;threaded_factory..threaded_func..s3&N&N&NAttA'?'?'?'?'?'?&N&N&Nrc(g|]}|gRiSrrrs rrz;threaded_factory..threaded_func..#s3'V'V'Vaa)A$)A)A)A&)A)A'V'V'Vr) isinstance applyfunc __class__ TypeErroris_Addr is_Relationallhsrhs)exprrrr rr r use_adds ``r threaded_funcz'threaded_factory..threaded_funcsn dJ ' ' 3>>"D"D"D"D"D"DEE E Xd^^ 3 ~~&N&N&N&N&N&N&N&N&NOOO     74==D 34; 3%t~'V'V'V'V'V'V49'V'V'VWW# 3~~dd48&Ed&E&E&Ef&E&E&*d48&Ed&E&E&Ef&E&EGGGtD242226222s"A A,+A,) sympy.corer sympy.matricesr sympy.utilities.iterablesr r)rr&r'r r r s`` @@@rthreaded_factoryr+s""""""))))))222222 4[[33333333[3& rc"t|dS)aUApply ``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"t|dS)aXApply ``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 xthreadedr1As" D% ( ((rc>ddlfd}t|}|S)zwAfter the function finishes, resets the value of ``mpmath.mp.dps`` to the value it had before the function was run.rNchjj} |i||j_S#|j_wxYwr)mpdps)rrr5rmpmaths r func_wrapperz)conserve_mpmath_dps..func_wrapperZsCim 4(((FIMMCFIM    s#1)r6r)rr7r6s` @rconserve_mpmath_dpsr8UsDMMM      ",55L rc eZdZdZdZddZdS)no_attrs_in_subclassaEDon'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 c"||_||_dSr)clsr)selfr<rs r__init__zno_attrs_in_subclass.__init__xsrNc||jkr7t|jdr|j||S|jSt)N__get__)r<hasattrrr@AttributeError)r=instanceowners rr@zno_attrs_in_subclass.__get__|sF DH  tvy)) 7v~~h6666Mrr)__name__ __module__ __qualname____doc__r>r@rrrr:r:esA$rr:cji||d<||d<||d<||d<||d<fdfd}|S) 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)``) N executablesmodulesdisable_viewerspython_version ground_typesc|ddlm}m}m}|}||d} |jdidS#|$rYdSwxYw)Nr)DependencyError SymPyDocTestsPyTestReporterFTr)sympy.testing.runtestsrPrQrR_check_dependencies)rPrQrRrt dependenciess r skiptestsz%doctest_depends_on..skiptestssYYYYYYYYYY N   M!T " "  !A ! 1 1L 1 1 15   44 s 2;;c|_|_tj|r4t ||j|_t ||j|_|Sr)_doctest_depends_on__doctest_skip__inspectisclassr:_doctest_depdends_on)fnrWrXs rdepends_on_decoz+doctest_depends_on..depends_on_decos^!-' ?2   )&:B*',',B #"6B'#)#)B  rr)exerKrLrMrNr`rWrXs @@rdoctest_depends_onrbsL &) ]#") Y"*9 &'!)7 %&'3 ^$            robjreturncbt|tjr|j}|j}n_t|t t t fr$t j|jj }|j}ntd|zd|vr|g|d<n|d ||S)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__rEtypesysrKrF__dict__r append)rcnsnames rpublicrps@#u)**H _| C$t**d+ , ,H [ ( 1|@3FGGG9  9 T""" Jrcdjzttfd}t|S)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._cjt|}|ur|}t|||Sr)getattrsetattr)r=valattrnamepropfuncsentinels raccessorz"memoize_property..accessorsAdHh// (??(4..C D(C ( ( ( r)rEobjectrproperty)rxrzrwrys` @@rmemoize_propertyr}s`X&&HxxH 8___ H  r) stacklevelc$||dfd}|S)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_targetctdr Gfdd}j|_n$tfd}|_|S)N__mro__cpeZdZjZjZZdjvr fdZxZSfdZxZS)9deprecated..deprecated_decorator..wrapper__new__c`tfiditj|g|Ri|SNr)rsuperr)r<rrrdecorator_kwargsmessagers rrzAdeprecated..deprecated_decorator..wrapper.__new__DsL1'ee=MeeZdeeee.uwwsDTDDDVDDDrc\tfiditj|i|dSr)rrr>)r=rrrrrrs rr>zBdeprecated..deprecated_decorator..wrapper.__init__HsH1'ee=MeeZdeeee(($9&99999r) rErFrGrH_sympy_deprecated_funcrlrr> __classcell__)rrrrwrappeds@rwrapperr?s!/$/ )0& 000EEEEEEEEEEEE::::::::::::rrc6tfidi|i|Srr)rrrrrrs rrz9deprecated..deprecated_decorator..wrapperMs;)']]5E]]R\]]]]w////r)rArErr)rrrrrs` rdeprecated_decoratorz(deprecated..deprecated_decorator=s 7I & & 5 : : : : : : : : : :' : : : '/G   7^^ 0 0 0 0 0 0 0^ 0.5G *rr)rrrrrrs` ` @r deprecatedrsI@5M-GII, r)NNNNN)rHtypingrrkrgr\ functoolsrrsympy.utilities.exceptionsrrr+r/r1r8r:rbrpr}rrrrrsX!! ++++++++@@@@@@ GCLL:(((()))(    >@D9=1111h..a....b&78X X X X X X X r