3
6ßL]×`  ã               @   sä   d Z ddlmZmZmZmZmZ ddlmZmZ ddl	m
Z
 ddlmZ ddlmZmZ ddlmZmZ dd	lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ dZdZdZdZeg eg ediZ G dd„ deƒZ!dS )z) The base class for all naming contexts. é    )ÚAnyÚDictÚEventÚ	HasTraitsÚInstance)ÚPropertyÚStr)ÚTypeManageré   )ÚBinding)ÚInvalidNameErrorÚNameAlreadyBoundError)ÚNameNotFoundErrorÚNotContextError)ÚOperationNotSupportedError)ÚNamingEvent)Únaming_manager)ÚObjectFactory)ÚStateFactory)Úmake_unique_namezapptools.naming.factory.initialzapptools.naming.factory.objectzapptools.naming.factory.statez$apptools.naming.factory.type.managerNc               @   sv  e Zd ZdZeZeZeZeZee	ƒZ
eeƒZeeeƒƒZeeƒZeeƒZeeƒZeeƒZeeƒZeeeƒZdd„ Zdd„ ZdEdd„ZdFd	d
„Zdd„ Zdd„ Zdd„ Z dd„ Z!dd„ Z"dd„ Z#dd„ Z$dd„ Z%dGdd„Z&dHdd„Z'd d!„ Z(d"d#„ Z)d$d%„ Z*d&d'„ Z+d(d)„ Z,d*d+„ Z-d,d-„ Z.d.d/„ Z/d0d1„ Z0d2d3„ Z1d4d5„ Z2d6d7„ Z3d8d9„ Z4d:d;„ Z5d<d=„ Z6d>d?„ Z7d@dA„ Z8dBdC„ Z9dDS )IÚContextz) The base class for all naming contexts. c             C   s   dS )až  
        Return the name of the context within its own namespace.

        That is the full-path, through the namespace this context participates
        in, to get to this context.  For example, if the root context of the
        namespace was called 'Foo', and there was a subcontext of that called
        'Bar', and we were within that and called 'Baz', then this should
        return 'Foo/Bar/Baz'.

        Ú © )Úselfr   r   ú=/tmp/pip-install-5sebvq2j/apptools/apptools/naming/context.pyÚ_get_namespace_nameo   s    zContext._get_namespace_namec             C   s   | j j| jƒS )z£ Returns the type manager in the context's environment.

        This will return None if no type manager was used to create the initial
        context.

        )ÚenvironmentÚgetÚTYPE_MANAGER)r   r   r   r   Ú_get_type_manager‰   s    zContext._get_type_managerFc             C   sÄ   t |ƒdkrtdƒ‚| j|ƒ}t |ƒdkrh|d }| j|ƒrDt|ƒ‚| j||ƒ tt||| d�d�| _nX| j|d ƒs–|rŠ| j	|d ƒ nt
|d ƒ‚| j|d ƒ}|jdj|dd… ƒ||ƒ dS )z“ Binds a name to an object.

        If 'make_contexts' is True then any missing intermediate contexts are
        created automatically.

        r   z
empty namer
   )ÚnameÚobjÚcontext)Únew_bindingú/N)Úlenr   Ú_parse_nameÚ	_is_boundr   Ú_bindr   r   Úobject_addedÚ_create_subcontextr   Ú_get_next_contextÚbindÚjoin)r   r    r!   Úmake_contextsÚ
componentsÚatomÚnext_contextr   r   r   r,   •   s"    

zContext.bindc             C   s®   t |ƒdkrtdƒ‚| j|ƒ}t |ƒdkrR| j|d |ƒ tt||| d�d�| _nX| j|d ƒs€|rt| j|d ƒ nt	|d ƒ‚| j
|d ƒ}|jdj|dd… ƒ||ƒ dS )aÞ   Binds an object to a name that may already be bound.

        If 'make_contexts' is True then any missing intermediate contexts are
        created automatically.

        The object may be a different object but may also be the same object
        that is already bound to the specified name. The name may or may not be
        already used. Think of this as a safer version of 'bind' since this
        one will never raise an exception regarding a name being used.

        r   z
empty namer
   )r    r!   r"   )r#   r$   N)r%   r   r&   Ú_rebindr   r   Úobject_changedr'   r*   r   r+   Úrebindr-   )r   r    r!   r.   r/   r1   r   r   r   r4   Â   s    
zContext.rebindc             C   s´   t |ƒdkrtdƒ‚| j|ƒ}t |ƒdkrp|d }| j|ƒsDt|ƒ‚| j|ƒ}| j|ƒ tt||| d�d�| _	n@| j|d ƒsŠt|d ƒ‚| j
|d ƒ}|jdj|dd… ƒƒ dS )z Unbinds a name. r   z
empty namer
   )r    r!   r"   )Úold_bindingr$   N)r%   r   r&   r'   r   Ú_lookupÚ_unbindr   r   Úobject_removedr+   Úunbindr-   )r   r    r/   r0   r!   r1   r   r   r   r9   î   s     



zContext.unbindc             C   sÎ   t |ƒdkst |ƒdkr tdƒ‚| j|ƒ}| j|ƒ}t |ƒdkrªt |ƒdkrª| j|ƒs^t|ƒ‚| j|ƒrpt|ƒ‚| j||ƒ | j|ƒ}tt	||| d�t	||| d�d�| _
n | j|ƒ}| j||ƒ | j|ƒ dS )z  Binds a new name to an object. r   z
empty namer
   )r    r!   r"   )r5   r#   N)r%   r   r&   r'   r   r   Ú_renamer6   r   r   Úobject_renamedÚlookupr,   r9   )r   Úold_nameÚnew_nameZold_componentsZnew_componentsr!   r   r   r   Úrename  s$    




	

zContext.renamec             C   s�   t |ƒdkr| S | j|ƒ}t |ƒdkrL|d }| j|ƒs@t|ƒ‚| j|ƒ}n@| j|d ƒsft|d ƒ‚| j|d ƒ}|jdj|dd… ƒƒ}|S )z+ Resolves a name relative to this context. r   r
   r$   N)r%   r&   r'   r   r6   r+   r<   r-   )r   r    r/   r0   r!   r1   r   r   r   r<   G  s    

zContext.lookupc             C   s”   t |ƒdkrtdƒ‚| j|ƒ}t |ƒdkrP|d }| j|ƒsDt|ƒ‚| j|ƒ}n@| j|d ƒsjt|d ƒ‚| j|d ƒ}|jdj|dd… ƒƒ}|S )z; Looks up the binding for a name relative to this context. r   z
empty namer
   r$   N)	r%   r   r&   r'   r   Ú_lookup_bindingr+   Úlookup_bindingr-   )r   r    r/   r0   Úbindingr1   r   r   r   rA   j  s    

zContext.lookup_bindingc             C   s�   t |ƒdkr| S | j|ƒ}t |ƒdkrL|d }| j|ƒs@t|ƒ‚| j|ƒ}n@| j|d ƒsft|d ƒ‚| j|d ƒ}|jdj|dd… ƒƒ}|S )z› Resolves a name relative to this context.

        The name MUST resolve to a context. This method is useful to return
        context adapters.

        r   r
   r$   N)r%   r&   r'   r   r+   r<   r-   )r   r    r/   r0   r!   r1   r   r   r   Úlookup_context‰  s    	

zContext.lookup_contextc             C   sª   t |ƒdkrtdƒ‚| j|ƒ}t |ƒdkrf|d }| j|ƒrDt|ƒ‚| j|ƒ}tt||| d�d�| _n@| j|d ƒs€t	|d ƒ‚| j
|d ƒ}|jdj|dd… ƒƒ}|S )z Creates a sub-context. r   z
empty namer
   )r    r!   r"   )r#   r$   N)r%   r   r&   r'   r   r*   r   r   r)   r   r+   Úcreate_subcontextr-   )r   r    r/   r0   Úsubr1   r   r   r   rD   ¯  s    


zContext.create_subcontextc             C   sÆ   t |ƒdkrtdƒ‚| j|ƒ}t |ƒdkr‚|d }| j|ƒsDt|ƒ‚| j|ƒ}| j|ƒs`t|ƒ‚| j|ƒ t	t
||| d�d�| _n@| j|d ƒsœt|d ƒ‚| j|d ƒ}|jdj|dd… ƒƒ dS )z Destroys a sub-context. r   z
empty namer
   )r    r!   r"   )r5   r$   N)r%   r   r&   r'   r   r6   Ú_is_contextr   Ú_destroy_subcontextr   r   r8   r+   Údestroy_subcontextr-   )r   r    r/   r0   r!   r1   r   r   r   rH   Ó  s$    




zContext.destroy_subcontextc             C   s   t || jdƒdd�S )z} Returns a name that is unique within the context.

        The name returned will start with the specified prefix.

        r   z%s (%d))ÚexistingÚformat)r   Ú
list_names)r   Úprefixr   r   r   Úget_unique_nameû  s    zContext.get_unique_namer   c             C   sd   t |ƒdkr| jƒ }nJ| j|ƒ}| j|d ƒs:t|d ƒ‚| j|d ƒ}|jdj|dd… ƒƒ}|S )z% Lists the names bound in a context. r   r$   r
   N)r%   Ú_list_namesr&   r'   r   r+   rK   r-   )r   r    Únamesr/   r1   r   r   r   rK     s    

zContext.list_namesc             C   sd   t |ƒdkr| jƒ }nJ| j|ƒ}| j|d ƒs:t|d ƒ‚| j|d ƒ}|jdj|dd… ƒƒ}|S )z" Lists the bindings in a context. r   r$   r
   N)r%   Ú_list_bindingsr&   r'   r   r+   Úlist_bindingsr-   )r   r    Úbindingsr/   r1   r   r   r   rQ     s    

zContext.list_bindingsc             C   s’   t |ƒdkrd}n|| j|ƒ}t |ƒdkrN|d }| j|ƒsBt|ƒ‚| j|ƒ}n@| j|d ƒsht|d ƒ‚| j|d ƒ}|jdj|dd… ƒƒ}|S )z1 Returns True if the name is bound to a context. r   Tr
   r$   N)r%   r&   r'   r   rF   r+   Ú
is_contextr-   )r   r    rS   r/   r0   r1   r   r   r   rS   /  s    

zContext.is_contextc             C   s(   |dkrg S g }g }| j |||i ƒ |S )z: Returns a list of namespace names that are bound to obj. N)Ú_search)r   r!   rO   Úpathr   r   r   ÚsearchP  s    zContext.searchc             C   s
   |j dƒS )zg Parse a name into a list of components.

        e.g. 'foo/bar/baz' -> ['foo', 'bar', 'baz']

        r$   )Úsplit)r   r    r   r   r   r&   e  s    zContext._parse_namec             C   s
   || j kS )z" Is a name bound in this context? )Ú	_bindings)r   r    r   r   r   r'   n  s    zContext._is_boundc             C   s   | j | }tj||| ƒS )z" Looks up a name in this context. )rX   r   Zget_object_instance)r   r    r!   r   r   r   r6   s  s    
zContext._lookupc             C   s   t || j|ƒ| d�S )z2 Looks up the binding for a name in this context. )r    r!   r"   )r   r6   )r   r    r   r   r   r@   z  s    zContext._lookup_bindingc             C   s   t j||| ƒ}|| j|< dS )z, Binds a name to an object in this context. N)r   Zget_state_to_bindrX   )r   r    r!   Ústater   r   r   r(     s    
zContext._bindc             C   s   | j ||ƒ dS )z. Rebinds a name to an object in this context. N)r(   )r   r    r!   r   r   r   r2   ‡  s    zContext._rebindc             C   s   | j |= dS )z# Unbinds a name from this context. N)rX   )r   r    r   r   r   r7   Ž  s    zContext._unbindc             C   s   | j | | j |< | j |= dS )z$ Renames an object in this context. N)rX   )r   r=   r>   r   r   r   r:   •  s    zContext._renamec             C   s   | j | jd�}|| j|< |S )z( Creates a sub-context of this context. )r   )Ú	__class__r   rX   )r   r    rE   r   r   r   r*      s    
zContext._create_subcontextc             C   s   | j |= dS )z) Destroys a sub-context of this context. N)rX   )r   r    r   r   r   rG   ¨  s    zContext._destroy_subcontextc             C   s4   g }x*| j ƒ D ]}|jt|| j|ƒ| d�ƒ qW |S )z% Lists the bindings in this context. )r    r!   r"   )rN   Úappendr   r6   )r   rR   r    r   r   r   rP   ¯  s
    zContext._list_bindingsc             C   s   t | jjƒ ƒS )z( Lists the names bound in this context. )ÚlistrX   Úkeys)r   r   r   r   rN   º  s    zContext._list_namesc             C   s   | j |ƒdk	S )z/ Returns True if a name is bound to a context. N)r+   )r   r    r   r   r   rF   ¿  s    zContext._is_contextc             C   s8   | j |ƒ}t|tƒr|}n| j|ƒ}|dkr4t|ƒ‚|S )z Returns the next context. N)r6   Ú
isinstancer   Ú_get_context_adapterr   )r   r    r!   r1   r   r   r   r+   Ä  s    


zContext._get_next_contextc             C   sŠ   x„| j ƒ D ]x}|j|kr<|j|jƒ |jdj|ƒƒ |jƒ  t|jtƒr
|j|kr
|j|jƒ d||j< |jj||||ƒ |jƒ  q
W dS )z‘ Append to names any name bound to obj.
            Join path and name with '/' to for a complete name from the
            top context.
        r$   TN)	rQ   r!   r[   r    r-   Úpopr^   r   rT   )r   r!   rO   rU   ZsearchedrB   r   r   r   rT   Ù  s    


zContext._searchc             C   s*   | j dk	r"| j j|t| j| d�}nd}|S )zj Returns a context adapter for an object.

        Returns None if no such adapter is available.

        N)r   r"   )Útype_managerZ	object_asr   r   )r   r!   Úadapterr   r   r   r_   ó  s
    
zContext._get_context_adapterN)F)F)r   )r   ):Ú__name__Ú
__module__Ú__qualname__Ú__doc__ÚINITIAL_CONTEXT_FACTORYÚOBJECT_FACTORIESÚSTATE_FACTORIESr   r   ÚENVIRONMENTr   r   r   Znamespace_namer   r	   ra   r   r   r)   r3   r8   r;   Zcontext_changedr   rX   r   r   r,   r4   r9   r?   r<   rA   rC   rD   rH   rM   rK   rQ   rS   rV   r&   r'   r6   r@   r(   r2   r7   r:   r*   rG   rP   rN   rF   r+   rT   r_   r   r   r   r   r   6   s\   

-
,'2#&$(

!	r   )"rf   Z
traits.apir   r   r   r   r   r   r   Zapptools.type_manager.apir	   rB   r   Ú	exceptionr   r   r   r   r   Znaming_eventr   r   Zobject_factoryr   Zstate_factoryr   Úunique_namer   rg   rh   ri   r   rj   r   r   r   r   r   Ú<module>   s(   