1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
# SPDX-FileCopyrightText: 2017 Ole Martin Bjorndalen <ombdalen@gmail.com>
#
# SPDX-License-Identifier: MIT
"""Utility functions for RtMidi backend.
These are in a separate file so they can be tested without
the `python-rtmidi` package.
"""
def expand_alsa_port_name(port_names, name):
"""Expand ALSA port name.
RtMidi/ALSA includes client name and client:port number in
the port name, for example:
TiMidity:TiMidity port 0 128:0
This allows you to specify only port name or client:port name when
opening a port. It will compare the name to each name in
port_names (typically returned from get_*_names()) and try these
three variants in turn:
TiMidity:TiMidity port 0 128:0
TiMidity:TiMidity port 0
TiMidity port 0
It returns the first match. If no match is found it returns the
passed name so the caller can deal with it.
"""
if name is None:
return None
for port_name in port_names:
if name == port_name:
return name
# Try without client and port number (for example 128:0).
without_numbers = port_name.rsplit(None, 1)[0]
if name == without_numbers:
return port_name
if ':' in without_numbers:
without_client = without_numbers.split(':', 1)[1]
if name == without_client:
return port_name
else:
# Let caller deal with it.
return name
|
