| Server IP : 209.205.66.10 / Your IP : 216.73.216.173 Web Server : Apache/2.4.52 (Ubuntu) System : Linux ammon 5.15.0-186-generic #196-Ubuntu SMP Sat Jun 20 16:09:34 UTC 2026 x86_64 User : ( 1006) PHP Version : 8.5.8 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /lib/python3/dist-packages/xdg/__pycache__/ |
Upload File : |
o
�stZ6D � @ s` d Z ddlmZmZ ddlZddlmZ ddlm Z ddl
Z ddl Z ddl
Z
G dd� de�ZdS )a/
Complete implementation of the XDG Desktop Entry Specification
http://standards.freedesktop.org/desktop-entry-spec/
Not supported:
- Encoding: Legacy Mixed
- Does not check exec parameters
- Does not check URL's
- Does not completly validate deprecated/kde items
- Does not completly check categories
� )�IniFile�is_asciiN)� ParsingError)�whichc @ s� e Zd ZdZdZdrdd�Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Z d4d5� Z d6d7� Z d8d9� Z d:d;� Z d<d=� Z!d>d?� Z"d@dA� Z#dBdC� Z$dDdE� Z%dFdG� Z&dHdI� Z'dJdK� Z(dLdM� Z)dNdO� Z*dPdQ� Z+dRdS� Z,dTdU� Z-dVdW� Z.dXdY� Z/dZd[� Z0d\d]� Z1d^d_� Z2d`da� Z3dbdc� Z4ddde� Z5dfdg� Z6dhdi� Z7djdk� Z8dldm� Z9dndo� Z:dpdq� Z;dS )s� DesktopEntryz+Class to parse and validate Desktop Entries�
Desktop EntryNc C s< t � | _|rtj�|�r| �|� dS |r | �|� dS dS )z�Create a new DesktopEntry.
If filename exists, it will be parsed as a desktop entry file. If not,
or if filename is None, a blank DesktopEntry is created.
N)�dict�content�os�path�exists�parse�new)�self�filename� r �2/usr/lib/python3/dist-packages/xdg/DesktopEntry.py�__init__ s �zDesktopEntry.__init__c C s | � � S �N)�getName�r r r r �__str__& s zDesktopEntry.__str__c C s t �| |ddg� dS )z�Parse a desktop entry file.
This can raise :class:`~xdg.Exceptions.ParsingError`,
:class:`~xdg.Exceptions.DuplicateGroupError` or
:class:`~xdg.Exceptions.DuplicateKeyError`.
r �KDE Desktop EntryN)r r
)r �filer r r r
) s zDesktopEntry.parsec C s | j ddd�}t|�S )z�Looks in the PATH for the executable given in the TryExec field.
Returns the full path to the executable if it is found, None if not.
Raises :class:`~xdg.Exceptions.NoKeyError` if TryExec is not present.
�TryExecT)�strict)�getr )r �tryexecr r r � findTryExec2 s zDesktopEntry.findTryExecc C �
| � d�S )N�Type�r r r r r �getType< �
zDesktopEntry.getTypec C � | j ddd�S )z)deprecated, use getVersionString instead �Version�numeric��typer! r r r r �
getVersion> s zDesktopEntry.getVersionc C r )Nr% r! r r r r �getVersionStringA r# z DesktopEntry.getVersionStringc C r$ )N�NameT��localer! r r r r r C � zDesktopEntry.getNamec C r$ )N� GenericNameTr, r! r r r r �getGenericNameE r. zDesktopEntry.getGenericNamec C r$ )N� NoDisplay�booleanr' r! r r r r � getNoDisplayG r. zDesktopEntry.getNoDisplayc C r$ )N�CommentTr, r! r r r r �
getCommentI r. zDesktopEntry.getCommentc C r$ )N�IconTr, r! r r r r �getIconK r. zDesktopEntry.getIconc C r$ )N�Hiddenr2 r' r! r r r r � getHiddenM r. zDesktopEntry.getHiddenc C r$ )N�
OnlyShowInT��listr! r r r r �
getOnlyShowInO r. zDesktopEntry.getOnlyShowInc C r$ )N� NotShowInTr; r! r r r r � getNotShowInQ r. zDesktopEntry.getNotShowInc C r )Nr r! r r r r �
getTryExecS r# zDesktopEntry.getTryExecc C r )N�Execr! r r r r �getExecU r# zDesktopEntry.getExecc C r )N�Pathr! r r r r �getPathW r# zDesktopEntry.getPathc C r$ )N�Terminalr2 r' r! r r r r � getTerminalY r. zDesktopEntry.getTerminalc C s | j dddd�S )z%deprecated, use getMimeTypes instead �MimeTypeT�regex)r< r( r! r r r r � getMimeType[ s zDesktopEntry.getMimeTypec C r$ )NrG Tr; r! r r r r � getMimeTypes^ r. zDesktopEntry.getMimeTypesc C r$ )N�
CategoriesTr; r! r r r r �
getCategories` r. zDesktopEntry.getCategoriesc C r$ )N�
StartupNotifyr2 r' r! r r r r �getStartupNotifyb r. z DesktopEntry.getStartupNotifyc C r )N�StartupWMClassr! r r r r �getStartupWMClassd r# z DesktopEntry.getStartupWMClassc C r )N�URLr! r r r r �getURLf r# zDesktopEntry.getURLc C r$ )N� ServiceTypesTr; r! r r r r �getServiceTypesk r. z DesktopEntry.getServiceTypesc C r )N�DocPathr! r r r r �
getDocPathm r# zDesktopEntry.getDocPathc C s | j dddd�S )N�KeywordsT)r< r- r! r r r r � getKeywordso s zDesktopEntry.getKeywordsc C r )N�InitialPreferencer! r r r r �getInitialPreferenceq r# z!DesktopEntry.getInitialPreferencec C r )N�Devr! r r r r �getDevs r# zDesktopEntry.getDevc C r )N�FSTyper! r r r r � getFSTypeu r# zDesktopEntry.getFSTypec C r )N�
MountPointr! r r r r �
getMountPointw r# zDesktopEntry.getMountPointc C r$ )N�ReadOnlyr2 r' r! r r r r � getReadonlyy r. zDesktopEntry.getReadonlyc C r$ )N� UnmountIconTr, r! r r r r �getUnmountIcon{ r. zDesktopEntry.getUnmountIconc C r$ )N�MiniIconTr, r! r r r r � getMiniIcon� r. zDesktopEntry.getMiniIconc C r )N�TerminalOptionsr! r r r r �getTerminalOptions� r# z DesktopEntry.getTerminalOptionsc C r )N�
DefaultAppr! r r r r �
getDefaultApp� r# zDesktopEntry.getDefaultAppc C r$ )N� ProtocolsTr; r! r r r r � getProtocols� r. zDesktopEntry.getProtocolsc C r$ )N�
ExtensionsTr; r! r r r r �
getExtensions� r. zDesktopEntry.getExtensionsc C r )N�
BinaryPatternr! r r r r �getBinaryPattern� r# z DesktopEntry.getBinaryPatternc C r )N� MapNotifyr! r r r r � getMapNotify� r# zDesktopEntry.getMapNotifyc C r )N�Encodingr! r r r r � getEncoding� r# zDesktopEntry.getEncodingc C r$ )N� SwallowTitleTr, r! r r r r �getSwallowTitle� r. z DesktopEntry.getSwallowTitlec C r )N� SwallowExecr! r r r r �getSwallowExec� r# zDesktopEntry.getSwallowExecc C r$ )N� SortOrderTr; r! r r r r � getSortOrder� r. zDesktopEntry.getSortOrderc C r$ )N� FilePatternrH r' r! r r r r �getFilePattern� r. zDesktopEntry.getFilePatternc C r$ )N�ActionsTr; r! r r r r �
getActions� r. zDesktopEntry.getActionsc C sh t j�|�d dkr
d}nt j�|�d dkrd}ntd|��t� | _| �| j� | �d|� || _ dS ) a$ Make this instance into a new, blank desktop entry.
If filename has a .desktop extension, Type is set to Application. If it
has a .directory extension, Type is Directory. Other extensions will
cause :class:`~xdg.Exceptions.ParsingError` to be raised.
� �.desktop� Application�
.directory� DirectoryzUnknown extensionr N)
r
r �splitextr r r �addGroup� defaultGroup�setr )r r r( r r r r � s
zDesktopEntry.newc C s� | j dkr | j�d� | jdkr| j�d� n| jdkr'| jdkr'| j�d� z | j| j d | _W n tyA | j�d � Y nw z | j| j d
| _W d S ty^ | j�d � Y d S w ) Nr z([KDE Desktop Entry]-Header is deprecatedz.kdelnkz$File extension .kdelnk is deprecatedr� r� zUnknown File extensionr zKey 'Type' is missingr+ zKey 'Name' is missing) r� �warnings�append�
fileExtensionr r( �KeyError�errors�namer r r r � checkExtras� s
� �zDesktopEntry.checkExtrasc C sr || j ks t�d|�s t�d|�rt|�s | j�d| � d S d| j| v r5d| j| v r7| j�d� d S d S d S )Nz ^Desktop Action [a-zA-Z0-9-]+$z^X-zInvalid Group name: %sr: r> z;Group may either have OnlyShowIn or NotShowIn, but not both)r� �re�matchr r� r� r )r �groupr r r �
checkGroup� s
�
�� �zDesktopEntry.checkGroupc C s� |dkr�|dks|dks|dkr| j �d| � n |dkr$| j �d� n|dks8|d ks8|d
ks8| j�d | � | jd krJ|d
ksJ| j �d
| � n| jdkrY|d
krY| j �d� |dkrjd| j| vrj| j �d� |d kr}d| j| vr| j �d� d S d S d S |dkr�| �||� d S t�dtj j
d |�r�d S t�dtj j
d |�r�d S |dkr�| j||dd� d S t�dtj j
d |�r�d S t�d tj j
d |�r�| �||� d S |d kr�| j||dd� d S |d kr�| j||d d � | � |� d S |d!k�r| j||d d � | � |� d S |d"k�r!| �||� | � |d� d S |dk�r4| �||� | � |d� d S |d#k�rG| �||� | � |d� d S |d$k�r\| j||dd� | � |d� d S |d%k�rq| j||d d � | � |d� d S |dk�r�| j||d d � | � |d� d S |d&k�r�| �||� | � |d� | �
|� d S t�d'tj j
d |��r�| j||d(d d)� | � |d� d S |d*k�r�| j||dd� | � |d� d S |d+k�r�| � |d� d S |dk�r�| �||� | � |d� d S |d,k�r| j||d d � | j �d-| � d S |d.k�r | �||� | j �d-| � d S |d/k�r4| j||d0d� | j �d-| � d S |d1k�rO| �||� | � |d� | j �d-| � d S |d2k�rj| �||� | � |d� | j �d-| � d S |d3k�r�| �||� | � |d� | j �d-| � d S |d4k�r�| j||dd� | � |d� | j �d-| � d S t�d5tj j
d |��r�| �||� | � |d� | j �d-| � d S |d6k�r�| �||� | j �d7| � d S t�d8tj j
d |��r�| �||� | j �d7| � d S |d9k�r | �||� | j �d7| � d S |d:k�r!| �||� | j �d7| � d S |d;k�r8| j||d d � | j �d7| � d S |d<k�rO| j||d d � | j �d7| � d S |d=k�rd| �||� | j �d7| � d S |d>k�ry| �||� | j �d7| � d S t�d?tj j
d |��r�| j �d7| � d S |d@k�r�| �||� | j �d7| � d S |dAk�r�| j||dBd d)� | j �d7| � d S |dCk�r�| j||d d � | j �d7| � d S t�dD|��r�d S | j�dE| � d S )FNr � ServiceType�Service�FSDevicezType=%s is a KDE extensionrG zType=MimeType is deprecatedr� �Linkr� zGValue of key 'Type' must be Application, Link or Directory, but is '%s'r� z.File extension is .directory, but Type is '%s'r� z>Files with Type=Directory should have the extension .directoryrA z!Type=Application needs 'Exec' keyrQ zType=Link needs 'URL' keyr% z^Name�$z ^GenericNamer1 r2 r' z^Commentz^Iconr8 r: Tr; r> r rC rE r} rK z ^Keywords� localestring)r( r< rM rO rS zKey '%s' is a KDE extensionrU rY r& r[ r] r_ ra z ^UnmountIconrs zKey '%s' is deprecatedz ^MiniIconrg ri rk rm ro rq z
^SwallowTitlerw r{ rH ry z^X-[a-zA-Z0-9-]+zInvalid key: %s)r� r� r� r� r �
checkValuer� r� �xdg�LocalerH �checkOnlyShowIn� checkType�checkCategories)r �key�valuer� r r r �checkKey� s �
zDesktopEntry.checkKeyc C s( | � � |ks| j�d||f � d S d S )Nz Key '%s' only allowed in Type=%s)r" r� r� )r r� r( r r r r� � s �zDesktopEntry.checkTypec C sH | � |�}g d�}|D ]}||vr!|dd� dkr!| j�d| � q d S )N)
�GNOME�KDE�LXDE�MATE�Razor�ROX�TDE�Unity�XFCE�Oldr � �X-z)'%s' is not a registered OnlyShowIn value)�getListr� r� )r r� �values�valid�itemr r r r� � s
��z DesktopEntry.checkOnlyShowInc st | � |�}g d�� t� fdd�|D ��s| j�d� g d�}|� }|D ]}||vr7|�d�s7| j�d| � q$d S )N)
�
AudioVideo�Audio�Video� Development� Education�Game�Graphics�Network�Office�Science�Settings�System�Utilityc 3 s � | ]}|� v V qd S r r )�.0r� ��mainr r � <genexpr>� s � z/DesktopEntry.checkCategories.<locals>.<genexpr>zMissing main category)~�Building�Debugger�IDE� GUIDesigner� Profiling�RevisionControl� Translation�Calendar�ContactManagement�Database�
Dictionary�Chart�Email�Finance� FlowChart�PDA�ProjectManagement� Presentation� Spreadsheet�
WordProcessor�
2DGraphics�VectorGraphics�RasterGraphics�
3DGraphics�Scanning�OCR� Photography�
Publishing�Viewer� TextTools�DesktopSettings�HardwareSettings�Printing�PackageManager�Dialup�InstantMessaging�Chat� IRCClient�Feed� FileTransfer�HamRadio�News�P2P� RemoteAccess� Telephony�TelephonyTools�VideoConference�
WebBrowser�WebDevelopment�Midi�Mixer� Sequencer�Tuner�TV�AudioVideoEditing�Player�Recorder� DiscBurning�
ActionGame�
AdventureGame�
ArcadeGame� BoardGame�
BlocksGame�CardGame�KidsGame� LogicGame� RolePlaying�Shooter�
Simulation�
SportsGame� StrategyGame�Art� Construction�Music� Languages�ArtificialIntelligence� Astronomy�Biology� Chemistry�ComputerScience�DataVisualization�Economy� Electricity� Geography�Geology�
Geoscience�History�
Humanities�ImageProcessing�
Literature�Maps�Math�NumericalAnalysis�MedicalSoftware�Physics�Robotics� Spirituality�Sports�ParallelComputing� Amusement� Archiving� Compression� Electronics�Emulator� Engineering� FileTools� FileManager�TerminalEmulator�
Filesystem�Monitor�Security�
Accessibility�
Calculator�Clock�
TextEditor�
Documentation�Adult�Corer� r� r� �GTK�Qt�Motif�Java� ConsoleOnlyr� z!'%s' is not a registered Category)r� �anyr� r� �
startswith)r r� r� �
additional�
allcategoriesr� r r� r r� � s
��z DesktopEntry.checkCategoriesc C s t �dt� | �|�S )z`Deprecated alias for checkCategories - only exists for backwards
compatibility.
z1checkCategorie is deprecated, use checkCategories)r� �warn�DeprecationWarningr� )r r� r r r �checkCategorie� s �
zDesktopEntry.checkCategorier )<�__name__�
__module__� __qualname__�__doc__r� r r r
r r" r) r* r r0 r3 r5 r7 r9 r= r? r@ rB rD rF rI rJ rL rN rP rR rT rV rX rZ r\ r^ r` rb rd rf rh rj rl rn rp rr rt rv rx rz r| r~ r r� r� r� r� r� r� rD r r r r r sv
= r )rH � xdg.IniFiler r �
xdg.Localer� �xdg.Exceptionsr �xdg.utilr �os.pathr
r� r� r r r r r �<module> s