3dUdZddlZddlZddlmZmZddlmZddZdeddddd fd Z dd Z gZ eee e fe d <d ZdZdS)z%Some helpers for deprecation messagesN)ListTuple)ScrapyDeprecationWarning0.12c t|jj}tj|d|d|d|d|d tddS)N.zC attribute is deprecated and will be no longer supported in Scrapy z, use z attribute instead stacklevel) __class____name__warningswarnr)objoldattrnewattrversioncnames 6lib/python3.11/site-packages/scrapy/utils/deprecate.py attributer s M "E M  H H7 H H H H$) H H,3 H H H  TzF{cls} inherits from deprecated class {old}, please inherit from {new}.z/{cls} is deprecated, instantiate {new} instead.c P G fddj  |f|pi} tjd} tj| d} | | j| _n.#t $r!} tjd| Yd} ~ nd} ~ wwxYw| S)aL Return a "deprecated" class that causes its subclasses to issue a warning. Subclasses of ``new_class`` are considered subclasses of this class. It also warns when the deprecated class is instantiated, but do not when its subclasses are instantiated. It can be used to rename a base class in a library. For example, if we have class OldName(SomeClass): # ... and we want to rename it to NewName, we can do the following:: class NewName(SomeClass): # ... OldName = create_deprecated_class('OldName', NewName) Then, if user class inherits from OldName, warning is issued. Also, if some code uses ``issubclass(sub, OldName)`` or ``isinstance(sub(), OldName)`` checks they'll still return True if sub is a subclass of NewName instead of OldName. cheZdZdZdZfdZfdZdZfdZfdZ xZ S)0create_deprecated_class..DeprecatedClassNFclt||||}|j||_|SN)super__new__deprecated_class)metaclsnamebasesclsdict_clsr s rrz8create_deprecated_class..DeprecatedClass.__new__=s6''//'4AAC' /+.(JrcP|j}|j}||vro r|jsfd|_ t |t | t  } r|dz }t j| dt|||dS)NT)r$oldnewz6 (warning only on first subclass, there may be others)r ) r rwarned_on_subclassformat_clspathrrr__init__)r$r!r"r#metar&msgr new_classnew_class_pathold_class_pathsubclass_warn_message warn_category warn_onces rr,z9create_deprecated_class..DeprecatedClass.__init__Cs=D'Ce| @Y @43J @*.'+22   n55 N;;3 TSSC c=Q???? GG  T5( 3 3 3 3 3rcbtfdt||jfDS)Nc3BK|]}|VdSr)__subclasscheck__).0cr$s r zUcreate_deprecated_class..DeprecatedClass.__instancecheck__..Vs1VVAs,,Q//VVVVVVr)anytyper )r$insts` r__instancecheck__zBcreate_deprecated_class..DeprecatedClass.__instancecheck__Us3VVVV$t**dn9UVVVVV Vrcjur!t|Stj|st dt |dd}tfd|DS)Nz"issubclass() arg 1 must be a class__mro__c3$K|] }|hvV dSrrA)r8r9r$r/s rr:zUcreate_deprecated_class..DeprecatedClass.__subclasscheck__..ds-::qS),,::::::r)rrr7inspectisclass TypeErrorgetattrr;)r$submroDeprecatedClassr r/s` rr7zBcreate_deprecated_class..DeprecatedClass.__subclasscheck__Xs/:: 6 ww00555?3'' F DEEE#y"--C:::::c::::: :rcj}||urJt| t }tj| dt j|i|S)N)r$r'r(r )rr*r+rrr__call__) r$argskwargsr&r.rIr instance_warn_messager/r0r1r3s rrKz9create_deprecated_class..DeprecatedClass.__call__fs!2Ccz @+22 n55 N;;3 c=Q????#577#T4V44 4r) r __module__ __qualname__rr)rr,r>r7rK __classcell__) r rIrNr/r0r1r2r3r4s @rrIr8s"      4 4 4 4 4 4 4 4 4 4 4$ W W W ; ; ; ; ; ; ; 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5rrIrNzError detecting parent module: ) r rCstack getmoduler rO Exceptionrr)r!r/clsdictr3r4r1r0r2rNdeprecated_clsfrm parent_moduleerIs ` `````` @rcreate_deprecated_classr[sH6565656565656565656565656565)-656565p%_TI<BGGN ?mooa )#a&11  ?(5(>N % ???  ===>>>>>>>> ? sAA88 B#BB#c,||S|jd|jS)Nr)rOr )r$forceds rr+r+s'  n - -s| - --rDEPRECATION_RULESctD]k\}}t|trQ||r<|||d}t jd|d|dt|cSl|S)z=Update a deprecated path from an object with its new locationrR`z` class is deprecated, use `z ` instead)r^ isinstancestr startswithreplacerrr)pathprefix replacementnew_paths rupdate_classpathris0 dC  T__V%<%< ||FK;;H MIDIIhIII(   OOO Krc^t||}t||}|j|juS)a Return True if a method named ``method_name`` of a ``base_class`` is overridden in a ``subclass``. >>> class Base: ... def foo(self): ... pass >>> class Sub1(Base): ... pass >>> class Sub2(Base): ... def foo(self): ... pass >>> class Sub3(Sub1): ... def foo(self): ... pass >>> class Sub4(Sub2): ... pass >>> method_is_overridden(Sub1, Base, 'foo') False >>> method_is_overridden(Sub2, Base, 'foo') True >>> method_is_overridden(Sub3, Base, 'foo') True >>> method_is_overridden(Sub4, Base, 'foo') True )rF__code__)subclass base_class method_name base_method sub_methods rmethod_is_overriddenrqs36*k22K;//J  z': ::r)rr)__doc__rCrtypingrrscrapy.exceptionsrrr[r+r^rb__annotations__rirqrArrrvs+++666666 *bKjjjjZ.... ,.4c3h(---   ;;;;;r