class_docstr: A warning for deprecated features of SymPy.
  
  See the :ref:`deprecation-policy` document for details on when and how
  things should be deprecated in SymPy.
  
  Note that simply constructing this class will not cause a warning to be
  issued. To do that, you must call the :func`sympy_deprecation_warning`
  function. For this reason, it is not recommended to ever construct this
  class directly.
  
  Explanation
  ===========
  
  The ``SymPyDeprecationWarning`` class is a subclass of
  ``DeprecationWarning`` that is used for all deprecations in SymPy. A
  special subclass is used so that we can automatically augment the warning
  message with additional metadata about the version the deprecation was
  introduced in and a link to the documentation. This also allows users to
  explicitly filter deprecation warnings from SymPy using ``warnings``
  filters (see :ref:`silencing-sympy-deprecation-warnings`).
  
  Additionally, ``SymPyDeprecationWarning`` is enabled to be shown by
  default, unlike normal ``DeprecationWarning``\s, which are only shown by
  default in interactive sessions. This ensures that deprecation warnings in
  SymPy will actually be seen by users.
  
  See the documentation of :func:`sympy_deprecation_warning` for a
  description of the parameters to this function.
  
  To mark a function as deprecated, you can use the :func:`@deprecated
  <sympy.utilities.decorator.deprecated>` decorator.
  
  See Also
  ========
  sympy.utilities.exceptions.sympy_deprecation_warning
  sympy.utilities.exceptions.ignore_warnings
  sympy.utilities.decorator.deprecated
  sympy.testing.pytest.warns_deprecated_sympy
class_docstr_tok: ["A","warning","for","deprecated","features","of","SymPy",".","See","the",":","ref",":","`","deprecation-policy","`","document","for","details","on","when","and","how","things","should","be","deprecated","in","SymPy",".","Note","that","simply","constructing","this","class","will","not","cause","a","warning","to","be","issued",".","To","do","that",",","you","must","call","the",":","func","`","sympy_deprecation_warning","`","function",".","For","this","reason",",","it","is","not","recommended","to","ever","construct","this","class","directly",".","Explanation","===========","The","``","SymPyDeprecationWarning","``","class","is","a","subclass","of","``","DeprecationWarning","``","that","is","used","for","all","deprecations","in","SymPy",".","A","special","subclass","is","used","so","that","we","can","automatically","augment","the","warning","message","with","additional","metadata","about","the","version","the","deprecation","was","introduced","in","and","a","link","to","the","documentation",".","This","also","allows","users","to","explicitly","filter","deprecation","warnings","from","SymPy","using","``","warnings","``","filters","(","see",":","ref",":","`","silencing-sympy-deprecation-warnings","`",")",".","Additionally",",","``","SymPyDeprecationWarning","``","is","enabled","to","be","shown","by","default",",","unlike","normal","``","DeprecationWarning","``","\\s",",","which","are","only","shown","by","default","in","interactive","sessions",".","This","ensures","that","deprecation","warnings","in","SymPy","will","actually","be","seen","by","users",".","See","the","documentation","of",":","func",":","`","sympy_deprecation_warning","`","for","a","description","of","the","parameters","to","this","function",".","To","mark","a","function","as","deprecated",",","you","can","use","the",":","func",":","`","@","deprecated","<","sympy.utilities.decorator.deprecated",">","`","decorator",".","See","Also","========","sympy.utilities.exceptions.sympy_deprecation_warning","sympy.utilities.exceptions.ignore_warnings","sympy.utilities.decorator.deprecated","sympy.testing.pytest.warns_deprecated_sympy"]
code: def __repr__(self):
      return f"{self.__class__.__name__}({self.message!r}, deprecated_since_version={self.deprecated_since_version!r}, active_deprecations_target={self.active_deprecations_target!r})"
  
file_path: sympy/sympy/utilities/exceptions.py
imports: import warnings
  import contextlib
  from textwrap import dedent
label_desc: Use image node_id 3 for calling the SymPyDeprecationWarning obj's underlying member method code with example usage: obj.__repr__() and returns: self, str, self, str, self, str, self, str