Allow latest release of black to run

[Adafruit_Blinka-hackapet.git] / src / adafruit_blinka / __init__.py

diff --git a/src/adafruit_blinka/__init__.py b/src/adafruit_blinka/__init__.py
old mode 100644 (file)
new mode 100755 (executable)
index 32b2002..69e9178
--- a/src/adafruit_blinka/__init__.py
+++ b/src/adafruit_blinka/__init__.py
@@ -1,9 +1,15 @@
-"""Module providing runtime utility objects to support the Micro/CircuitPython api"""
+"""
+`adafruit_blinka` - Runtime utility objects for re-implementation of CircuitPython API
+======================================================================================
 
-class Enum(object):
+* Author(s): cefn
+"""
+
+
+class Enum:
     """
-        Object supporting CircuitPython-style of static symbols
-        as seen with Direction.OUTPUT, Pull.UP
+    Object supporting CircuitPython-style of static symbols
+    as seen with Direction.OUTPUT, Pull.UP
     """
 
     def __repr__(self):
@@ -21,34 +27,58 @@ class Enum(object):
     @classmethod
     def iteritems(cls):
         """
-            Inspects attributes of the class for instances of the class
-            and returns as key,value pairs mirroring dict#iteritems
+        Inspects attributes of the class for instances of the class
+        and returns as key,value pairs mirroring dict#iteritems
         """
         for key in dir(cls):
             val = getattr(cls, key)
-            if type(val) is cls:
+            if isinstance(cls, val):
                 yield (key, val)
 
 
 class ContextManaged:
+    """An object that automatically deinitializes hardware with a context manager."""
+
     def __enter__(self):
         return self
 
     def __exit__(self, exc_type, exc_value, traceback):
         self.deinit()
 
+    # pylint: disable=no-self-use
+    def deinit(self):
+        """Free any hardware used by the object."""
+        return
+
+    # pylint: enable=no-self-use
+
+
 class Lockable(ContextManaged):
+    """An object that must be locked to prevent collisions on a microcontroller resource."""
+
     _locked = False
 
     def try_lock(self):
+        """Attempt to grab the lock. Return True on success, False if the lock is already taken."""
         if self._locked:
             return False
-        else:
-            self._locked=True
-            return True
+        self._locked = True
+        return True
 
     def unlock(self):
+        """Release the lock so others may use the resource."""
         if self._locked:
             self._locked = False
         else:
             raise ValueError("Not locked")
+
+
+def patch_system():
+    """Patch modules that may be different due to the platform."""
+    # pylint: disable=import-outside-toplevel
+    import sys
+    from adafruit_blinka.agnostic import time
+
+    # pylint: enable=import-outside-toplevel
+
+    sys.modules["time"] = time