blackifying

Author: choldgraf

doc/source/conf.py

@@ -9,35 +9,28 @@
 import os
 import sys
 
-sys.path.insert(0, os.path.abspath('../..'))
+sys.path.insert(0, os.path.abspath("../.."))
 
 import jupyter_sphinx
 
-project = 'Jupyter Sphinx'
-copyright = '2019, Jupyter Development Team'
-author = 'Jupyter Development Team'
+project = "Jupyter Sphinx"
+copyright = "2019, Jupyter Development Team"
+author = "Jupyter Development Team"
 
 # The full version, including alpha/beta/rc tags
 release = jupyter_sphinx.__version__
 # The short X.Y version
-version = release[:len(release) - len(release.lstrip('0123456789.'))].rstrip('.')
+version = release[: len(release) - len(release.lstrip("0123456789."))].rstrip(".")
 
-master_doc = 'index'
+master_doc = "index"
 
-extensions = [
-    'sphinx.ext.mathjax',
-    'jupyter_sphinx',
-]
+extensions = ["sphinx.ext.mathjax", "jupyter_sphinx"]
 
-html_theme = 'alabaster'
+html_theme = "alabaster"
 html_theme_options = {
     "github_user": "jupyter",
     "github_repo": "jupyter-sphinx",
     "github_banner": True,
 }
 
-jupyter_sphinx_thebelab_config = {
-    "binderOptions": {
-        "repo": "jupyter/jupyter-sphinx",
-    },
-}
+jupyter_sphinx_thebelab_config = {"binderOptions": {"repo": "jupyter/jupyter-sphinx"}}

jupyter_sphinx/__init__.py

@@ -8,12 +8,21 @@
 from sphinx.util.fileutil import copy_asset
 from IPython.lib.lexers import IPythonTracebackLexer, IPython3Lexer
 
-from .ast import JupyterCell, JupyterCellNode, JupyterWidgetViewNode, JupyterWidgetStateNode, WIDGET_VIEW_MIMETYPE, jupyter_download_role
+from .ast import (
+    JupyterCell,
+    JupyterCellNode,
+    JupyterWidgetViewNode,
+    JupyterWidgetStateNode,
+    WIDGET_VIEW_MIMETYPE,
+    jupyter_download_role,
+)
 from .execute import JupyterKernelNode, JupyterKernel, ExecuteJupyterCells
 from .thebelab import ThebeButton, ThebeButtonNode, ThebeOutputNode, ThebeSourceNode
 
-REQUIRE_URL_DEFAULT = 'https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js'
-THEBELAB_URL_DEFAULT = 'https://unpkg.com/thebelab@^0.4.0'
+REQUIRE_URL_DEFAULT = (
+    "https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"
+)
+THEBELAB_URL_DEFAULT = "https://unpkg.com/thebelab@^0.4.0"
 
 logger = logging.getLogger(__name__)
 
@@ -27,36 +36,42 @@ def builder_inited(app):
     require_url = app.config.jupyter_sphinx_require_url
     if require_url:
         app.add_js_file(require_url)
-        embed_url = app.config.jupyter_sphinx_embed_url or ipywidgets.embed.DEFAULT_EMBED_REQUIREJS_URL
+        embed_url = (
+            app.config.jupyter_sphinx_embed_url
+            or ipywidgets.embed.DEFAULT_EMBED_REQUIREJS_URL
+        )
     else:
-        embed_url = app.config.jupyter_sphinx_embed_url or ipywidgets.embed.DEFAULT_EMBED_SCRIPT_URL
+        embed_url = (
+            app.config.jupyter_sphinx_embed_url
+            or ipywidgets.embed.DEFAULT_EMBED_SCRIPT_URL
+        )
     if embed_url:
         app.add_js_file(embed_url)
 
     # add jupyter-sphinx css
-    app.add_css_file('jupyter-sphinx.css')
+    app.add_css_file("jupyter-sphinx.css")
     # Check if a thebelab config was specified
     if app.config.jupyter_sphinx_thebelab_config:
-        app.add_js_file('thebelab-helper.js')
-        app.add_css_file('thebelab.css')
+        app.add_js_file("thebelab-helper.js")
+        app.add_css_file("thebelab.css")
 
 
 def build_finished(app, env):
-    if app.builder.format != 'html':
+    if app.builder.format != "html":
         return
 
     # Copy stylesheet
-    src = os.path.join(os.path.dirname(__file__), 'css')
-    dst = os.path.join(app.outdir, '_static')
+    src = os.path.join(os.path.dirname(__file__), "css")
+    dst = os.path.join(app.outdir, "_static")
     copy_asset(src, dst)
 
     thebe_config = app.config.jupyter_sphinx_thebelab_config
     if not thebe_config:
         return
 
     # Copy all thebelab related assets
-    src = os.path.join(os.path.dirname(__file__), 'thebelab')
-    dst = os.path.join(app.outdir, '_static')
+    src = os.path.join(os.path.dirname(__file__), "thebelab")
+    dst = os.path.join(app.outdir, "_static")
     copy_asset(src, dst)
 
 
@@ -69,42 +84,38 @@ def _setup(app):
     # Configuration
 
     app.add_config_value(
-        'jupyter_execute_kwargs',
+        "jupyter_execute_kwargs",
         dict(timeout=-1, allow_errors=True, store_widget_state=True),
-        'env'
+        "env",
     )
+    app.add_config_value("jupyter_execute_default_kernel", "python3", "env")
     app.add_config_value(
-        'jupyter_execute_default_kernel',
-        'python3',
-        'env'
-    )
-    app.add_config_value(
-        'jupyter_execute_data_priority',
+        "jupyter_execute_data_priority",
         [
             WIDGET_VIEW_MIMETYPE,
-            'application/javascript',
-            'text/html',
-            'image/svg+xml',
-            'image/png',
-            'image/jpeg',
-            'text/latex',
-            'text/plain'
+            "application/javascript",
+            "text/html",
+            "image/svg+xml",
+            "image/png",
+            "image/jpeg",
+            "text/latex",
+            "text/plain",
         ],
-        'env',
+        "env",
     )
 
     # ipywidgets config
-    app.add_config_value('jupyter_sphinx_require_url', REQUIRE_URL_DEFAULT, 'html')
-    app.add_config_value('jupyter_sphinx_embed_url', None, 'html')
+    app.add_config_value("jupyter_sphinx_require_url", REQUIRE_URL_DEFAULT, "html")
+    app.add_config_value("jupyter_sphinx_embed_url", None, "html")
 
     # thebelab config, can be either a filename or a dict
-    app.add_config_value('jupyter_sphinx_thebelab_config', None, 'html')
+    app.add_config_value("jupyter_sphinx_thebelab_config", None, "html")
 
-    app.add_config_value('jupyter_sphinx_thebelab_url', THEBELAB_URL_DEFAULT, 'html')
+    app.add_config_value("jupyter_sphinx_thebelab_url", THEBELAB_URL_DEFAULT, "html")
 
     # linenos config
-    app.add_config_value('jupyter_sphinx_linenos', False, 'env')
-    app.add_config_value('jupyter_sphinx_continue_linenos', False, 'env')
+    app.add_config_value("jupyter_sphinx_linenos", False, "env")
+    app.add_config_value("jupyter_sphinx_continue_linenos", False, "env")
 
     # Used for nodes that do not need to be rendered
     def skip(self, node):
@@ -132,17 +143,16 @@ def visit_element_html(self, node):
 
     # Used to render the ThebeSourceNode conditionally for non-HTML builders
     def visit_thebe_source(self, node):
-        if node['hide_code']:
+        if node["hide_code"]:
             raise docutils.nodes.SkipNode
         else:
             self.visit_container(node)
 
     render_thebe_source = (
         visit_thebe_source,
-        lambda self, node: self.depart_container(node)
+        lambda self, node: self.depart_container(node),
     )
 
-
     # JupyterKernelNode is just a doctree marker for the
     # ExecuteJupyterCells transform, so we don't actually render it.
     app.add_node(
@@ -220,24 +230,21 @@ def visit_thebe_source(self, node):
         man=(skip, None),
     )
 
-    app.add_directive('jupyter-execute', JupyterCell)
-    app.add_directive('jupyter-kernel', JupyterKernel)
-    app.add_directive('thebe-button', ThebeButton)
-    app.add_role('jupyter-download:notebook', jupyter_download_role)
-    app.add_role('jupyter-download:script', jupyter_download_role)
+    app.add_directive("jupyter-execute", JupyterCell)
+    app.add_directive("jupyter-kernel", JupyterKernel)
+    app.add_directive("thebe-button", ThebeButton)
+    app.add_role("jupyter-download:notebook", jupyter_download_role)
+    app.add_role("jupyter-download:script", jupyter_download_role)
     app.add_transform(ExecuteJupyterCells)
 
     # For syntax highlighting
-    app.add_lexer('ipythontb', IPythonTracebackLexer())
-    app.add_lexer('ipython', IPython3Lexer())
+    app.add_lexer("ipythontb", IPythonTracebackLexer())
+    app.add_lexer("ipython", IPython3Lexer())
 
-    app.connect('builder-inited', builder_inited)
-    app.connect('build-finished', build_finished)
+    app.connect("builder-inited", builder_inited)
+    app.connect("build-finished", build_finished)
 
-    return {
-        'version': __version__,
-        'parallel_read_safe': True,
-    }
+    return {"version": __version__, "parallel_read_safe": True}
 
 
 def setup(app):
@@ -246,4 +253,4 @@ def setup(app):
     This should be replaced with `_setup` after a deprecation cycle.
     """
     out = _setup(app)
-    return out
+    return out

jupyter_sphinx/_version.py

@@ -1,6 +1,12 @@
-version_info = (0, 2, 3, 'final')
+version_info = (0, 2, 3, "final")
 
-_specifier_ = {'alpha': 'a', 'beta': 'b', 'candidate': 'rc', 'final': ''}
+_specifier_ = {"alpha": "a", "beta": "b", "candidate": "rc", "final": ""}
 
-__version__ = '%s.%s.%s%s'%(version_info[0], version_info[1], version_info[2],
-  '' if version_info[3]=='final' else _specifier_[version_info[3]]+str(version_info[4]))
+__version__ = "%s.%s.%s%s" % (
+    version_info[0],
+    version_info[1],
+    version_info[2],
+    ""
+    if version_info[3] == "final"
+    else _specifier_[version_info[3]] + str(version_info[4]),
+)