import mido
mido.set_backend('mido.backends.rtmidi')
import time
import sys

Logging = False

def set_logging(logging):
    global Logging
    Logging = logging


class MidiControl(object):
    def __init__(self, midi_manager, name, control_number, value=0, min=0, max=255, allowed_values=None):
        self.midi_manager = midi_manager
        self.min = 0
        self.max = 255
        self.control_number = control_number
        self.value = value
        self.name = name
        self.allowed_values = allowed_values
        if self.allowed_values is not None:
            self.min = 0
            self.max = len(self.allowed_values) - 1
        midi_manager.register_control(self)


    def set_value(self, value):
        new_value = value / 127.0 * (self.max - self.min) + self.min

        if self.allowed_values is not None:
            self.value = self.allowed_values[int(new_value+0.01)]
        else:
            self.value = new_value

        if Logging:
            sys.stderr.write("Setting %s to %f (CC=%d)\n" % (self.name, self.value, self.control_number))



class MidiControlManager(object):
    def __init__(self):
        self.inport = mido.open_input()
        self.controls = {}

    def register_control(self, control):
        self.controls[control.control_number] = control


    def poll(self):
        for msg in self.inport.iter_pending():
            if msg.type=='control_change':
                control_number = msg.control
                value = msg.value

                if control_number in self.controls:
                    self.controls[control_number].set_value(value)
                elif Logging:
                    sys.stderr.write("Control_change: CC=%d Value=%d\n" % (control_number,value))

import mido
mido.set_backend('mido.backends.rtmidi')
import time
import sys

Logging = False

def set_logging(logging):
    global Logging
    Logging = logging


class MidiControl(object):
    """
    A variable that will receive midi control changes.

    Attributes:
        value:  The current value of the control.
    """

    def __init__(self, midi_manager, name, control_number, value=0, min=0, max=255, allowed_values=None):
    """
    Instantiate a midi control object that will receive midi control changes.

    Parameters
    ----------
    midi_manager : MidiControlManager
        The parent MidiControlManager this control will be registered to.
    name : str
        Name of this control.
    control_number: int
        The midi control number (CC).
    value:  int or float
        The initial value of this control.
    min, max: int or float
        The value range of this control.
    allowed_values: array
        A collection of discrete values this control should hold.

    """
        self.midi_manager = midi_manager
        self.min = 0
        self.max = 255
        self.control_number = control_number
        self.value = value
        self.name = name
        self.allowed_values = allowed_values
        if self.allowed_values is not None:
            self.min = 0
            self.max = len(self.allowed_values) - 1
        midi_manager.register_control(self)


    def set_value(self, value):
        new_value = value / 127.0 * (self.max - self.min) + self.min

        if self.allowed_values is not None:
            self.value = self.allowed_values[int(new_value+0.01)]
        else:
            self.value = new_value

        if Logging:
            sys.stderr.write("Setting %s to %f (CC=%d)\n" % (self.name, self.value, self.control_number))



class MidiControlManager(object):
    """
        The control manager receives control changes and dispatches them to all registered MidiControls.
    """

    def __init__(self):
        self.inport = mido.open_input()
        self.controls = {}


    def register_control(self, control):
    """
        Register a MidiControl. Called during contstruction of MidiControl.
    """
        self.controls[control.control_number] = control


    def poll(self):
        """ Poll for new midi messages. Call this method your event loop. """

        for msg in self.inport.iter_pending():
            if msg.type=='control_change':
                control_number = msg.control
                value = msg.value

                if control_number in self.controls:
                    self.controls[control_number].set_value(value)
                elif Logging:
                    sys.stderr.write("Control_change: CC=%d Value=%d\n" % (control_number,value))

add documentation