+ h?,csRt^RIt^RIt^RIt^RIt^RIHt^RIHtRt !RR4t !RR] 4t !R R ] 4t !R R ] 4t !R R] 4t!RR4tR#)z pyudev.discover =============== Tools to discover a device given limited information. .. moduleauthor:: mulhern NDeviceNotFoundError)DevicescsFa\P!S4V3Rl4pV#)zP Allow Device discovery methods to return None instead of raising an exception. cs:<S!V/VB# \dR#i;i)zy Returns result of calling ``func`` on ``args``, ``kwargs``. Returns None if ``func`` raises :exc:`DeviceNotFoundError`. Nr)ZargsZkwargsfuncs*,4/usr/lib/python3.14/site-packages/pyudev/discover.pythe_funcZ wrap_exception..the_func+s*  (( ("  s  ) functoolsZwraps)rrsf rwrap_exceptionr%s' __T Ocsa]tRt^9toRt]P t]]PR44t ]]PR44t ]R4t ]R4t RtVtR#) HypothesiszE Represents a hypothesis about the meaning of the device identifier. c \4h)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 ZNotImplementedErrorclsvalue&&rmatchZHypothesis.match@s "##rc r )a 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` r )r contextkeys&&&rlookupZHypothesis.lookupQs "##rc sR#)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 rrrsetupZHypothesis.setup_s rc sbVPV4pVeVPW4#\4#)z 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` )rr frozenset)r rrr&&& r get_devicesZHypothesis.get_devicesjs,ii+.?szz''K KrrN)__name__ __module__ __qualname____firstlineno____doc__abcZABCMetaZ __metaclass__ classmethodZabstractmethodrrrr__static_attributes____classdictcell__Z __classdict__@rr r 9sKKM $ $ $ $   L Lrr csta]tRt^xtoRt]R4t]R4t]R4t]R4t ]R4t Rt Vt R#) 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 s\P!R4pVPV4pT;'dH\P!\ VP R44\ VP R444#)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\d+)(\D+)(?P\d+)$ZmajorZminor)recompilerosZmakedevintgroup)r rZmajor_minor_rer&& r_match_major_minorZ)DeviceNumberHypothesis._match_major_minorsa$JK$$U+    G$ %s5;;w+?'@  rc s\P!R4pVPV4pT;'d\VP R44#)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\d+)$Znumber)r&r'rr)r*)r rZ number_rerr+r _match_numberZ$DeviceNumberHypothesis._match_numbers=JJ34 &33U[[233rc sVVPV4;'gVPV4#)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 rrrZDeviceNumberHypothesis.matchs(%%e,HH0A0A%0HHrc sVPp\P!\PP VR44#)z Find subsystems in /sys/dev. :param Context context: the context :returns: a lis of available subsystems :rtype: list of str Zdev)sys_pathr(listdirpathjoin)r rr.&& rfind_subsystemsZ&DeviceNumberHypothesis.find_subsystemss-##zz"'',,x788rc aaa\\P4oVVV3RlVPS44p\ RV44#)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` c38<"TFpS!SVS4xK R#5iNr.0Zsrrr& r 0DeviceNumberHypothesis.lookup..K.JtGQ$$.Jc30"TF qfKVxK R#5ir6rr8Zr& rr:r;9CqC )rrZfrom_device_numberr3rr rrresr&ff @rrZDeviceNumberHypothesis.lookups;g889Kc.A.A'.JK9C999rrN) rrrrrr r,r-rr3rr!r"r#r$rr%r%xsp      4 4II 9 9 : :rr%csDa]tRt^toRt]R4t]R4tRtVt R#)DevicePathHypothesisz? Discover the device assuming the identifier is a device path. c V#)z{ Match ``value`` under the assumption that it is a device path. :returns: the device path or None :rtype: str or NoneType rr rrrZDevicePathHypothesis.match  rc st\\P4!W4pVe \V34#\4#) 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` )rrZ from_pathr)r rrrDrrrZDevicePathHypothesis.lookups1W../=$'Oy# DDrrN) rrrrrr rrr!r"r#r$rrFrFs4 E ErrFcsTa]tRt^toRt]R4t]R4t]R4tRt Vt R#)DeviceNameHypothesiszZ Discover the device assuming the input is a device name. Try every available subsystem. c snaVPoRpV3RlV4pRV4p\RV44#)zt Find all subsystems in sysfs. :param Context context: the context :rtype: frozenset :returns: subsystems in sysfs c3sd<"TF%p\PPSV4xK' R#5ir6r(r0r1)r8Znamer.& rr:7DeviceNameHypothesis.find_subsystems..s#FXTBGGLL400X-0c3st"TF.p\PPV4'gK*VxK0 R#5ir6)r(r0Zisdirr8dr@rr:rMs!=1BGGMM!,.r<r=c3r>r6rr?r@rr:rR rArB)rrZ from_namer3rrCrErrZDeviceNameHypothesis.lookups;g//0Kc.A.A'.JK9C999rrN) rrrrrr r3rrr!r"r#r$rrJrJsH  F F : :rrJcsla]tRtRtoRt.R Ot]R4t]R4t]R4t ]R4t Rt Vt R#) DeviceFileHypothesisi z{ Discover the device assuming the value is some portion of a device file. The device file may be a link to a device node. c s|VP4pRV4pRV4p\\RV444#)z 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 c3s`"TF$p\VP4'gK VxK& R#5ir6)Zlist device_linksrOr@rr:5DeviceFileHypothesis.get_link_dirs...sIAD4Haas. .c3sH"TFqPFq"xK K R#5ir6)rT)r8rPlrQrr:rU/sG.q1.s "c3s`"TF$p\PPV4xK& R#5ir6)r(r0Zdirname)r8rVr@rr:rU0s &&(IIG.Gc.Ts#@2b#&&rNc3s6<"TFpS!SV4xK R#5ir6r)r8Zfrrs& rr:rZUs3U4##Usc3r>r6rrOr@rr:rZVs=GqGrB)rrZfrom_device_filerrY)r rrZdeviceZfilesrWrs&ff @rrZDeviceFileHypothesis.lookupAsjg667 #:'3'F+1+=9fY' N9; N@@3U3=G===rrN) 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/vg) rrrrrrYr rXrrrr!r"r#r$rrSrS sa J>> 44>>rrScsBa]tRtRtoRt]]]].t Rt Rt Rt Rt VtR#) DiscoveryiYz) Provides discovery methods for devices. cs(VPVnR#r6) _HYPOTHESES _hypotheses)selfs&r__init__ZDiscovery.__init__fs++rc sNVPFpVPV4K R#)z_ Set up individual hypotheses. May be an expensive call. :param Context context: the context N)r]r)r^rZhypr2rrZDiscovery.setupis ##C IIg $rc sFaa\VV3RlVP44#)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` c3sV<"TFqPSS4Fq"xK K R#5ir6)r)r8ZhrPrrs& rr:Z(Discovery.get_devices..}s' '!w1NAA1NA's&))rr])r^rrs&ffrrZDiscovery.get_devicests% ''   r)r]N)rrrrrrSrJr%rFr\r_rrr!r"r#r$rr[r[Ys3  K,    rr[)rrrr(r&Zpyudev._errorsrZ pyudev.devicerrr r%rFrJrSr[rrrr`su"  /!(<L<L~E:ZE:PE:E:,::,:^J>:J>Z& & r