Added venv libs, changed readme

Author: matthewlipski

.gitignore

@@ -117,3 +117,6 @@ dmypy.json
 
 # Pyre type checker
 .pyre/
+
+#IDE
+.idea/

.idea/.gitignore

@@ -1,4 +1,29 @@
 # USB MIDI Tool
-A lightweight, background tool which allows for connected MIDI devices to interact with each other over a USB connection.
+A lightweight, background tool which allows for connected MIDI devices to interact with each other over a USB
+connection.
 
+To get started, follow the instructions below:
 
+1. Ensure you have the newest version of Python 3 installed on your computer.
+2. Run start.pyw. No other installation is required but a config file will be generated the first time the tool is run.
+Instructions on editing the config file are found below. Simply re-run start.pyw for your config changes to take effect.
+3. Press ctrl+shift+f7 to show the program window and ctrl+shift+f8 to hide it.
+4. Disconnected MIDI devices can simply be disabled, but new devices ones will require config.txt to be deleted and
+generated again by running start.pyw.
+
+###Editing config.txt:
+
+**To disable a MIDI Device, add a '#' in front of its name:**  
+
+E.g. `Arturia MicroLab 1 -> #Arturia MicroLab 1`.  
+
+Remove the '#' to enable it again. Both actions require a restart of the program.
+
+**Change the channel mode by setting 'mode' to either 0 or 1. The channel modes are:**
+
+**0:** Your MIDI instruments should all be set to channel 1 and channel control is done by the USB MIDI tool software.  
+
+**1:** Your MIDI instruments should each be set to their own channel and channel control is done by the USB MIDI protocol.
+Change the MIDI channel of your MIDI controller to control each instrument with either mode.
+
+**Do not edit config.txt in any other way!**

.idea/dictionaries/matth.xml

@@ -1,7 +1,7 @@
 import subprocess
 
 # Path to virtual environment Python executable
-python_bin = "venv/Scripts/python.exe"
+python_bin = "venv/scripts/python.exe"
 
 # Path to script
 script_file = "usb_midi.pyw"

.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,123 @@
+import sys
+import os
+import re
+import importlib
+import warnings
+
+
+is_pypy = '__pypy__' in sys.builtin_module_names
+
+
+def warn_distutils_present():
+    if 'distutils' not in sys.modules:
+        return
+    if is_pypy and sys.version_info < (3, 7):
+        # PyPy for 3.6 unconditionally imports distutils, so bypass the warning
+        # https://foss.heptapod.net/pypy/pypy/-/blob/be829135bc0d758997b3566062999ee8b23872b4/lib-python/3/site.py#L250
+        return
+    warnings.warn(
+        "Distutils was imported before Setuptools, but importing Setuptools "
+        "also replaces the `distutils` module in `sys.modules`. This may lead "
+        "to undesirable behaviors or errors. To avoid these issues, avoid "
+        "using distutils directly, ensure that setuptools is installed in the "
+        "traditional way (e.g. not an editable install), and/or make sure "
+        "that setuptools is always imported before distutils.")
+
+
+def clear_distutils():
+    if 'distutils' not in sys.modules:
+        return
+    warnings.warn("Setuptools is replacing distutils.")
+    mods = [name for name in sys.modules if re.match(r'distutils\b', name)]
+    for name in mods:
+        del sys.modules[name]
+
+
+def enabled():
+    """
+    Allow selection of distutils by environment variable.
+    """
+    which = os.environ.get('SETUPTOOLS_USE_DISTUTILS', 'stdlib')
+    return which == 'local'
+
+
+def ensure_local_distutils():
+    clear_distutils()
+    distutils = importlib.import_module('setuptools._distutils')
+    distutils.__name__ = 'distutils'
+    sys.modules['distutils'] = distutils
+
+    # sanity check that submodules load as expected
+    core = importlib.import_module('distutils.core')
+    assert '_distutils' in core.__file__, core.__file__
+
+
+def do_override():
+    """
+    Ensure that the local copy of distutils is preferred over stdlib.
+
+    See https://github.com/pypa/setuptools/issues/417#issuecomment-392298401
+    for more motivation.
+    """
+    if enabled():
+        warn_distutils_present()
+        ensure_local_distutils()
+
+
+class DistutilsMetaFinder:
+    def find_spec(self, fullname, path, target=None):
+        if path is not None:
+            return
+
+        method_name = 'spec_for_{fullname}'.format(**locals())
+        method = getattr(self, method_name, lambda: None)
+        return method()
+
+    def spec_for_distutils(self):
+        import importlib.abc
+        import importlib.util
+
+        class DistutilsLoader(importlib.abc.Loader):
+
+            def create_module(self, spec):
+                return importlib.import_module('setuptools._distutils')
+
+            def exec_module(self, module):
+                pass
+
+        return importlib.util.spec_from_loader('distutils', DistutilsLoader())
+
+    def spec_for_pip(self):
+        """
+        Ensure stdlib distutils when running under pip.
+        See pypa/pip#8761 for rationale.
+        """
+        if self.pip_imported_during_build():
+            return
+        clear_distutils()
+        self.spec_for_distutils = lambda: None
+
+    @staticmethod
+    def pip_imported_during_build():
+        """
+        Detect if pip is being imported in a build script. Ref #2355.
+        """
+        import traceback
+        return any(
+            frame.f_globals['__file__'].endswith('setup.py')
+            for frame, line in traceback.walk_stack(None)
+        )
+
+
+DISTUTILS_FINDER = DistutilsMetaFinder()
+
+
+def add_shim():
+    sys.meta_path.insert(0, DISTUTILS_FINDER)
+
+
+def remove_shim():
+    try:
+        sys.meta_path.remove(DISTUTILS_FINDER)
+    except ValueError:
+        pass

.idea/misc.xml

@@ -0,0 +1 @@
+__import__('_distutils_hack').do_override()

.idea/modules.xml

@@ -0,0 +1,56 @@
+"""adodbapi - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
+
+Copyright (C) 2002 Henrik Ekelund, version 2.1 by Vernon Cole
+* http://sourceforge.net/projects/adodbapi
+"""
+import sys
+import time
+
+if sys.version_info < (3,0): # in Python 2, define all symbols, just like the bad old way
+    from .apibase import *
+    VariantConversionMap = MultiMap # old name. Should use apibase.MultiMap
+    from .ado_consts import *
+    _makeByteBuffer = buffer
+else:
+    # but if the user is running Python 3, then keep the dictionary clean
+    from .apibase import apilevel, threadsafety, paramstyle
+    from .apibase import Warning, Error, InterfaceError, DatabaseError, DataError, OperationalError, IntegrityError
+    from .apibase import InternalError, ProgrammingError, NotSupportedError, FetchFailedError
+    from .apibase import NUMBER, STRING, BINARY, DATETIME, ROWID
+    _makeByteBuffer = bytes
+
+from .adodbapi import connect, Connection, __version__, dateconverter, Cursor
+
+def Binary(aString):
+    """This function constructs an object capable of holding a binary (long) string value. """
+    return _makeByteBuffer(aString)
+
+def Date(year,month,day):
+    "This function constructs an object holding a date value. "
+    return dateconverter.Date(year,month,day)
+
+def Time(hour,minute,second):
+    "This function constructs an object holding a time value. "
+    return dateconverter.Time(hour,minute,second)
+
+def Timestamp(year,month,day,hour,minute,second):
+    "This function constructs an object holding a time stamp value. "
+    return dateconverter.Timestamp(year,month,day,hour,minute,second)
+
+def DateFromTicks(ticks):
+    """This function constructs an object holding a date value from the given ticks value
+    (number of seconds since the epoch; see the documentation of the standard Python time module for details). """
+    return Date(*time.gmtime(ticks)[:3])
+
+def TimeFromTicks(ticks):
+    """This function constructs an object holding a time value from the given ticks value
+    (number of seconds since the epoch; see the documentation of the standard Python time module for details). """
+    return Time(*time.gmtime(ticks)[3:6])
+
+def TimestampFromTicks(ticks):
+    """This function constructs an object holding a time stamp value from the given
+    ticks value (number of seconds since the epoch;
+    see the documentation of the standard Python time module for details). """
+    return Timestamp(*time.gmtime(ticks)[:6])
+
+version = 'adodbapi v' + __version__