58 lines
2.0 KiB
Python
58 lines
2.0 KiB
Python
|
#! 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
|
||
|
|
|
||
|
|
from __future__ import absolute_import
|
||
|
|
|
||
|
|
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)
|