add appnope to external

IPython/external/appnope/__init__.py

@@ -0,0 +1,15 b''
+
+try:
+    from appnope import *
+except ImportError:
+    __version__ = '0.0.5'
+    import sys
+    import platform
+    from distutils.version import LooseVersion as V
+
+    if sys.platform != "darwin" or V(platform.mac_ver()[0]) < V("10.9"):
+        from _dummy import *
+    else:
+        from ._nope import *
+
+    del sys, platform, V

IPython/external/appnope/_dummy.py

@@ -0,0 +1,30 b''
+#-----------------------------------------------------------------------------
+#  Copyright (C) 2013 Min RK
+#
+#  Distributed under the terms of the 2-clause BSD License.
+#-----------------------------------------------------------------------------
+
+from contextlib import contextmanager
+
+def beginActivityWithOptions(options, reason=""):
+    return
+
+def endActivity(activity):
+    return
+
+def nope():
+    return
+
+def nap():
+    return
+
+
+@contextmanager
+def nope_scope(
+        options=0,
+        reason="Because Reasons"
+    ):
+    yield
+
+def napping_allowed():
+    return True
  No newline at end of file

IPython/external/appnope/_nope.py

@@ -0,0 +1,126 b''
+#-----------------------------------------------------------------------------
+#  Copyright (C) 2013 Min RK
+#
+#  Distributed under the terms of the 2-clause BSD License.
+#-----------------------------------------------------------------------------
+
+from contextlib import contextmanager
+
+import ctypes
+import ctypes.util
+
+objc = ctypes.cdll.LoadLibrary(ctypes.util.find_library('objc'))
+
+void_p = ctypes.c_void_p
+ull = ctypes.c_uint64
+
+objc.objc_getClass.restype = void_p
+objc.sel_registerName.restype = void_p
+objc.objc_msgSend.restype = void_p
+objc.objc_msgSend.argtypes = [void_p, void_p]
+
+msg = objc.objc_msgSend
+
+def _utf8(s):
+    """ensure utf8 bytes"""
+    if not isinstance(s, bytes):
+        s = s.encode('utf8')
+    return s
+
+def n(name):
+    """create a selector name (for methods)"""
+    return objc.sel_registerName(_utf8(name))
+
+def C(classname):
+    """get an ObjC Class by name"""
+    return objc.objc_getClass(_utf8(classname))
+
+# constants from Foundation
+
+NSActivityIdleDisplaySleepDisabled             = (1 << 40)
+NSActivityIdleSystemSleepDisabled              = (1 << 20)
+NSActivitySuddenTerminationDisabled            = (1 << 14)
+NSActivityAutomaticTerminationDisabled         = (1 << 15)
+NSActivityUserInitiated                        = (0x00FFFFFF | NSActivityIdleSystemSleepDisabled)
+NSActivityUserInitiatedAllowingIdleSystemSleep = (NSActivityUserInitiated & ~NSActivityIdleSystemSleepDisabled)
+NSActivityBackground                           = 0x000000FF
+NSActivityLatencyCritical                      = 0xFF00000000
+
+def beginActivityWithOptions(options, reason=""):
+    """Wrapper for:
+    
+    [ [ NSProcessInfo processInfo] 
+        beginActivityWithOptions: (uint64)options
+                          reason: (str)reason
+    ]
+    """
+    NSProcessInfo = C('NSProcessInfo')
+    NSString = C('NSString')
+    
+    reason = msg(NSString, n("stringWithUTF8String:"), _utf8(reason))
+    info = msg(NSProcessInfo, n('processInfo'))
+    activity = msg(info,
+        n('beginActivityWithOptions:reason:'),
+        ull(options),
+        void_p(reason)
+    )
+    return activity
+
+def endActivity(activity):
+    """end a process activity assertion"""
+    NSProcessInfo = C('NSProcessInfo')
+    info = msg(NSProcessInfo, n('processInfo'))
+    msg(info, n("endActivity:"), void_p(activity))
+
+_theactivity = None
+
+def nope():
+    """disable App Nap by setting NSActivityUserInitiatedAllowingIdleSystemSleep"""
+    global _theactivity
+    _theactivity = beginActivityWithOptions(
+        NSActivityUserInitiatedAllowingIdleSystemSleep,
+        "Because Reasons"
+    )
+
+def nap():
+    """end the caffeinated state started by `nope`"""
+    global _theactivity
+    if _theactivity is not None:
+        endActivity(_theactivity)
+        _theactivity = None
+
+def napping_allowed():
+    """is napping allowed?"""
+    return _theactivity is None
+
+@contextmanager
+def nope_scope(
+        options=NSActivityUserInitiatedAllowingIdleSystemSleep,
+        reason="Because Reasons"
+    ):
+    """context manager for beginActivityWithOptions.
+    
+    Within this context, App Nap will be disabled.
+    """
+    activity = beginActivityWithOptions(options, reason)
+    try:
+        yield
+    finally:
+        endActivity(activity)
+
+__all__ = [
+    "NSActivityIdleDisplaySleepDisabled",
+    "NSActivityIdleSystemSleepDisabled",
+    "NSActivitySuddenTerminationDisabled",
+    "NSActivityAutomaticTerminationDisabled",
+    "NSActivityUserInitiated",
+    "NSActivityUserInitiatedAllowingIdleSystemSleep",
+    "NSActivityBackground",
+    "NSActivityLatencyCritical",
+    "beginActivityWithOptions",
+    "endActivity",
+    "nope",
+    "nap",
+    "napping_allowed",
+    "nope_scope",
+]