o
    �¨Êh³  ã                   @   s  d dl mZmZmZ d dlZd dlZd dlZd dlZd dlZd dl	Z	d dl
Z
d dlmZ d dlmZmZmZ d dlZz
d dlmZmZ W n eyQ   d ZZY nw zd dlZW n eye   d dlZY nw zd dlmZ W n ey}   d dlmZ Y nw zd dlmZ W n ey•   d dlmZ Y nw zd dlmZ W n ey«   d dlZY nw zd dl m!Z! W n eyÃ   d dl"m!Z! Y nw ze#Z$W n e%yÕ   e&Z$e'Z(Y nw d	Z)d
gZ*zee+ƒZ,e,j-Z.e,j/Z0W n eyö   dZ.ee.ƒZ0Y nw dd„ Z1e	 2d¡Z3dZ4G dd„ dej5ƒZ6e 7d¡Z8e6ƒ Z9e8 :e9¡ ej; <dd¡ =¡ dv �r3e8 >ej?¡ e @¡ ZAe8 :eA¡ dd„ ZBeBƒ ZCdd„ ZDdd„ ZEdd„ ZFd2dd„ZGd d!„ ZHd"d#„ ZIG d$d%„ d%eJƒZKG d&d'„ d'eLƒZMG d(d
„ d
eLƒZNG d)d*„ d*eLƒZOd+ZPd,d-„ ZQG d.d/„ d/eNƒZRG d0d1„ d1eLƒZSdS )3é    )Úabsolute_importÚprint_functionÚunicode_literalsN)ÚElementTree)ÚDistributionNotFoundÚget_distributionÚparse_version)ÚKazooClientÚ
KazooState)Ú	urlencode)Úquote)ÚHTTPExceptionz5Daniel Lindsley, Joseph Kocherhans, Jacob Kaplan-MossÚSolrz0.0.dev0c                   C   ó   t S ©N)Ú__version__© r   r   ú8/var/www/html/env/lib/python3.10/site-packages/pysolr.pyÚget_versionK   ó   r   zn^(?P<year>\d{4})-(?P<month>\d{2})-(?P<day>\d{2})T(?P<hour>\d{2}):(?P<minute>\d{2}):(?P<second>\d{2})(\.\d+)?Z$Ú_childDocuments_c                   @   s   e Zd Zdd„ ZdS )ÚNullHandlerc                 C   s   d S r   r   )ÚselfÚrecordr   r   r   ÚemitU   r   zNullHandler.emitN)Ú__name__Ú
__module__Ú__qualname__r   r   r   r   r   r   T   s    r   ÚpysolrÚDEBUG_PYSOLRÚ )ÚtrueÚ1c                   C   s    zt  W dS  ty   Y dS w )NFT)Ú
basestringÚ	NameErrorr   r   r   r   Úis_py3f   s   ÿr%   c                 C   sf   t rt| tƒr| jddd�} | S t| tƒst| ƒ} | S t| tƒr(|  dd¡} | S t| tƒs1t| ƒ} | S )z9
    Forces a bytestring to become a Unicode string.
    úutf-8Úreplace©Úerrors)ÚIS_PY3Ú
isinstanceÚbytesÚdecodeÚstrr#   Úunicode©Úvaluer   r   r   Úforce_unicodeq   s   


÷
û
ýr2   c                 C   s6   t rt| tƒr|  dd¡} | S t| tƒr|  d¡} | S )z9
    Forces a Unicode string to become a bytestring.
    r&   Úbackslashreplace)r*   r+   r.   Úencoder/   r0   r   r   r   Úforce_bytes…   s   

ý
r5   c                 C   s   dd„ }t  d|| ¡S )zÿ
    Removes HTML or XML character references and entities from a text string.

    @param text The HTML (or XML) source text.
    @return The plain text, as a Unicode string, if necessary.

    Source: http://effbot.org/zone/re-sub.htm#unescape-html
    c                 S   s    |   d¡}|d d… dkr7z|d d… dkr"tt|dd… dƒƒW S tt|dd… ƒƒW S  ty6   Y |S w zttj|dd…  ƒ}W |S  tyO   Y |S w )	Nr   é   z&#é   z&#xéÿÿÿÿé   é   )ÚgroupÚunicode_charÚintÚ
ValueErrorÚhtmlentitiesÚname2codepointÚKeyError)ÚmÚtextr   r   r   Úfixupœ   s"   
øþþzunescape_html.<locals>.fixupz&#?\w+;)ÚreÚsub)rC   rD   r   r   r   Úunescape_html“   s   	rG   c                 C   s‚   t rt| |ƒS t| dƒr|  ¡ } tƒ }| D ]&\}}| d¡}t|ttfƒr2| |dd„ |D ƒf¡ q| |t	|ƒf¡ qt||ƒS )zœ
    UTF-8-safe version of safe_urlencode

    The stdlib safe_urlencode prior to Python 3.x chokes on UTF-8 values
    which can't fail down to ascii.
    Úitemsr&   c                 S   s   g | ]}t |ƒ‘qS r   )r5   ©Ú.0Úir   r   r   Ú
<listcomp>Ä   s    z"safe_urlencode.<locals>.<listcomp>)
r*   r   ÚhasattrrH   Úlistr4   r+   ÚtupleÚappendr5   )ÚparamsÚdoseqÚ
new_paramsÚkÚvr   r   r   Úsafe_urlencode±   s   



rV   c                 C   sP   d|   ko	dkn  p'| dv p'd|   kodkn  p'd|   ko%dkS   S )z¿
    Defines whether char is valid to use in xml document

    XML standard defines a valid char as::

    Char ::= #x9 | #xA | #xD | [#x20-#xD7FF] | [#xE000-#xFFFD] | [#x10000-#x10FFFF]
    é    iÿ×  )é	   é
   é   i à  iýÿ  i   iÿÿ r   )rK   r   r   r   Úis_valid_xml_char_ordinalË   s   
ÿþüür[   c                 C   s   d  dd„ | D ƒ¡S )z¤
    Cleans string from invalid xml chars

    Solution was found there::

    http://stackoverflow.com/questions/8733233/filtering-out-certain-bytes-in-python
    r    c                 s   s    � | ]}t t|ƒƒr|V  qd S r   )r[   Úord)rJ   Úcr   r   r   Ú	<genexpr>ä   s   € z#clean_xml_string.<locals>.<genexpr>)Újoin)Úsr   r   r   Úclean_xml_stringÜ   s   ra   c                   @   s   e Zd ZdS )Ú	SolrErrorN)r   r   r   r   r   r   r   rb   ç   s    rb   c                   @   s(   e Zd ZdZdd„ Zdd„ Zdd„ ZdS )	ÚResultsa  
    Default results class for wrapping decoded (from JSON) solr responses.

    Required ``decoded`` argument must be a Solr response dictionary.
    Individual documents can be retrieved either through ``docs`` attribute
    or by iterating over results instance.

    Example::

        results = Results({
            'response': {
                'docs': [{'id': 1}, {'id': 2}, {'id': 3}],
                'numFound': 3,
            }
        })

        # this:
        for doc in results:
            print doc

        # ... is equivalent to:
        for doc in results.docs:
            print doc

        # also:
        list(results) == results.docs

    Note that ``Results`` object does not support indexing and slicing. If you
    need to retrieve documents by index just use ``docs`` attribute.

    Other common response metadata (debug, highlighting, qtime, etc.) are available as attributes.

    The full response from Solr is provided as the `raw_response` dictionary for use with features which
    change the response format.
    c                 C   s¬   || _ | d¡p	i }| dd¡| _| dd¡| _| di ¡| _| di ¡| _| di ¡| _| d	i ¡| _| d
i ¡| _| di ¡ dd ¡| _	| di ¡| _
| dd ¡| _d S )NÚresponseÚdocsr   ÚnumFoundr   ÚdebugÚhighlightingÚfacet_countsÚ
spellcheckÚstatsÚresponseHeaderÚQTimeÚgroupedÚnextCursorMark)Úraw_responseÚgetre   Úhitsrg   rh   Úfacetsrj   rk   Úqtimern   ro   )r   ÚdecodedÚresponse_partr   r   r   Ú__init__  s   zResults.__init__c                 C   ó
   t | jƒS r   )Úlenre   ©r   r   r   r   Ú__len__"  ó   
zResults.__len__c                 C   rx   r   )Úiterre   rz   r   r   r   Ú__iter__%  r|   zResults.__iter__N)r   r   r   Ú__doc__rw   r{   r~   r   r   r   r   rc   ë   s
    $rc   c                   @   s   e Zd ZdZddedddddfdd„Zd	d
„ Zdd„ Zd:dd„Zd;dd„Z	d<dd„Z
d=dd„Zd>dd„Z		d?dd„Zdd„ Zdd „ Zd!d"„ Zd#d$„ Zd%d&„ Zd<d'd(„Zd=d)d*„Zd>d+d,„Zd@d-d.„Z		dAd/d0„ZdBd1d2„ZdCd3d4„ZdDd5d6„ZdEd8d9„ZdS )Fr   a  
    The main object for working with Solr.

    Optionally accepts ``decoder`` for an alternate JSON decoder instance.
    Default is ``json.JSONDecoder()``.

    Optionally accepts ``timeout`` for wait seconds until giving up on a
    request. Default is ``60`` seconds.

    Optionally accepts ``results_cls`` that specifies class of results object
    returned by ``.search()`` and ``.more_like_this()`` methods.
    Default is ``pysolr.Results``.

    Usage::

        solr = pysolr.Solr('http://localhost:8983/solr')
        # With a 10 second timeout.
        solr = pysolr.Solr('http://localhost:8983/solr', timeout=10)

        # with a dict as a default results class instead of pysolr.Results
        solr = pysolr.Solr('http://localhost:8983/solr', results_cls=dict)

    Né<   ÚselectFTc
           
      C   sR   |pt  ¡ | _|| _|| _|  ¡ | _d | _|| _|| _	|| _
|| _|	| _|| _d S r   )ÚjsonÚJSONDecoderÚdecoderÚurlÚtimeoutÚ_get_logÚlogÚsessionÚresults_clsÚsearch_handlerÚuse_qt_paramÚauthÚverifyÚalways_commit)
r   r…   r„   r†   rŠ   r‹   rŒ   r�   r�   rŽ   r   r   r   rw   B  s   

zSolr.__init__c                 C   s,   | j d u rt ¡ | _ d| j _| j| j _| j S )NF)r‰   ÚrequestsÚSessionÚstreamrŽ   rz   r   r   r   Úget_sessionP  s
   


zSolr.get_sessionc                 C   r   r   )ÚLOGrz   r   r   r   r‡   W  r   zSolr._get_logr    c                 C   s*   t |ƒrd | j d¡| d¡g¡S | jS )Nú/)ry   r_   r…   ÚrstripÚlstrip)r   Úpathr   r   r   Ú_create_full_urlZ  s   zSolr._create_full_urlc              
   C   s4  |   |¡}| ¡ }|}|d u ri }|d u rd}n	t|tƒs!t|ƒ}| j d|||d d… ¡ t ¡ }|  ¡ }	zt	|	|ƒ}
W n t
yP } ztd |¡ƒ‚d }~ww |}|d ur[t|ƒ}z|
||||| j| jd�}W ni tjjy‹ } zd}| jj|||dd� t|||f ƒ‚d }~w tjjy± } zd	}||f}| jj|g|¢R d
diŽ t|| ƒ‚d }~w tyÒ } zd}| jj||||dd� t||||f ƒ‚d }~ww t ¡ }| j d|||d d… || |j¡ t|jƒdk�rd}|  |¡}| jj||j|d|j|j||dœid� t||j|f ƒ‚t|jƒS )Nr    z/Starting request to '%s' (%s) with body '%s'...rY   z'Unable to use unknown HTTP method '{0}.)ÚdataÚheadersÚfilesr†   r�   z'Connection to server '%s' timed out: %sT©Úexc_infoznFailed to connect to server at '%s', are you sure that URL is correct? Checking it in a browser might help: %srž   zUnhandled error: %s %s: %szBFinished '%s' (%s) with body '%s' in %0.3f seconds, with status %séÈ   z*Solr responded with an error (HTTP %s): %srš   )r›   rd   Úrequest_bodyÚrequest_headers©Úextra)r™   Úlowerr+   r.   Úreprrˆ   rg   Útimer“   ÚgetattrÚAttributeErrorrb   Úformatr5   r†   r�   r�   Ú
exceptionsÚTimeoutÚerrorÚConnectionErrorr   ÚinfoÚstatus_coder=   Ú_extract_errorr›   Úcontentr2   )r   Úmethodr˜   Úbodyr›   rœ   r…   Úlog_bodyÚ
start_timer‰   Úrequests_methodÚerrÚ
bytes_bodyÚrespÚerror_messagerQ   Úend_timeÚsolr_messager   r   r   Ú_send_requesta  sx   

ÿ€ÿ

ÿ€€€ýÿ
ýÿ
zSolr._send_requestc                 C   s~   d|d< |p| j }d}|r| jr||d< n|}t|dƒ}t|ƒdk r.d||f }|  d|¡S d	| }d
di}| jd|||d�S )z€
        :param params:
        :param handler: defaults to self.search_handler (fallback to 'select')
        :return:
        r‚   Úwtr�   ÚqtTi   z%s/?%srq   ú%s/úContent-typez0application/x-www-form-urlencoded; charset=utf-8Úpost)r³   r›   )r‹   rŒ   rV   ry   r½   )r   rQ   ÚhandlerÚcustom_handlerÚparams_encodedr˜   r›   r   r   r   Ú_select   s   


ÿzSolr._selectÚmltc                 C   ó   |   ||¡S r   ©rÆ   ©r   rQ   rÃ   r   r   r   Ú_mlt¾  ó   z	Solr._mltÚtermsc                 C   rÈ   r   rÉ   rÊ   r   r   r   Ú_suggest_termsÁ  rÌ   zSolr._suggest_termsÚupdatec	                 C   s  g }	|}
| j rd}
|	 dt|dƒ ¡ d|
 }|du r| j}|r.|	 dtt|ƒƒ ¡  ¡ n|r=|	 dtt|ƒƒ ¡  ¡ |durN|	 dtt|ƒƒ ¡  ¡ |dur_|	 d	tt|ƒƒ ¡  ¡ |durp|	 d
tt|ƒƒ ¡  ¡ |	r{d|d |	¡f }|r�t|ƒ}|  	d||ddi¡S )a“  
        Posts the given xml message to http://<self.url>/update and
        returns the result.

        Passing `clean_ctrl_chars` as False will prevent the message from being cleaned
        of control characters (default True). This is done by default because
        these characters would cause Solr to fail to parse the XML. Only pass
        False if you're positive your data is clean.
        r�   zqt=%sTrÀ   Nz	commit=%szsoftCommit=%szwaitFlush=%szoverwrite=%szwaitSearcher=%sz%s?%sú&rÂ   rÁ   ztext/xml; charset=utf-8)
rŒ   rP   rV   r�   r.   Úboolr¤   r_   Úsanitizer½   )r   ÚmessageÚclean_ctrl_charsÚcommitÚ
softCommitÚ	waitFlushÚwaitSearcherÚ	overwriterÃ   Ú
query_varsÚpath_handlerr˜   r   r   r   Ú_updateÄ  s.   zSolr._updatec                 C   s”   |j  dd¡}d}|du r:z
| ¡ d d }W n" ty#   |j}Y n ty9   |  |j |j¡\}}t|ƒ}Y nw d| }|du rH|d| 7 }|S )zH
        Extract the actual error message from a solr response.
        ÚreasonNr¬   Úmsgz[Reason: %s]z
%s)r›   rq   r‚   rA   r±   r>   Ú_scrape_responserG   )r   r¹   rÝ   Úfull_responseÚ	full_htmlrÞ   r   r   r   r°   ö  s   
ýzSolr._extract_errorc              
   C   sò  d}|  dd¡}|rd| ¡ v rd}|rd| ¡ v rd}d}d}d}tr-t|dƒr-| ¡ }| d¡rqz4t |¡}| d	¡}	| d
¡}
|	durM|	j	 
¡  }}|
dur\|
j	 
¡ }|du r\|}|re|re||fW S W n
 tjyp   Y nw |dkrŠt d|tj¡}|r…| d¡}nPd| }nKz(t |¡}d}	|dkrœ| d¡}	n| d¡}	|	dur¨|	j	}|du r±t |¡}W n" tyÔ } ztjd|dd|iid� d| }W Y d}~nd}~ww t|ƒ}| dd¡}| dd¡}| dd¡}| dd¡}| 
¡ }||fS )z+
        Scrape the html response.
        NÚserverr    ÚjettyÚcoyoteÚtomcatr-   z<?xmlz#lst[@name="error"]/str[@name="msg"]z%lst[@name="error"]/str[@name="trace"]z<(h1)[^>]*>\s*(.+?)\s*</\1>r6   z%szbody/prez
head/titlez4Unable to extract error message from invalid XML: %srš   rd   r¢   Ú
úz<br/>z<br />)rq   r¤   r*   rM   r-   Ú
startswithr   Ú
fromstringÚfindrC   ÚstripÚ
ParseErrorrE   ÚsearchÚ
IGNORECASEr;   ÚtostringÚSyntaxErrorr”   Úwarningr2   r'   )r   r›   rd   Úserver_typeÚserver_stringrÝ   rá   Údom_treeÚsoupÚreason_nodeÚtb_noderB   r·   r   r   r   rß     st   





€þ



€
ÿ€ýzSolr._scrape_responsec                 C   sÂ   t |dƒr,t |dƒr"| ¡ }|r|| }|jdd� ¡ d }t|ƒS d| ¡  }t|ƒS t|tƒr?|r9d}t|ƒS d}t|ƒS trMt|tƒrLt|d	d
�}nt|tƒrXt	|d	d
�}d 
|¡}t|ƒS )zo
        Converts python values to a form suitable for insertion into the xml
        we send to solr.
        ÚstrftimeÚhourN)ÚtzinfoÚZz%sT00:00:00Zr!   Úfalser'   r(   z{0})rM   Ú	utcoffsetr'   Ú	isoformatr+   rÑ   r*   r,   r.   r/   r©   ra   )r   r1   Úoffsetr   r   r   Ú_from_pythona  s.   

î
ïóõ
€

zSolr._from_pythonc              	   C   s  t |ttttfƒr|S t |ttfƒr|d }|dkrdS |dkr"dS d}tr7t |tƒr/t	|ƒ}t |t
ƒr6d}nt |t
ƒr@t	|ƒ}t |tƒrGd}|ryt |¡}|ry| ¡ }| ¡ D ]
\}}t|ƒ||< qXt |d |d |d |d	 |d
 |d ¡S zt |¡W S  ttfy‹   Y |S w )zD
        Converts values from Solr to native Python values.
        r   r!   Trü   FÚyearÚmonthÚdayrù   ÚminuteÚsecond)r+   r=   ÚfloatÚlongÚcomplexrN   rO   r*   r,   r2   r.   r#   ÚDATETIME_REGEXrí   Ú	groupdictrH   ÚdatetimeÚastÚliteral_evalr>   rð   )r   r1   Ú	is_stringÚpossible_datetimeÚdate_valuesÚdkÚdvr   r   r   Ú
_to_python�  s@   

€


,üzSolr._to_pythonc                 C   sL   |du rdS t rt|tƒrt|ƒdkrdS dS t|tƒr$t|ƒdkr$dS dS )zª
        Check if a given value is ``null``.

        Criteria for this is based on values that shouldn't be included
        in the Solr ``add`` request at all.
        NTr   F)r*   r+   r.   ry   r#   )r   r1   r   r   r   Ú_is_null_value´  s   üzSolr._is_null_valuec                 K   sX   d|i}|  |¡ | j||d�}| j |¡}| j d| di ¡p!i  dd¡¡ |  |¡S )aD  
        Performs a search and returns the results.

        Requires a ``q`` for a string version of the query to run.

        Optionally accepts ``**kwargs`` for additional options to be passed
        through the Solr URL.

        Returns ``self.results_cls`` class object (defaults to
        ``pysolr.Results``)

        Usage::

            # All docs.
            results = solr.search('*:*')

            # Search with highlighting.
            results = solr.search('ponies', **{
                'hl': 'true',
                'hl.fragsize': 10,
            })

        Úq©rÃ   zFound '%s' search results.rd   rf   r   )rÏ   rÆ   r„   r-   rˆ   rg   rq   rŠ   )r   r  r‹   ÚkwargsrQ   rd   ru   r   r   r   rí   Ì  s   
ý
zSolr.searchc                 K   sZ   ||dœ}|  |¡ | j||d�}| j |¡}| j d| di ¡p"i  dd¡¡ |  |¡S )a  
        Finds and returns results similar to the provided query.

        Returns ``self.results_cls`` class object (defaults to
        ``pysolr.Results``)

        Requires Solr 1.3+.

        Usage::

            similar = solr.more_like_this('id:doc_234', 'text')

        )r  zmlt.flr  zFound '%s' MLT results.rd   rf   r   )rÏ   rË   r„   r-   rˆ   rg   rq   rŠ   )r   r  ÚmltflrÃ   r  rQ   rd   ru   r   r   r   Úmore_like_thisð  s   þ
ý
zSolr.more_like_thisc                 K   sÔ   ||dœ}|  |¡ | j||d�}| j |¡}| di ¡}i }	t|ttfƒr7tt	|ddd… |ddd… ƒƒ}| 
¡ D ]\}
}tƒ }|rS| | d¡| d¡f¡ |sD||	|
< q;| j dtd	d
„ |	 
¡ D ƒƒ¡ |	S )zÀ
        Accepts a list of field names and a prefix

        Returns a dictionary keyed on field name containing a list of
        ``(term, count)`` pairs

        Requires Solr 1.4+.
        )zterms.flzterms.prefixr  rÍ   r   Nr6   r:   z$Found '%d' Term suggestions results.c                 s   s   � | ]	\}}t |ƒV  qd S r   )ry   )rJ   rK   Újr   r   r   r^   0  s   € z%Solr.suggest_terms.<locals>.<genexpr>)rÏ   rÎ   r„   r-   rq   r+   rN   rO   ÚdictÚziprH   rP   Úpoprˆ   rg   Úsum)r   ÚfieldsÚprefixrÃ   r  rQ   rd   ÚresultrÍ   ÚresÚfieldÚvaluesÚtmpr   r   r   Úsuggest_terms  s$   
þ
"ÿ
 zSolr.suggest_termsc              	   C   s  t  d¡}| ¡ D ]\}}|tkr!|D ]}| |  |||¡¡ qq	|dkr.| dt|ƒ¡ q	t|t	t
tfƒr9|}n|f}|D ]I}	|  |	¡rFq>|dkrV|  |	|¡}| |¡ q>d|i}
|rf||v rf|| |
d< |rt||v rtt|| ƒ|
d< t jdi |
¤Ž}|  |	¡|_| |¡ q>q	|S )NÚdocÚboostÚ_docÚnamerÏ   r#  )r#  )r   ÚElementrH   ÚNESTED_DOC_KEYrP   Ú
_build_docÚsetr2   r+   rN   rO   r  r   rC   )r   r'  r(  ÚfieldUpdatesÚdoc_elemÚkeyr1   Úchildr$  ÚbitÚattrsr#  r   r   r   r-  3  s:   


ìzSolr._build_docc              	   C   s    t   ¡ }| j d¡ t d¡}|r| d|¡ |D ]}| j|||d�}| |¡ qtj|dd�}t	|ƒ}t   ¡ }| j dt
|ƒ|| ¡ | j||||||	|
d�S )	a
  
        Adds or updates documents.

        Requires ``docs``, which is a list of dictionaries. Each key is the
        field name and each value is the value to index.

        Optionally accepts ``commit``. Default is ``None``. None signals to use default

        Optionally accepts ``softCommit``. Default is ``False``.

        Optionally accepts ``boost``. Default is ``None``.

        Optionally accepts ``fieldUpdates``. Default is ``None``.

        Optionally accepts ``commitWithin``. Default is ``None``.

        Optionally accepts ``waitFlush``. Default is ``None``.

        Optionally accepts ``waitSearcher``. Default is ``None``.

        Optionally accepts ``overwrite``. Default is ``None``.

        Usage::

            solr.add([
                {
                    "id": "doc_1",
                    "title": "A test document",
                },
                {
                    "id": "doc_2",
                    "title": "The Banana: Tasty or Dangerous?",
                },
            ])
        z Starting to build add request...ÚaddÚcommitWithin)r(  r/  r&   )Úencodingz.Built add request of %s docs in %0.2f seconds.)rÕ   rÖ   r×   rØ   rÙ   rÃ   )r¦   rˆ   rg   r   r+  r.  r-  rP   rï   r2   ry   rÜ   )r   re   r(  r/  rÕ   rÖ   r6  r×   rØ   rÙ   rÃ   rµ   rÓ   r'  ÚelrB   r»   r   r   r   r5  ^  s   %
ÿzSolr.addc           	      C   sª   |du r|du rt dƒ‚|dur|durt dƒ‚|durBt|tttfƒs(|g}nttd|ƒƒ}|r>dd dd„ |D ƒ¡ }nt dƒ‚|durJd	| }| j||||||d
�S )aÅ  
        Deletes documents.

        Requires *either* ``id`` or ``query``. ``id`` is if you know the
        specific document id to remove. Note that ``id`` can also be a list of
        document ids to be deleted. ``query`` is a Lucene-style query
        indicating a collection of documents to delete.

        Optionally accepts ``commit``. Default is ``True``.

        Optionally accepts ``softCommit``. Default is ``False``.

        Optionally accepts ``waitFlush``. Default is ``None``.

        Optionally accepts ``waitSearcher``. Default is ``None``.

        Usage::

            solr.delete(id='doc_12')
            solr.delete(id=['doc_1', 'doc_3'])
            solr.delete(q='*:*')

        NzYou must specify "id" or "q".z,You many only specify "id" OR "q", not both.z<delete>%s</delete>r    c                 s   s   � | ]}d | V  qdS )z<id>%s</id>Nr   rI   r   r   r   r^   º  s   € zSolr.delete.<locals>.<genexpr>z*The list of documents to delete was empty.z"<delete><query>%s</query></delete>©rÕ   rÖ   r×   rØ   rÃ   )r>   r+   rN   r.  rO   Úfilterr_   rÜ   )	r   Úidr  rÕ   rÖ   r×   rØ   rÃ   rB   r   r   r   Údelete˜  s   zSolr.deletec                 C   s:   |durdt t|ƒƒ ¡  }nd}| j|| ||||d�S )au  
        Forces Solr to write the index data to disk.

        Optionally accepts ``expungeDeletes``. Default is ``None``.

        Optionally accepts ``waitFlush``. Default is ``None``.

        Optionally accepts ``waitSearcher``. Default is ``None``.

        Optionally accepts ``softCommit``. Default is ``False``.

        Usage::

            solr.commit()

        Nz<commit expungeDeletes="%s" />z
<commit />r9  )r.   rÑ   r¤   rÜ   )r   rÖ   r×   rØ   ÚexpungeDeletesrÃ   rÞ   r   r   r   rÕ   Â  s   zSolr.commitc                 C   s&   |rd| }nd}| j |||||d�S )al  
        Tells Solr to streamline the number of segments used, essentially a
        defragmentation operation.

        Optionally accepts ``maxSegments``. Default is ``None``.

        Optionally accepts ``waitFlush``. Default is ``None``.

        Optionally accepts ``waitSearcher``. Default is ``None``.

        Usage::

            solr.optimize()

        z<optimize maxSegments="%d" />z<optimize />)rÕ   r×   rØ   rÃ   )rÜ   )r   rÕ   r×   rØ   ÚmaxSegmentsrÃ   rÞ   r   r   r   ÚoptimizeÚ  s   
zSolr.optimizeúupdate/extractc              
   K   s  t |dƒs	tdƒ‚|rdnddddœ}| |¡ t|j d¡ƒ}z| jd||d	||fid
�}W n ttfyG } z
| j	j
d|dd� ‚ d}~ww zt |¡}	W n tye } z
| j	j
d|dd� ‚ d}~ww |	 |d¡|	d< i  |	d< }
|	 d| d¡}|rŠ|rŠ| ¡ |
| ¡ < |s€|	S )a5  
        POSTs a file to the Solr ExtractingRequestHandler so rich content can
        be processed using Apache Tika. See the Solr wiki for details:

            http://wiki.apache.org/solr/ExtractingRequestHandler

        The ExtractingRequestHandler has a very simple model: it extracts
        contents and metadata from the uploaded file and inserts it directly
        into the index. This is rarely useful as it allows no way to store
        additional data or otherwise customize the record. Instead, by default
        we'll use the extract-only mode to extract the data without indexing it
        so the caller has the opportunity to process it as appropriate; call
        with ``extractOnly=False`` if you want to insert with no additional
        processing.

        Returns None if metadata cannot be extracted; otherwise returns a
        dictionary containing at least two keys:

            :contents:
                        Extracted full-text content, if applicable
            :metadata:
                        key:value pairs of text strings
        r*  zGextract() requires file-like objects which have a defined name propertyr!   rü   r‚   )ÚextractOnlyÚ
lowernamesr¾   r&   rÂ   Úfile)r³   rœ   z'Failed to extract document metadata: %sTr�   Nz Failed to load JSON response: %sÚcontentsÚmetadataz%s_metadata)rM   r>   rÏ   r   r*  r4   r½   ÚIOErrorrb   rˆ   r¬   r‚   Úloadsr  )r   Úfile_objrA  rÃ   r  rQ   Úfilenamer¹   r·   rš   rE  Úraw_metadatar   r   r   Úextractñ  sJ   

ý


þ
ÿ€ý
ÿ€ýÿzSolr.extract)r    ©r    NNNr   )rÇ   )rÍ   )TNFNNNrÏ   )NN)	NNNFNNNNrÏ   )NNNFNNrÏ   )FNNNrÏ   )TNNNrÏ   )Tr@  )r   r   r   r   rc   rw   r“   r‡   r™   r½   rÆ   rË   rÎ   rÜ   r°   rß   r   r  r  rí   r  r&  r-  r5  r<  rÕ   r?  rK  r   r   r   r   r   )  s>    
ÿ


?


ÿ2Q 3

$

&+
ÿ
:
*
c                       sj   e Zd ZdZ‡ fdd„Zi i fdd„Zddd„Zddd„Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ Z‡  ZS )ÚSolrCoreAdminaÇ  
    Handles core admin operations: see http://wiki.apache.org/solr/CoreAdmin

    This must be initialized with the full admin cores URL::

        solr_admin = SolrCoreAdmin('http://localhost:8983/solr/admin/cores')
        status = solr_admin.status()

    Operations offered by Solr are:
       1. STATUS
       2. CREATE
       3. RELOAD
       4. RENAME
       5. ALIAS
       6. SWAP
       7. UNLOAD
       8. LOAD (not currently implemented)
    c                    s    t t| ƒj|i |¤Ž || _d S r   )ÚsuperrM  rw   r…   )r   r…   Úargsr  ©Ú	__class__r   r   rw   F  s   
zSolrCoreAdmin.__init__c                 C   s   t j|t|ƒ|d�}t|jƒS )N)rš   r›   )r�   rq   rV   r2   r±   )r   r…   rQ   r›   r¹   r   r   r   Ú_get_urlJ  s   
zSolrCoreAdmin._get_urlNc                 C   s,   ddi}|dur|j |d� | j| j|d�S )zShttp://wiki.apache.org/solr/CoreAdmin#head-9be76f5a459882c5c093a7a1456e98bea7723953ÚactionÚSTATUSN)Úcore©rQ   ©rÏ   rR  r…   ©r   rU  rQ   r   r   r   ÚstatusN  s
   ÿzSolrCoreAdmin.statusúsolrconfig.xmlú
schema.xmlc                 C   s@   d|||dœ}|du r|j |d� n|j |d� | j| j|d�S )zShttp://wiki.apache.org/solr/CoreAdmin#head-7ca1b98a9df8b8ca0dcfbfc49940ed5ac98c4a08ÚCREATE)rS  r*  ÚconfigÚschemaN)ÚinstanceDirrV  rW  )r   r*  Úinstance_dirr]  r^  rQ   r   r   r   ÚcreateY  s   üzSolrCoreAdmin.createc                 C   ó   d|dœ}| j | j|d�S )zShttp://wiki.apache.org/solr/CoreAdmin#head-3f125034c6a64611779442539812067b8b430930ÚRELOAD©rS  rU  rV  ©rR  r…   rX  r   r   r   Úreloadi  ó   þzSolrCoreAdmin.reloadc                 C   ó   d||dœ}| j | j|d�S )zShttp://wiki.apache.org/solr/CoreAdmin#head-9473bee1abed39e8583ba45ef993bebb468e3afeÚRENAME©rS  rU  ÚotherrV  re  ©r   rU  rk  rQ   r   r   r   Úrenameq  ó
   ýzSolrCoreAdmin.renamec                 C   rh  )zShttp://wiki.apache.org/solr/CoreAdmin#head-928b872300f1b66748c85cebb12a59bb574e501bÚSWAPrj  rV  re  rl  r   r   r   Úswapz  rn  zSolrCoreAdmin.swapc                 C   rb  )zShttp://wiki.apache.org/solr/CoreAdmin#head-f5055a885932e2c25096a8856de840b06764d143ÚUNLOADrd  rV  re  rX  r   r   r   Úunloadƒ  rg  zSolrCoreAdmin.unloadc                 C   s   t dƒ‚)Nz1Solr 1.4 and below do not support this operation.)ÚNotImplementedError)r   rU  r   r   r   Úload‹  s   zSolrCoreAdmin.loadr   )NrZ  r[  )r   r   r   r   rw   rR  rY  ra  rf  rm  rp  rr  rt  Ú__classcell__r   r   rP  r   rM  3  s    

		rM  ))ó    ó    )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  )ó   rw  c                 C   s*   t | ƒ}tD ]
\}}| ||¡}qt|ƒS r   )r5   ÚREPLACEMENTSr'   r2   )rš   Úfixed_stringÚbadÚgoodr   r   r   rÒ   ²  s   rÒ   c                       s8   e Zd Zd‡ fdd„	Zdd„ Zdd
d„Zdd„ Z‡  ZS )Ú	SolrCloudNr€   çš™™™™™É?Tc                    sX   |  |¡}
|| _|| _tt| ƒj|
g|¢R ||| j| jdœ|	¤Ž || _|| _|| _d S )N)r„   r†   r�   rŽ   )	ÚgetRandomURLr�   rŽ   rN  r˜  rw   Ú	zookeeperÚ
collectionÚretry_timeout)r   r›  rœ  r„   r†   r�  r�   rŽ   rO  r  r…   rP  r   r   rw   ½  s   
ÿÿ
zSolrCloud.__init__c                 C   s2   | j  | j¡| _t d| j¡ t | |||||¡S )NzUsing random URL: %s)r›  rš  rœ  r…   r”   rg   r   r½   ©r   r²   r˜   r³   r›   rœ   r   r   r   Ú_randomized_requestÊ  s   zSolrCloud._randomized_requestr    c              
   C   sœ   z
|   |||||¡W S  tjjy-   tjd| jdd� t | j¡ |   |||||¡ Y S  t	yM   tjd| jdd� t | j¡ |   |||||¡ Y S w )Nz$RequestException, retrying after %fsTr�   z!SolrException, retrying after %fs)
rŸ  r�   rª   ÚRequestExceptionr”   rñ   r�  r¦   Úsleeprb   rž  r   r   r   r½   Ï  s   ýzSolrCloud._send_requestc                 O   s6   | j  | j¡| _t d| j¡ tj| g|¢R i |¤ŽS )NzUsing random leader URL: %s)r›  ÚgetLeaderURLrœ  r…   r”   rg   r   rÜ   )r   rO  r  r   r   r   rÜ   Ü  s   zSolrCloud._update)Nr€   r™  NTrL  )r   r   r   rw   rŸ  r½   rÜ   ru  r   r   rP  r   r˜  »  s
    
r˜  c                   @   sj   e Zd ZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZdZddd„Zddd„Zdd„ Zddd„Zdd„ ZdS )Ú	ZooKeeperz/live_nodesz/aliases.jsonz/clusterstate.jsonÚshardsÚreplicasÚstateÚactiveÚleaderÚbase_urlr!   rü   rœ  é   r8   Nc           	         sÎ   t d u rt d¡ t‚i ˆ _i ˆ _i ˆ _d ˆ _|d u r*t |d|d|id|id�ˆ _n|ˆ _ˆ j 	¡  ‡ fdd„}ˆ j 
|¡ ˆ j tj¡‡ fdd„ƒ}ˆ j tj¡‡ fd	d
„ƒ}ˆ j tj¡‡ fdd„ƒ}d S )Nz6ZooKeeper requires the `kazoo` library to be installedTÚ	max_tries)Ú	read_onlyr†   Úcommand_retryÚconnection_retryc                    s,   | t jkr
| ˆ _d S | t jkr| ˆ _d S d S r   )r
   ÚLOSTr¦  Ú	SUSPENDED)r¦  rz   r   r   ÚconnectionListener  s
   



ÿz.ZooKeeper.__init__.<locals>.connectionListenerc                    s6   | s	t  d¡ d S t |  d¡¡ˆ _t  dˆ j¡ d S )Nz3No cluster state available: no collections defined?r&   zUpdated collections: %s)r”   rñ   r‚   rG  r-   Úcollectionsr®   )rš   rO  r  rz   r   r   ÚwatchClusterState  s   z-ZooKeeper.__init__.<locals>.watchClusterStatec                    s   | ˆ _ t d| ¡ d S )NzUpdated live nodes: %s)Ú	liveNodesr”   r®   )Úchildrenrz   r   r   ÚwatchLiveNodes  s   z*ZooKeeper.__init__.<locals>.watchLiveNodesc                    sZ   | r!t  |  d¡¡}tj|v r|tj ˆ _nt dtj| ¡ ¡ nd ˆ _t 	dˆ j¡ d S )Nr&   z&Expected to find %s in alias update %szUpdated aliases: %s)
r‚   rG  r-   r£  Ú
COLLECTIONÚaliasesr”   rñ   Úkeysr®   )rš   ÚstatÚ	json_datarz   r   r   ÚwatchAliases  s   

ÿz(ZooKeeper.__init__.<locals>.watchAliases)r	   Úloggingr¬   ÚRuntimeErrorr²  r´  r¸  r¦  ÚzkÚstartÚadd_listenerÚ	DataWatchr£  ÚCLUSTER_STATEÚChildrenWatchÚLIVE_NODES_ZKNODEÚALIASES)	r   ÚzkServerAddressr†   Úmax_retriesÚkazoo_clientr±  r³  r¶  r¼  r   rz   r   rw   ñ  s,   

þ
zZooKeeper.__init__Fc                 C   sÚ   | j r|| j v r|  |||¡S g }|| jvrtd| ƒ‚| j| }|tj }| ¡ D ]@}|| }|tj tjkrj|tj	 }	|	 ¡ D ](}
|	|
 }|tj tjkri|r[| 
tjd ¡tjkri|tj }||vri| |¡ qAq*|S )NzUnknown collection: %s)r¸  ÚgetAliasHostsr²  rb   r£  ÚSHARDSr¹  ÚSTATEÚACTIVEÚREPLICASrq   ÚLEADERÚTRUEÚBASE_URLrP   )r   ÚcollnameÚonly_leaderÚseen_aliasesÚhostsrœ  r¤  Ú	shardnameÚshardr¥  ÚreplicanameÚreplicar©  r   r   r   ÚgetHosts%  s(   





€zZooKeeper.getHostsc                 C   st   |r||v rt  d|¡ g S ng }| |¡ | j|  d¡}g }|D ]}|  |||¡D ]}||vr6| |¡ q+q"|S )Nz)%s in circular alias definition - ignoredú,)r”   ÚwarnrP   r¸  ÚsplitrÚ  )r   rÒ  rÓ  rÔ  r²  rÕ  rœ  Úhostr   r   r   rÊ  <  s    þ

€þzZooKeeper.getAliasHostsc                 C   s,   | j ||d�}|stdƒ‚dt |¡|f S )N©rÓ  z$ZooKeeper returned no active shards!z%s/%s)rÚ  rb   ÚrandomÚchoice)r   rÒ  rÓ  rÕ  r   r   r   rš  L  s   zZooKeeper.getRandomURLc                 C   s   | j |dd�S )NTrß  )rš  )r   rÒ  r   r   r   r¢  R  s   zZooKeeper.getLeaderURL)rª  r8   N)FN)F)r   r   r   rÅ  rÆ  rÃ  rË  rÎ  rÌ  rÍ  rÏ  rÑ  rÐ  ÚFALSEr·  rw   rÚ  rÊ  rš  r¢  r   r   r   r   r£  â  s$    

4
r£  )r   )TÚ
__future__r   r   r   r  r  r½  Úosrà  rE   r¦   Ú	xml.etreer   Úpkg_resourcesr   r   r   r�   Úkazoo.clientr	   r
   ÚImportErrorÚ
simplejsonr‚   Úurllib.parser   Úurllibr   Úhtml.entitiesÚentitiesr?   ÚhtmlentitydefsÚhttp.clientr   ÚhttplibÚunichrr<   r$   Úchrr=   r  Ú
__author__Ú__all__r   Úpkg_distributionÚversionr   Úparsed_versionÚversion_infor   Úcompiler	  r,  ÚHandlerr   Ú	getLoggerr”   ÚhÚ
addHandlerÚenvironrq   r¤   ÚsetLevelÚDEBUGÚStreamHandlerr’   r%   r*   r2   r5   rG   rV   r[   ra   Ú	Exceptionrb   Úobjectrc   r   rM  r”  rÒ   r˜  r£  r   r   r   r   Ú<module>   s´   ÿÿþþþÿü
þ




>      ]"	'