File: //lib/python3.6/site-packages/pyudev/__pycache__/discover.cpython-36.opt-1.pyc
3
u1‘Wô, ã @ sì d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlZddlZddlZddl Z ddl
Z
ddl m Z ddl m
Z
d d
„ Ze
jejƒG d d „ d eƒƒZG d
d„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZdS )zš
pyudev.discover
===============
Tools to discover a device given limited information.
.. moduleauthor:: mulhern <amulhern@redhat.com>
é )Úabsolute_import)Údivision)Úprint_function)Úunicode_literalsN)ÚDevices)ÚDeviceNotFoundErrorc s t jˆ ƒ‡ fdd„ƒ}|S )z\
Allow Device discovery methods to return None instead of raising an
exception.
c s$ y
ˆ | |ŽS t k
r dS X dS )z‘
Returns result of calling ``func`` on ``args``, ``kwargs``.
Returns None if ``func`` raises :exc:`DeviceNotFoundError`.
N)r )ÚargsÚkwargs)Úfunc© ú /usr/lib/python3.6/discover.pyÚthe_func1 s
z wrap_exception.<locals>.the_func)Ú functoolsÚwraps)r
r
r )r
r Úwrap_exception+ s r c @ sL e Zd ZdZeejdd„ ƒƒZeejdd„ ƒƒZedd„ ƒZ edd „ ƒZ
d
S ) Ú
HypothesiszM
Represents a hypothesis about the meaning of the device identifier.
c C s
t ƒ ‚dS )aì
Match the given string according to the hypothesis.
The purpose of this method is to obtain a value corresponding to
``value`` if that is possible. It may use a regular expression, but
in general it should just return ``value`` and let the lookup method
sort out the rest.
:param str value: the string to inspect
:returns: the matched thing or None if unmatched
:rtype: the type of lookup's key parameter or NoneType
N)ÚNotImplementedError)ÚclsÚvaluer r r ÚmatchD s zHypothesis.matchc C s
t ƒ ‚dS )aN
Lookup the given string according to the hypothesis.
:param Context context: the pyudev context
:param key: a key with which to lookup the device
:type key: the type of match's return value if not None
:returns: a list of Devices obtained
:rtype: frozenset of :class:`Device`
N)r )r ÚcontextÚkeyr r r ÚlookupU s zHypothesis.lookupc C s dS )zé
A potentially expensive method that may allow an :class:`Hypothesis`
to find devices more rapidly or to find a device that it would
otherwise miss.
:param Context context: the pyudev context
Nr )r r r r r Úsetupc s zHypothesis.setupc C s$ | j |ƒ}|dk r | j||ƒS tƒ S )a
Get any devices that may correspond to the given string.
:param Context context: the pyudev context
:param str value: the value to look for
:returns: a list of devices obtained
:rtype: set of :class:`Device`
N)r r Ú frozenset)r r r r r r r Ú get_devicesn s
zHypothesis.get_devicesN) Ú__name__Ú
__module__Ú __qualname__Ú__doc__Ú classmethodÚabcÚabstractmethodr r r r r r r r r > s
r c @ sL e Zd ZdZedd„ ƒZedd„ ƒZedd„ ƒZedd „ ƒZed
d „ ƒZ d S )
ÚDeviceNumberHypothesisz—
Represents the hypothesis that the device is a device number.
The device may be separated into major/minor number or a composite number.
c C s8 t jdƒ}|j|ƒ}|o6tjt|jdƒƒt|jdƒƒƒS )zÌ
Match the number under the assumption that it is a major,minor pair.
:param str value: value to match
:returns: the device number or None
:rtype: int or NoneType
z#^(?P<major>\d+)(\D+)(?P<minor>\d+)$ÚmajorÚminor)ÚreÚcompiler ÚosÚmakedevÚintÚgroup)r r Zmajor_minor_rer r r r Ú_match_major_minorƒ s
z)DeviceNumberHypothesis._match_major_minorc C s& t jdƒ}|j|ƒ}|o$t|jdƒƒS )zÉ
Match the number under the assumption that it is a single number.
:param str value: value to match
:returns: the device number or None
:rtype: int or NoneType
z^(?P<number>\d+)$Znumber)r& r' r r* r+ )r r Z number_rer r r r Ú
_match_number• s
z$DeviceNumberHypothesis._match_numberc C s | j |ƒp| j|ƒS )z
Match the number under the assumption that it is a device number.
:returns: the device number or None
:rtype: int or NoneType
)r, r- )r r r r r r ¢ s z DeviceNumberHypothesis.matchc C s |j }tjtjj|dƒƒS )z§
Find subsystems in /sys/dev.
:param Context context: the context
:returns: a lis of available subsystems
:rtype: list of str
Zdev)Úsys_pathr( ÚlistdirÚpathÚjoin)r r r. r r r Úfind_subsystems¬ s z&DeviceNumberHypothesis.find_subsystemsc s8 t tjƒ‰‡ ‡‡fdd„| jˆ ƒD ƒ}tdd„ |D ƒƒS )zß
Lookup by the device number.
:param Context context: the context
:param int key: the device number
:returns: a list of matching devices
:rtype: frozenset of :class:`Device`
c 3 s | ]}ˆˆ |ˆƒV qd S )Nr )Ú.0Ús)r r
r r r ú <genexpr>Ã s z0DeviceNumberHypothesis.lookup.<locals>.<genexpr>c s s | ]}|d k r|V qd S )Nr )r3 Úrr r r r5 Ä s )r r Zfrom_device_numberr2 r )r r r Úresr )r r
r r r ¸ s
z DeviceNumberHypothesis.lookupN)
r r r r r r, r- r r2 r r r r r r# | s
r# c @ s( e Zd ZdZedd„ ƒZedd„ ƒZdS )ÚDevicePathHypothesiszG
Discover the device assuming the identifier is a device path.
c C s |S )z›
Match ``value`` under the assumption that it is a device path.
:returns: the device path or None
:rtype: str or NoneType
r )r r r r r r Ì s zDevicePathHypothesis.matchc C s( t tjƒ||ƒ}|dk r"t|fƒS tƒ S )zÔ
Lookup by the path.
:param Context context: the context
:param str key: the device path
:returns: a list of matching devices
:rtype: frozenset of :class:`Device`
N)r r Z from_pathr )r r r r7 r r r r Ö s
zDevicePathHypothesis.lookupN)r r r r r r r r r r r r8 Ç s
r8 c @ s4 e Zd ZdZedd„ ƒZedd„ ƒZedd„ ƒZdS ) ÚDeviceNameHypothesiszf
Discover the device assuming the input is a device name.
Try every available subsystem.
c s< |j ‰ d}‡ fdd„|D ƒ}dd„ |D ƒ}tdd„ |D ƒƒS ) zœ
Find all subsystems in sysfs.
:param Context context: the context
:rtype: frozenset
:returns: subsystems in sysfs
ÚbusÚclassÚ subsystemc 3 s | ]}t jjˆ |ƒV qd S )N)r( r0 r1 )r3 Úname)r. r r r5 ö s z7DeviceNameHypothesis.find_subsystems.<locals>.<genexpr>c s s | ]}t jj|ƒr|V qd S )N)r( r0 Úisdir)r3 Údr r r r5 ÷ s c s s" | ]}t j|ƒD ]
}|V qqd S )N)r( r/ )r3 r? Únr r r r5 ø s )r: r; r< )r. r )r r ZdirnamesZabsnamesZ realnamesr )r. r r2 ë s
z$DeviceNameHypothesis.find_subsystemsc C s |S )z›
Match ``value`` under the assumption that it is a device name.
:returns: the device path or None
:rtype: str or NoneType
r )r r r r r r ú s zDeviceNameHypothesis.matchc s8 t tjƒ‰‡ ‡‡fdd„| jˆ ƒD ƒ}tdd„ |D ƒƒS )zÔ
Lookup by the path.
:param Context context: the context
:param str key: the device path
:returns: a list of matching devices
:rtype: frozenset of :class:`Device`
c 3 s | ]}ˆˆ |ˆƒV qd S )Nr )r3 r4 )r r
r r r r5 s z.DeviceNameHypothesis.lookup.<locals>.<genexpr>c s s | ]}|d k r|V qd S )Nr )r3 r6 r r r r5 s )r r Ú from_namer2 r )r r r r7 r )r r
r r r s
zDeviceNameHypothesis.lookupN)r r r r r r2 r r r r r r r9 ä s
r9 c @ sZ e Zd ZdZdddddddd d
d d g Zed
d„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZ dS )ÚDeviceFileHypothesisz‡
Discover the device assuming the value is some portion of a device file.
The device file may be a link to a device node.
z/devz/dev/disk/by-idz/dev/disk/by-labelz/dev/disk/by-partlabelz/dev/disk/by-partuuidz/dev/disk/by-pathz/dev/disk/by-uuidz/dev/input/by-pathz /dev/mapperz/dev/mdz/dev/vgc C s: |j ƒ }dd„ |D ƒ}dd„ |D ƒ}ttdd„ |D ƒƒƒS )a7
Get all directories that may contain links to device nodes.
This method checks the device links of every device, so it is very
expensive.
:param Context context: the context
:returns: a sorted list of directories that contain device links
:rtype: list
c s s | ]}t |jƒr|V qd S )N)ÚlistÚ device_links)r3 r? r r r r5 5 s z5DeviceFileHypothesis.get_link_dirs.<locals>.<genexpr>c s s | ]}|j D ]
}|V q qd S )N)rD )r3 r? Úlr r r r5 6 s c s s | ]}t jj|ƒV qd S )N)r( r0 Údirname)r3 rE r r r r5 7 s )Z list_devicesÚsortedÚset)r r ÚdevicesZdevices_with_linksZlinksr r r Ú
get_link_dirs( s z"DeviceFileHypothesis.get_link_dirsc C s | j |ƒ| _dS )z¸
Set the link directories to be used when discovering by file.
Uses `get_link_dirs`, so is as expensive as it is.
:param Context context: the context
N)rJ Ú
_LINK_DIRS)r r r r r r 9 s zDeviceFileHypothesis.setupc C s |S )Nr )r r r r r r D s zDeviceFileHypothesis.matchc sr t tjƒ‰dˆkr4ˆˆ ˆƒ}|dk r.t|fƒS tƒ S ‡fdd„| jD ƒ}‡ ‡fdd„|D ƒ}tdd„ |D ƒƒS dS )a‚
Lookup the device under the assumption that the key is part of
the name of a device file.
:param Context context: the context
:param str key: a portion of the device file name
It is assumed that either it is the whole name of the device file
or it is the basename.
A device file may be a device node or a device link.
ú/Nc 3 s | ]}t jj|ˆ ƒV qd S )N)r( r0 r1 )r3 Zld)r r r r5 [ s z.DeviceFileHypothesis.lookup.<locals>.<genexpr>c 3 s | ]}ˆˆ |ƒV qd S )Nr )r3 Úf)r r
r r r5 \ s c s s | ]}|d k r|V qd S )Nr )r3 r? r r r r5 ] s )r r Zfrom_device_filer rK )r r r ZdeviceÚfilesrI r )r r
r r r H s
zDeviceFileHypothesis.lookupN)
r r r r rK r rJ r r r r r r r rB s rB c @ s4 e Zd ZdZeeeegZdd„ Z dd„ Z
dd„ Z dS ) Ú Discoveryz1
Provides discovery methods for devices.
c C s | j | _d S )N)Ú _HYPOTHESESÚ _hypotheses)Úselfr r r Ú__init__m s zDiscovery.__init__c C s x| j D ]}|j|ƒ qW dS )z
Set up individual hypotheses.
May be an expensive call.
:param Context context: the context
N)rQ r )rR r Zhypr r r r p s zDiscovery.setupc s t ‡ ‡fdd„| jD ƒƒS )zý
Get the devices corresponding to value.
:param Context context: the context
:param str value: some identifier of the device
:returns: a list of corresponding devices
:rtype: frozenset of :class:`Device`
c 3 s$ | ] }|j ˆ ˆƒD ]
}|V qqd S )N)r )r3 Úhr? )r r r r r5 … s z(Discovery.get_devices.<locals>.<genexpr>)r rQ )rR r r r )r r r r { s zDiscovery.get_devicesN) r r r r rB r9 r# r8 rP rS r r r r r r rO ` s rO )r Z
__future__r r r r r! r r( r& ZsixZ
pyudev.devicer r r Z
add_metaclassÚABCMetaÚobjectr r# r8 r9 rB rO r r r r Ú<module> s& =K /M