catched up with latest release of rtmidi, finally allowing to specify the api used in linux. Also a more correct approach to sending midi for the special case of 3 bytes

Author: gesellkammer

.gitignore

@@ -0,0 +1,4 @@
+rtmidi2.cpp
+*.so
+build/
+dist/

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Guido Lorenz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

MANIFEST

@@ -0,0 +1,8 @@
+MANIFEST
+tests.py
+README.rst
+rtmidi2.pyx
+setup.py
+RtMidi/RtMidi.h
+RtMidi/RtMidi.cpp
+version.cfg

README.rst

@@ -0,0 +1,129 @@
+=======
+rtmidi2
+=======
+
+Python wrapper for RtMidi_, the lightweight, cross-platform MIDI I/O library. For Linux, Mac OS X and Windows.
+
+Based on rtmidi-python
+
+Setup
+-----
+
+The wrapper is written in Cython_. Cython should be installed for this module to be installed. 
+RtMidi is included in the source tree, so you only need to do::
+
+  python setup.py install
+    
+Python 2 & 3
+------------
+
+This module is compatible with both Python 2 and Python 3. The only visible difference is that under python 3, all strings are byte strings. If you pass a unicode string to any function taking a string (open_virtual_port), an attempt will be made to encode the string as ASCII, through .encode("ASCII", errors="ignore"). 
+
+Usage Examples
+--------------
+
+`rtmidi2` uses a very similar API as RtMidi
+
+Print all in and out ports
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: python
+
+   import rtmidi2
+   print(rtmidi2.get_in_ports())
+   print(rtmidi2.get_out_ports())
+
+
+Send messages
+~~~~~~~~~~~~~
+
+.. code-block:: python
+
+   import rtmidi2
+  
+   midi_out = rtmidi2.MidiOut()
+   # open the first available port
+   midi_out.open_port(0) 
+   # send C3 with vel. 100 on channel 1
+   midi_out.send_noteon(0, 48, 100)
+
+
+
+Get incoming messages - blocking interface
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: python
+
+   midi_in = rtmidi.MidiIn()
+   midi_in.open_port(0)
+
+   while True:
+       message, delta_time = midi_in.get_message()  # will block until a message is available
+       if message:
+            print(message, delta_time)
+
+
+Get incoming messages using a callback -- non blocking
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: python
+
+    def callback(message, time_stamp):
+        print(message, time_stamp)
+
+    midi_in = rtmidi2.MidiIn()
+    midi_in.callback = callback
+    midi_in.open_port(0)
+
+
+Open multiple ports at once
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+   
+.. code-block:: python
+
+    # get messages from all available ports
+    midi_in = MidiInMulti().open_ports("*")
+
+    def callback(msg, timestamp):
+        msgtype, channel = splitchannel(msg[0])
+        print(msgtype2str(msgtype), msg[1], msg[2])
+
+    midi_in.callback = callback
+
+
+You can also get the device which generated the event by changing your callback to:
+
+.. code-block:: python
+
+    def callback(src, msg, timestamp):
+        # src will hold the name of the device
+        print("got message from", src)
+
+               
+Send multiple notes at once
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: python
+
+    # send a cluster of ALL notes with a duration of 1 second
+    midi_out = MidiOut().open_port()
+    notes = range(127)
+    velocities = [90] * len(notes)
+    midi_out.send_noteon_many(0, notes, velocities)
+    time.sleep(1)
+    midi_out.send_noteon_many(0, notes, [0] * len(notes))
+
+
+----
+
+
+License
+-------
+
+`rtmidi2` is licensed under the MIT License, see `LICENSE`.
+
+It uses RtMidi, licensed under a modified MIT License, see `RtMidi/RtMidi.h`.
+
+
+.. _RtMidi: http://www.music.mcgill.ca/~gary/rtmidi/
+.. _Cython: http://www.cython.org