tidy, docstrings

IPython/terminal/pt_inputhooks/osx.py

@@ -1,3 +1,7 b''
+"""Inputhook for OS X
+
+Calls NSApp / CoreFoundation APIs via ctypes.
+"""
 
 # obj-c boilerplate from appnope, used under BSD 2-clause
 
@@ -5,7 +9,6 b' import ctypes'
 import ctypes.util
 
 objc = ctypes.cdll.LoadLibrary(ctypes.util.find_library('objc'))
-CoreFoundation = ctypes.cdll.LoadLibrary(ctypes.util.find_library('CoreFoundation'))
 
 void_p = ctypes.c_void_p
 
@@ -30,7 +33,11 b' def C(classname):'
     """get an ObjC Class by name"""
     return objc.objc_getClass(_utf8(classname))
 
-# CoreFoundation calls we will use:
+# end obj-c boilerplate from appnope
+
+# CoreFoundation C-API calls we will use:
+CoreFoundation = ctypes.cdll.LoadLibrary(ctypes.util.find_library('CoreFoundation'))
+
 CFFileDescriptorCreate = CoreFoundation.CFFileDescriptorCreate
 CFFileDescriptorCreate.restype = void_p
 CFFileDescriptorCreate.argtypes = [void_p, ctypes.c_int, ctypes.c_bool, void_p]
@@ -66,10 +73,12 b' CFFileDescriptorInvalidate.argtypes = [void_p]'
 kCFFileDescriptorReadCallBack = 1
 kCFRunLoopCommonModes = void_p.in_dll(CoreFoundation, 'kCFRunLoopCommonModes')
 
+
 def _NSApp():
     """Return the global NSApplication instance (NSApp)"""
     return msg(C('NSApplication'), n('sharedApplication'))
 
+
 def _wake(NSApp):
     """Wake the Application"""
     event = msg(C('NSEvent'),
@@ -87,6 +96,7 b' def _wake(NSApp):'
     )
     msg(NSApp, n('postEvent:atStart:'), void_p(event), True)
     
+
 def _input_callback(fdref, flags, info):
     """Callback to fire when there's input to be read"""
     CFFileDescriptorInvalidate(fdref)
@@ -98,6 +108,7 b' def _input_callback(fdref, flags, info):'
 _c_callback_func_type = ctypes.CFUNCTYPE(None, void_p, void_p, void_p)
 _c_input_callback = _c_callback_func_type(_input_callback)
 
+
 def _stop_on_read(fd):
     """Register callback to stop eventloop when there's data on fd"""
     fdref = CFFileDescriptorCreate(None, fd, False, _c_input_callback, None)
@@ -107,6 +118,7 b' def _stop_on_read(fd):'
     CFRunLoopAddSource(loop, source, kCFRunLoopCommonModes)
     CFRelease(source)
 
+
 def inputhook(context):
     """Inputhook for Cocoa (NSApp)"""
     NSApp = _NSApp()