Python-rtmidi

Building:

- Rebuild `src/_rtmidi.cpp` with current Cython for Python 3.7 compatibility.
- Remove testing with Python 3.3 environment from `tox.ini` and add Python
3.6 and 3.7.
- Update dev requirements for Python 3.7 compatibility.
- Upload releases with twine.

Documentation:

- Python 3.3 is not officially tested or supported anymore.

Project infrastructure:

- Updated project homepage URL; copyright year and link to docs in readme.

Building:

- Added script to automate updating github pages docs.

Enhancements / Changes:

- Synced with upstream [RtMidi] (2.1.1-907a94c).
- Applied patch from <https://github.com/thestk/rtmidi/pull/89>.
This means that when using the ALSA API port names are reported
in the form `<client name>:<port name> <port id>` (this change
was actually already in version 1.0.0).
- Added new `MidiIn` / `MidiOut` method `is_port_open`.
- `MidiIn` / `MidiOut` constructors and `open_port` / `open_virtual_port`
methods now raise `TypeError` when an invalid type is passed as the
client resp. port name.

[RtMidi]: (https://github.com/thestk/rtmidi

Documentation:

- Various small documentation improvements.

Examples:

- Basic examples: some clean-up, more comments, updated API usage.
- Added new advanced example script `midiwrapper.py`.
- Added new advanced example script `recvrpn.py`.
- `wavetablemodstep.py`: added command line param to set controller number.
- `midi2command`: Fixed wrong mock lru_cache substitution for Python < 3.2.

Project infrastructure:

- Added automatic documentation publishing on readthedocs.org.

Documentation:

- Added auto docs for MidiIn/MidiOut classes to sphinx docs.
- Removed pre-release related information from installation docs.

Building:

- Added generated INSTALL.rst to repo to make ReadTheDocs integration work.

Examples:

- Added new example script `panic.py`.

Project infrastructure:

- Moved repository to Github.

Fixes:

- `midiutil.open_midiport`:
- Correctly report and log I/O direction and instance type.
- Fix naming of virtual port.

Enhancements / Changes:

- Synced with upstream [RtMidi] (2.1.1-399a8ee).
- `midiutil`:
- The function `midiutil.open_port` has been renamed to
`open_midiport`.
- Added convenience functions `open_midiinput` and
`open_midioutput`, which wrap `open_midiport`.
- RtMidi API to use can be specified via the `RTMIDI_API`
environment variable. Only used when `API_UNSPECIFIED` is
passed for the `api` argument. Value should be one of the
`API_*` constant names with out the `API_` prefix, e.g.
`UNIX_JACK` for the Jack API.
- Cython wrapper class hierarchy restructured to better match the
underlying C++ classes and remove code duplication.
- Some source code re-ordering was done.

Documentation:

- Added basic structure and initial content of Sphinx documentation.
- Documented exceptions raised by `MidiIn/Out.open_[virtual_]port()`.
- Some docstring corrections and formatting fixes.

Building:

- Simplified `setup.py` by throwing out old compatibility stuff.
- Explicitly call `PyEval_InitThreads` from Cython code instead of
using undocumented compiler macro.

Examples:

- Moved [osc2midi] example into its own repository.
- Add new `sequencer` example.
- Add new `noteon2osc` example.
- `midifilter`:
- Moved `main.py` to `__main__.py`, removed old code and fixed
command line args access.
- Streamlined event matching.
- Added `CCToBankChange` filter.
- `Queue` module renamed to `queue` in Python 3.
- Fixed opening of output port erroneously used `"input"`.
- Fixed positional command line args handling.
- Set command name for argparse.
- `midi2command`:
- Added README.
- Added command line option to select backend API.
- Catch errors when opening port.
- Set client and port name.
- Cache command lookup (Python 3.2+ only).
- `sysexsaver`:
- Moved `main.py` to `__main__.py`, some refactoring.
- `models.py`: Fixed wrong entry for manufacturer
`(0, 32, 81)`.
- Moved module level code into `main` function.
- Include model name in output file, if possible.
- `drumseq`:
- Fixed global access in `Sequencer` class.
- Use `args.FileType` for pattern command line args.

[osc2midi]: https://github.com/SpotlightKid/osc2rtmidi.git

Fixes:

- Synced [RtMidi] code with git repo 2c7a6664d6, which fixed
several issues (see
<https://github.com/thestk/rtmidi/issues?state=closed>).
- `MidiIn/Out.open_virtual_port` returns `self` for context
manager support, consistent with `MidiIn/Out.open_port`.
- Fix Python \<= 2.6 incompatible encode method call
(python-rtmidi officially only supports Python \>= 2.7). Thanks
to Michiel Overtoom for reporting this.
- Respect passed MIDI api when requesting MidiOut instance from
`midiutil.open_midiport`.

Enhancements / Changes:

- Support for Windows Kernel Streaming API was removed in RtMidi
(it was broken anyway) and consequently in `python-rtmidi` as
well.
- Raise `RtMidiError` exception when trying to open a (virtual)
port on a `MidiIn/Out` instance that already has an open
(virtual) port.
- Add some common synonyms for MIDI events and controllers and
some source comments about controller usage to `midiconstants`
module.

Documentation:

- Fix and clarify `queue_size_limit` default value in docstrings
- Various docstring consistency improvements and minor fixes.

Examples:

- New example script `midi2command.py`, which executes external
commands on reception of configurable MIDI events, with example
configuration.
- New example directory `drumseq` with a simple drum pattern
sequencer and example drum patterns. Thanks to Michiel Overtoom
for the original script!

Building:

- Add numeric suffix to version number to comply with PEP 440.
- Add missing `fill_template.py` to source distribution.
- Set default setuptools version in `ez_setup.py` to 1.3.2, which
contains fix for bug 99 mentioned below.

Documentation:

- Add note to installation guide about required `--pre` option with pip.