B `5@sjddlmZddlmZddlmZddlmZddl m Z m Z m Z ddl mZGdddZd d Zd S) )update_wrapper)Response) Interface) action_method) IResourceURL IResponse ITraverser) takes_one_argc@sheZdZedddZddZddZeddd Zed d Zd d Z edddZ edddZ dS)AdaptersConfiguratorMixinNc sj}||dkr&tftttfs:ffdd}dtdd<d<jd|fdS)aAdd an event :term:`subscriber` for the event stream implied by the supplied ``iface`` interface. The ``subscriber`` argument represents a callable object (or a :term:`dotted Python name` which identifies a callable); it will be called with a single object ``event`` whenever :app:`Pyramid` emits an :term:`event` associated with the ``iface``, which may be an :term:`interface` or a class or a :term:`dotted Python name` to a global object representing an interface or a class. Using the default ``iface`` value, ``None`` will cause the subscriber to be registered for all event types. See :ref:`events_chapter` for more information about events and subscribers. Any number of predicate keyword arguments may be passed in ``**predicates``. Each predicate named will narrow the set of circumstances in which the subscriber will be invoked. Each named predicate must have been registered via :meth:`pyramid.config.Configurator.add_subscriber_predicate` before it can be used. See :ref:`subscriber_predicates` for more information. .. versionadded:: 1.4 The ``**predicates`` argument. Ncsdd}|jf\}}}fdd|D}|}|||||dj|dS)N subscribercsg|]}|qS)_derive_predicate).0p)selfr _/home/kop/projects/devel/pgwui/test_venv/lib/python3.7/site-packages/pyramid/config/adapters.py 0szNAdaptersConfiguratorMixin.add_subscriber..register..)phashorder predicatesderived_predicatesderived_subscriber)Z get_predlistmake_derive_subscriberupdateregistryZregisterHandler)Zpredlistrpredsrrr)ifaceintrrrr r rregister,s  z:AdaptersConfiguratorMixin.add_subscriber..registerZ subscribersr Z interfaces)introspectables) maybe_dottedr isinstancetuplelistintrospectableidobject_descriptionaction)rr rrZdottedrr )rrrrr radd_subscriber s z(AdaptersConfiguratorMixin.add_subscribercs}trfdd}|S)Ncs |dS)Nrr )arg) predicater rderived_predicateSszFAdaptersConfiguratorMixin._derive_predicate..derived_predicate) eventonly)rr+r,r )r+rr Ns z+AdaptersConfiguratorMixin._derive_predicatecsZtr,fddtdr,ts4Sfdd}tdrVt||S)Ncs |dS)Nrr )r*)r r rr`szHAdaptersConfiguratorMixin._derive_subscriber..derived_subscriber__name__cs"tfddDrSdS)Nc3s|]}|VqdS)Nr )rr+)r*r r |sz[AdaptersConfiguratorMixin._derive_subscriber..subscriber_wrapper..)all)r*)rr)r*rsubscriber_wrapperiszHAdaptersConfiguratorMixin._derive_subscriber..subscriber_wrapper)r-hasattrr)rr rr1r )rrr rr[s     z,AdaptersConfiguratorMixin._derive_subscribercCs|jd||||ddS)a .. versionadded:: 1.4 Adds a subscriber predicate factory. The associated subscriber predicate can later be named as a keyword argument to :meth:`pyramid.config.Configurator.add_subscriber` in the ``**predicates`` anonymous keyword argument dictionary. ``name`` should be the name of the predicate. It must be a valid Python identifier (it will be used as a ``**predicates`` keyword argument to :meth:`~pyramid.config.Configurator.add_subscriber`). ``factory`` should be a :term:`predicate factory` or :term:`dotted Python name` which refers to a predicate factory. See :ref:`subscriber_predicates` for more information. r )weighs_more_thanweighs_less_thanN)Z_add_predicate)rnamefactoryr3r4r r radd_subscriber_predicates z2AdaptersConfiguratorMixin.add_subscriber_predicatecshfdd}tf}d|d}|d<|d<j|||fddS) aeWhen an object of type (or interface) ``type_or_iface`` is returned from a view callable, Pyramid will use the adapter ``adapter`` to convert it into an object which implements the :class:`pyramid.interfaces.IResponse` interface. If ``adapter`` is None, an object returned of type (or interface) ``type_or_iface`` will itself be used as a response object. ``adapter`` and ``type_or_interface`` may be Python objects or strings representing dotted names to importable Python global objects. See :ref:`using_iresponse` for more information.cs2j}dkr|ftn|ftdS)N)rZregisterSelfAdapterrregisterAdapter)reg)adapterr type_or_ifacer rrsz@AdaptersConfiguratorMixin.add_response_adapter..registerzresponse adapterszresponse adapterr:type)r N)r!rr%r'r()rr:r;r discriminatorrr )r:rr;radd_response_adapters  z.AdaptersConfiguratorMixin.add_response_adaptercCs|dtdS)N)r> WebobResponse)rr r radd_default_response_adapterssz7AdaptersConfiguratorMixin.add_default_response_adapterscsh|}|ffdd }d|f}d|d|d}|d<||d<j|||fdd S) a% The superdefault :term:`traversal` algorithm that :app:`Pyramid` uses is explained in :ref:`traversal_algorithm`. Though it is rarely necessary, this default algorithm can be swapped out selectively for a different traversal pattern via configuration. The section entitled :ref:`changing_the_traverser` details how to create a traverser class. For example, to override the superdefault traverser used by Pyramid, you might do something like this: .. code-block:: python from myapp.traversal import MyCustomTraverser config.add_traverser(MyCustomTraverser) This would cause the Pyramid superdefault traverser to never be used; instead all traversal would be done using your ``MyCustomTraverser`` class, no matter which object was returned by the :term:`root factory` of this application. Note that we passed no arguments to the ``iface`` keyword parameter. The default value of ``iface``, ``None`` represents that the registered traverser should be used when no other more specific traverser is available for the object returned by the root factory. However, more than one traversal algorithm can be active at the same time. The traverser used can depend on the result of the :term:`root factory`. For instance, if your root factory returns more than one type of object conditionally, you could claim that an alternate traverser adapter should be used against one particular class or interface returned by that root factory. When the root factory returned an object that implemented that class or interface, a custom traverser would be used. Otherwise, the default traverser would be used. The ``iface`` argument represents the class of the object that the root factory might return or an :term:`interface` that the object might implement. To use a particular traverser only when the root factory returns a particular class: .. code-block:: python config.add_traverser(MyCustomTraverser, MyRootClass) When more than one traverser is active, the "most specific" traverser will be used (the one that matches the class or interface of the value returned by the root factory most closely). Note that either ``adapter`` or ``iface`` can be a :term:`dotted Python name` or a Python object. See :ref:`changing_the_traverser` for more information. cs"|dkr t}j|ftdS)N)rrr8r)r)r:rr rrsz9AdaptersConfiguratorMixin.add_traverser..registerZ traverserZ traversersztraverser for %rr:r)r N)r!r%r()rr:rrr=rr )r:rr add_traversers7  z'AdaptersConfiguratorMixin.add_traversercsh|}|ffdd }d|f}d|d|d}|d<||d<j|||fdd S) a .. versionadded:: 1.3 When you add a traverser as described in :ref:`changing_the_traverser`, it's convenient to continue to use the :meth:`pyramid.request.Request.resource_url` API. However, since the way traversal is done may have been modified, the URLs that ``resource_url`` generates by default may be incorrect when resources are returned by a custom traverser. If you've added a traverser, you can change how :meth:`~pyramid.request.Request.resource_url` generates a URL for a specific type of resource by calling this method. The ``adapter`` argument represents a class that implements the :class:`~pyramid.interfaces.IResourceURL` interface. The class constructor should accept two arguments in its constructor (the resource and the request) and the resulting instance should provide the attributes detailed in that interface (``virtual_path`` and ``physical_path``, in particular). The ``resource_iface`` argument represents a class or interface that the resource should possess for this url adapter to be used when :meth:`pyramid.request.Request.resource_url` looks up a resource url adapter. If ``resource_iface`` is not passed, or it is passed as ``None``, the url adapter will be used for every type of resource. See :ref:`changing_resource_url` for more information. cs$|dkr t}j|tftdS)N)rrr8r)resource_iface)r:rr rr5szDAdaptersConfiguratorMixin.add_resource_url_adapter..registerzresource url adapterzresource url adaptersz*resource url adapter for resource iface %rr:rB)r N)r!r%r()rr:rBrr=rr )r:rradd_resource_url_adapters  z2AdaptersConfiguratorMixin.add_resource_url_adapter)N)NN)N)N) r. __module__ __qualname__rr)r rr7r>r@rArCr r r rr s B )  # Ir cCs t|ddS)Nevent)argname)r )Zcalleer r rr-Hsr-N) functoolsrZwebobrr?Zzope.interfacerZpyramid.config.actionsrZpyramid.interfacesrrrZ pyramid.utilr r r-r r r rs     @