§
    8Ý)cØ  ã                   ó,  — d Z ddlZddlmZ ddlZej        ej        ej        hZej        ej        hZ G d„ de	¦  «        Z
 G d„ d¦  «        Z G d„ d	e¦  «        Z G d
„ de¦  «        Z G d„ de¦  «        Z G d„ de¦  «        Z G d„ de¦  «        ZdS )zg
ldap.asyncsearch - handle async LDAP search operations

See https://www.python-ldap.org/ for details.
é    N)Ú__version__c                   ó   — e Zd Zd„ Zd„ ZdS )ÚWrongResultTypec                 óV   — || _         || _        t                               | ¦  «         d S ©N)ÚreceivedResultTypeÚexpectedResultTypesÚ	ExceptionÚ__init__)Úselfr   r	   s      ú2/usr/lib/python3/dist-packages/ldap/asyncsearch.pyr   zWrongResultType.__init__   s,   € Ø0€DÔØ2€DÔÝ×Ò�tÑÔÐÐÐó    c                 óh   — d                      | j        d                     | j        ¦  «        ¦  «        S )Nz3Received wrong result type {} (expected one of {}).z, )Úformatr   Újoinr	   ©r   s    r   Ú__str__zWrongResultType.__str__    s2   € Ø@×GÒGØ
ÔØ
‡i‚i�Ô(Ñ)Ô)ñô ð r   N)Ú__name__Ú
__module__Ú__qualname__r   r   © r   r   r   r      s2   € € € € € ðð ð ð
ð ð ð ð r   r   c                   óL   — e Zd ZdZd„ Z	 	 	 	 	 	 dd„Zd„ Zd„ Zd	„ Zdd
„Z	d„ Z
dS )ÚAsyncSearchHandlerz`
  Class for stream-processing LDAP search results

  Arguments:

  l
    LDAPObject instance
  c                 ó0   — || _         d | _        d| _        d S )Né   )Ú_lÚ_msgIdÚ_afterFirstResult©r   Úls     r   r   zAsyncSearchHandler.__init__1   s   € Ø€D„GØ€D„KØ€DÔÐÐr   Nr   éÿÿÿÿc
                 ób   — | j                              |||||||	||¦	  «	        | _        d| _        dS )a¥  
    searchRoot
        See parameter base of method LDAPObject.search()
    searchScope
        See parameter scope of method LDAPObject.search()
    filterStr
        See parameter filter of method LDAPObject.search()
    attrList=None
        See parameter attrlist of method LDAPObject.search()
    attrsOnly
        See parameter attrsonly of method LDAPObject.search()
    timeout
        Maximum time the server shall use for search operation
    sizelimit
        Maximum number of entries a server should return
        (request client-side limit)
    serverctrls
        list of server-side LDAP controls
    clientctrls
        list of client-side LDAP controls
    r   N)r   Ú
search_extr   r   )
r   Ú
searchRootÚsearchScopeÚ	filterStrÚattrListÚ	attrsOnlyÚtimeoutÚ	sizelimitÚserverctrlsÚclientctrlss
             r   ÚstartSearchzAsyncSearchHandler.startSearch6   sA   € ðB ”'×$Ò$Ø�˜YØˆy˜ [°¸ñô €D„Kð €DÔØ
€Fr   c                 ó   — dS )zd
    Do anything you want after starting search but
    before receiving and processing results
    Nr   r   s    r   ÚpreProcessingz AsyncSearchHandler.preProcessing^   ó   € € € r   c                 ó   — dS )zh
    Do anything you want right after successfully receiving but before
    processing first result
    Nr   r   s    r   ÚafterFirstResultz#AsyncSearchHandler.afterFirstResultd   r0   r   c                 ó   — dS )zI
    Do anything you want after receiving and processing all results
    Nr   r   s    r   ÚpostProcessingz!AsyncSearchHandler.postProcessingj   r0   r   c                 óè  — |                       ¦   «          d}||z   }d}d}d| _        || _        	 d\  }}	|rÈ|€N|	sL| j                             | j        d|¦  «        \  }}	}
}| j        r|                      ¦   «          d| _        |€|	¯L|	snu|t          vrt          |t          ¦  «        ‚|	D ]F}||k     r| j        dz   | _        n)|dk    s||k     r|  
                    ||¦  «         nd}d} n|dz   }ŒGd\  }}	|| _        |°È|r*| j        dk    r| j                             | j        ¦  «         n3# |r+| j        dk    r!| j                             | j        ¦  «         w w w xY w|                      ¦   «          |S )a1  
    ignoreResultsNumber
        Don't process the first ignoreResultsNumber results.
    processResultsCount
        If non-zero this parameters indicates the number of results
        processed is limited to processResultsCount.
    timeout
        See parameter timeout of ldap.LDAPObject.result()
    r   r   )NNN)r/   ÚbeginResultsDroppedÚendResultBreakr   Úresult3r   r   r2   ÚSEARCH_RESULT_TYPESr   Ú_processSingleResultÚabandonr4   )r   ÚignoreResultsNumberÚprocessResultsCountr)   Úresult_counterÚend_result_counterÚgo_aheadÚpartialÚresult_typeÚresult_listÚresult_msgidÚresult_serverctrlsÚresult_items                r   ÚprocessResultsz!AsyncSearchHandler.processResultso   sù  € ð 	×ÒÑÔÐØ€NØ,Ð-@Ñ@ÐØ€HØ€GØ €DÔØ(€DÔð%Ø )Ñ€k�+Øð -ØÐ!¨+Ð!ØDHÄGÇOÂOÐTXÔT_Ð`aÐbiÑDjÔDjÑ
Aˆ+�k ,Ð/AØÔ#ð 'Ø×!Ò!Ñ#Ô#Ð#Ø%&ˆDÔ"ð	 Ð!¨+Ð!ð
 ð 	Ø
ØÕ1Ð1Ð1Ý Õ,?Ñ@Ô@Ð
@à&ð 		,ð 		,ˆKØÐ/Ò/Ð/Ø'+Ô'?ÀÑ'AˆDÔ$Ð$Ø" AÒ%Ð%¨Ð8JÒ)JÐ)JØ×%Ò% k°+Ñ>Ô>Ð>Ð>àˆHØˆGØˆEØ)¨!Ñ+ˆ.ˆ.Ø"+Ñˆ�KØ,ˆÔð- ð -ð0 
ð %�T”[ $Ò&Ð&ØŒ�Š˜œÑ$Ô$Ð$øøð 
ð %�T”[ $Ò&Ð&ØŒ�Š˜œÑ$Ô$Ð$Ð$ð%Ð&øøøà×ÒÑÔÐØ€Ns   ¯CD+ Ä+0Ec                 ó   — dS )zv
    Process single entry

    resultType
        result type
    resultItem
        Single item of a result list
    Nr   ©r   Ú
resultTypeÚ
resultItems      r   r:   z'AsyncSearchHandler._processSingleResultŸ   s	   € ð 	€Dr   )Nr   r!   r   NN)r   r   r!   )r   r   r   Ú__doc__r   r-   r/   r2   r4   rG   r:   r   r   r   r   r   '   s§   € € € € € ðð ðð ð ð ØØØØØð&ð &ð &ð &ðPð ð ðð ð ðð ð ð
.ð .ð .ð .ð`		ð 		ð 		ð 		ð 		r   r   c                   ó   — e Zd ZdZd„ Zd„ ZdS )ÚListz¼
  Class for collecting all search results.

  This does not seem to make sense in the first place but think
  of retrieving exactly a certain portion of the available search
  results.
  c                 óJ   — t                                | |¦  «         g | _        d S r   )r   r   Ú
allResultsr   s     r   r   zList.__init__´   ó#   € Ý×Ò  QÑ'Ô'Ð'Ø€D„O€O€Or   c                 ó>   — | j                              ||f¦  «         d S r   )rP   ÚappendrI   s      r   r:   zList._processSingleResult¸   s#   € Ø„O×Ò˜J zÐ2Ñ3Ô3Ð3Ð3Ð3r   N©r   r   r   rL   r   r:   r   r   r   rN   rN   «   s<   € € € € € ðð ðð ð ð4ð 4ð 4ð 4ð 4r   rN   c                   ó   — e Zd ZdZd„ Zd„ ZdS )ÚDictzJ
  Class for collecting all search results into a dictionary {dn:entry}
  c                 óJ   — t                                | |¦  «         i | _        d S r   )r   r   Ú
allEntriesr   s     r   r   zDict.__init__Á   rQ   r   c                 ó:   — |t           v r|\  }}|| j        |<   d S d S r   )ÚENTRY_RESULT_TYPESrX   ©r   rJ   rK   ÚdnÚentrys        r   r:   zDict._processSingleResultÅ   s1   € ØÕ'Ð'Ð'à�h€bˆØ!€d„o�bÑÐÐð (Ð'r   NrT   r   r   r   rV   rV   ¼   s<   € € € € € ðð ðð ð ð"ð "ð "ð "ð "r   rV   c                   ó    — e Zd ZdZdd„Zd„ ZdS )ÚIndexedDictz„
  Class for collecting all search results into a dictionary {dn:entry}
  and maintain case-sensitive equality indexes to entries
  Nc                 óŽ   — t                                | |¦  «         |pd| _        i                      | j        i ¦  «        | _        d S )Nr   )rV   r   Úindexed_attrsÚfromkeysÚindex)r   r    ra   s      r   r   zIndexedDict.__init__Ò   s?   € Ý‡M‚M�$�qÑÔÐØ&Ð,¨"€DÔØ—’˜TÔ/°Ñ3Ô3€D„J€J€Jr   c                 óü   — |t           v rp|\  }}|| j        |<   | j        D ][}||v rS||         D ]J}	 | j        |         |                              |¦  «         Œ*# t
          $ r |g| j        |         |<   Y ŒGw xY wŒZd S d S r   )rZ   rX   ra   rc   rS   ÚKeyError)r   rJ   rK   r\   r]   ÚaÚvs          r   r:   z IndexedDict._processSingleResult×   s¾   € ØÕ'Ð'Ð'à�h€bˆØ!€d„o�bÑØÔ!ð (ð (ˆ!Ø�ˆ:ˆ:Ø˜”8ð (ð (ˆað(ØŒj˜Œm˜AÔ×%Ò% bÑ)Ô)Ð)Ð)øÝð (ð (ð (Ø#% ˆdŒj˜Œm˜AÑÐÐð(øøøøð (Ð'ð(ð (s   ±&AÁA6Á5A6r   rT   r   r   r   r_   r_   Ì   sA   € € € € € ðð ð
4ð 4ð 4ð 4ð
(ð (ð (ð (ð (r   r_   c                   ó&   — e Zd ZdZdd„Zd„ Zd„ ZdS )Ú
FileWriterz±
  Class for writing a stream of LDAP search results to a file object

  Arguments:
  l
    LDAPObject instance
  f
    File object instance where the LDIF data is written to
  Ú c                 óf   — t                                | |¦  «         || _        || _        || _        d S r   )r   r   Ú_fÚ	headerStrÚ	footerStr)r   r    Úfrm   rn   s        r   r   zFileWriter.__init__ð   s1   € Ý×Ò  QÑ'Ô'Ð'Ø€D„GØ€D„NØ€D„N€N€Nr   c                 óD   — | j                              | j        ¦  «         dS )zs
    The headerStr is written to output after starting search but
    before receiving and processing results.
    N)rl   Úwriterm   r   s    r   r/   zFileWriter.preProcessingö   ó    € ð
 	„G‡M‚M�$”.Ñ!Ô!Ð!Ð!Ð!r   c                 óD   — | j                              | j        ¦  «         dS )zX
    The footerStr is written to output after receiving and
    processing results.
    N)rl   rq   rn   r   s    r   r4   zFileWriter.postProcessingý   rr   r   N©rj   rj   )r   r   r   rL   r   r/   r4   r   r   r   ri   ri   å   sP   € € € € € ðð ðð ð ð ð"ð "ð "ð"ð "ð "ð "ð "r   ri   c                   ó    — e Zd ZdZdd„Zd„ ZdS )Ú
LDIFWriterzÇ
  Class for writing a stream LDAP search results to a LDIF file

  Arguments:

  l
    LDAPObject instance
  writer_obj
    Either a file-like object or a ldif.LDIFWriter instance used for output
  rj   c                 óÌ   — t          |t          j        ¦  «        r|| _        nt          j        |¦  «        | _        t                               | || j        j        ||¦  «         d S r   )Ú
isinstanceÚldifrv   Ú_ldif_writerri   r   Ú_output_file)r   r    Ú
writer_objrm   rn   s        r   r   zLDIFWriter.__init__  s[   € Ý�*�Tœ_Ñ-Ô-ð 6Ø$€dÔÐåœ/¨*Ñ5Ô5€dÔÝ×Ò˜˜Q˜tÔ0Ô=¸iÈ	ÑRÔRÐRÐRÐRr   c                 ó\   — |t           v r"|\  }}| j                             ||¦  «         d S d S r   )rZ   rz   Úunparser[   s        r   r:   zLDIFWriter._processSingleResult  s>   € ØÕ'Ð'Ð'à�h€bˆØ
Ô×Ò  5Ñ)Ô)Ð)Ð)Ð)ð (Ð'r   Nrt   rT   r   r   r   rv   rv     sE   € € € € € ð	ð 	ðSð Sð Sð Sð*ð *ð *ð *ð *r   rv   )rL   Úldapr   ry   ÚRES_SEARCH_ENTRYÚRES_SEARCH_RESULTÚRES_SEARCH_REFERENCEr9   rZ   r
   r   r   rN   rV   r_   ri   rv   r   r   r   ú<module>rƒ      s¢  ððð ð €€€à Ð Ð Ð Ð Ð à €€€ð ÔØÔØÔðÐ ð ÔØÔðÐ ðð ð ð ð �iñ ô ð ðA	ð A	ð A	ð A	ð A	ñ A	ô A	ð A	ðH4ð 4ð 4ð 4ð 4Ðñ 4ô 4ð 4ð""ð "ð "ð "ð "Ðñ "ô "ð "ð (ð (ð (ð (ð (�$ñ (ô (ð (ð2"ð "ð "ð "ð "Ð#ñ "ô "ð "ð@*ð *ð *ð *ð *�ñ *ô *ð *ð *ð *r   