_#8@s"dZddlZddlmZddlmZddlmZddlmZyddl m Z WnKe k rydd l m Z Wn"e k rdd lm Z YnXYnXd d ZGd d d eZGdddeZGdddeZeGdddeZdS)z werkzeug.local ~~~~~~~~~~~~~~ This module implements context-local objects. :copyright: 2007 Pallets :license: BSD-3-Clause N)update_wrapper)implements_bool)PY2)ClosingIterator) getcurrent) get_identcCs|jdS)aMReleases the contents of the local for the current context. This makes it possible to use locals without a manager. Example:: >>> loc = Local() >>> loc.foo = 42 >>> release_local(loc) >>> hasattr(loc, 'foo') False With this function one can release :class:`Local` objects as well as :class:`LocalStack` objects. However it is not possible to release data held by proxies that way, one always has to retain a reference to the underlying local object in order to be able to release it. .. versionadded:: 0.6.1 N)__release_local__)localr 2/tmp/pip-build-5gj8f0j9/Werkzeug/werkzeug/local.py release_localsr c@sjeZdZdZddZddZddZd d Zd d Zd dZ ddZ dS)Local __storage____ident_func__cCs*tj|ditj|dtdS)Nrr)object __setattr__r)selfr r r __init__8szLocal.__init__cCst|jjS)N)iterritems)rr r r __iter__<szLocal.__iter__cCs t||S)zCreate a proxy for a name.) LocalProxy)rproxyr r r __call__?szLocal.__call__cCs|jj|jddS)N)rpopr)rr r r r CszLocal.__release_local__c Cs>y|j|j|SWntk r9t|YnXdS)N)rrKeyErrorAttributeError)rnamer r r __getattr__Fs zLocal.__getattr__c CsP|j}|j}y||||>> ls = LocalStack() >>> ls.push(42) >>> ls.top 42 >>> ls.push(23) >>> ls.top 23 >>> ls.pop() 23 >>> ls.top 42 They can be force released by using a :class:`LocalManager` or with the :func:`release_local` function but the correct way is to pop the item from the stack after using. When the stack is empty it will no longer be bound to the current context (and as such released). By calling the stack without arguments it returns a proxy that resolves to the topmost item on the stack. .. versionadded:: 0.6.1 cCst|_dS)N)r_local)rr r r rvszLocalStack.__init__cCs|jjdS)N)r(r )rr r r r yszLocalStack.__release_local__cCs |jjS)N)r(r)rr r r r|szLocalStack.__ident_func__cCstj|jd|dS)Nr)rrr()rr r r r rscsfdd}t|S)Ncs%j}|dkr!td|S)Nzobject unbound)top RuntimeError)rv)rr r _lookups   z$LocalStack.__call__.._lookup)r)rr,r )rr rszLocalStack.__call__cCsBt|jdd}|dkr1g|j_}|j||S)zPushes a new item to the stackstackN)getattrr(r-append)robjr+r r r pushs   zLocalStack.pushcCsZt|jdd}|dkr%dSt|dkrLt|j|dS|jSdS)z}Removes the topmost item from the stack, will return the old value or `None` if the stack was already empty. r-Nr)r.r(lenr r)rr-r r r rs  zLocalStack.popc Cs5y|jjdSWnttfk r0dSYnXdS)z[The topmost item on the stack. If the stack is empty, `None` is returned. rNr2)r(r-r IndexError)rr r r r)szLocalStack.topN) r#r$r%__doc__rr propertyrsetterrr1rr)r r r r r'[s     r'c@sdeZdZdZddddZddZddZd d Zd d Zd dZ dS) LocalManageraNLocal objects cannot manage themselves. For that you need a local manager. You can pass a local manager multiple locals or add them later by appending them to `manager.locals`. Every time the manager cleans up, it will clean up all the data left in the locals for this context. The `ident_func` parameter can be added to override the default ident function for the wrapped locals. .. versionchanged:: 0.6.1 Instead of a manager the :func:`release_local` function can be used as well. .. versionchanged:: 0.7 `ident_func` was added. NcCs|dkrg|_n-t|tr6|g|_nt||_|dk r||_x0|jD]}tj|d|qdWn t|_dS)Nr)locals isinstancerlist ident_funcrrr)rr9r<r r r r rs    zLocalManager.__init__cCs |jS)aReturn the context identifier the local objects use internally for this context. You cannot override this method to change the behavior but use it to link other context local objects (such as SQLAlchemy's scoped sessions) to the Werkzeug locals. .. versionchanged:: 0.7 You can pass a different ident function to the local manager that will then be propagated to all the locals passed to the constructor. )r<)rr r r rs zLocalManager.get_identcCs"x|jD]}t|q WdS)zManually clean up the data in the locals for this context. Call this at the end of the request or use `make_middleware()`. N)r9r )rr r r r cleanupszLocalManager.cleanupcsfdd}|S)zWWrap a WSGI application so that cleaning up happens after request end. cst||jS)N)rr=)environZstart_response)apprr r applicationsz1LocalManager.make_middleware..applicationr )rr?r@r )r?rr make_middlewareszLocalManager.make_middlewarecCst|j||S)asLike `make_middleware` but for decorating functions. Example usage:: @manager.middleware def application(environ, start_response): ... The difference to `make_middleware` is that the function passed will have all the arguments copied from the inner application (name, docstring, module). )rrA)rfuncr r r middlewares zLocalManager.middlewarecCsd|jjt|jfS)Nz<%s storages: %d>) __class__r#r3r9)rr r r __repr__szLocalManager.__repr__) r#r$r%r5rrr=rArCrEr r r r r8s   r8c@s^eZdZdZdWZdddZd d Zed d Zd dZ ddZ ddZ ddZ ddZ ddZddZerddZddZdd Zd!dZd"dZd#dZd$dZd%dZd&dZd'dZd(dZd)dZd*dZd+dZd,dZd-dZ d.dZ!d/dZ"d0dZ#d1dZ$d2dZ%d3dZ&d4dZ'd5dZ(d6dZ)d7dZ*d8dZ+d9dZ,d:dZ-d;dZ.d<dZ/d=dZ0d>dZ1d?dZ2d@dZ3dAdZ4dBdZ5dCdZ6dDdZ7dEdZ8dFdZ9dGdZ:dHdZ;dIdZ<dJdZ=dKdZ>dLdZ?dMdZ@dNdZAdOdZBdPdZCerdQdZDneCZDdRdZEdSdZFdTdZGdUdZHdVdZIdS)XrahActs as a proxy for a werkzeug local. Forwards all operations to a proxied object. The only operations not supported for forwarding are right handed operands and any kind of assignment. Example usage:: from werkzeug.local import Local l = Local() # these are proxies request = l('request') user = l('user') from werkzeug.local import LocalStack _response_local = LocalStack() # this is a proxy response = _response_local() Whenever something is bound to l.user / l.request the proxy objects will forward all operations. If no object is bound a :exc:`RuntimeError` will be raised. To create proxies to :class:`Local` or :class:`LocalStack` objects, call the object as shown above. If you want to have a proxy to an object looked up by a function, you can (as of Werkzeug 0.6.1) pass a function to the :class:`LocalProxy` constructor:: session = LocalProxy(lambda: get_current_request().session) .. versionchanged:: 0.6.1 The class can be instantiated with a callable as well now. __local__dict__r# __wrapped__NcCsYtj|d|tj|d|t|rUt|d rUtj|d|dS)N_LocalProxy__localr#r rH)rrcallablehasattr)rr rr r r r$szLocalProxy.__init__c Cs_t|jds|jSyt|j|jSWn%tk rZtd|jYnXdS)zReturn the current object. This is useful if you want the real object behind the proxy at a time for performance reasons or because you want to pass the object into a different context. r zno object bound to %sN)rKrIr.r#rr*)rr r r _get_current_object,s   zLocalProxy._get_current_objectc Cs6y|jjSWntk r1tdYnXdS)NrG)rLrGr*r)rr r r rG8s zLocalProxy.__dict__c Cs=y|j}Wn tk r2d|jjSYnXt|S)Nz <%s unbound>)rLr*rDr#repr)rr0r r r rE?s  zLocalProxy.__repr__c Cs1yt|jSWntk r,dSYnXdS)NF)boolrLr*)rr r r __bool__Fs zLocalProxy.__bool__c Cs7yt|jSWntk r2t|SYnXdS)N)unicoderLr*rM)rr r r __unicode__Ls zLocalProxy.__unicode__c Cs1yt|jSWntk r,gSYnXdS)N)dirrLr*)rr r r __dir__Rs zLocalProxy.__dir__cCs/|dkrt|jSt|j|S)N __members__)rRrLr.)rrr r r rXs zLocalProxy.__getattr__cCs||j|dszLocalProxy.cCs||j||S)N)rL)rXrdr r r r[scCs|j|?S)N)rL)rXrdr r r r[scCs|j|@S)N)rL)rXrdr r r r[scCs|j|AS)N)rL)rXrdr r r r[scCs|j|BS)N)rL)rXrdr r r r[scCs|jj|S)N)rL__div__)rXrdr r r r[scCs|jj|S)N)rL __truediv__)rXrdr r r r[scCs |j S)N)rL)rXr r r r[scCs |j S)N)rL)rXr r r r[scCst|jS)N)absrL)rXr r r r[scCs |jS)N)rL)rXr r r r[scCst|jS)N)complexrL)rXr r r r[scCst|jS)N)intrL)rXr r r r[scCst|jS)N)longrL)rXr r r r[scCst|jS)N)floatrL)rXr r r r[scCst|jS)N)octrL)rXr r r r[scCst|jS)N)hexrL)rXr r r r[scCs|jjS)N)rL __index__)rXr r r r[scCs|jj||S)N)rL __coerce__)rXrdr r r r[scCs|jjS)N)rL __enter__)rXr r r r[scOs|jj||S)N)rL__exit__)rXrgrhr r r r[scCs||jS)N)rL)rXrdr r r r[scCs||jS)N)rL)rXrdr r r r[scCs||jS)N)rL)rXrdr r r r[scCs||jS)N)rL)rXrdr r r r[scCs|jj|S)N)rL __rtruediv__)rXrdr r r r[scCs||jS)N)rL)rXrdr r r r[scCs||jS)N)rL)rXrdr r r r[scCs|jj|S)N)rL __rdivmod__)rXrdr r r r[scCstj|jS)N)copyrL)rXr r r r[scCstj|j|S)N)rydeepcopyrL)rXmemor r r r[s)rFrGr#rH)Jr#r$r%r5r&rrLr6rGrErOrQrSrrVrWrZ __getslice__r]r^rr"__str____lt____le____eq____ne____gt____ge__Z__cmp____hash__r__len__ __getitem__r __contains____add____sub____mul__ __floordiv____mod__ri__pow__ __lshift__ __rshift____and____xor____or__rjrk__neg____pos____abs__ __invert__ __complex____int__Z__long__ __float__Z__oct__Z__hex__rsrtrurv__radd____rsub____rmul__Z__rdiv__rw __rfloordiv____rmod__rx__copy__ __deepcopy__r r r r rs #                                                               r)r5ry functoolsr_compatrrZwsgirZgreenletrr ImportErrorthread_threadr rrr'r8rr r r r  s$    &RP