0x1949 Team - FAZEMRX - MANAGER
Edit File: xorgparser.cpython-310.pyc
o p��O�W � @ s� d dl mZ d dl mZ d dlZd dlmZmZ d dlZG dd� de�ZG dd� de�Z G d d � d e�Z G d d � d e�Z G d d� de �Z dS )� )�print_function)�unicode_literalsN)�stdout�stderrc @ � e Zd ZdZdS )�IdentifierExceptionz#Raise if no identifier can be foundN��__name__� __module__� __qualname__�__doc__� r r �1/usr/lib/python3/dist-packages/xkit/xorgparser.pyr � r c @ r )�OptionExceptionz&Raise when an option is not available.Nr r r r r r r r c @ r )�SectionExceptionz&Raise when a section is not available.Nr r r r r r " r r c @ r )�ParseExceptionz&Raise when a postion is not available.Nr r r r r r & r r c @ s� e Zd ZdZd\dd�Zdd� Zdd� Zeee�Zd d � Z d d � Z d d� Z dd� Z dd� Z dd� Zd\dd�Zdd� Z d]dd�Z d^d d �Z d^d d �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�Z d\d2d3�Z d4d5� Z d_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.Nc C s� d| _ d| _|| _ddddddd d d d d ddd| j | jf| _| jdd� | _g d�| _g d�| _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���)r r r r r r )r r r r r ) � subsection�commentsection�source�sections�valid_sections� require_id� references�fromkeys� identifiers�comments�_gdict� _check_sanity)�selfr' �elemr r r �__init__. s: "� zParser.__init__c C s | j S �N�r/ )r1 r r r � _get_global~ s zParser._get_globalc C s || _ d S r4 r5 )r1 � global_dictr r r � _set_global� s zParser._set_globalc C s� | j }|dkr g }nt|d�s t|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 | � || � d d� || � d g � || d � | �� � nJ|| j }| j | j � | ji � | j | j | j }|� |i � || � d |� || � d | � || � d |� || � d g � || 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 < W n t�y� ~d}t|��w ||d < g |d < ~nod}t|��| �� �� �d�dk�r�| d7 } |dk�r�d}|| j d7 < nHd}t|��|dk�r<| �� dk�r<|dk�r | j | j | d � d| �� d � n | j � |i � || }| j | � |g �� d| �� d � | d7 } q8|�sb| d dk�sR| d dk�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�rr TF� �#� 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.� � � z The 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 r r0 � s� ! �� �� � � � zParser._check_sanityc C sH t | �� �dkrdt| �� � }t|��| �� | �� }d}|D ] }|t || �7 }q |dkr9dt|� }t|��| jD ]}t | j| �t | j| �krRd}t|��q<t | jd �dkr{| jd D ]}| j d|dgd�}t |d �dkrzd}t|��qa| � � }t |�dkr�t |�d kr�d }t|��| j d|d d �s�d }t|��d S d S )zuThis method contains the several checks which can guarantee compliance with the syntax rules of the xorg.confr z&There cannot be Duplicate Sections: %sz%There cannot be Broken References: %szDNot all the sections which require an identifier have an identifier.r r )�reflistzNThe ServerLayout section must have at least 1 reference to a "Screen" section.rB zRNo 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)r1 rh �brokenr` r? �screen_references�default_layoutr r r rU ] sL � ��� �zParser._check_syntaxc C s� | j D ]Q}g | j|< d}| j| D ]B}z | �|d|�}W n ttfy/ d||f }t|��w z |�d� |d }W n tyD Y nw | 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; rB N) r* r- r/ � get_valuer r r rN �AttributeError)r1 rg r` r2 r= rh r r r rT � s, �� � ��zParser._fill_identifiersc C s� ddg}dg}| j D ]j}||vrt| j| D ]^}|| jkr&| j| | d }n| j| | }|D ]C}|�� }|�d�dkrE|d|�d�� }d|�� }| j|d d �}t|�d krf|d �� �� |vrft|��|d d � � srt|��q/qq d S ) z�One word entries are not acceptable as either options or references If a one word entry is found, ParseException will be raised.r r �endmoder@ r< r$ r z#The following option is invalid: %sT)� include_nullrB N) r( r/ r% rL rQ �_clean_duplicatesrl rP r �isalpha) r1 �sections_whitelist�options_whitelistr? r> r@ �optionrh �optbitsr r r ro � s: �� �����zParser._validate_optionsc C s g d�}g }g }|dkr| j | | d }n| j | | }|D ]T}|�� }|�d�dkr5|d|�d�� }| �|�}z.|d �� |v rK|�|d � n |d �� dkrgt|�dkrg|d d krg |�|d � W q ttfys Y q w i } |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= r r@ r< r$ r r� rB N) r/ rL rQ r| rP rN rl ry � IndexError�get) r1 r? r> � blacklist�total� duplicatesr@ r� r� �finalr r r �get_duplicate_options s8 �� z Parser.get_duplicate_optionsc C sP i }| j D ] }| j | D ]}| �||�}t|�dkr$|�|i ��||� q q|S )z5Look for and return duplicate options in all sectionsr )r/ r� rl rO )r1 r� r? r2 �duploptr r r �check_duplicate_optionsM s ���z Parser.check_duplicate_optionsc C sJ g }d}d}d}|� d�}|dkrV|D ]A}|�� s'|dkr"|d7 }n ||7 }n|d dkr2||7 }n t|�dkr?|�|� d}|t|�d krP|dkrP|�|� |d7 }qn:|D ]7}|�� sc||7 }n t|�dkrp|�|� d}|t|�d kr�|dkr�|�|� n |r�d}|�|� |d7 }qX|r�t|�|d d kr�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; r rA rB rG )�count�isspacerl rN ) r1 r� r{ r� �optbitr` � quotation�optcount�ir r r r| Z sL � zParser._clean_duplicatesc C sh i }| j D ],}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 identifierr rB )r- rN r� rO )r1 r� r? �temprg r2 r r r rm � s ���z Parser.get_duplicate_sectionsrA c C s� dg}|dkr(| j | �|�dkrt�|r | j||||d� n| j|||d� n| �||� |dkrm|dkrGd| d | t|� | d } n>|�� �� |vr`d| d | t|� | d } n%d| d t|� d } nd| d d | d d | t|� | d } t| j | �dkr�i | j |< g | j | d< || jv r�d | d } | j | d � | � |dkr�| j | D ] } | j | | � | � q�dS | j | | � | � dS ) a Add 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> rj rE rF rA r z Identifier "Default z" ) r/ r� r � remove_optionrn rL rP rl r* rN ) r1 r? r� r� � option_typer> � reference�prefix� refSections�toaddr= r2 r r r � add_option� sT � ������� �zParser.add_optionc C sn i }t | j| �dkr�|dkra| j| D ]J}d}| j| | D ]>} |dkrE| �� �|�� �dkrD| �� �|�� �dkrD|�|g ��|� n| �� �|�� �dkrY|�|g ��|� |d7 }q q|S | j| �|�dkrmdS d}| j| | D ]>} |dkr�| �� �|�� �dkr�| �� �|�� �dkr�|�|g ��|� n| �� �|�� �dkr�|�|g ��|� |d7 }qv|S )z=Private method shared by remove_option and comment_out_optionr Nr$ rB )rl r/ rP rQ rO rN r� ) r1 r? r� r� r> r� � to_remover2 r` ra r r r �_get_options_to_blacklist� s: � �"�� z Parser._get_options_to_blacklistc C sR | � |||||�}|D ]}d}|| D ]} | | } | j| | | = |d7 }qq dS )aC Remove 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)r rB N)r� r/ ) r1 r? r� r� r> r� r� �part�moddedra �realposr r r r� & s � ��zParser.remove_optionc C s t | j| �}|| jv r�|dkr}d}d}| j| D ]E}| �|||�r^z| �|||��� �� |�� �� kr9d}W n&W q ty] | �|||�D ]}|�� �� |�� �� krZd} nqHY qw q|r{g | j| |< | j||||d� | j| � ||f� |S t d| ��g | j| |< |S )a Create 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)Nrw TFr� z!%s Section requires an identifier) rl r/ r* rx rL rP ry r� r- rN r )r1 r? r= r> r� �create�subr2 r r r � make_section9 sR � �� ����� � ��zParser.make_sectionc C s� i }|r z| � ||�}|�|d� W n) ty Y n!w |dkr.| j||d�r-|�|d� nt| j| �� �}i �|�}|| jv rpd}| j | D ]'}zt|�� �� |d �} ||t|�� �| < W n t yj Y nw |d7 }qHt|�� �} | � � d} | D ]A} | � || �} | D ]}z | j| j |= W q� ty� Y q�w | �|| � | j| | = || }|dkr�|| }| j | |= | d7 } q~dS )z/Remove Sections by identifier, position or typeNrj r rB )� get_positionrO r rs �listr/ �keysr, r* r- �index� ValueError�sort�get_subsectionsr% rS �_remove_comment_entries)r1 r? r= r> r� �pos�allkeysr` r� �ref� sorted_remover� rg � subsectionsr� �identrefr� r r r �remove_sectionr sX � � � � ��zParser.remove_sectionc C � | 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� �r1 r? r� r= r> r r r � add_reference� � �zParser.add_referencec C r� )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 C s& |dkr| j }n |�d� |d= |}i �|�}|D ]w}g ||< i }z | j|||dd�}W n ty7 g }Y nw |r�z5|�d� |d= |D ](} z| �d� | d= | D ] } | r[|�| � qRW qE tym | rk|�| � Y qEw W n ty |r}|�|� Y nw t|�� �D ] } || �| � q�q|S )aW Get 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* rN r, rx r rO ry r� r� ) r1 r? r> ri r@ r+ r� �reference_dictr� r2 �extrefr� r r r rq � sT � �� ��� ���zParser.get_referencesc C s� t | j| j �}|dkrk| j| D ]W}d}| j| j D ]+}| j| j | �d�|krF| j| j | �d�|krF| j| j | �d�|krFd}q|rhi }| j| j |< ||d< ||d< g |d< ||d< ~|d7 }qdS d}| j| j D ]+}| j| j | �d�|kr�| j| j | �d�|kr�| j| j | �d�|kr�d}qs|r�i }| j| j |< ||d< ||d< g |d< ||d< ~dS dS ) 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 )rl r/ r% r� ) r1 r? r= r> rd r2 r� r� rc r r r �make_subsection s^ �����������zParser.make_subsectionc C s� t | j| j �}g }|dkr7| j| j D ]!}| j| j | �d�|kr5| j| j | �d�|kr5|�|� qn5| j| j D ].}| 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> )rl r/ r% r� rN )r1 r? r= r> rd r� r2 �itemr r r �remove_subsectionD s8 �� ����� ��zParser.remove_subsectionc C s� d}g }g } |dkr| � |||� n | j ||||d� |dkr,d| d t|� d } nd| d | | | d | t|� | d } t| j| j �} | dkr\||g d�| j| j d< |dkr�t| j| �} d} | | k r�| j| j D ].}| j| j | �d�| kr�| j| j | �d �|kr�| j| j | �d �|kr�|�| � qs| d 7 } | | k smt| d �D ]}||vr�| j|||d� q�| j| j D ]!}| j| j | �d �|kr�| j| j | �d �|kr�| �|� q�nQ| j| j D ]#}| j| j | �d�|k�r| j| j | �d �|k�r| �|� q�t| �dk�r9t| j| j �} ||g |d �| j| j t| 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)rA Nrj rE rF r )r? r= r@ r> r? r= rB )r? r= r@ r> r@ ) �remove_suboptionrn rl r/ r% r� rN �ranger� )r1 r? r= r� r� r� r> r� � not_to_create� to_modifyr� rd �cursect_lengthr` r2 r� r r r � add_suboptiond s� ���������� �� ��� ���� �� �� �zParser.add_suboptionc C s6 i }t | j| �dkr�t | j| j �dkr�| j| j D ]}}| j| j | }|dkr]|�d�|kr\|�d�|kr\d}|d D ] } | �� �� �|�� �� �dkrW|�|g ��|� |d7 }q=n:|�d�|kr�|�d�|kr�|�d�|kr�d}|d D ] } | �� �� �|�� �� �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()r Nr? r= r@ r$ rB r> ) rl r/ r% r� rL rP rQ rO rN ) r1 r? r= r� r> r� r2 � temp_elemr` �optr r r � _get_suboptions_to_blacklist� s8 � � � z#Parser._get_suboptions_to_blacklistc C sV | � ||||�}|D ] }d}|| D ]}|| } | j| j | d | = |d7 }qq dS )z#Remove an option from a subsection.r r@ rB N)r� r/ r% ) r1 r? r= r� r> r� r2 r� r� �real_posr r r r� � s � ��zParser.remove_suboptionc C sT d||f }z| j | D ]}|d |kr|d W S q W t|�� ty) t�w )z;Get the identifier of a specific section from its position.z1No identifier can be found for section "%s" No %drB r )r- rS r r )r1 r? r> � error_msgrg r r r �get_identifier� s � �� ��zParser.get_identifierc C s� |rd|� � �� v r dS |� � �� �|� � �� �sdS g }d}d}d}|�d�} | dkr�|D ]�} | dv rr|dkrr| �� sg| dkr\|dkrW|d dkrWt|�dkrW|�|� d}|d 7 }n@|d dkrf|| 7 }n5|d dkrq|| 7 }n*| �� s�| dkr|d 7 }n || 7 }n|d dkr�|| 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�q z | � | |�}|gW W S t �yJ Y W dS w t �yT Y nw | d k�ry|dk�ryd}|D ]}|�� |�� k�rpd }�qc|dk�rydS | dk�r�|d �� � � dk�r�dS dd � | j D �}| d k�r�|dk�r�|�� � � dk�r�t|�dk�r�|d = i }|D ]}|�|� �q�t|�� �S | dk�r�| d k�r�|| d S | d k�r�|d= |S | dk�r�|d= d�|�S dS | dv �r�|dk�r�|S dS )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; r rA )rG � r rG rB c S � g | ]}|� � �� �qS r )rP rL )�.0�xr r r � <listcomp>J � z(Parser._clean_option.<locals>.<listcomp>r� T�Truec S r� r )rL rP )r� rg r r r r� q r� � inputdevice� N)rL rP rM r� r� rl rN r+ �intr* r� r r� r( rO r� r� �join)r1 r� �optnamer� r? r� r� r` r� r� r� �optlen�references_listrg r� r� r= �statusr2 r( � server_dictr r r � _clean_option� s� � � �( � ��� �zParser._clean_optionc C s^ g }| j | �|�dkrt�z | j | | �d� W dS ty� |dkr*td��| j | D ]d}| j | | �d�|kr�| j | | �d�|kr�| j | | �d�|kr�| j | | d D ]4} |�� �� | �� �� v r�| �� �d�d kr�| �� d | �� �d�� } n| �� } |� | j | ||d �� q^q/t |�d kr�t �t |�d kr�| Y S z|d W Y S t y� Y Y dS w t�y% | j | | D ]5}|�� �� |�� �� v r�|�� �d�d kr�|�� d |�� �d�� } n|�� } |� | j | |||d �� q�t |�d k�rt �t |�d k�r| Y S z|d W Y S t �y$ Y Y dS w t�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$ r r� rB )r� r? )r/ r� r r� ry � ExceptionrL rP rQ rN r� rl r r� r� rS ) r1 r? r� r> r= rg r� �valuesr2 r� �stroptr r r rx � sx I �� � � �� � ����zParser.get_valuec C sX |dkrz | � ||� W dS ty Y dS w |dkr&| j| �|�dkS d}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� r r/ r� r� )r1 r? r= r> r� r r r rs # s �zParser.is_sectionc C sd d||f }| j | D ]"}z|d �� �� |�� �� kr#|d W S W q ty- Y q w t|��)z;Get the position of a specific section from its identifier.z%No %s section named "%s" can be foundr rB )r- rL rP ry r )r1 r? r= r� rg r r r r� 4 s � � �zParser.get_positionc C s� 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/ rq rl r( rP rL rs rO )r1 �broken_references�references_treer? rg r2 �refsectr� r r r rp A s2 �� � ���z Parser.get_broken_referencesc C s� g }| j d }d}|D ]H}z8| �dd|�}|rDd}| jd D ]}|d �� �� |�� �� kr9|�|d � |d7 }q |dkrDd}t|��W n tyN Y nw |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.r r �DefaultServerLayoutr rB rk )r/ rx r- rP rL rN r r ) r1 �default� serverflagsr` �flagrv �def_itr= rh r r r rr o s4 � ��� � z Parser.get_default_serverlayoutc C s� |d D ]Y}|d | d }|d | d }|d | � d�}|d | d }|| �|g ��d| d d � t|�d krO|| | �d d �|� d � q|| | �d �|�d � qz|d= W |S tyn Y |S w ) z<Put SubSections back into the sections to which they belong.r r? r= r> r@ z SubSection "rA rF r rE z EndSubSection )r� rO rN rl r� rS )r1 rc rg r? r= r> r@ r r r �_merge_subsections� s< ���� ��� ��zParser._merge_subsectionsc C s* t �| j�}| �|�}| �|�}g }d�| j�d }|�|� |D ]/}|| jkrPt || �dkrP|| D ]}|�d| d d � |�d�|| | �d � q4q!~t |d�sr|r_t |d�}nt |d �}|� d�|�� |� � d S z|� ttd�|�d ��� W d S ty� |� d �|�� Y d S w ) 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; rF r z Section "rA z EndSection r9 �a�wzUTF-8� N)�copy�deepcopyr/ �_merge_commented_optionsr� r� r. rN r& rl rH rI r9 rK rn �bytes� TypeError)r1 � destination�testrc �linesr. r? r2 r r r r9 � s6 �� �z Parser.writec C sT g }| j | j D ] }| j | j | d |kr'| j | j | d |kr'|�|� q|S )z.Get all the subsections contained in a sectionr? r> )r/ r% rN )r1 r? r> r� r� r r r r� � s �zParser.get_subsectionsc C s� |D ]`}| j | j | d }| j | j | d }| j | j | �d�}| j | j | d }| j�d| d d � |D ]}d|�� }| j�|� | j�d � q;z | j | j |= W q tyb Y qw d 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 "rA rF �# %s �# EndSubSection N)r/ r% r� r. rN rL rS ) r1 r� rg r? r= r> r@ r� r� r r r � _permanent_merge_subsections� s$ � ��z#Parser._permanent_merge_subsectionsc C sX g }| 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 )r1 r? r> r. rg r r r � _get_comments� s � �zParser._get_commentsc C s0 d}|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& rN rL )r1 r� �end_subsectionrg r? r= r> r@ �start_subsectionr. rc �comments_optionsr� r� r r r � _merge_subsections_with_comments s: �� �z'Parser._merge_subsections_with_commentsc C s | � ||�}| �|� dS )z-Comment out all the subsections of a section.N)r� r� )r1 r? r> r� r r r �_comment_out_subsections6 s z Parser._comment_out_subsectionsc C s, | � ||�}|D ] }| j| j | |= qdS )zBRemove comment sections of a "section" from the "Comments" sectionN)r� r/ r& )r1 r? r> r. �comment_sectionr r r r� < s �z Parser._remove_comment_entriesc C s� d| }d}i }|r"z| � ||�}|�|d� W n) ty! Y n!w |dkr4| j||d�r3|�|d� nt| j| �� �}i �|�}|| jv rvd} | j | D ]'} zt|�� �� | d �} | |t|�� �| < W n t yp Y nw | 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 Nrj r rB z# %s )r� rO r rs r� r/ r� r, r* r- r� r� r� r. rN rL r� r� )r1 r? r= r> � start_section� end_sectionr� r� �all_keysr` r� r� r� r� rg r� �commented_option� ident_refr� r r r �comment_out_sectionC sZ � � � ��zParser.comment_out_sectionc C sh g }| j | j D ]$}| 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% rN r� )r1 r? r= r> r� r% rc r r r �comment_out_subsection� s z Parser.comment_out_subsectionc C s | � |||||�}|D ]�}d}|| D ]y} | | } d| j| | | �� | j| | | < | j| j �|i � t| j| j | �} | j| j | } | �|i � | | �dd� | | �d|� | | �dd� | | �dg � | | d �| j| | | � ~ | j| | | = |d7 }qq dS ) 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/ rL r& rO rl rN ) r1 r? r� r� r> r� r� r� r� ra r� rd rc r r r �comment_out_option� s4 � � � ��zParser.comment_out_optionc C s. | � ||||�}|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 ) ap Comment 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)r r r@ r= r> r? rB N)r� r/ r% rL r& rO rN ) r1 r? r= r� r> r� r2 r� r� r� rc r� r r r r �comment_out_suboption� s@ � �� �� ��z Parser.comment_out_suboptionc C s8 || j D ]�}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% rL rO rN ) r1 rc rg �section_options�section_instancer? r= r> r@ r� r% r� r r r r� � sX �� �� �� �� � � �z Parser._merge_commented_optionsr4 )NNNrA )NNN)NN)2r r r r r3 r6 r8 �property� globaldictr0 rU rT ro r� r� r| rm r� r� r� r� r� r� r� rq r� r� r� r� r� r� r� rx rs r� rp rr r� r9 r� r� r� r� r� r� r r r r r� r r r r r * s| P Wn/$/ E �H �. � 9 C 3 8! �R � # � . , , H � ' +r )� __future__r r �sysr r r� r� r r r r �objectr r r r r �<module> s