1#@!#!123s

: / lib / python3.6 / site-packages / serial / tools /

Filename : list_ports_common.py

back

#!/usr/bin/env python
#
# This is a helper module for the various platform dependent list_port
# implementations.
#
# This file is part of pySerial. https://github.com/pyserial/pyserial
# (C) 2015 Chris Liechti <cliechti@gmx.net>
#
# SPDX-License-Identifier:    BSD-3-Clause
import re


def numsplit(text):
    """\
    Convert string into a list of texts and numbers in order to support a
    natural sorting.
    """
    result = []
    for group in re.split(r'(\d+)', text):
        if group:
            try:
                group = int(group)
            except ValueError:
                pass
            result.append(group)
    return result


class ListPortInfo(object):
    """Info collection base class for serial ports"""

    def __init__(self, device=None):
        self.device = device
        self.name = None
        self.description = 'n/a'
        self.hwid = 'n/a'
        # USB specific data
        self.vid = None
        self.pid = None
        self.serial_number = None
        self.location = None
        self.manufacturer = None
        self.product = None
        self.interface = None

    def usb_description(self):
        """return a short string to name the port based on USB info"""
        if self.interface is not None:
            return '{} - {}'.format(self.product, self.interface)
        elif self.product is not None:
            return self.product
        else:
            return self.name

    def usb_info(self):
        """return a string with USB related information about device"""
        return 'USB VID:PID={:04X}:{:04X}{}{}'.format(
            self.vid,
            self.pid,
            ' SER={}'.format(self.serial_number) if self.serial_number is not None else '',
            ' LOCATION={}'.format(self.location) if self.location is not None else '')

    def apply_usb_info(self):
        """update description and hwid from USB data"""
        self.description = self.usb_description()
        self.hwid = self.usb_info()

    def __eq__(self, other):
        return self.device == other.device

    def __lt__(self, other):
        return numsplit(self.device) < numsplit(other.device)

    def __str__(self):
        return '{} - {}'.format(self.device, self.description)

    def __getitem__(self, index):
        """Item access: backwards compatible -> (port, desc, hwid)"""
        if index == 0:
            return self.device
        elif index == 1:
            return self.description
        elif index == 2:
            return self.hwid
        else:
            raise IndexError('{} > 2'.format(index))

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# test
if __name__ == '__main__':
    print(ListPortInfo('dummy'))

Name	Size	Last Modified	Owner	Permissions
__pycache__	Dir	May 29 2024 3:41:25	root	0755
__init__.py	0 KB	June 12 2016 8:47:09	root	0644
hexlify_codec.py	3.552 KB	June 12 2016 8:47:09	root	0644
list_ports.py	3.022 KB	June 12 2016 8:47:09	root	0644
list_ports_common.py	2.663 KB	June 12 2016 8:47:09	root	0644
list_ports_linux.py	3.489 KB	June 12 2016 8:47:09	root	0644
list_ports_osx.py	8.982 KB	June 12 2016 8:47:09	root	0644
list_ports_posix.py	3.522 KB	June 12 2016 8:47:09	root	0644
list_ports_windows.py	10.587 KB	June 12 2016 8:47:09	root	0644
miniterm.py	33.084 KB	June 12 2016 8:47:09	root	0644

2017 © D7net \| D704T team