def match_attribute(self, attribute, value, nomatch=False):
"""
Include all devices, whose ``attribute`` has the given ``value``.
``attribute`` is either a unicode string or a byte string, containing
the name of a sys attribute to match. ``value`` is an attribute value,
being one of the following types:
- :func:`int`,
- :func:`bool`
- A byte string
- Anything convertable to a unicode string (including a unicode string
itself)
If ``nomatch`` is ``True`` (default is ``False``), the match is
inverted: A device is include if the ``attribute`` does *not* match
the given ``value``.
.. note::
If ``nomatch`` is ``True``, devices which do not have the given
``attribute`` at all are also included. In other words, with
``nomatch=True`` the given ``attribute`` is *not* guaranteed to
exist on all returned devices.
Return the instance again.
"""
match = (libudev.udev_enumerate_add_match_sysattr if not nomatch else
libudev.udev_enumerate_add_nomatch_sysattr)
match(self, ensure_byte_string(attribute),
property_value_to_bytes(value))
return self
def match_attribute(self, attribute, value, nomatch=False):
"""
Include all devices, whose ``attribute`` has the given ``value``.
``attribute`` is either a unicode string or a byte string, containing
the name of a sys attribute to match. ``value`` is an attribute value,
being one of the following types:
- :func:`int`,
- :func:`bool`
- A byte string
- Anything convertable to a unicode string (including a unicode string
itself)
If ``nomatch`` is ``True`` (default is ``False``), the match is
inverted: A device is include if the ``attribute`` does *not* match
the given ``value``.
.. note::
If ``nomatch`` is ``True``, devices which do not have the given
``attribute`` at all are also included. In other words, with
``nomatch=True`` the given ``attribute`` is *not* guaranteed to
exist on all returned devices.
Return the instance again.
"""
match = (self._libudev.udev_enumerate_add_match_sysattr
if not nomatch else
self._libudev.udev_enumerate_add_nomatch_sysattr)
match(self, ensure_byte_string(attribute),
property_value_to_bytes(value))
return self
def match_property(self, property, value):
"""
Include all devices, whose ``property`` has the given ``value``.
``property`` is either a unicode string or a byte string, containing
the name of the property to match. ``value`` is a property value,
being one of the following types:
- :func:`int`
- :func:`bool`
- A byte string
- Anything convertable to a unicode string (including a unicode string
itself)
Return the instance again.
"""
libudev.udev_enumerate_add_match_property(
self, ensure_byte_string(property), property_value_to_bytes(value))
return self
def match_property(self, property, value):
"""
Include all devices, whose ``property`` has the given ``value``.
``property`` is either a unicode string or a byte string, containing
the name of the property to match. ``value`` is a property value,
being one of the following types:
- :func:`int`
- :func:`bool`
- A byte string
- Anything convertable to a unicode string (including a unicode string
itself)
Return the instance again.
"""
self._libudev.udev_enumerate_add_match_property(
self, ensure_byte_string(property), property_value_to_bytes(value))
return self
def test_property_value_to_bytes_bool():
assert _util.property_value_to_bytes(True) == b'1'
assert isinstance(_util.property_value_to_bytes(True), bytes)
assert _util.property_value_to_bytes(False) == b'0'
assert isinstance(_util.property_value_to_bytes(False), bytes)
def test_property_value_to_bytes_int():
assert _util.property_value_to_bytes(10000) == b'10000'
assert isinstance(_util.property_value_to_bytes(10000), bytes)
def test_property_value_to_bytes_string():
hello = 'hello world'.encode(sys.getfilesystemencoding())
assert _util.property_value_to_bytes(hello) is hello
assert isinstance(_util.property_value_to_bytes('hello world'), bytes)
assert _util.property_value_to_bytes('hello world') == hello
def test_property_value_to_bytes_bool():
assert _util.property_value_to_bytes(True) == b'1'
assert isinstance(_util.property_value_to_bytes(True), bytes)
assert _util.property_value_to_bytes(False) == b'0'
assert isinstance(_util.property_value_to_bytes(False), bytes)
def test_property_value_to_bytes_int():
assert _util.property_value_to_bytes(10000) == b'10000'
assert isinstance(_util.property_value_to_bytes(10000), bytes)
def test_property_value_to_bytes_string():
hello = 'hello world'.encode(sys.getfilesystemencoding())
assert _util.property_value_to_bytes(hello) is hello
assert isinstance(_util.property_value_to_bytes('hello world'), bytes)
assert _util.property_value_to_bytes('hello world') == hello