Current File : //proc/227033/root/opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyc
�
��4]c @ s� d Z d d l Z d d l Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d
d � Z
d
d � Z d
d � Z d e d � Z d � Z d e d � Z d � Z d � Z d d � Z d d � Z d S( sS Helpers related to deprecation of functions, methods, classes, other
functionality.i����Ni ( t compat( t decorator( t inject_docstring_text( t inject_param_texti ( t exci c C s t j | t j d | �d S( Nt
stacklevel( t warningst warnR t SADeprecationWarning( t msgR ( ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt warn_deprecated s c C s t j | t j d | �d S( NR ( R R R t SAPendingDeprecationWarning( R R ( ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt warn_pending_deprecation s t __init__c s/ d | � p d f � � � � f d � } | S( Ns .. deprecated:: %s %st c s& t | � t j � t d � � � � S( Nt func( t _decorate_cls_with_warningR R t dict( t cls( t constructort headert message( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt decorate s ( ( t versionR R R ( ( R R R sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt deprecated_cls s c sP | r d | � p d f � n d � � d k r: d � n � � f d � } | S( s� Decorates a function and issues a deprecation warning on use.
:param version:
Issue version in the warning.
:param message:
If provided, issue message in the warning. A sensible default
is used if not provided.
:param add_deprecation_to_docstring:
Default True. If False, the wrapped function's __doc__ is left
as-is. If True, the 'message' is prepended to the docs if
provided, or sensible default if message is omitted.
s .. deprecated:: %s %sR s$ Call to deprecated function %(func)sc s& t | t j � t d | j � � � S( NR ( t _decorate_with_warningR R R t __name__( t fn( R R ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyR E s
N( t None( R R t add_deprecation_to_docstringR ( ( R R sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt
deprecated, s c sO i � x0 � j � D]" \ } \ } } t | � � | <q W� � f d � } | S( s" Decorates a function to warn on use of certain parameters.
e.g. ::
@deprecated_params(
weak_identity_map=(
"0.7",
"the :paramref:`.Session.weak_identity_map parameter "
"is deprecated."
)
)
c s t j | � } | j d k r� t t | j t | j � t | j � | j � � � t � � j � � � t � � j
� � � n d � t � � � t � � � � f d � � } | j d k r� | j p� d } | r� t
| d � � j � D� � } n | | � } | | _ | S( Nc s� xB � D]: } | | � | k r t j � | t j d d �q q Wx: � D]2 } | | k rL t j � | t j d d �qL qL W| | | � S( NR i ( R R R R ( R t argst kwargst m( t check_defaultst check_kwt defaultst messages( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt warneds s
R c S s5 i | ]+ \ } \ } } d | | p' d f | � q S( s .. deprecated:: %s %sR ( ( t .0t paramR R ( ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pys
<dictcomp>� s ( ( R t inspect_getfullargspecR$ R R t zipR t lent sett intersectiont
differenceR t __doc__R t items( R t specR& t doct decorated( R% t specs( R" R# R$ sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyR d s( ( R0 t _sanitize_restructured_text( R4 R( R R R ( ( R% R4 sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt deprecated_paramsP s
+c sP | r d | � p d f � n d � � d k r: d � n � � f d � } | S( sE Decorates a function and issues a pending deprecation warning on use.
:param version:
An approximate future version at which point the pending deprecation
will become deprecated. Not used in messaging.
:param message:
If provided, issue message in the warning. A sensible default
is used if not provided.
:param add_deprecation_to_docstring:
Default True. If False, the wrapped function's __doc__ is left
as-is. If True, the 'message' is prepended to the docs if
provided, or sensible default if message is omitted.
s .. deprecated:: %s (pending) %sR s$ Call to deprecated function %(func)sc s& t | t j � t d | j � � � S( NR ( R R R R R ( R ( R R ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyR � s
N( R ( R R R R ( ( R R sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt pending_deprecation� s c C s" | d k r | St | � | Sd S( N( R R
( t parameter_valuet
default_valuet warning_text( ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt deprecated_option_value� s
c C s d � } t j d | | � S( Nc S s5 | j d d � \ } } | d k r1 | d 7} n | S( Ni i R t meths ()( R R< ( t group( R! t type_t name( ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt repl� s
s \:(\w+)\:`~?\.?(.+?)`( t ret sub( t textR@ ( ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyR5 � s c C s� | j d k r | j p d } | d k r� | t d | � ;} t | | d � } t | � t k r� t | j � } | | d <t | j | j | � } | | } q� | | _ t | | � } n t | | t
| | | d � � | S( NR R i R/ ( R/ R R R t typet __dict__R t __bases__t getattrt setattrR ( R R t wtypeR t docstring_headerR2 t clsdictt constructor_fn( ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyR � s
c s� t � � � t � � f d � � } | j d k r< | j p? d } | d k ry | t d | j � ;} t | | d � } n | | � } | | _ � � f d � | _ | S( s= Wrap a function with a warnings.warn and augmented docstring.c s# t j � � d d �| | | � S( NR i ( R R ( R R R ( R RI ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyR& � s R R i c s t j � � d d �S( NR i ( R R ( ( R RI ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt <lambda>� R N( R5 R R/ R R R R t _sa_warn( R RI R RJ R& R2 R3 ( ( R RI sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyR � s ( R/ RA R R R t langhelpersR R R R R
R R R t TrueR R6 R7 R; R5 R R ( ( ( sO /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/deprecations.pyt <module> s" $ C%
Mini Shell