python-rtmidi
python-rtmidi copied to clipboard
Incorrect documentation for open_midi* functions
The first line of the documentation for each of the open_midiinput
, open_midioutput
, and open_midiport
functions states:
Open MIDI port for input or output and return MidiIn/MidiOut instance.
(or an appropriate variation of the above). This is incorrect, or at least incorrect and misleading.
The Returns clause for open_midiport
correctly states that it returns:
A two-element tuple of a new MidiIn or MidiOut instance and the name of the MIDI port which was opened.
This Returns clause is not present for open_midiinput
or open_midioutput
.
Someone trying to use the simpler open_midiinput
or open_midioutput
functions is going to be confused as to why this code:
midiout = open_midioutput(0)
midiout.send_message(msg)
gives them the following error:
AttributeError: 'tuple' object has no attribute 'send_message'
The documentation for all three of the open_midi*
functions should be updated to state that they return a tuple, not just the MidiIn
/MidiOut
instance.