Merge branch 'main' into pre-commit

Author: 12rambau

.devcontainer/devcontainer.json

@@ -0,0 +1,9 @@
+{
+  "name": "Python 3",
+  "image": "mcr.microsoft.com/devcontainers/python:1-3.11-bullseye",
+  "features": {
+    "ghcr.io/devcontainers-contrib/features/hatch:2": {},
+    "ghcr.io/devcontainers-contrib/features/pre-commit:2": {}
+  },
+  "postCreateCommand": "pre-commit install"
+}

jupyter_sphinx/__init__.py

@@ -5,9 +5,10 @@
 import docutils
 import ipywidgets
 from IPython.lib.lexers import IPython3Lexer, IPythonTracebackLexer
+from sphinx.application import Sphinx
 from sphinx.errors import ExtensionError
 from sphinx.util import logging
-from sphinx.util.fileutil import copy_asset
+from sphinx.util.fileutil import copy_asset_file
 
 from ._version import __version__
 from .ast import (
@@ -89,7 +90,7 @@ def visit_thebe_source(self, node):
 
 
 # Sphinx callback functions
-def builder_inited(app):
+def builder_inited(app: Sphinx):
     """Init the build.
 
     2 cases
@@ -108,17 +109,17 @@ def builder_inited(app):
         app.add_js_file(embed_url)
 
 
-def copy_file(src, dst):
-    if not (dst / src.name).exists():
-        copy_asset(str(src), str(dst))
+def copy_file(src: Path, dst: Path):
+    """wrapper of copy_asset_file to handle path"""
+    copy_asset_file(str(src.resolve()), str(dst.resolve()))
 
 
-def build_finished(app, env):
+def build_finished(app: Sphinx, env):
     if app.builder.format != "html":
         return
 
     module_dir = Path(__file__).parent
-    static = Path(app.outdir) / "_static"
+    static = Path(app.builder.outdir) / "_static"
 
     # Copy stylesheet
     src = module_dir / "css" / "jupyter-sphinx.css"
@@ -136,7 +137,7 @@ def build_finished(app, env):
 
 ##############################################################################
 # Main setup
-def setup(app):
+def setup(app: Sphinx):
     """A temporary setup function so that we can use it here and in execute.
 
     This should be removed and converted into `setup` after a deprecation