Mini Shell
3
�N�P�A � @ sT d Z ddlmZmZ ddlZddlmZ ddlZ ddl
Z
ddl Z G dd� de�Z dS )a=
Complete implementation of the XDG Desktop Entry Specification Version 0.9.4
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)� ParsingErrorc @ s� e Zd ZdZdZdpdd�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:dS )q� DesktopEntryz+Class to parse and validate Desktop Entriesz
Desktop EntryNc C s6 t � | _|r$tjj|�r$| j|� n|r2| j|� 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 �"/usr/lib/python3.6/DesktopEntry.py�__init__ s
zDesktopEntry.__init__c C s | j � S )N)�getName)r
r r r �__str__% s zDesktopEntry.__str__c C s t j| |ddg� dS )zParse a desktop entry file.z
Desktop EntryzKDE Desktop EntryN)r r )r
�filer r r r ( s zDesktopEntry.parsec C s
| j d�S )N�Type)�get)r
r r r �getType- s zDesktopEntry.getTypec C s | j ddd�S )z)deprecated, use getVersionString instead �Version�numeric)�type)r )r
r r r �
getVersion/ s zDesktopEntry.getVersionc C s
| j d�S )Nr )r )r
r r r �getVersionString2 s z DesktopEntry.getVersionStringc C s | j ddd�S )N�NameT)�locale)r )r
r r r r 4 s zDesktopEntry.getNamec C s | j ddd�S )NZ GenericNameT)r )r )r
r r r �getGenericName6 s zDesktopEntry.getGenericNamec C s | j ddd�S )N� NoDisplay�boolean)r )r )r
r r r � getNoDisplay8 s zDesktopEntry.getNoDisplayc C s | j ddd�S )N�CommentT)r )r )r
r r r �
getComment: s zDesktopEntry.getCommentc C s | j ddd�S )NZIconT)r )r )r
r r r �getIcon< s zDesktopEntry.getIconc C s | j ddd�S )N�Hiddenr! )r )r )r
r r r � getHidden> s zDesktopEntry.getHiddenc C s | j ddd�S )N�
OnlyShowInT)�list)r )r
r r r �
getOnlyShowIn@ s zDesktopEntry.getOnlyShowInc C s | j ddd�S )N� NotShowInT)r) )r )r
r r r � getNotShowInB s zDesktopEntry.getNotShowInc C s
| j d�S )N�TryExec)r )r
r r r �
getTryExecD s zDesktopEntry.getTryExecc C s
| j d�S )N�Exec)r )r
r r r �getExecF s zDesktopEntry.getExecc C s
| j d�S )N�Path)r )r
r r r �getPathH s zDesktopEntry.getPathc C s | j ddd�S )N�Terminalr! )r )r )r
r r r � getTerminalJ s zDesktopEntry.getTerminalc C s | j dddd�S )z%deprecated, use getMimeTypes instead �MimeTypeT�regex)r) r )r )r
r r r � getMimeTypeL s zDesktopEntry.getMimeTypec C s | j ddd�S )Nr5 T)r) )r )r
r r r � getMimeTypesO s zDesktopEntry.getMimeTypesc C s | j ddd�S )N�
CategoriesT)r) )r )r
r r r �
getCategoriesQ s zDesktopEntry.getCategoriesc C s | j ddd�S )N�
StartupNotifyr! )r )r )r
r r r �getStartupNotifyS s z DesktopEntry.getStartupNotifyc C s
| j d�S )N�StartupWMClass)r )r
r r r �getStartupWMClassU s z DesktopEntry.getStartupWMClassc C s
| j d�S )N�URL)r )r
r r r �getURLW s zDesktopEntry.getURLc C s | j ddd�S )N� ServiceTypesT)r) )r )r
r r r �getServiceTypes\ s z DesktopEntry.getServiceTypesc C s
| j d�S )N�DocPath)r )r
r r r �
getDocPath^ s zDesktopEntry.getDocPathc C s | j dddd�S )NZKeywordsT)r) r )r )r
r r r � getKeywords` s zDesktopEntry.getKeywordsc C s
| j d�S )N�InitialPreference)r )r
r r r �getInitialPreferenceb s z!DesktopEntry.getInitialPreferencec C s
| j d�S )N�Dev)r )r
r r r �getDevd s zDesktopEntry.getDevc C s
| j d�S )N�FSType)r )r
r r r � getFSTypef s zDesktopEntry.getFSTypec C s
| j d�S )N�
MountPoint)r )r
r r r �
getMountPointh s zDesktopEntry.getMountPointc C s | j ddd�S )N�ReadOnlyr! )r )r )r
r r r � getReadonlyj s zDesktopEntry.getReadonlyc C s | j ddd�S )NZ UnmountIconT)r )r )r
r r r �getUnmountIconl s zDesktopEntry.getUnmountIconc C s | j ddd�S )NZMiniIconT)r )r )r
r r r � getMiniIconq s zDesktopEntry.getMiniIconc C s
| j d�S )N�TerminalOptions)r )r
r r r �getTerminalOptionss s z DesktopEntry.getTerminalOptionsc C s
| j d�S )N�
DefaultApp)r )r
r r r �
getDefaultAppu s zDesktopEntry.getDefaultAppc C s | j ddd�S )N� ProtocolsT)r) )r )r
r r r � getProtocolsw s zDesktopEntry.getProtocolsc C s | j ddd�S )N�
ExtensionsT)r) )r )r
r r r �
getExtensionsy s zDesktopEntry.getExtensionsc C s
| j d�S )N�
BinaryPattern)r )r
r r r �getBinaryPattern{ s z DesktopEntry.getBinaryPatternc C s
| j d�S )N� MapNotify)r )r
r r r � getMapNotify} s zDesktopEntry.getMapNotifyc C s
| j d�S )N�Encoding)r )r
r r r � getEncoding s zDesktopEntry.getEncodingc C s | j ddd�S )NZ SwallowTitleT)r )r )r
r r r �getSwallowTitle� s z DesktopEntry.getSwallowTitlec C s
| j d�S )N� SwallowExec)r )r
r r r �getSwallowExec� s zDesktopEntry.getSwallowExecc C s | j ddd�S )N� SortOrderT)r) )r )r
r r r � getSortOrder� s zDesktopEntry.getSortOrderc C s | j ddd�S )N� FilePatternr6 )r )r )r
r r r �getFilePattern� s zDesktopEntry.getFilePatternc C s | j ddd�S )N�ActionsT)r) )r )r
r r r �
getActions� s zDesktopEntry.getActionsc C sh t jj|�d dkrd}n$t jj|�d dkr4d}n
td|��t� | _| j| j� | jd|� || _ dS ) z�Make this instance into a new desktop entry.
If filename has a .desktop extension, Type is set to Application. If it
has a .directory extension, Type is Directory.
� z.desktop� Applicationz
.directory� DirectoryzUnknown extensionr N)
r r �splitextr r r ZaddGroup� defaultGroup�setr )r
r r r r r r � s
zDesktopEntry.newc C s� | j dkr| jjd� | jdkr.| jjd� n | jdkrN| jdkrN| jjd� y| j| j d | _W n tk
r� | jjd � Y nX y| j| j d
| _W n tk
r� | jjd � Y nX d S ) NzKDE Desktop Entryz([KDE Desktop Entry]-Header is deprecatedz.kdelnkz$File extension .kdelnk is deprecatedz.desktopz
.directoryzUnknown File extensionr zKey 'Type' is missingr zKey 'Name' is missing) rm �warnings�append�
fileExtensionr r �KeyError�errors�name)r
r r r � checkExtras� s
zDesktopEntry.checkExtrasc C sh || j kp(tjd|�p(tjd|�o(t|�s<| jjd| � n(d| j| krdd| j| krd| jjd� 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)rm �re�matchr rs rp r )r
�groupr r r �
checkGroup� s
zDesktopEntry.checkGroupc C s� |dkr�|dks |dks |dkr2| j jd| � n>|dkrH| j jd� n(|dkp^|d kp^|d
ksp| jjd | � | jd kr�|d
k r�| j jd
| � n | jdkr�|d
kr�| j jd� |dkr�d| j| kr�| j jd� |d kr�d| j| kr�| j jd� �n�|dk�r| j||� �n�tjdtj j
d |��r4�n�tjdtj j
d |��rR�nt|dk�rp| j||dd� �nVtjdtj j
d |��r��n8tjd tj j
d |��r�| j||� �n|d k�r�| j||dd� �n�|d k�r�| j||d d � | j |� �n�|d!k�r&| j||d d � | j |� �n�|d"k�rL| j||� | j |d� �nz|dk�rr| j||� | j |d� �nT|d#k�r�| j||� | j |d� �n.|d$k�r�| j||dd� | j |d� �n|d%k�r�| j||d d � | j |d� �n�|dk�r| j||d d � | j |d� �n�|d&k�rF| j||� | j |d� | j
|� �n�tjd'tj j
d |��r�| j||d(d d)� | j |d� �nD|d*k�r�| j||dd� | j |d� �n|d+k�r�| j |d� �n |dk�r�| j||� | j |d� �n�|d,k�r| j||d d � | j jd-| � �n�|d.k�rD| j||� | j jd-| � �n�|d/k�rr| j||d0d� | j jd-| � �nT|d1k�r�| j||� | j |d� | j jd-| � �n |d2k�r�| j||� | j |d� | j jd-| � �n�|d3k�r| j||� | j |d� | j jd-| � �n�|d4k�rN| j||dd� | j |d� | j jd-| � �nxtjd5tj j
d |��r�| j||� | j |d� | j jd-| � �n2|d6k�r�| j||� | j jd7| � �ntjd8tj j
d |��r�| j||� | j jd7| � �n�|d9k�r"| j||� | j jd7| � �n�|d:k�rL| j||� | j jd7| � �nz|d;k�rz| j||d d � | j jd7| � �nL|d<k�r�| j||d d � | j jd7| � �n |d=k�r�| j||� | j jd7| � n�|d>k�r�| j||� | j jd7| � n�tjd?tj j
d |��r$| j jd7| � n�|d@k�rL| j||� | j jd7| � nz|dAk�rz| j||dBd d)� | j jd7| � nL|dCk�r�| j||d d � | j jd7| � n tjdD|��r�n| jjdE| � d S )FNr Z ServiceTypeZServiceZFSDevicezType=%s is a KDE extensionr5 zType=MimeType is deprecatedrj ZLinkrk zGValue of key 'Type' must be Application, Link or Directory, but is '%s'z
.directoryz.File extension is .directory, but Type is '%s'z.desktopz>Files with Type=Directory should have the extension .directoryr/ z!Type=Application needs 'Exec' keyr? zType=Link needs 'URL' keyr z^Name�$z ^GenericNamer r! )r z^Commentz^Iconr& r( T)r) r+ r- r1 r3 rg r9 z ^KeywordsZ localestring)r r) r; r= rA zKey '%s' is a KDE extensionrC rF r rH rJ rL rN z ^UnmountIconr^ zKey '%s' is deprecatedz ^MiniIconrR rT rV rX rZ r\ z
^SwallowTitlera re r6 rc z^X-[a-zA-Z0-9-]+zInvalid key: %s)ro rp rs rq r Z
checkValuerv rw �xdgZLocaler6 �checkOnlyShowIn� checkType�checkCategories)r
�key�valuerx r r r �checkKey� s
zDesktopEntry.checkKeyc C s$ | j � |ks | jjd||f � d S )Nz Key '%s' only allowed in Type=%s)r rs rp )r
r r r r r r} � s zDesktopEntry.checkTypec
C s\ | j |�}ddddddddd d
g
}x4|D ],}||kr(|d d � d
kr(| jjd| � q(W d S )N�GNOME�KDEZLXDEZMATEZRazorZROXZTDEZUnity�XFCEZOldr � zX-z)'%s' is not a registered OnlyShowIn value)�getListrs rp )r
r� �valuesZvalid�itemr r r r| � s
z DesktopEntry.checkOnlyShowInc ~ s� | j |�}ddddddddd d
d d d
g
� t� fdd�|D �� rL| jjd� dddddddddddd d d d d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�g~}|� }x6|D ].}||k�or|jd�� �r�| jjd�| � �qZW d S )�NZ
AudioVideoZAudioZVideoZ DevelopmentZ EducationZGameZGraphicsZNetworkZOfficeZScienceZSettingsZSystemZUtilityc 3 s | ]}|� kV qd S )Nr )�.0r� )�mainr r � <genexpr>� s z/DesktopEntry.checkCategories.<locals>.<genexpr>zMissing main categoryZBuildingZDebuggerZIDEZ GUIDesignerZ ProfilingZRevisionControlZ TranslationZCalendarZContactManagementZDatabaseZ
DictionaryZChartZEmailZFinanceZ FlowChartZPDAZProjectManagementZ PresentationZ SpreadsheetZ
WordProcessorZ
2DGraphicsZVectorGraphicsZRasterGraphicsZ
3DGraphicsZScanningZOCRZ PhotographyZ
PublishingZViewerZ TextToolsZDesktopSettingsZHardwareSettingsZPrintingZPackageManagerZDialupZInstantMessagingZChatZ IRCClientZFeedZ FileTransferZHamRadioZNewsZP2PZ RemoteAccessZ TelephonyZTelephonyToolsZVideoConferenceZ
WebBrowserZWebDevelopmentZMidiZMixerZ SequencerZTunerZTVZAudioVideoEditingZPlayerZRecorderZ DiscBurningZ
ActionGameZ
AdventureGameZ
ArcadeGameZ BoardGameZ
BlocksGameZCardGameZKidsGameZ LogicGameZ RolePlayingZShooterZ
SimulationZ
SportsGameZ StrategyGameZArtZ ConstructionZMusicZ LanguagesZArtificialIntelligenceZ AstronomyZBiologyZ ChemistryZComputerScienceZDataVisualizationZEconomyZ ElectricityZ GeographyZGeologyZ
GeoscienceZHistoryZ
HumanitiesZImageProcessingZ
LiteratureZMapsZMathZNumericalAnalysisZMedicalSoftwareZPhysicsZRoboticsZ SpiritualityZSportsZParallelComputingZ AmusementZ ArchivingZ CompressionZ ElectronicsZEmulatorZ EngineeringZ FileToolsZ FileManagerZTerminalEmulatorZ
FilesystemZMonitorZSecurityZ
AccessibilityZ
CalculatorZClockZ
TextEditorZ
DocumentationZAdultZCorer� r� r� ZGTKZQtZMotifZJavaZ ConsoleOnlyzX-z!'%s' is not a registered Category)r� �anyrs rp �
startswith)r
r� r� Z
additionalZ
allcategoriesr� r )r� r r~ � s
�
z DesktopEntry.checkCategoriesc C s t jdt� | j|�S )z`Deprecated alias for checkCategories - only exists for backwards
compatibility.
z1checkCategorie is deprecated, use checkCategories)ro �warn�DeprecationWarningr~ )r
r� r r r �checkCategorie� s zDesktopEntry.checkCategorie)N);�__name__�
__module__� __qualname__�__doc__rm r r r r r r r r r" r$ r% r' r* r, r. r0 r2 r4 r7 r8 r: r< r> r@ rB rD rE rG rI rK rM rO rP rQ rS rU rW rY r[ r] r_ r` rb rd rf rh r ru ry r� r} r| r~ r� r r r r r sr
=r )
r� Z xdg.IniFiler r Z
xdg.Localer{ Zxdg.Exceptionsr Zos.pathr rv ro r r r r r �<module> s