Move code out of Installation.ipynb

Author: krassowski

docs/Installation.ipynb

@@ -8,62 +8,14 @@
    },
    "outputs": [],
    "source": [
-    "from sys import path\n",
-    "path.insert(0, '../py_src/jupyter_lsp')"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {
-    "hide_input": true
-   },
-   "outputs": [],
-   "source": [
-    "import _version\n",
-    "JUPYTER_LSP_VERSION = _version.__version__"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {
-    "hide_input": true
-   },
-   "outputs": [],
-   "source": [
-    "import json\n",
-    "\n",
-    "with open('../packages/jupyterlab-lsp/package.json') as f:\n",
-    "    jupyterlab_lsp_package = json.load(f)\n",
-    "\n",
-    "JUPYTERLAB_LSP_VERSION = jupyterlab_lsp_package['version']\n",
-    "JUPYTERLAB_VERSION = jupyterlab_lsp_package['devDependencies']['@jupyterlab/application'].lstrip('~^')\n",
-    "JUPYTERLAB_NEXT_MAJOR_VERSION = int(JUPYTERLAB_VERSION.split('.')[0]) + 1\n",
-    "\n",
-    "REQUIRED_JUPYTERLAB = f'>={JUPYTERLAB_VERSION},<{JUPYTERLAB_NEXT_MAJOR_VERSION}'"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {
-    "hide_input": true
-   },
-   "outputs": [],
-   "source": [
-    "from IPython.display import Markdown\n",
-    "from IPython.core.magic import register_cell_magic\n",
-    "\n",
-    "\n",
-    "@register_cell_magic\n",
-    "def markdown(line, cell):\n",
-    "    \"\"\"Cell itnerpreted as Markdown but with variable substitution support.\n",
-    "\n",
-    "    Variables from global environment will be substituted using the standard\n",
-    "    Python format mechanism which uses single curly braces (e.g. {variable})\n",
-    "    \"\"\"\n",
-    "    return Markdown(cell.format(**globals()))"
+    "from markdown import markdown\n",
+    "from versions import (\n",
+    "    JUPYTER_LSP_VERSION,\n",
+    "    JUPYTERLAB_LSP_VERSION,\n",
+    "    JUPYTERLAB_NEXT_MAJOR_VERSION,\n",
+    "    JUPYTERLAB_VERSION,\n",
+    "    REQUIRED_JUPYTERLAB\n",
+    ")"
    ]
   },
   {

docs/markdown.py

@@ -0,0 +1,13 @@
+from IPython.display import Markdown
+from IPython.core.magic import register_cell_magic, needs_local_scope
+
+
+@register_cell_magic
+@needs_local_scope
+def markdown(line, cell, local_ns):
+    """Cell interpreted as Markdown but with variable substitution support.
+
+    Variables from global environment will be substituted using the standard
+    Python format mechanism which uses single curly braces (e.g. {variable})
+    """
+    return Markdown(cell.format(**local_ns))

docs/versions.py

@@ -0,0 +1,22 @@
+import json
+from sys import path
+
+path.insert(0, '../py_src/jupyter_lsp')
+
+import _version   # noqa
+
+
+JUPYTER_LSP_VERSION = _version.__version__
+
+with open('../packages/jupyterlab-lsp/package.json') as f:
+    jupyterlab_lsp_package = json.load(f)
+
+JUPYTERLAB_LSP_VERSION = jupyterlab_lsp_package['version']
+JUPYTERLAB_VERSION = (
+    jupyterlab_lsp_package
+    ['devDependencies']
+    ['@jupyterlab/application']
+    .lstrip('~^')
+)
+JUPYTERLAB_NEXT_MAJOR_VERSION = int(JUPYTERLAB_VERSION.split('.')[0]) + 1
+REQUIRED_JUPYTERLAB = f'>={JUPYTERLAB_VERSION},<{JUPYTERLAB_NEXT_MAJOR_VERSION}'