Merge pull request #10266 from Carreau/ipython-ext-dir

Warn about IPython extension dir

docs/source/whatsnew/pr/pending-deprecation-ipython-extension.rst

@@ -0,0 +1,5 b''
+Loading extensions from ``ipython_extension_dir`` print a warning that this location is pending
+deprecation. This should only affect users still having extensions installed with ``%install_ext``
+which has been deprecated since IPython 4.0, and removed in 5.0. extensions still present in
+``ipython_extension_dir`` may shadow more recently installed versions using pip. It is thus
+recommended to clean ``ipython_extension_dir`` of any extension now available as a package.

IPython/core/extensions.py

@@ -5,12 +5,14 b''
 # Distributed under the terms of the Modified BSD License.
 
 import os
+import os.path
+import warnings
 from shutil import copyfile
 import sys
 from importlib import import_module
 
 from traitlets.config.configurable import Configurable
-from IPython.utils.path import ensure_dir_exists
+from IPython.utils.path import ensure_dir_exists, compress_user
 from traitlets import Instance
 
 try:
@@ -81,7 +83,12 b' class ExtensionManager(Configurable):'
         with self.shell.builtin_trap:
             if module_str not in sys.modules:
                 with prepended_to_syspath(self.ipython_extension_dir):
-                    import_module(module_str)
+                    mod = import_module(module_str)
+                    if mod.__file__.startswith(self.ipython_extension_dir):
+                        print(("Loading extensions from {dir} is deprecated. "
+                               "We recommend managing extensions like any "
+                               "other Python packages, in site-packages.").format(
+                              dir=compress_user(self.ipython_extension_dir)))
             mod = sys.modules[module_str]
             if self._call_load_ipython_extension(mod):
                 self.loaded.add(module_str)
@@ -168,3 +175,5 b' class ExtensionManager(Configurable):'
         filename = os.path.join(self.ipython_extension_dir, filename)
         copy(url, filename)
         return filename
+
+