File: PKG-INFO

package info (click to toggle)
python-mido 1.1.18-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 652 kB
  • ctags: 645
  • sloc: python: 3,253; makefile: 136; sh: 4
file content (183 lines) | stat: -rw-r--r-- 6,184 bytes parent folder | download | duplicates (2)
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
Metadata-Version: 1.1
Name: mido
Version: 1.1.18
Summary: MIDI Objects for Python
Home-page: https://mido.readthedocs.io/
Author: Ole Martin Bjorndalen
Author-email: ombdalen@gmail.com
License: MIT
Description: Mido - MIDI Objects for Python
        ==============================
        
        Mido is a library for working with MIDI messages and ports. It's
        designed to be as straight forward and Pythonic as possible:
        
        .. code-block:: python
        
            >>> import mido
            >>> output = mido.open_output()
            >>> output.send(mido.Message('note_on', note=60, velocity=64))
        
        .. code-block:: python
        
            >>> with input as mido.open_input('SH-201'):
            ...     for msg in input:
            ...         print(msg)
        
        .. code-block:: python
        
            >>> from mido import Message
            >>> msg = Message('program_change', program=1)
            >>> msg
            <message program_change channel=0 program=1 time=0>
            >>> msg.copy(program=2, time=100)
            <message program_change channel=0 program=2 time=100>
            >>> msg.time
            100
            >>> msg.bytes()
            [192, 1]
        
        .. code-block:: python
        
            >>> from mido import MidiFile
            >>> for msg in MidiFile('song.mid').play():
            ...     output.send(msg)
        
        Full documentation at https://mido.readthedocs.io/
        
        
        Main Features
        -------------
        
        * works in Python 2 and 3.
        
        * convenient message objects.
        
        * supports PortMidi, RtMidi and Pygame. New backends are easy to
          write.
        
        * full support for all 18 messages defined by the MIDI standard.
        
        * standard port API allows all kinds of input and output ports to be
          used interchangeably. New port types can be written by subclassing
          and overriding a few methods.s
        
        * includes a reusable MIDI parser.
        
        * full support for MIDI files (read, write, create and play) with
          complete access to every message in the file, including all common
          meta messages.
        
        * can read and write SYX files (binary and plain text).
        
        * implements (somewhat experimental) MIDI over TCP/IP with socket
          ports. This allows for example wireless MIDI between two
          computers.
        
        * includes programs for playing MIDI files, listing ports and
          serving and forwarding ports over a network.
        
        
        Status
        ------
        
        1.1 is the second stable release.
        
        See docs/changes.rst for a full list of changes.
        
        
        Requirements
        ------------
        
        Mido targets Python 2.7 and 3.2.
        
        If you want to use message ports, you will need `PortMidi
        <http://portmedia.sourceforge.net/portmidi/>`_ installed on your
        system. The PortMidi library is loaded on demand, so you can use the
        parser and messages without it.
        
        The PortMidi wrapper is tested on on Ubuntu and Mac OS X, but may also
        run on other systems where the ``portmidi.so/dll`` file is available.
        
        Alternative backends are included for `python-rtmidi
        <http://pypi.python.org/pypi/python-rtmidi/>`_ and `Pygame
        <http://www.pygame.org/docs/ref/midi.html>`_. These can be selected
        with the environment variable ``MIDO_BACKEND`` or by calling
        ``mido.set_backend()``.
        
        Like PortMidi, these are loaded on demand.
        
        
        Installing
        ----------
        
        To install::
        
            $ pip install mido
        
        The PortMidi wrapper is written with `ctypes`, so no compilation is
        required.
        
        If you want to use ports, you need the PortMidi shared library. The
        Ubuntu package is called ``libportmidi-dev``, while the `MacPorts
        <http://www.macports.org/>`_ and `Homebrew
        <http://mxcl.github.io/homebrew/>`_ packages are called ``portmidi``.
        
        To build documentation locally::
        
            python setup.py docs
        
        This requires Sphinx. The resulting files can be found in
        ``docs/_build/``.
        
        
        Known Bugs
        ----------
        
        * in OS X, PortMidi and RtMidi usually hang for a second or two
          seconds while initializing. This is actually not a Mido bug, but
          something that happens at a lower level.
        
        * PortMidi in Ubuntu is mistakenly compiled in debug mode, which causes it
          to print out error message instead of returning an error code::
        
            PortMidi: `Bad pointer'
            type ENTER...PortMidi call failed...
        
          See https://bugs.launchpad.net/ubuntu/+source/portmidi/+bug/890600
        
          This means here is no way for Mido to catch the error and raise an
          exception.
        
          This regularity occurs in two places: in PortMidi when you close a
          port that has a callback, and in Pygame when you close any port.
        
        
        Source Code
        -----------
        
        Latest version of the code: https://github.com/olemb/mido/ .
        
        Latest development version: https://github.com/olemb/mido/tree/develop/
        
        
        License
        -------
        
        Mido is released under the terms of the `MIT license
        <http://en.wikipedia.org/wiki/MIT_License>`_.
        
        
        Contact
        -------
        
        Ole Martin Bjorndalen - ombdalen@gmail.com
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2