o Rcy@srdZddlZddlmZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZddl mZddl mZd d ZGd d d eZd dZddZddZddZddZddZddZddZddZdd Zdd!d"ZGd#d$d$eZd%d&Z dd'd(Z!d)d*Z"dd,d-Z#dd/d0Z$dd1d2Z% 3 3 3dd4d5Z&d6d7Z'd8d9Z(dd:d;Z)Gdd?Z+d@dAZ,   B ddCdDZ-dEdFZ.ddGdHZ/GdIdJdJeZ0dKdLZ1GdMdNdNeZ2GdOdPdPeZ3dQdRZ4dSdTZ5dUdVZ6ddWdXZ7dYdZZ8d[d\Z9d]d^Z:dd_d`Z;dadbZZ?GdgdhdheZ@GdidjdjeZAGdkdldleBZCdmeC_DGdndmdmeZEdaFdodpZGdqdrZHddtduZIGdvdwdwejJZKddxdyZLdzd{ZMdd|d}ZNd~dZOePdZQePdZReReQfddZSeTdZUddZVGdddeTZWddZXddZYddZZddZ[ddZ\ePdZ]ddZ^ddZ_ddZ`dS)zRoutines to help with the creation, loading and introspection of modules, classes, hierarchies, attributes, functions, and methods. Nupdate_wrapper) _collections)compat)exccCs*tjr|d}t}|||S)Nzutf-8)rpy3kencodehashlibmd5update hexdigest)xmr=D:\Flask\env\Lib\site-packages\sqlalchemy/util/langhelpers.pymd5_hexs   rc@s.eZdZdZdZd ddZddZdd Zd S) safe_reraiseaKReraise an exception after invoking some handler code. Stores the existing exception info before invoking so that it is maintained across a potential coroutine context switch. e.g.:: try: sess.commit() except: with safe_reraise(): sess.rollback() ) warn_only _exc_infoFcCs ||_dSN)r)selfrrrr__init__: zsafe_reraise.__init__cCst|_dSr)sysexc_inforrrrr __enter__=zsafe_reraise.__enter__cCs|dur|j\}}}d|_|jstj||ddSdStjs4|jr4|jdr4td|jd|jdfd|_tj||ddS)N)with_tracebackrzfAn exception has occurred during handling of a previous exception. The previous exception is: %s %s r)rrrZraise_r warn)rtype_value tracebackexc_type exc_valueexc_tbrrr__exit__@s"  zsafe_reraise.__exit__NF)__name__ __module__ __qualname____doc__ __slots__rrr(rrrrr&s   rccsNt}|g}|r%|}||vrq|||||V|s dSdSr)setpopaddextend__subclasses__)clsseenstackrrrwalk_subclassesWs  r7cCs6t|tjr|Szt|WStyd|YSw)Nzunprintable element %r) isinstancer string_typesstr Exception)elementrrrstring_or_unprintablees    r=cCsdddtd|jDS)N css|]}|VqdSr)lower).0nrrr ps z(clsname_as_plain_name..z ([A-Z][a-z]+))joinrefindallr*)r4rrrclsname_as_plain_nameos  rFcCs.t|ts |j}n|}|j}t||}||kS)z1Return True if the two class methods don't match.)r8type __class__r*getattr)Zinstance_or_clsZagainst_methodZ current_cls method_nameZcurrent_methodrrrmethod_is_overriddenus  rKcCs>g}|j|j|jfD]}t|dr|}||q t|S)zrdecode a slice object as sent to __getitem__. takes into account the 2.5 __index__() method, basically. __index__)startstopstephasattrrLappendtuple)Zslcretrrrr decode_slices   rTc 'slt|}|D],tftfddtd}|D]}||vr,|||VnqtdqdS)Ncs t|Sr)r:)ibaserrs z!_unique_symbols..iz&exhausted namespace for symbol base %s)r/ itertoolschainrZitertools_imapranger1 NameError)usedbasespoolsymrrVr_unique_symbolss   raccs2|r||d@}||V||N}|sdSdS)z6Call the given function given each nonzero bit from n.rNr)fnrAbrrrmap_bitss   rdcfdd}t|S)z'A signature-matching decorator factory.c st|st|stdt|}i}t||}t|d|dd|jf}t |dd\}}t ||d}| t |dd |j|d <d |}| |||d |j it|||j}t|d |j|_||_t||S)Nznot a decoratable functionrrtargetrb)rgrbFgroupednamezDdef %(name)s(%(args)s): return %(target)s(%(fn)s, %(apply_kw)s) r*__func__)inspect isfunctionismethodr;rinspect_getfullargspec!_update_argspec_defaults_into_envrRr*radictr format_argspec_plusr+_exec_code_in_envrI __defaults__ __wrapped__r) rbspecenvnamesZ targ_namefn_namemetadatacode decoratedrgrrdecorates&      zdecorator..decorater)rgr~rr}r decorators  rcCsx|jr:g}d}|jD] }t|jdvr%d|}|||<|||d7}q ||q t|}t||d<tj|S|S)zCgiven a FullArgSpec, convert defaults to be symbol names in an env.r)builtins __builtin__zx%drrf)defaultsrGr+rQlistrRr FullArgSpec)rvrwZ new_defaultsrUargrjelemrrrrps      rpcCst||||Sr)exec)r{rwryrrrrss rscCszt|tr|j}|}d|r|nd|j|f}n|}}d|}|dd}t|}|dd=t|dd}||d <d |} |t|j d } t | | | |} t |d rw|j \} } | j }|d urhd|j |jf}t|d| ||fd}|| _ n|j | _ d|ddd| _ | j tjvrtd| j ftjst |dr||j_ t |jd s| |f|j_ | S||_ t |d s| |f|_ | S)zProduce a wrapping function for the given cls or classmethod. Rationale here is so that the __init__ method of the class can serve as documentation for the function. zConstruct a new :class:`%s` object. This constructor is mirrored as a public API function; see :func:`sqlalchemy%s` for a full usage and argument description.z.%szSThis function is mirrored; see :func:`sqlalchemy%s` for a description of arguments..rFrhrjz5def %(name)s(%(args)s): return cls(%(apply_kw)s) )r4symbolr* _linked_toNz%s.%sz.. container:: inherited_member This documentation is inherited from :func:`sqlalchemy%s`; this constructor, :func:`sqlalchemy%s`, creates a :class:`sqlalchemy%s` object. See that class for additional details describing this subclass.r sqlalchemyz0public_factory location %s is not in sys.modulesrk)r8rGrr*splitrrorrrr+rrPrr-inject_docstring_textrsplitrmodules ImportErrorpy2krk)rglocationZclass_locationrbZ callable_docZ location_namervrzr{rwr|Z linked_toZlinked_to_locationZ linked_to_docrrrpublic_factorysv              rc@.eZdZd ddZddZddZdd ZdS) PluginLoaderNcCs||_i|_||_dSr)groupimplsauto_fn)rrrrrrr@s zPluginLoader.__init__cCs|jdSr)rclearrrrrrErzPluginLoader.clearcCs||jvr |j|S|jr||}|r||j|<|St|jD]}|j|kr6|j|j|<|Sq#td|j|f)NzCan't load plugin: %s:%s) rrrZimportlib_metadata_getrrjloadrZNoSuchModuleError)rrjloaderimplrrrrHs        zPluginLoader.loadcsfdd}||j|<dS)Ncs6t}dddD]}t||}qt|S)Nrr)rimport_rrI)modtoken modulepathobjnamerrr\s   z#PluginLoader.register..load)r)rrjrrrrrrregister[szPluginLoader.registerr)r*r+r,rrrrrrrrr?s   rcCshztj}Wntyt|}|dt|dfYSw|j}|j}t|j d|t|j |@fS)Nrr) rlCO_VARKEYWORDSAttributeErrorrrobool__code__ co_argcountr co_varnamesco_flags)rbZco_varkeywordsrvconargsrrr_inspect_func_argses     rcCs|du}|r t}|jdd}|ot|tjot|jtj}|r2t|\}}| ||s2|s2dS|r6|rE|j D] }t ||durDnq9| d|S)aeReturn the full set of inherited kwargs for the given `cls`. Probes a class's __init__ method, collecting all named arguments. If the __init__ defines a \**kwargs catch-all, then the constructor is presumed to pass along unrecognized keywords to its base classes, and the collection process is repeated recursively on each of the bases. Uses a subset of inspect.getfullargspec() to cut down on method overhead, as this is used within the Core typing system to create copies of type objects which is a performance-sensitive operation. No anonymous tuple arguments please ! NrFr) r/__dict__getr8types FunctionTyperCodeTyperr __bases__get_cls_kwargsdiscard)r4_settoplevelZctrZhas_initrxZhas_kwcrrrrys*      rcCst|dS)zReturn the set of legal kwargs for the given `func`. Uses getargspec so is safe to call for methods, functions, etc. r)rro)funcrrrget_func_kwargssrFc Cs0t|r td|t|r4|r/|r/t|}t|jdd|j|j |j |j |j |j St|St|rb|r\|s@|jr\t|j}t|jdd|j|j |j |j |j |j St|jSt|rot|j|ddSt|drzt|jSt|drt|jrt|j|dStd |td |) zReturn the argument signature for any callable. All pure-Python callables are accepted, including functions, methods, classes, objects with __call__; builtins and other edge cases like functools.partial() objects raise a TypeError. zCan't inspect builtin: %srNT)no_self_is_initrk__call__)rzCan't inspect callable: %s)rl isbuiltin TypeErrorrmrrorargsvarargsvarkwr kwonlyargskwonlydefaults annotationsrn__self__rkisclassget_callable_argspecrrPr)rbrrrvrrrrsN              rTc Cst|r t|}n|}tj|}t|d|d|dd|d}|drC|dd}t|ddd|d|dd|d}n|drPd|d}|}nd}|}d}|drb|t|d7}|drn|t|d7}|d|d}|r|d|d} nd} tj||d|d| d d d } |drtj|dd|d|d| d d d } n| } |rt|||| || d St|dd||dd| dd|dd| ddd S)aReturns a dictionary of formatted, introspected function arguments. A enhanced variant of inspect.formatargspec to support code generation. fn An inspectable callable or tuple of inspect getargspec() results. grouped Defaults to True; include (parens, around, argument) lists Returns: args Full inspect.formatargspec for fn self_arg The name of the first positional argument, varargs[0], or None if the function defines no positional arguments. apply_pos args, re-written in calling rather than receiving syntax. Arguments are passed positionally. apply_kw Like apply_pos, except keyword-ish args are passed as keywords. apply_pos_proxied Like apply_pos but omits the self/cls argument Example:: >>> format_argspec_plus(lambda self, a, b, c=3, **d: 123) {'args': '(self, a, b, c=3, **d)', 'self_arg': 'self', 'apply_kw': '(self, a, b, c=c, **d)', 'apply_pos': '(self, a, b, c, **d)'} rrrNz%s[0]rfrcSd|SN=rrrrrrX3z%format_argspec_plus..) formatvaluecSrrrrrrrrX<r)rself_arg apply_posapply_kwapply_pos_proxiedapply_kw_proxiedr)rcallableroinspect_formatargspeclenrq) rbrirvrrrr num_defaultsZ name_argsZdefaulted_valsrrrrrrrsv "   "       rrcCsr|tjur|r dnd}|rdnd}nzt||dWSty.|r$dnd}|r*dnd }Ynwtd|||||d S) a format_argspec_plus with considerations for typical __init__ methods Wraps format_argspec_plus with error handling strategies for typical __init__ cases:: object.__init__ -> (self) other unreflectable (usually C) -> (self, *args, **kwargs) z(self)rz()rhz(self, *args, **kwargs)zself, *args, **kwargsz(*args, **kwargs)z*args, **kwargs)rrrrrr)objectrrrrrq)methodrirZproxiedrrrformat_argspec_initUs(  rrcsfdd}|S)zA class decorator that will copy attributes to a proxy class. The class to be instrumented must define a single accessor "_proxied". csd fdd }fdd}D]}t||r"td||ft||||qD]}t||r.decorate..instrumentcsRj|d}|durt|jdfd}nd}dd|i}t|d|id}|S)Nrrzdef set_(self, attr): self._proxied.%(name)s = attr def get(self): return self._proxied.%(name)s get.__doc__ = doc getset = property(get, set_)rjrgetset)rrrr-rs)rjattrrr{rrrrmakeprops"  z8create_proxy_methods..decorate..makepropz class %s already has a method %sTrr))rPrsetattr)r4rrmethprop attributes classmethodsmethodsrrrrrr~s*-      z&create_proxy_methods..decorater)rrrrrrr~rrrcreate_proxy_methodsvscrcCsJzt|WSty$|tjurdgdddfYSdgdddfYSw)zinspect.getargspec with considerations for typical __init__ methods Wraps inspect.getargspec with error handling for typical __init__ cases:: object.__init__ -> (self) other unreflectable (usually C) -> (self, *args, **kwargs) rNrkwargs)rrorrr)rrrrgetargspec_inits   rcCst|tjr |js |jS|S)zSAdjust the incoming callable such that a 'self' argument is not required. )r8r MethodTyperrk)Z func_or_clsrrrunbound_method_to_callablesrc s(|durg}nt|}tg}t}d}t|D]k\}}zt|j} Wn ty1Yqw| j r:t | j p;d} |dkr_| j rF| j }| rT| | j d| n| | j ddn|fdd| j d| D| r|ddt| j | d| j Dqg} | fdd|D|durt|r| d dt|D|D]+\} } | |vrqzt| }|ur|| kr| d | |fWqtyYqw|r |D]'\} } zt| }|ur|| kr| d | |fWqtyYqwd jjd | fS) z}Produce a __repr__() based on direct association of the __init__() specification vs. same-named attributes present. Nrrcsg|]}|fqSrrr@r)missingrr 'z generic_repr..cSsg|]\}}||fqSrr)r@rdefaultrrrr,sc3s |] }tt|dVqdSr)reprrIrobjrrrB5szgeneric_repr..cSsg|]}t|qSrr)r@valrrrr8rz%s=%rz%s(%s), )rto_listr OrderedDict enumeraterrorrrrrr2rr ziprPrIitemsrQr;rHr*rC)rZ additional_kwZ to_inspectZ omit_kwargZpos_argsZkw_argsZvargsrUZinsprvZ default_lenoutputrZdefvalrr)rrr generic_reprst      rc@s6eZdZdZdZddZddZd dd Zd d Zd S)portable_instancemethodz_Turn an instancemethod into a (parent, name) pair to produce a serializable callable. )rgrjr __weakref__cCs|j|j|jdS)Nrgrjrr rrrr __getstate__Xsz$portable_instancemethod.__getstate__cCs&|d|_|d|_|dd|_dS)Nrgrjrr)rgrjrr)rstaterrr __setstate___s  z$portable_instancemethod.__setstate__rcCs|j|_|j|_||_dSr)rrgr*rjr)rrrrrrrds z portable_instancemethod.__init__cOs$||jt|j|j|i|Sr)r rrIrgrj)rrkwrrrris z portable_instancemethod.__call__N)r) r*r+r,r-r.r rrrrrrrr Ps  r cstjr t|tjr tS|ht|j}|r||}tjr/t|tjr$qfdd|jD}n fdd|jD}|D] }| | |q;tj rW|j dksUt |dsVqn |j dksat |dsbqfdd|DD] }| | |qm|stS) aReturn an unordered sequence of all classes related to cls. Traverses diamond hierarchies. Fibs slightly: subclasses of builtin types are not returned. Thus class_hierarchy(class A(object)) returns (A, object), not A plus every class systemwide that derives from object. Old-style classes are discarded and hierarchies rooted on them will not be descended. c3s(|]}|vrt|tjs|VqdSr)r8r ClassTyper@_ZhierrrrBs  z"class_hierarchy..c3s|] }|vr|VqdSrrrrrrrBrr3rcsg|]}|vr|qSrrrrrrrsz#class_hierarchy..)rrr8rrr__mro__r0rrQr1r r+rPr3)r4processrr^rcsrrrclass_hierarchyns<         rccsBt|}|D]}|jD]}||jvr||j|fVnq qdS)ziterate all the keys and attributes associated with a class, without using getattr(). Does not use getattr() so that class-sensitive descriptors (i.e. property.__get__()) are not called. N)dirrr)r4keyskeyrrrriterate_attributess  r self.proxyc s$|r|}ndur dfddt|D}|D]v}zt||}t|ds(Wqt|d|}Wn ty8Yqwzt|} t| d} t| ddd} Wn ty_d } d } Ynwd t} |durm||ipni} t | | z|j | |_ Wn tyYnwt || |qdS) z9Automates delegation of __specials__ for a proxying type.N)r.__del____getattribute__ __metaclass__r rcs6g|]}|dr|drt|s|vr|qS)__) startswithendswithrPr@rinto_clsskiprrrsz0monkeypatch_proxied_specials..rrkrrz(self, *args, **kw)z (*args, **kw)z?def %(method)s%(fn_args)s: return %(name)s.%(method)s%(d_args)s) rrIrPrrrorrlocalsexec_rtr)r&Zfrom_clsr'onlyrjZ from_instanceZdundersrrbrvZfn_argsZd_argspyrwrr%rmonkeypatch_proxied_specialssJ          r,cCst|d|t|d|uS)z;Return True if the two methods are the same implementation.rk)rI)Zmeth1Zmeth2rrrmethods_equivalents r-c Csj|s|stdt|trt||r|St|pddt|D}tt|}tj}t|tr2|}n |s;t}tj}nt|}||||rI|St|t sc|tjurUdpVd}td||d |fGdd d t }|rsd |j |_ t} t |D](\} } | |vrtd | t| std | | ft|| t| | | qz|| |r|Std d || )aEnsure basic interface compliance for an instance or dict of callables. Checks that ``obj`` implements public methods of ``cls`` or has members listed in ``methods``. If ``required`` is not supplied, implementing at least one interface method is sufficient. Methods present on ``obj`` that are not in the interface are ignored. If ``obj`` is a dict and ``dict`` does not meet the interface requirements, the keys of the dictionary are inspected. Keys present in ``obj`` that are not in the interface will raise TypeErrors. Raises TypeError if ``obj`` does not meet the interface criteria. In all passing cases, an object with callable members is returned. In the simple case, ``obj`` is returned as-is; if dict processing kicks in then an anonymous class is returned. obj A type, instance, or dictionary of callables. cls Optional, a type. All public methods of cls are considered the interface. An ``obj`` instance of cls will always pass, ignoring ``required``.. methods Optional, a sequence of method names to consider as the interface. required Optional, a sequence of mandatory implementations. If omitted, an ``obj`` that provides at least one interface method is considered sufficient. As a convenience, required may be a type, in which case all public methods of the type are required. z2a class or collection of method names are requiredcSsg|] }|ds|qS)r)r"r$rrrrsz as_interface..zany ofzall ofz%r does not implement %s: %src@seZdZdZdS)z(as_interface..AnonymousInterfacezA callable-holding shell.N)r*r+r,r-rrrrAnonymousInterface6sr.Z Anonymousz%r: unknown in this interfacez%r=%r is not callablez,dictionary does not contain required keys %s)rr8rGr/roperatorgegt intersectionrqrCrr*dictlike_iteritemsrrr staticmethodr1) rr4rrequiredZ interfaceZ implementedZcompliesZ qualifierr.foundrrrrr as_interfacesP!         r7c@s6eZdZdZd ddZddZddZed d ZdS) memoized_propertyz2A read-only @property that is only evaluated once.NcC||_|p|j|_|j|_dSrfgetr-r*rr;rrrrrQ  zmemoized_property.__init__cCs&|dur|S|||j|j<}|Sr)r;rr*rrr4resultrrr__get__Vszmemoized_property.__get__cCst||jdSr)r8resetr*)rrrrr_reset\szmemoized_property._resetcCs|j|ddSr)rr0)r4rrjrrrrA_szmemoized_property.resetr) r*r+r,r-rr@rBrrArrrrr8Ns r8cre)zDecorate a method memoize its return value. Best applied to no-arg methods: memoization is not sensitive to argument values, and will always return the same value even when called with different arguments. csB|g|Ri|fdd}j|_j|_||jj<S)NcSrrarr?rrmemopz6memoized_instancemethod..oneshot..memo)r*r-rrrrrGrbrFroneshotms   z(memoized_instancemethod..oneshotr)rbrKrrJrmemoized_instancemethodds rLc@sNeZdZdZdZeZddZddZddZ Gd d d e Z e d d Z d S) HasMemoizedzyA class that maintains the names of memoized elements in a collection for easy cache clearing, generative, etc. rcCs|jD] }|j|dqdSr)_memoized_keysrr0rrrrr_reset_memoizations zHasMemoized._reset_memoizationscCs|jD] }||jvs JqdSr)rNrrOrrr_assert_no_memoizationsrQz#HasMemoized._assert_no_memoizationscCs||j|<|j|hO_dSr)rrN)rrr#rrr_set_memoized_attributes z#HasMemoized._set_memoized_attributec@s"eZdZdZdddZddZdS)zHasMemoized.memoized_attributezTA read-only @property that is only evaluated once. :meta private: NcCr9rr:r<rrrrr=z'HasMemoized.memoized_attribute.__init__cCs8|dur|S|||j|j<}|j|jhO_|Sr)r;rr*rNr>rrrr@s z&HasMemoized.memoized_attribute.__get__r)r*r+r,r-rr@rrrrmemoized_attributes  rTcfdd}t|S)z+Decorate a method memoize its return value.csT|g|Ri|fdd}j|_j|_||jj<|jjhO_S)NcrCrrrDrFrrrGrHzBHasMemoized.memoized_instancemethod..oneshot..memo)r*r-rrNrIrJrFrrKs  z4HasMemoized.memoized_instancemethod..oneshotr)r4rbrKrrJrrLs  z#HasMemoized.memoized_instancemethodN)r*r+r,r-r. frozensetrNrPrRrSrrTrrLrrrrrM{srMc@s$eZdZdZdZddZddZdS) MemoizedSlotszApply memoized items to an object using a __getattr__ scheme. This allows the functionality of memoized_property and memoized_instancemethod to be available to a class using __slots__. rcCst|r)r)rrrrr_fallback_getattrzMemoizedSlots._fallback_getattrcsdr ttdr td}t||Stdr.oneshot..memo)r*r-r)rrrGrbrrrFrrKs   z*MemoizedSlots.__getattr__..oneshot)r"rrPrIrr-rX)rrr#rKrrZr __getattr__s    zMemoizedSlots.__getattr__N)r*r+r,r-r.rXr[rrrrrWs  rWcCsDt|tjr|}|dvrdS|dvrdStd|t|S)N)trueyesonyt1T)falsenooffrAf0FzString is not true/false: %r)r8rr9stripr? ValueErrorrrrrrasbools   ricsfdd}|S)zqReturn a callable that will evaluate a string as boolean, or one of a set of "alternate" string values. cs|vr|St|Sr)rirtextrr bool_or_valuesz"bool_or_str..bool_or_valuer)rkrlrrjr bool_or_strs rmcCs|dur|St|S)zCoerce to integer.N)int)r#rrrasintsrocCsx|dur|}||vr6t|trt|||s:||dur8|tur,|r,t||||<dS|||||<dSdSdSdS)zIf 'key' is present in dict 'kw', coerce its value to type 'type\_' if necessary. If 'flexi_bool' is True, the string '0' is considered false when coercing to boolean. N)r8rGrri)rrr"Z flexi_booldestrrrcoerce_kw_types    rqcs$t|}|ftfdd|DS)zbProduce a tuple structure that is cacheable using the __dict__ of obj to retrieve values c3(|]}|jvr|j|fVqdSrrr@krrrrB    z"constructor_key..)rrR)rr4rxrrrconstructor_keys rwcs4t|}|fdd||D||i|S)zInstantiate cls using the __dict__ of obj as constructor arguments. Uses inspect to match the named arguments of ``cls``. c3rrrrsrtrrrrB*rvz#constructor_copy..)rr difference)rr4rrrxrrrconstructor_copy"s rycs&tjtdfdd}|S)z%Return a threadsafe counter function.rcs0 tWdS1swYdSr)nextrcounterlockrr_next7s$zcounter.._next)r threadingLockrYcount)r~rr{rr|0s  r|cCst|dr|jdurt|jtrtS|jSt|trtpt}||tr%tS||tr,tS||tr3tSt|dr:tSt|drAtSt|drHtS|S)zGiven an instance or class, guess if it is or is acting as one of the basic collection types: list, set and dict. If the __emulates__ property is present, return that preferentially. __emulates__NrQr1r/)rPr issubclassr/r8rGrrq)ZspecimenrZisarrrduck_type_collection>s(        rcCsXt||r|St|tr td|ddd|Dt|ftd||t|f)Nz8Argument '%s' is expected to be one of type %s, got '%s'z or css|]}d|VqdS)z'%s'Nr)r@rErrrrBfsz"assert_arg_type..z6Argument '%s' is expected to be of type '%s', got '%s')r8rRr ArgumentErrorrCrG)rZargtyperjrrrassert_arg_type_s   rcstjrtdrtSntdrStdr#tStdtdddur7tdtdrFfdd }|Std rXtfd d  DStd) z?Return a (key, value) iterator for almost any dict-like object.r iteritems __getitem__rNzObject '%r' is not dict-likeiterkeysc3s"D] }||fVqdSr)r)rdictlikegetterrriterators z$dictlike_iteritems..iteratorrc3s|] }||fVqdSrr)r@r)rrrrBrz%dictlike_iteritems..) rr rPrrriterrIrr)rrrrrr3os"         r3c(eZdZdZfddZddZZS) classpropertyaAA decorator that behaves like @property except that operates on classes rather than instances. The decorator is currently special when using the declarative module, but note that the :class:`~.sqlalchemy.ext.declarative.declared_attr` decorator should be used for this purpose with declarative. cs*tt|j|g|Ri||j|_dSr)superrrr-)rr;rrrHrrrs zclassproperty.__init__cCs ||Sr)r;)descrr4rrrr@rzclassproperty.__get__)r*r+r,r-rr@ __classcell__rrrrrs rc@s$eZdZddZddZddZdS)hybridpropertycCs||_||_dSr)rrrrrrrrs zhybridproperty.__init__cCs |dur ||}|S||Sr)rr)rinstanceownerZclsvalrrrr@s  zhybridproperty.__get__cC ||_|Srrrrrr classlevelzhybridproperty.classlevelN)r*r+r,rr@rrrrrrs rc@s(eZdZdZddZddZddZdS) hybridmethodz/Decorate a function as cls- or instance- level.cCs||_|_||_dSr)rrkrrrrrrs  zhybridmethod.__init__cCs&|dur |j||jS|j||Sr)rr@rHr)rrrrrrr@szhybridmethod.__get__cCrrrrrrrrrzhybridmethod.classlevelN)r*r+r,r-rr@rrrrrrs  rc@r) _symbolNcCs@t|tjsJ|durt|}tt|}||_|r||_|S)zConstruct a new named symbol.N) r8rr9hashrn__new__rrjr-)rrjr canonicalvrrrrs z_symbol.__new__cCst|jdt|ffS)Nr)rrjrnrrrr __reduce__sz_symbol.__reduce__cCst|Srrrrrr__str__rYz_symbol.__str__cCs d|jS)Nz symbol(%r))rjrrrr__repr__rz_symbol.__repr__NN)r*r+r,rrrrrrrrrs    rrc@s8eZdZdZiZejZdddZ e d ddZ dS) raA constant symbol. >>> symbol('foo') is symbol('foo') True >>> symbol('foo') A slight refinement of the MAGICCOOKIE=object() pattern. The primary advantage of symbol() is its repr(). They are also singletons. Repeated calls of symbol('name') will all return the same instance. The optional ``doc`` argument assigns to ``__doc__``. This is strictly so that Sphinx autoattr picks up the docstring we want (it doesn't appear to pick up the in-module docstring if the datamember is in a different module - autoattribute also blows up completely). If Sphinx fixes/improves this then we would no longer need ``doc`` here. NcCsX|j|j|}|durt||||j|<}|WdS1s%wYdSr)_locksymbolsrr)r4rjrrr`rrrrs  $zsymbol.__new__FcCsf|D]\}}||ur|S|r||jkr|S||vr#|Sq|dur*dStd||f)aGiven a user parameter, parse the parameter into a chosen symbol. The user argument can be a string name that matches the name of a symbol, or the symbol object itself, or any number of alternate choices such as True/False/ None etc. :param arg: the user argument. :param choices: dictionary of symbol object to list of possible entries. :param name: name of the argument. Used in an :class:`.ArgumentError` that is raised if the parameter doesn't match any available argument. :param resolve_symbol_names: include the name of each symbol as a valid entry. NzInvalid value for '%s': %r)rrjrr)r4rchoicesrjZresolve_symbol_namesr`choicerrrparse_user_argumentszsymbol.parse_user_argumentrr)) r*r+r,r-rrrrrrrrrrrrrs  cCst|_td7adS)zAssign a '_creation_order' sequence to the given instance. This allows multiple instances to be sorted in order of creation (typically within a single thread; the counter is not particularly threadsafe). rN)_creation_order)rrrrset_creation_order"s rcOs>z||i|WStytdtddYdSw)zXexecutes the given function, catches all exceptions and converts to a warning. z%s('%s') ignoredrrN)r;r!rr)rrrrrrwarn_exception/s  rcCs<zt||krd|d|WS|WSty|YSw)Nz%s...r)rr)r#Zlen_rrrellipses_string:s  rcs0eZdZdZfddZddZddZZS)_hash_limit_stringa/A string subclass that can only be hashed on a maximum amount of unique values. This is used for warnings so that we can send out parameterized warnings without the __warningregistry__ of the module, or the non-overridable "once" registry within warnings.py, overloading memory, cs@||d|}tt|||}td|t||f|_|S)Nz6 (this warning may be suppressed after %d occurrences)z%s_%d)rrrr_hash)r4r#numrZ interpolatedrrrrrOs z_hash_limit_string.__new__cCs|jSr)rrrrr__hash__Wsz_hash_limit_string.__hash__cCst|t|kSr)r)rotherrrr__eq__Zsz_hash_limit_string.__eq__)r*r+r,r-rrrrrrrrrDs  rcCs*|r ttj||ddSt|tjdS)zdIssue a warning. If msg is a string, :class:`.exc.SAWarning` is used as the category. )r{N)_warnings_warnr SAWarning)msgr{rrrr!^sr!cCs |rt|d|}t|tjdS)z\Issue a warning with a parameterized string, limiting the number of registrations. N)rrrr)rrrrr warn_limitedks rcCszt|}Wntyd}Yn,d}Yn%|dur>td|jddr>|j}|d7}|dur>td|jdds(|durNtj |||dddStj ||dddS)Nrz^(?:sqlalchemy\.|alembic\.)r*rr) stacklevel) r _getframerhrDmatch f_globalsrf_backwarningsr!)messagecategoryrframerrrrus"   rcsgfdd}|S)zNDecorate the given function to be a no-op after it is called exactly once.cs>}r}z||i|WSrd|dS)Nr)r0insert)rrZ strong_fnZonce_fnrbonceretry_on_exceptionrrgos zonly_once..gor)rbrrrrr only_onces rz%sqlalchemy/([a-z_]+/){0,2}[a-z_]+\.pyzunit(?:2|test2?/)cCsd}t|d}||kr"|||r"|d7}||kr"|||s||kr<|||r<|d8}||kr<|||s-|||dS)atChop extraneous lines off beginning and end of a traceback. :param tb: a list of traceback lines as returned by ``traceback.format_stack()`` :param exclude_prefix: a regular expression object matching lines to skip at beginning of ``tb`` :param exclude_suffix: a regular expression object matching lines to skip at end of ``tb`` rr)rsearch)tbZexclude_prefixZexclude_suffixrMendrrrchop_tracebacks rcCs$d|}t}t|||dS)Nz&def set(obj, value): obj.%s = valuer/)r(copyr)attrnamer{rwrrr attrsetters  rcr)EnsureKWArgTypezYApply translation of functions to accept \**kw arguments if they don't already. c sr|j}|r-|D]%}t||}|r,||}t|}|js,||||<} t||| qtt | |||dSr) Z ensure_kwargrDrrror _wrap_w_kwrrrr) r4clsnamer^ZclsdictZfn_regrrrbrvwrappedrrrrs   zEnsureKWArgType.__init__crU)Ncs|Srr)rrrJrrwraprYz(EnsureKWArgType._wrap_w_kw..wrapr)rrbrrrJrrs  zEnsureKWArgType._wrap_w_kw)r*r+r,r-rrrrrrrrs  rcCsht|dr t||S|}|jj|_t|dr|j|_t|jdr+|jjr+|jj|_|S|jr2|j|_|S)zAugment functools.update_wrapper() to work with objects with a ``__call__()`` method. :param fn: object with __call__ method r*r+r-)rPrrHr*r+rr-)wrapperrbZ_frrr wrap_callables     rcCsd|vr |dSd}gg}d}t|}||kr`||}|dkrC|dkr>||dkr>||ddkr>|dd|d7}n|dN}n|dkrQ|dkrQ|gn|d||d7}||ksdd|DS)aParse a dotted identifier with accommodation for quoted names. Includes support for SQL-style double quotes as a literal character. E.g.:: >>> quoted_token_parser("name") ["name"] >>> quoted_token_parser("schema.name") ["schema", "name"] >>> quoted_token_parser('"Schema"."Name"') ['Schema', 'Name'] >>> quoted_token_parser('"Schema"."Name""Foo"') ['Schema', 'Name""Foo'] "rrrrcSsg|]}d|qS)r)rC)r@rrrrr'sz'quoted_token_parser..)rrrQ)r#r r?idxlvcharrrrquoted_token_parsers& $   rcstfdd}|S)Ncs:|jdur|jp d}|rt|fddD}||_|S)Nrcsi|]}|qSrr)r@paramrjrr 0sz8add_parameter_text..decorate..)r-inject_param_text)rbrparamsrkrrr~-s z$add_parameter_text..decorate)rr)rrkr~rrradd_parameter_text*s rcCsJ|dd}t|dkr|S|\}}|ds |dt|St|S)N rr>)rrr"textwrapdedent)rkZ split_text firstline remainingrrr_dedent_docstring7s    rcCst|pd}|d}t|dkr|dt|d}|dr(|ddddt|D}|dd|t|t|d}|d||||d}d |S)NrrrrcSsg|] \}}|s|qSr)rg)r@rlinerrrrLsz)inject_docstring_text..) rrrrQrrrrminrC)doctextZ injecttextposlinesZ injectlinesZblanksZ inject_posrrrrCs       rz(\s+):param (.+?):c Cs t|}g}d}|r|}t|}|durO|rN|dd}||vrNdt|dd}|rHt d|d} | rHdt| d}|||}n+|r\| d|dgd}n| sk| ||dgd}n| drz| ||gq | ||s d|S) Nr*r>rz(\s+)\Srrz::) collectionsdeque splitlinespopleft _param_regrrlstriprrDr2rstripr#rQrC) rZ inject_paramsZdoclinesrZ to_injectrrrindentm2rrrrXs:     !rcCs~t|dkrdSt|dk}|r|ddn |dd|dd}dd|D}|r0d|Sd d|dd|dfS) zTrims a list of strings from the middle and return a string of up to four elements. Strings greater than 11 characters will be truncatedrNrrfrcSs,g|]}t|dkrd|ddn|qS) z%s..N)r)r@rjrrrrs,z$repr_tuple_names..rz %s, ..., %s)rrC)rxflagresrrrrepr_tuple_namess  ( rcCs@zddlm}ddlm}ddlm}WdStyYdSw)Nr)cimmutabledict) cprocessors) cresultproxyTF)rrrrr)rrrrrrhas_compiled_exts    rr)FF)T)rrr)rNr)NNrN)NNN)TN)r)Nr)ar-r functoolsrr rlrYr/rDrrrrrrrrrrrr7r=rFrKrTrardrrprsrrrrrrrrrrrrrr rrr,r-r7r8rLrMrWrirmrorqrwryr|rrr3propertyrrrrnrr*rrrrr text_typerr!rrrcompileZ_SQLA_REZ _UNITTEST_RErrGNoneTyperrrrrrrrrrrrrrrs    1  # W& + 6 p% t H3 ? V<)    !D     ,  +