HEX

File: //lib/python3/dist-packages/xkit/__pycache__/xorgparser.cpython-310.pyc
o

p��O�W�@s�ddlmZddlmZddlZddlmZmZddlZGdd�de�ZGdd�de�Z	Gd	d
�d
e�Z
Gdd�de�ZGd
d�de�Z
dS)�)�print_function)�unicode_literalsN)�stdout�stderrc@�eZdZdZdS)�IdentifierExceptionz#Raise if no identifier can be foundN��__name__�
__module__�__qualname__�__doc__�r
r
�1/usr/lib/python3/dist-packages/xkit/xorgparser.pyr�rc@r)�OptionExceptionz&Raise when an option is not available.Nrr
r
r
rrrrc@r)�SectionExceptionz&Raise when a section is not available.Nrr
r
r
rr"rrc@r)�ParseExceptionz&Raise when a postion is not available.Nrr
r
r
rr&rrc@s�eZdZdZd\dd�Zdd�Zdd�Zeee�Zd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zd\dd�Zdd�Z		d]dd�Z		d^dd�Z		d^dd�Zd\d d!�Zd_d"d#�Zd\d$d%�Zd\d&d'�Zd\d(d)�Zd\d*d+�Zd\d,d-�Z	d_d.d/�Z	d\d0d1�Zd\d2d3�Zd4d5�Zd_d6d7�Z		d^d8d9�Z d_d:d;�Z!d<d=�Z"d>d?�Z#d@dA�Z$dBdC�Z%d\dDdE�Z&dFdG�Z'dHdI�Z(dJdK�Z)dLdM�Z*dNdO�Z+dPdQ�Z,d_dRdS�Z-dTdU�Z.		d^dVdW�Z/d\dXdY�Z0dZd[�Z1dS)`�Parserz^Only low-level methods here.
    
    See the xutils.XUtils subclass for higher-level methods.NcCs�d|_d|_||_ddddddd	d
ddd
ddd|j|jf|_|jdd�|_gd�|_gd�|_i�|j�|_g|_	i�|jd�|_
|j
D]}i|j
|<qE|��dS)a�source = can be an object or a file. If set to None (default)
                 Parser will start from scratch with an empty
                 configuration.
        
        Public:
        
        comments = name of the section which stores the commented lines
                   located outside of the sections in the xorg.conf.

        globaldict = a global dictionary containing all the sections and
                     options. For further information on globaldict, have a
                     look at __check_sanity() and at get_value().

        globaldict['Comments'] = stores the commented lines located inside of
                                 the sections in the xorg.conf.

        require_id = a list of the sections which require to have an
                    "Identifier" set in the xorg.conf (e.g. Device sections).

        identifiers = a dictionary of the sections which require identifiers.

        sections = a tuple containing the names of all the sections in
                   globaldict. Their names are not guaranteed to be all legal
                   in xorg.conf (see "valid_sections").

        valid_sections = a tuple containing the names of all the sections
                         which __check_sanity() will look for in the
                         xorg.conf. Sections with other names will be ignored
                         by self._check_sanity().

        references = a list containing the names of all the possible
                     references.�
SubSection�Comments�InputDevice�Device�Module�Monitor�Screen�ServerLayout�ServerFlags�
Extensions�Files�
InputClass�DRI�VideoAdaptor�Vendor�ModesN���)rrrrrr)rrrrr)�
subsection�commentsection�source�sections�valid_sections�
require_id�
references�fromkeys�identifiers�comments�_gdict�
_check_sanity)�selfr'�elemr
r
r�__init__.s:"�


zParser.__init__cCs|jS�N�r/)r1r
r
r�_get_global~szParser._get_globalcCs
||_dSr4r5)r1�global_dictr
r
r�_set_global�s
zParser._set_globalc	Cs�|j}|dkr
g}nt|d�st|d�}|��}|��n|��}i�|jd�}d}d}d}d}d}	d}
d}|D�]}|���d�r�|dkrN|j	�
|��n�||}
|dkr�|j|j�
|i�|j|j|}|�
|
i�||
�
d	d�||
�
d
|
�||
�
dd�||
�
dg�||
d�
|���nJ||j}|j|j�
|ji�|j|j|j}|�
|i�||�
d	|�||�
d
|
�||�
d|�||�
dg�||d�
|���~�nU|�����d��r1d}|jD]}|���d
|��d
�dk�rd}|}nq�|�sd|}t|��|dk�r+|	d7}	|}d}d}�nd}t|��|�����d�dk�r^|	d7}	|dk�rX|dk�rX||d7<d}d}n�d}t|��|�����d�dk�r�|
d7}
|dk�r�|dk�r�d}||�d
�d|�d
����}|j�
|ji�||j}i|j|j|<|j|j|}||d<z|||d
<Wnt�y�~d}t|��w||d	<g|d<~nod}t|��|�����d�dk�r�|
d7}
|dk�r�d}||jd7<nHd}t|��|dk�r<|��dk�r<|dk�r|j|j|d�
d|��d�n|j�
|i�||}|j|�
|g��
d|��d�|d7}q8|�sb|	ddk�sR|
ddk�rXd}t|��|��|��dS|��dS)a�Perform a sanity check of the file and fill self.globaldict with
        all the sections and subsections in the xorg.conf
        
        
        empty = is the file empty? If yes, then don't check if:
            * the last section is not complete
            * there are duplicates
        
        has_section:
            * == True: a section is already open
            * == False: a section is closed and/or a new section can be opened
            
        has_subsection:
            * == True: a subsection is already open
            * == False: a section is closed and/or a new section can be opened
            
        section_flag:
            * == '':a section is closed and/or a new section can be opened
            * == the name the current section
        
        section_tags = counter of the number of Section and EndSection strings
        
        subsection_tags = counter of the number of SubSection and EndSubSection
                         strings
        
        lines_list = the list of the lines in the source object.
        
        global_iters = counts how many times each kind of section
                             (section_flag) is found in the xorg.confN�write�rrTF��#�
identifier�position�section�options�"r$z;The name in the following line is invalid for a section:
%s�z,Sections cannot be nested in other sections.�
endsectionz$An EndSection is in the wrong place.r%z7SubSections can be nested only in well formed sections.�
endsubsectionz=SubSections can be closed only after being previously opened.�	�
�zThe last section is incomplete.)r'�hasattr�open�	readlines�closer,r(�strip�
startswithr.�appendr/r&�
setdefaultr%�lowerr)�findr�rfind�KeyError�_fill_identifiers�
_check_syntax)r1�file�
lines_list�myfile�global_iters�empty�has_section�has_subsection�section_flag�section_tags�subsection_tags�it�line�section_pos�	temp_dict�	curlength�
subsection_id�test_line_found�sectr?�errorr
r
rr0�s�!





 ��
��

�


��
zParser._check_sanitycCsHt|���dkrdt|���}t|��|��|��}d}|D]
}|t||�7}q |dkr9dt|�}t|��|jD]}t|j|�t|j|�krRd}t|��q<t|jd�dkr{|jdD]}|j	d|dgd�}t|d�dkrzd}t|��qa|�
�}t|�dkr�t|�d	kr�d
}t|��|jd|dd�s�d}t|��d
Sd
S)zuThis method contains the several checks which can guarantee
        compliance with the syntax rules of the xorg.confrz&There cannot be Duplicate Sections:
%sz%There cannot be Broken References:
%szDNot all the sections which require an identifier have an identifier.rr)�reflistzNThe ServerLayout section must have at least 1 reference to a "Screen" section.rBzRNo more than one default ServerLayout can be specified in the ServerFlags section.�r>�(The default ServerLayout does not exist.N)�len�get_duplicate_sections�strr�_validate_options�get_broken_referencesr*r/r-�get_references�get_default_serverlayout�
is_section)r1rh�brokenr`r?�screen_references�default_layoutr
r
rrU]sL
�

����zParser._check_syntaxcCs�|jD]Q}g|j|<d}|j|D]B}z	|�|d|�}Wnttfy/d||f}t|��wz|�d�|d}Wn	tyDYnw|j|�||f�|d7}qqdS)a�Fill self.identifiers
        
        self.identifiers has the section types as keys and a list of tuples
        as values. The tuples contain the identifier and the position of
        each section.
        
        Here's a basic scheme:
        
        self.identifiers = {section_type1: [
                                        (identifier1, position1),
                                        (identifier2, position2)
                                      ], etc.
                           }
        
        Concrete example:
        
        self.identifiers = {'Device': [
                                        ('Configured Video Device', 0),
                                        ('Another Video Device', 1)
                                      ],
                            'Screen': [
                                        ('Configured Screen Device', 0),
                                        ('Another Screen Device', 1)
                                      ],
                           } r�
Identifierz8No Identifier for section %s, position %d, can be found.r;rBN)	r*r-r/�	get_valuerrrrN�AttributeError)r1rgr`r2r=rhr
r
rrT�s,

��
�
��zParser._fill_identifiersc	Cs�ddg}dg}|jD]j}||vrt|j|D]^}||jkr&|j||d}n|j||}|D]C}|��}|�d�dkrE|d|�d��}d|��}|j|d	d
�}t|�dkrf|d����|vrft|��|dd�	�srt|��q/qq
dS)
z�One word entries are not acceptable as either options or references

        If a one word entry is found, ParseException will be raised.rr�endmoder@r<r$rz#The following option is invalid: %sT)�include_nullrBN)
r(r/r%rLrQ�_clean_duplicatesrlrPr�isalpha)	r1�sections_whitelist�options_whitelistr?r>r@�optionrh�optbitsr
r
rro�s:

�������zParser._validate_optionsc

Csgd�}g}g}|dkr|j||d}n|j||}|D]T}|��}|�d�dkr5|d|�d��}|�|�}z.|d��|vrK|�|d�n|d��dkrgt|�dkrg|dd	krg	|�|d�WqttfysYqwi}	|D]}|	�	|�d	kr�|�|�qx||	|<qx|S)
z�See if there are duplicate options in a section

        It is ok to have duplicated references e.g. several Load options, or
        Screen, etc. though)�driver�busidr=rr@r<r$rr�rBN)
r/rLrQr|rPrNrlry�
IndexError�get)
r1r?r>�	blacklist�total�
duplicatesr@r�r��finalr
r
r�get_duplicate_optionss8
��
zParser.get_duplicate_optionscCsPi}|jD] }|j|D]}|�||�}t|�dkr$|�|i��||�qq|S)z5Look for and return duplicate options in all sectionsr)r/r�rlrO)r1r�r?r2�duploptr
r
r�check_duplicate_optionsMs
���zParser.check_duplicate_optionsc	CsJg}d}d}d}|�d�}|dkrV|D]A}|��s'|dkr"|d7}n||7}n|ddkr2||7}n
t|�dkr?|�|�d}|t|�dkrP|dkrP|�|�|d7}qn:|D]7}|��sc||7}n
t|�dkrp|�|�d}|t|�dkr�|dkr�|�|�n	|r�d}|�|�|d7}qX|r�t|�|ddkr�d}|�|�|S)z�Clean the option and return all its components in a list
        
        include_null - is used only by _validate_options() and makes
        sure that options with a null value assigned in quotation
        marks are not considered as one-word optionsr;rrArBrG)�count�isspacerlrN)	r1r�r{r��optbitr`�	quotation�optcount�ir
r
rr|ZsL






�




zParser._clean_duplicatescCshi}|jD],}g}|j|D]	}|�|d�q|D]}|�|�dkr0|�|i��||�|��qq|S)zpReturn a dictionary with the duplicate sections i.e. sections
        of the same kind, with the same identifierrrB)r-rNr�rO)r1r�r?�temprgr2r
r
rrm�s
���zParser.get_duplicate_sectionsrAcCs�dg}|dkr(|j|�|�dkrt�|r|j||||d�n|j|||d�n|�||�|dkrm|dkrGd|d|t|�|d}	n>|����|vr`d|d|t|�|d}	n%d|dt|�d}	nd|dd|dd|t|�|d}	t|j|�dkr�i|j|<g|j|d<||jvr�d	|d
}
|j|d�	|
�|dkr�|j|D]}|j||�	|	�q�dS|j||�	|	�dS)aAdd an option to a section
        
        section= the section which will have the option added
        option= the option to add
        value= the value which will be assigned to the option
        position= e.g. 0 (i.e. the first element in the list of Screen
                      sections)
        option_type= if set to "Option" it will cause the option to look like
                    the following:
                    Option "NameOfTheOption" "Value"
                    
                    Otherwise it will look like the following:
                    NameOfTheOption "Value"
        position= e.g. 0 (i.e. the first element in the list of Screen
                      sections)
        reference= used only in a particular case of reference (see
                   add_reference)
        
        prefix= usually quotation marks are used for the values (e.g. "True")
                however sometimes they don't have to be used
                (e.g. DefaultDepth 24) and prefix should be set to '' instead
                of '"'  �deviceN��valuer>rjrErFrArz	Identifier	"Default z"
)
r/r�r�
remove_optionrnrLrPrlr*rN)r1r?r�r��option_typer>�	reference�prefix�refSections�toaddr=r2r
r
r�
add_option�sT
��������

�zParser.add_optionc
Csni}t|j|�dkr�|dkra|j|D]J}d}|j||D]>}	|dkrE|	���|���dkrD|	���|���dkrD|�|g��|�n|	���|���dkrY|�|g��|�|d7}qq|S|j|�|�dkrmdSd}|j||D]>}	|dkr�|	���|���dkr�|	���|���dkr�|�|g��|�n|	���|���dkr�|�|g��|�|d7}qv|S)z=Private method shared by remove_option and comment_out_optionrNr$rB)rlr/rPrQrOrNr�)
r1r?r�r�r>r��	to_remover2r`rar
r
r�_get_options_to_blacklist�s:�
�"��
z Parser._get_options_to_blacklistcCsR|�|||||�}|D]}d}||D]}	|	|}
|j|||
=|d7}qqdS)aCRemove an option from a section.
        
        section= the section which will have the option removed
        option= the option to remove
        value= if you want to remove an option only if it has a certain value
        position= e.g. 0 (i.e. the first element in the list of Screen
                      sections)rrBN)r�r/)r1r?r�r�r>r�r��part�moddedra�realposr
r
rr�&s

�
��zParser.remove_optionc	Cst|j|�}||jvr�|dkr}d}d}|j|D]E}|�|||�r^z|�|||�����|����kr9d}Wn&Wqty]|�|||�D]}|����|����krZd}nqHYqwq|r{g|j||<|j||||d�|j|�	||f�|St
d|��g|j||<|S)aCreate a new section and return the position of the section

        The position is relative to the list of sections of the same type
        (e.g. "Screen") so as to make it available in case the user wants
        to add some options to it.
        
        The identifier and the position of the new section is added to 
        self.identifiers[section]
        
        section= the section to create
        identifier= the identifier of a section (if the section requires
                    an identifier)NrwTFr�z!%s Section requires an identifier)rlr/r*rxrLrPryr�r-rNr)r1r?r=r>r��create�subr2r
r
r�make_section9sR
�
��

�����
���zParser.make_sectionc
Cs�i}|rz|�||�}|�|d�Wn)tyYn!w|dkr.|j||d�r-|�|d�nt|j|���}i�|�}||jvrpd}|j	|D]'}zt|����
|d�}	||t|���|	<Wn	tyjYnw|d7}qHt|���}
|
��d}|
D]A}|�
||�}
|
D]}z	|j|j|=Wq�ty�Yq�w|�||�|j||=||}|dkr�||}|j	||=|d7}q~dS)z/Remove Sections by identifier, position or typeNrjrrB)�get_positionrOrrs�listr/�keysr,r*r-�index�
ValueError�sort�get_subsectionsr%rS�_remove_comment_entries)r1r?r=r>r��pos�allkeysr`r��ref�
sorted_remover�rg�subsectionsr��identrefr�r
r
r�remove_sectionrsX��

�
���zParser.remove_sectioncC�|j||||dd�dS)a�Add a reference to a section from another section.

        For example:
        to put a reference to the Screen section named "Default Screen"
        in the ServerLayout section you should do:

        section='ServerLayout'
        reference='Screen'
        identifier='Default Screen'
        position=0 #the first ServerLayout section

        NOTE: if position is set to None it will add such reference to any
        instance of the section (e.g. to any ServerLayout section)T�r�r>r�N)r��r1r?r�r=r>r
r
r�
add_reference��

�zParser.add_referencecCr�)a�Remove a reference to a section from another section.

        For example:
        to remove a reference to Screen "Default Screen" from the
        ServerLayout section you should do:

        section='ServerLayout'
        reference='Screen'
        identifier='Default Screen'
        position=0 #the first ServerLayout section

        NOTE: if position is set to None it will remove such reference from
        any instance of the section (e.g. from any ServerLayout section)Tr�N)r�r�r
r
r�remove_reference�r�zParser.remove_referencec
Cs&|dkr|j}n
|�d�|d=|}i�|�}|D]w}g||<i}z|j|||dd�}Wnty7g}Ynw|r�z5|�d�|d=|D](}	z|	�d�|	d=|	D]	}
|	r[|�|
�qRWqEtym|	rk|�|	�YqEwWnty|r}|�|�Ynwt|���D]	}||�|�q�q|S)aWGet references to other sections which are located in a section.

        section= the section (e.g. "Screen")
        position= e.g. 0 stands for the 1st Screen section
        reflist= a list of references which this function should look for.
                 The default list of references is self.require_id but this
                 list can be overridden by the reflist argument so that, for
                 example, if reflist is set to ['Device'], this function will
                 look for references to other devices only (references to,
                 say, screens, will be ignored).Nr;r$T�r�)	r*rNr,rxrrOryr�r�)r1r?r>rir@r+r��reference_dictr�r2�extrefr�r
r
rrq�sT

�


��
���

���zParser.get_referencesc	Cs�t|j|j�}|dkrk|j|D]W}d}|j|jD]+}|j|j|�d�|krF|j|j|�d�|krF|j|j|�d�|krFd}q|rhi}|j|j|<||d<||d<g|d<||d<~|d7}qdSd}|j|jD]+}|j|j|�d�|kr�|j|j|�d�|kr�|j|j|�d�|kr�d}qs|r�i}|j|j|<||d<||d<g|d<||d<~dSdS)	a�Create a new subsection inside of a section.

        section= the section to which the subsection will belong
        identifier= the name of the subsection
        position= the position of the section in the dictionary with the
                  sections (e.g. the 1st "Screen" section would be 0).
                  If set to None, it will create a new subsection in all
                  the instances of the said section (e.g. in all the
                  "Screen" sections)NTr?r=r>Fr@rB)rlr/r%r�)	r1r?r=r>rdr2r�r�rcr
r
r�make_subsections^�����������zParser.make_subsectioncCs�t|j|j�}g}|dkr7|j|jD]!}|j|j|�d�|kr5|j|j|�d�|kr5|�|�qn5|j|jD].}|j|j|�d�|krk|j|j|�d�|krk|j|j|�d�|krk|�|�q=|D]	}|j|j|=qndS)a�Remove a subsection from one or more sections.
        
        section= the section to which the subsection belongs
        identifier= the name of the subsection
        position= the position of the section in the dictionary with the
                  sections (e.g. the 1st "Screen" section would be 0).
                  If set to None it will remove a subsection from all the
                  instances of the said section (e.g. in all the "Screen"
                  sections)Nr?r=r>)rlr/r%r�rN)r1r?r=r>rdr�r2�itemr
r
r�remove_subsectionDs8��
�����
��zParser.remove_subsectioncCs�d}g}g}	|dkr|�|||�n	|j||||d�|dkr,d|dt|�d}
nd|d|||d|t|�|d}
t|j|j�}|dkr\||gd�|j|jd<|dkr�t|j|�}d}
|
|kr�|j|jD].}|j|j|�d�|
kr�|j|j|�d	�|kr�|j|j|�d
�|kr�|�|
�qs|
d7}
|
|ksmt|d�D]}||vr�|j|||d�q�|j|jD]!}|j|j|�d
�|kr�|j|j|�d	�|kr�|	�|�q�nQ|j|jD]#}|j|j|�d�|k�r|j|j|�d
�|k�r|	�|�q�t|	�dk�r9t|j|j�}||g|d�|j|jt|j|j�<|	�|�|	D]}|j|j|d
�|
��q;dS)a�Add an option to one or more subsections.
        
        section= the section which contains the subsection
        identifier= the identifier of the SubSection (e.g. Display)
        option= the option to add
        value= the value which will be assigned to the option
        option_type= if set to "Option" it will cause the option to look like
                     the following:
                     Option "NameOfTheOption" "Value"
                    
                     Otherwise it will look like the following:
                     NameOfTheOption "Value"
        position= e.g. 0 (i.e. the option will be added to a subsection which
                  is located in the first element in the list of Screen
                  sections)rANrjrErFr)r?r=r@r>r?r=rB)r?r=r@r>r@)	�remove_suboptionrnrlr/r%r�rN�ranger�)r1r?r=r�r�r�r>r��
not_to_create�	to_modifyr�rd�cursect_lengthr`r2r�r
r
r�
add_suboptionds�
����������
��
���
����
��
��
�zParser.add_suboptionc
Cs6i}t|j|�dkr�t|j|j�dkr�|j|jD]}}|j|j|}|dkr]|�d�|kr\|�d�|kr\d}|dD]}	|	�����|�����dkrW|�|g��|�|d7}q=n:|�d�|kr�|�d�|kr�|�d�|kr�d}|dD]}	|	�����|�����dkr�|�|g��|�|d7}qx~q|S)	z�Get a dictionay of the suboptions to blacklist.

        See add_suboption() for an explanation on the arguments.

        Used in both remove_option() and remove_suboption()rNr?r=r@r$rBr>)	rlr/r%r�rLrPrQrOrN)
r1r?r=r�r>r�r2�	temp_elemr`�optr
r
r�_get_suboptions_to_blacklist�s8
�
�
�
z#Parser._get_suboptions_to_blacklistc
CsV|�||||�}|D]}d}||D]}||}	|j|j|d|	=|d7}qq
dS)z#Remove an option from a subsection.rr@rBN)r�r/r%)
r1r?r=r�r>r�r2r�r��real_posr
r
rr��s�
��zParser.remove_suboptioncCsTd||f}z|j|D]}|d|kr|dWSqWt|��ty)t�w)z;Get the identifier of a specific section from its position.z1No identifier can be found for section "%s" No %drBr)r-rSrr)r1r?r>�	error_msgrgr
r
r�get_identifier�s�����zParser.get_identifiercCs�|rd|����vrdS|�����|�����sdSg}d}d}d}|�d�}	|	dkr�|D]�}
|	dvrr|dkrr|
��sg|
dkr\|dkrW|ddkrWt|�dkrW|�|�d}|d	7}n@|ddkrf||
7}n5|ddkrq||
7}n*|
��s�|
dkr|d	7}n||
7}n|ddkr�||
7}n
t|�dkr�|�|�d}|t|�d	kr�|dkr�|�|�|d	7}q.n0|D]-}
|
��s�||
7}n
t|�dkr�|�|�d}|t|�d	kr�|dkr�|�|�|d	7}q�t|�}|d	k�r�d
d�|jD�}|dk�rU|dk�rU|dk�rU|d����|v�rUz<d}
t|d	���}|j	D]}|d����|����k�r1|}
n�qz|�
|
|�}|gWWSt�yJYWdSwt�yTYnw|	dk�ry|dk�ryd}|D]}|��|��k�rpd
}�qc|dk�rydS|dk�r�|d����dk�r�dSdd�|j
D�}|	dk�r�|dk�r�|����dk�r�t|�dk�r�|d	=i}|D]}|�|��q�t|���S|	dk�r�|	dk�r�||d	S|	dk�r�|d=|S|	dk�r�|d=d�|�SdS|	dv�r�|dk�r�|SdS)z�Clean the option and return the value

        This returns the last item of the list which this method generates.

        If no value can be found, return False.r�Fr;rrA)rG�rrGrBcS�g|]}|�����qSr
)rPrL)�.0�xr
r
r�
<listcomp>J�z(Parser._clean_option.<locals>.<listcomp>r�T�TruecSr�r
)rLrP)r�rgr
r
rr�qr��inputdevice� N)rLrPrMr�r�rlrNr+�intr*r�rr�r(rOr�r��join)r1r��optnamer�r?r�r�r`r�r�r��optlen�references_listrgr�r�r=�statusr2r(�server_dictr
r
r�
_clean_option�s�


��





�(






�
���
 


�zParser._clean_optioncCs^g}|j|�|�dkrt�z
|j||�d�WdSty�|dkr*td��|j|D]d}|j||�d�|kr�|j||�d�|kr�|j||�d�|kr�|j||dD]4}	|����|	����vr�|	���d�d	kr�|	��d
|	���d��}
n|	��}
|�	|j
|
||d��q^q/t|�d
kr�t�t|�dkr�|YSz|d
WYSt
y�YYdSwt�y%|j||D]5}|����|����vr�|���d�d	kr�|��d
|���d��}
n|��}
|�	|j
|
|||d
��q�t|�d
k�rt�t|�dk�r|YSz|d
WYSt
�y$YYdSwt�y.t�w)a�Get the value which is assigned to an option.

        Return types:
          * string (if only one value is available)
            - usually in options
          * list (if more than one option is found)
            - having multiple references of the same type is allowed.
              for example it is not unusual to have 2 references to
              Screen sections in the ServerLayout section (in case of
              Xinerama)
            - if the options are actually options and not references
              then there are duplicate options, which should be detected
              in advance with get_duplicate_options()   
          * None (if no value can be found) - Not always true -> See below.

        Use-case for returning None
          * When dealing with incomplete references. For example:
                Screen "Configured Screen"
              is different from:
                Screen
                (which is an incomplete reference)
          * When dealing with incomplete options. For example:
                Depth 24
              is different from:
                Depth
                (which is an incomplete option)
          * Exception:
              Some options (with the "Option" prefix) (not references)
              can be used with no value (explicitly) assigned and are
              considered as True by the Xserver. In such case get_value()
              will return "True". For example:
                Option "AddARGBGLXVisuals" 
              is the same as:
                Option "AddARGBGLXVisuals" "True"

        Meaning of keys in Sections and SubSections:
          * When dealing with a Section:
              section= e.g. 'Screen', 'Device', etc.
              option= the option
              position= e.g. 0 (i.e. the first element in the list of Screen
                        sections)
              reference= used only by get_references()

          * When dealing with a SubSection:
              section= 'SubSection' (this is mandatory)
              option= the option
              position= e.g. 0 would mean that the subsection belongs to 
                        the 1st item of the list of, say, "Screen" sections.
                        (i.e. the first element in the list of Screen 
                        sections)
                        ["position" is a key of an item of the list of 
                        subsections see below]
              identifier= the name of the subsection e.g. 'Display'
              sect = the 'section' key of an item of the list of 
                     subsections e.g. the "Display" subsection can be 
                     found in the "Screen" section ('sect' is the latter)

        Anatomy of Sections and SubSections:
          * Anatomy of subsections:
              self.globaldict['SubSection'] =
                  {0: {'section': 'Screen', 'identifier': 'Display', 
                   'position': 0, 'options': [option1, option2, etc.], 
                   etc.}
                  In this case we refer to the 'Display' subsection 
                  which is located in the first 'Screen' section.

          * Anatomy of a section:
              self.globaldict['Screen'] =
                  {0: [option1, option2, etc.], 1: [...], ...}
              0, 1, etc. is the position N�fooz)An identifier is required for subsectionsr=r>r?r@r<r$rr�rB)r�r?)r/r�rr�ry�	ExceptionrLrPrQrNr�rlrr�r�rS)r1r?r�r>r=rgr��valuesr2r��stroptr
r
rrx�sxI��

�

�
�������zParser.get_valuecCsX|dkrz	|�||�WdStyYdSw|dkr&|j|�|�dkSd}t|��)zqSee if a section with a certain identifier exists.

        NOTE: either identifier or position must be provided.NTFz.Either identifier or position must be provided)r�rr/r�r�)r1r?r=r>r�r
r
rrs#s�zParser.is_sectionc	Csdd||f}|j|D]"}z|d����|����kr#|dWSWqty-Yqwt|��)z;Get the position of a specific section from its identifier.z%No %s section named "%s" can be foundrrB)r-rLrPryr)r1r?r=r�rgr
r
rr�4s���zParser.get_positioncCs�i�|j�}i}|jD]}i||<i||<|j|D]}|�||�|||<qq|D]H}||D]A}|||D]8}t||||�dkrp||||D]!}|jD]}|��|����kra|}qS|�||�so||�	|�qNq8q0q*|S)a�Look for references to sections which don't exist

        This returns a dictionary having the items of self.require_id as keys
        and a dictionary with the identifiers of the sections which are
        being referred to by the broken references.

        For example:

        broken_references = {
                            'InputDevice': {'InputDevice 1': None,
                                            'Another input device': None},
                            'Device': {...},
                            'Monitor' {...},
                            'Screen' {...},
                            'ServerLayout' {...}
                            }r)
r,r*r/rqrlr(rPrLrsrO)r1�broken_references�references_treer?rgr2�refsectr�r
r
rrpAs2
��
����zParser.get_broken_referencesc		Cs�g}|jd}d}|D]H}z8|�dd|�}|rDd}|jdD]}|d����|����kr9|�|d�|d7}q|dkrDd}t|��Wn	tyNYnw|d7}q|S)z�Return a list with the position of default ServerLayout sections

        NOTE: If the section set as the default ServerLayout doesn't exist
              it will raise a ParseException.rr�DefaultServerLayoutrrBrk)r/rxr-rPrLrNrr)	r1�default�serverflagsr`�flagrv�def_itr=rhr
r
rrros4
�
����
zParser.get_default_serverlayoutcCs�|dD]Y}|d|d}|d|d}|d|�d�}|d|d}||�|g��d|dd�t|�d	krO|||�d
d
�|�d�q|||�d
�|�d�qz|d=W|StynY|Sw)z<Put SubSections back into the sections to which they belong.rr?r=r>r@z
	SubSection "rArFrrEz	EndSubSection
)r�rOrNrlr�rS)r1rcrgr?r=r>r@r
r
r�_merge_subsections�s<���������zParser._merge_subsectionscCs*t�|j�}|�|�}|�|�}g}d�|j�d}|�|�|D]/}||jkrPt	||�dkrP||D]}|�d|dd�|�d�|||�d�q4q!~t
|d�sr|r_t|d�}nt|d	�}|�d�|��|�
�dSz|�ttd�|�d
���WdSty�|�d�|��YdSw)
a�Write the changes to the destination

        The destination can be either a file (e.g. /etc/X11/xorg.conf)
        or a file object (e.g. sys.stdout).

        destination = the destination file or file object (mandatory)
        test = if set to True write will append the result to the
               destination file instead of overwriting it. It has no
               effect on file objects. Useful for testing.r;rFrz	Section "rAzEndSection

r9�a�wzUTF-8�N)�copy�deepcopyr/�_merge_commented_optionsr�r�r.rNr&rlrHrIr9rKrn�bytes�	TypeError)r1�destination�testrc�linesr.r?r2r
r
rr9�s6



��

 �zParser.writecCsTg}|j|jD]}|j|j|d|kr'|j|j|d|kr'|�|�q|S)z.Get all the subsections contained in a sectionr?r>)r/r%rN)r1r?r>r�r�r
r
rr��s
�zParser.get_subsectionsc		Cs�|D]`}|j|j|d}|j|j|d}|j|j|�d�}|j|j|d}|j�d|dd�|D]}d|��}|j�|�|j�d	�q;z	|j|j|=WqtybYqwd
S)a)Put SubSections back into their sections and comment them out

        This alters globaldict and should be used only in
        comment_out_section() i.e. when the whole section is being
        commented out.

        subsections = the list of the indices subsections to merge and
        remover?r=r>r@z#	SubSection "rArF�#		%s
�#	EndSubSection
N)r/r%r�r.rNrLrS)	r1r�rgr?r=r>r@r�r�r
r
r�_permanent_merge_subsections�s$
���z#Parser._permanent_merge_subsectionscCsXg}|j|j�|�r*|j|j|D]}|j|j||�d�|kr)|�|�q|S)zBReturn the index of the entry in the Comments section of a sectionr>)r/r&r�rN)r1r?r>r.rgr
r
r�
_get_comments�s�
�zParser._get_commentscCs0d}|D]�}|j|j|d}|j|j|d}|j|j|�d�}|j|j|d}d|}|�||�}	|	shi|j|j|<i|j|j||<|j|j||}
d|
d<||
d<d|
d<g|
d<~
|j|j||d}|�|�|D]
}d|��}
|�|
�q{|�|�|j|j|=qdS)	a[Put SubSections back into their sections and comment them out

        This alters globaldict and should be used only to comment out
        subsections (i.e. in comment_out_subsection()) when the whole section
        is not being commented out.

        subsections = the list of the indices subsections to merge and
                      remover�r?r=r>r@z#	SubSection "%s"
Nr�)r/r%r�r�r&rNrL)r1r��end_subsectionrgr?r=r>r@�start_subsectionr.rc�comments_optionsr�r�r
r
r� _merge_subsections_with_comments
s:
��

�z'Parser._merge_subsections_with_commentscCs|�||�}|�|�dS)z-Comment out all the subsections of a section.N)r�r�)r1r?r>r�r
r
r�_comment_out_subsections6szParser._comment_out_subsectionscCs,|�||�}|D]}|j|j||=qdS)zBRemove comment sections of a "section" from the "Comments" sectionN)r�r/r&)r1r?r>r.�comment_sectionr
r
rr�<s�zParser._remove_comment_entriesc	Cs�d|}d}i}|r"z|�||�}|�|d�Wn)ty!Yn!w|dkr4|j||d�r3|�|d�nt|j|���}i�|�}||jvrvd}	|j	|D]'}
zt|����
|
d�}|	|t|���|<Wn	typYnw|	d7}	qNt|���}|��d}
|D]L}|j
�|�|j||D]}d|��}|j
�|�q�|�||�|j
�|�|�||�|j||=||}|dkr�||
}|j	||=|
d7}
q�dS)z.Comment out a section and all its subsections.z
#Section "%s"
z#EndSection
NrjrrBz#	%s
)r�rOrrsr�r/r�r,r*r-r�r�r�r.rNrLr�r�)r1r?r=r>�
start_section�end_sectionr�r��all_keysr`r�r�r�r�rgr��commented_option�	ident_refr�r
r
r�comment_out_sectionCsZ��

�
��zParser.comment_out_sectioncCshg}|j|jD]$}|j|j|}|d|kr+|d|kr+|d|kr+|�|�n~q|�|�dS)z�Comment out a subsection.

        section= the type of the section which contains the subsection
        identifier= the identifier of the subsection
        position= the position of the sectionr?r=r>N)r/r%rNr�)r1r?r=r>r�r%rcr
r
r�comment_out_subsection�s
zParser.comment_out_subsectionc
Cs |�|||||�}|D]�}d}||D]y}	|	|}
d|j|||
��|j|||
<|j|j�|i�t|j|j|�}|j|j|}|�|i�||�dd�||�d|�||�dd�||�dg�||d�|j|||
�~|j|||
=|d7}qqdS)	a]Comment out an option in a section.

        section= the section which will have the option commented out
        option= the option to comment out
        value= if you want to comment out an option only if it has a
               certain value
        position= e.g. 0 (i.e. the first element in the list of Screen
                      sections)r�#%sr=Nr>r?r@rB)r�r/rLr&rOrlrN)
r1r?r�r�r>r�r�r�r�rar�rdrcr
r
r�comment_out_option�s4
���
��zParser.comment_out_optionc
Cs.|�||||�}|D]�}d}||D]�}||}	d|j|j|d|	��|j|j|d|	<|j|j�|ji�|j|j|j}
|
�|i�|
|�d|�|
|�d|�|
|�d|�|
|�dg�|
|d}|j|j|d|	}|�|�~
|j|j|d|	=|d7}qq
dS)	apComment out an option in a subsection.

        section= the section which contains the subsection
        identifier= the identifier of the subsection
        option= the option to comment out
        position= the position of the section which contains the subsection
                  e.g. 0 (i.e. the first element in the list of Screen
                  sections)rrr@r=r>r?rBN)r�r/r%rLr&rOrN)
r1r?r=r�r>r�r2r�r�r�rcr�rr
r
r�comment_out_suboption�s@
�����

��zParser.comment_out_suboptioncCs8||jD]�}d}||j|D]g}||j||�d�}||j||�d�}||j||�d�}||j||d}||jkrp||D]$}	|||	}
|
d|krn|
d|krn|
d|krn|||	d}nqJq||�|�}q|r�|D]}d|��}||jkr�|�dg��|�q||�|�q|q|S)zAPut commented out options back into their sections or subsectionsNr?r=r>r@z	%s
)r&r�r%rLrOrN)r1rcrg�section_options�section_instancer?r=r>r@r�r%r�r
r
rr��sX��������
�
�
�zParser._merge_commented_optionsr4)NNNrA)NNN)NN)2r	r
rrr3r6r8�property�
globaldictr0rUrTror�r�r|rmr�r�r�r�r�r�r�rqr�r�r�r�r�r�r�rxrsr�rprrr�r9r�r�r�r�r�r�rrrr	r�r
r
r
rr*s|
P
Wn/$/

E
�H
�.
�

9
C


3
8!
�R
�
#

�

.
,,
H
�
'+r)�
__future__rr�sysrrr�r�rrrr�objectrr
r
r
r�<module>s