3
,WO @ s@ d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m
Z
dd l m Z dd
l m
Z
dd l mZ dd lmZ dd
lmZ ddlmZmZ ddlmZ ddlmZ yddlmZ W n0 e k
r dd Z e Z Z Z Z!eZY n2X ddl"m Z ddl"m Z ddl"m Z ddl"m#Z# e
dZ$G dd de%eZ&dd Z'G d d d e Z(G d d d e Z)d!d" Z*d@d&d'Z+G d(d) d)e Z,e'Z-dAd*d+Z.G d,d- d-e(Z/dBd.d/Z0G d0d1 d1e Z1dCd2d3Z2G d4d5 d5e Z3G d6d7 d7e Z4G d8d9 d9e3e4Z5d#d#d#e fd:d;Z6G dd?Z8d#S )Dz.Component Architecture configuration handlers
)ConfigurationError)Bool)GlobalInterface) GlobalObject)PythonIdentifier)Tokens)MessageFactory) Interface)
implementedBy)
providedBy)TextLine)getSiteManager) adaptedBygetName)provideInterface)_BLANK)
Permissionc O s t dd S )NzTsecurity proxied components are not supported because zope.security is not available)r )argskw r /usr/lib/python3.6/zcml.py _no_security$ s r )_checker)proxify)protectedFactory)securityAdapterFactoryZzopec @ s e Zd ZdS )ComponentConfigurationErrorN)__name__
__module__ __qualname__r r r r r 1 s r c O s t t | }||| d S )N)getattrr
)Z
methodNamer kwargsmethodr r r handler4 s r# c @ sN e Zd ZeededddZeededddZeededddZd S )
IBasicComponentInformationzComponent to usezPython name of the implementation object. This must identify an object in a module using the full dotted name. If specified, the ``factory`` field must be left blank.F)title descriptionrequiredr z*Permission required to use this component.FactoryzPython name of a factory which can create the implementation object. This must identify an object in a module using the full dotted name. If specified, the ``component`` field must be left blank.N) r r r r _ componentr
permissionfactoryr r r r r$ 8 s r$ c @ s e Zd ZdZeededde dZeededdd Z eed
ed dee
d dZ e ed
eddd Z
eededdd ZeededdddZeededdddZdS )IAdapterDirectivez
Register an adapter
zAdapter factory/factorieszHA list of factories (usually just one) that create the adapter instance.T)r% r& r'
value_typez Interface the component provideszIThis attribute specifies the interface the adapter instance must provide.F)r% r& r' z Specifications to be adaptedz.This should be a list of interfaces or classes)
missing_valuer zEThis adapter is only available, if the principal has this permission.NamezYAdapters can have names.
This attribute allows you to specify the name for this adapter.TrustedaI Make the adapter a trusted adapter
Trusted adapters have unfettered access to the objects they
adapt. If asked to adapt security-proxied objects, then,
rather than getting an unproxied adapter of security-proxied
objects, you get a security-proxied adapter of unproxied
objects.
)r% r& r' defaultLocatezMake the adapter a locatable adapter
Located adapter should be used if a non-public permission
is used.
N)r r r __doc__r r) r r, r providesobjectfor_r r+ r namer trustedlocater r r r r- S sH
r- c s fdd} d |_ |S )Nc s x D ] }|| } qW | S )Nr )obf) factoriesr r r, s
z!_rolledUpFactory..factoryr )r, )r= r, r )r= r _rolledUpFactory s
r> N Fc C s |d kr0t |dkr t|d }|d kr0tdt|}|d krt |dkrptt|d }t |dkrp|d }|d krtd|dkrt |dkrt|d }|} t | dkr| d }n@t | dk rtdn*t | dkrt |dkrtdnt| }|d k rt |||}|s&|d k s&|r4t
||||}| j d|||ft d ||||| j
fd
| j d td|fd
|rx,|D ]$}
|
d k rz| j d td|
fd
qzW d S ) N r zJNo for attribute was provided and can't determine what the factory adapts.z Missing 'provides' attributer? zNo factory specifiedz-Can't use multiple factories and multiple foradapterregisterAdapter)
discriminatorcallabler )lenr TypeErrortuplelistr
r r r> r r actionr# infor ) _contextr, r5 r7 r+ r8 r9 r: pr= ifacer r r rA sZ
rA c @ s e Zd ZdZeededddZeededddZeeded ddZ e
ed
ed dee d d
Z e
ededddZeededdddZeededdddZdS )ISubscriberDirectivez
Register a subscriber
zSubscriber factoryz1A factory used to create the subscriber instance.F)r% r& r' ZHandlerz&A callable object that handles events.z Interface the component provideszIThis attribute specifies the interface the adapter instance must provide.z5Interfaces or classes that this subscriber depends onz.This should be a list of interfaces or classes)r/ )r% r& r' r. r zHThis subscriber is only available, if the principal has this permission.r1 aX Make the subscriber a trusted subscriber
Trusted subscribers have unfettered access to the objects they
adapt. If asked to adapt security-proxied objects, then,
rather than getting an unproxied subscriber of security-proxied
objects, you get a security-proxied subscriber of unproxied
objects.
)r% r& r' r2 r3 zMake the subscriber a locatable subscriber
Located subscribers should be used if a non-public permission
is used.
N)r r r r4 r r) r, r# r r5 r r6 r7 r r+ r r9 r: r r r r rN sF rN c C s< |d kr.|d krt d|d k r(t d|}n |d k r>t d|d krNt d|d krnt|}|d krnt d|d k rt|||}t|}|s|d k s|rt||||}|d k r| jd td||t| jfd n | jd td|||t| jfd |d k r
| jd t d |fd x,|D ]$}|d k r| jd t d |fd qW d S )
Nz No factory or handler providedz Cannot use handler with providesz Cannot use handler with factoryz@You must specify a provided interface when registering a factoryzWNo for attribute was provided and can't determine what the factory (or handler) adapts.ZregisterHandler)rC rD r ZregisterSubscriptionAdapterr? )
rF r r rG r rI _handlerr rJ r ) rK r7 r, r# r5 r+ r9 r: rM r r r
subscriber& sT
rP c @ s< e Zd ZdZeededddZeededddZdS ) IUtilityDirectivezRegister a utility.zProvided interfacez"Interface provided by the utility.F)r% r& r' r0 zTName of the registration. This is used by application code when locating a utility.N) r r r r4 r r) r5 r r8 r r r r rQ d s rQ c C s |r|rt d|d krT|r*tt|}n tt|}t|dkrL|d }nt d|dkrr|rjt|}nt|}|d k rt|||d}| jd||ftd|||| j ft
|d d
| jd t d|fd d S ) Nz$Can't specify factory and component.r@ r z Missing 'provides' attributer? )r5 r+ utilityZregisterUtility)r, )rC rD r r )rC rD r ) rF rH r
r rE r r rI r# rJ dictr )rK r5 r* r, r+ r8 r r r rR t s0
rR c @ s@ e Zd ZdZeedddZeedddZeedddZ dS ) IInterfaceDirectivez
Define an interface
r T)r% r' zInterface typeFr0 N)
r r r r4 r r) interfacetyper r8 r r r r rT s rT c C s | j d t|||fd d S )N)rC rD r )rI r )rK rU rV r8 r r r rU s rU c @ s e Zd ZdZeededdee ddZe ededd d
Z
eed ed d d
Z eed
edd e dZ
eededd e dZdS )IBasicViewInformationz,This is the basic information for all views.z*Specifications of the objects to be viewedz7This should be a list of interfaces or classes
T)r/ )r% r& r' r. r z&The permission needed to use the view.F)r% r& r' ZClassz2A class that provides attributes used by the view.z6Interface that is also allowed if user has permission.a=
By default, 'permission' only applies to viewing the view and
any possible sub views. By specifying this attribute, you can
make the permission also apply to everything described in the
supplied interface.
Multiple interfaces can be provided, separated by
whitespace.zAView attributes that are also allowed if the user has permission.z
By default, 'permission' only applies to viewing the view and
any possible sub views. By specifying 'allowed_attributes',
you can make the permission also apply to the extra attributes
on the view object.N)r r r r4 r r) r r6 r7 r r+ Zclass_r allowed_interfacer allowed_attributesr r r r rW s8
rW c @ sP e Zd ZdZeededdedZeededde dZ
eed dd
Z d S ) IBasicResourceInformationz)
Basic information for resources
zThe name of the resource.z3The name shows up in URLs/paths. For example 'foo'.T)r% r& r' r2 z&The interface this component provides.zi
A view can provide an interface. This would be used for
views that support other views.Fz Request type)r% r' N) r r r r4 r r) r r8 r r r5 rV r r r r rZ s rZ c @ s$ e Zd ZdZeedde dZdS )IViewDirectivez Register a view for a componentr( F)r% r' r. N)r r r r4 r r) r r, r r r r r[ s
r[ c sJ |s|r| rt d|d k rNt| |||} G dd dt}
|
|d | |d< |sZt dt|}| t dkr| d }nNt dk rt dn8t dkrt|dkrt dn fd d
} d |_||f }| jd |||ftd ||||| jfd
| jd t d|fd
|d k rFx,|D ]$} | d k r | jd t d| fd
q W d S )NzF'permission' required with 'allowed_interface' or 'allowed_attributes'c @ s e Zd ZdZdd Zdd ZdS )zview..ProxyViewz#Class to create simple proxy views.c S s || _ || _d S )N)r, checker)selfr, r\ r r r __init__ s z view..ProxyView.__init__c W s t | j| | jS )N)r r, r\ )r] Zobjectsr r r __call__# s z view..ProxyView.__call__N)r r r r4 r^ r_ r r r r ProxyView s r` r@ zNo for interfaces specifiedr zNo view factory specifiedz-Can't use multiple factories and multiple forc s, x d d D ] }|| } qW d | |S )Nr@ ra r )r; requestr< )r= r r r, 7 s zview..factoryviewrB )rC rD r r? ra ra )
r r r6 rG rE r, rI r# rJ r ) rK r, rV r8 r7 r+ rX rY r5 r\ r` rM r )r= r rc
sN
rc c @ s8 e Zd ZdZeedde dZeedde dZ dS )IResourceDirectivezRegister a resourcez6Interface that is also allowed if user has permission.F)r% r' r. z=View attributes that are also allowed if user has permission.N)
r r r r4 r r) r rX r rY r r r r rd V s
rd c
C s |s|r| rt d|d k rDt| |||}||fdd} || _| }| jd|||ftd||f||| jfd | jd td|fd | jd td|fd d S )NzDMust use name attribute with allowed_interface or allowed_attributesc S s t || |S )N)r )rb r, r\ r r r
proxyResourcex s z resource..proxyResourceresourcerB )rC rD r r? )r r r, rI r# rJ r )
rK r, rV r8 r+ rX rY r5 r\ re r r r rf g s.
rf )NNNr? FF)NNNNNFF)NNNNr? )Nr? )9r4 Z zope.configuration.exceptionsr Zzope.configuration.fieldsr r r r r Zzope.i18nmessageidr Zzope.interfacer r
r Z zope.schemar Zzope.component._apir
Zzope.component._declarationr r Zzope.component.interfacer Zzope.component._compatr Zzope.security.zcmlr ImportErrorr r r r ZsecurityZzope.component.securityr r)
ValueErrorr r# r$ r- r> rA rN rO rP rQ rR rT rU rW rZ r[ rc rd rf r r r r sl
E
@A
=
#
3
H