REDROOM

Preview: protocol_alt.py Size: 1.95 KB

/lib/python3.6/site-packages/serial/urlhandler/protocol_alt.py

#! python
#
# This module implements a special URL handler that allows selecting an
# alternate implementation provided by some backends.
#
# This file is part of pySerial. https://github.com/pyserial/pyserial
# (C) 2015 Chris Liechti <cliechti@gmx.net>
#
# SPDX-License-Identifier:    BSD-3-Clause
#
# URL format:    alt://port[?option[=value][&option[=value]]]
# options:
# - class=X used class named X instead of Serial
#
# example:
#   use poll based implementation on Posix (Linux):
#   python -m serial.tools.miniterm alt:///dev/ttyUSB0?class=PosixPollSerial

try:
    import urlparse
except ImportError:
    import urllib.parse as urlparse

import serial


def serial_class_for_url(url):
    """extract host and port from an URL string"""
    parts = urlparse.urlsplit(url)
    if parts.scheme != 'alt':
        raise serial.SerialException(
            'expected a string in the form "alt://port[?option[=value][&option[=value]]]": '
            'not starting with alt:// ({!r})'.format(parts.scheme))
    class_name = 'Serial'
    try:
        for option, values in urlparse.parse_qs(parts.query, True).items():
            if option == 'class':
                class_name = values[0]
            else:
                raise ValueError('unknown option: {!r}'.format(option))
    except ValueError as e:
        raise serial.SerialException(
            'expected a string in the form '
            '"alt://port[?option[=value][&option[=value]]]": {!r}'.format(e))
    if not hasattr(serial, class_name):
        raise ValueError('unknown class: {!r}'.format(class_name))
    cls = getattr(serial, class_name)
    if not issubclass(cls, serial.Serial):
        raise ValueError('class {!r} is not an instance of Serial'.format(class_name))
    return (''.join([parts.netloc, parts.path]), cls)

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
if __name__ == '__main__':
    s = serial.serial_for_url('alt:///dev/ttyS0?class=PosixPollSerial')
    print(s)

Name	Size	Perms	Modified	Actions
__pycache__ DIR	-	drwxr-xr-x	2025-03-30 04:21:29	Edit Download recursive recursive
protocol_alt.py	1.95 KB	lrw-r--r--	2016-06-12 20:47:09	Edit Download recursive recursive
protocol_hwgrep.py	3.05 KB	lrw-r--r--	2016-06-12 20:47:09	Edit Download recursive recursive
protocol_loop.py	9.48 KB	lrw-r--r--	2016-06-12 20:47:09	Edit Download recursive recursive
protocol_rfc2217.py	277 B	lrw-r--r--	2016-06-12 20:47:09	Edit Download recursive recursive
protocol_socket.py	10.89 KB	lrw-r--r--	2016-06-12 20:47:09	Edit Download recursive recursive
protocol_spy.py	8.81 KB	lrw-r--r--	2016-06-12 20:47:09	Edit Download recursive recursive
__init__.py	0 B	lrw-r--r--	2016-06-12 20:47:09	Edit Download recursive recursive

Directory Contents