ó
`ï}Nc           @   s†   y" d  d l  Z  d  d l Z e Z Wn e k
 r; e Z n Xd  d l Z d  d l Z d  d l Z d Z	 d d d „  ƒ  YZ
 d „  Z d S(   iÿÿÿÿNs   /var/lib/debtags/package-tagst   AptTagsc           B   s>   e  Z d  „  Z d „  Z d „  Z d „  Z d „  Z d „  Z RS(   c         C   sß   t  s t d d ƒ St j d ƒ |  _ t j d ƒ |  _ t t d ƒ sS t d d ƒ St j j	 d ƒ } t
 j j | ƒ s„ t d d ƒ St d t
 j j | ƒ d t d | d	 d
 ƒ g d t d d d d d d d	 d d d ƒ g ƒ S(   s  
        Return general information about the plugin.

        The information returned is a dict with various keywords:
         
         timestamp (required)
           the last modified timestamp of this data source.  This will be used
           to see if we need to update the database or not.  A timestamp of 0
           means that this data source is either missing or always up to date.
         values (optional)
           an array of dicts { name: name, desc: description }, one for every
           numeric value indexed by this data source.

        Note that this method can be called before init.  The idea is that, if
        the timestamp shows that this plugin is currently not needed, then the
        long initialisation can just be skipped.
        t	   timestampi    s   \b([^{]+)\{([^}]+)\}s   \s*,\s*t   configs   Dir::Cache::pkgcachet   sourcest   patht   descs	   APT indext   prefixest   idxt   XTt   qps   tag:t   typet   bools   Debtags tagt   ldescs   Debtags package categories(   t   HAS_APTt   dictt   ret   compilet	   re_expandt   re_splitt   hasattrt   apt_pkgR   t	   find_filet   osR   t   existst   getmtime(   t   selft   file(    (    s.   /usr/share/apt-xapian-index/plugins/apttags.pyt   info   s     c         C   s   d S(   s5  
        If needed, perform long initialisation tasks here.

        info is a dictionary with useful information.  Currently it contains
        the following values:

          "values": a dict mapping index mnemonics to index numbers

        The progress indicator can be used to report progress.
        N(    (   R   R   t   progress(    (    s.   /usr/share/apt-xapian-index/plugins/apttags.pyt   init2   s    c         C   s   t  d d d d d d ƒ S(   s+  
        Return documentation information for this data source.

        The documentation information is a dictionary with these keys:
          name: the name for this data source
          shortDesc: a short description
          fullDoc: the full description as a chapter in ReST format
        t   names   Apt tagst	   shortDescs.   Debtags tag information from the Packages filet   fullDocs  
            The Apt tags data source indexes Debtags tags as found in the
            Packages file as terms with the ``XT`` prefix; for example:
            'XTrole::program'.

            Using the ``XT`` terms, queries can be enhanced with semantic
            information.  Xapian's support for complex expressions in queries
            can be used to great effect: for example::

                XTrole::program AND XTuse::gameplaying AND (XTinterface::x11 OR XTinterface::3d)

            ``XT`` terms can also be used to improve the quality of search
            results.  For example, the ``gimp`` package would not usually show
            up when searching the terms ``image editor``.  This can be solved
            using the following technique:

             1. Perform a normal query
             2. Put the first 5 or so results in an Rset
             3. Call Enquire::get_eset using the Rset and an expand filter that
                only accepts ``XT`` terms.  This gives you the tags that are
                most relevant to the query.
             4. Add the resulting terms to the initial query, and search again.

            The Apt tags data source will not work when Debtags is installed,
            as Debtags is able to provide a better set of tags.
            (   R   (   R   (    (    s.   /usr/share/apt-xapian-index/plugins/apttags.pyt   doc?   s    	c            sV   ‡  f d †  } ˆ  j  j | | ƒ } x+ ˆ  j j | ƒ D] } | j d | ƒ q7 Wd S(   s?   
        Parse tagstring into tags, and index the tags
        c            sN   |  j  d ƒ } ˆ  j j |  j  d ƒ ƒ } d j g  | D] } | | ^ q7 ƒ S(   Ni   i   s   , (   t   groupR   t   splitt   join(   t   mot   roott   endst   x(   R   (    s.   /usr/share/apt-xapian-index/plugins/apttags.pyt
   expandTagsk   s    R   N(   R   t   subR   R#   t   add_term(   R   t	   tagstringt   documentR)   t   tag(    (   R   s.   /usr/share/apt-xapian-index/plugins/apttags.pyt   _parse_and_indexg   s    c         C   sc   | j  } | d k r d S| j } | d k r2 d Sy |  j | d | ƒ Wn t k
 r^ d SXd S(   sÂ   
        Update the document with the information from this data source.

        document  is the document to update
        pkg       is the python-apt Package object for this package
        Nt   Tag(   t	   candidatet   Nonet   recordR/   t   KeyError(   R   R-   t   pkgt   vert   rec(    (    s.   /usr/share/apt-xapian-index/plugins/apttags.pyt   indext   s    	 	 c         C   s1   y |  j  | d | ƒ Wn t k
 r, d SXd S(   s7  
        Update the document with the information from this data source.

        This is alternative to index, and it is used when indexing with package
        data taken from a custom Packages file.

        document  is the document to update
        pkg       is the Deb822 object for this package
        R0   N(   R/   R4   (   R   R-   R5   (    (    s.   /usr/share/apt-xapian-index/plugins/apttags.pyt   indexDeb822„   s    
(   t   __name__t
   __module__R   R   R!   R/   R8   R9   (    (    (    s.   /usr/share/apt-xapian-index/plugins/apttags.pyR       s   	$		(		c          K   s   t  j j t ƒ r d St ƒ  S(   s.   
    Create and return the plugin object.
    N(   R   R   R   t	   DEBTAGSDBR2   R    (   t   kw(    (    s.   /usr/share/apt-xapian-index/plugins/apttags.pyR   ”   s    (    (   t   aptR   t   TrueR   t   ImportErrort   FalseR   R   t   os.pathR<   R    R   (    (    (    s.   /usr/share/apt-xapian-index/plugins/apttags.pyt   <module>   s   

$‡