chore: Template upgrade

Author: pawamoy

.copier-answers.yml

@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier
-_commit: 0.3.1
+_commit: 1.0.0
 _src_path: gh:mkdocstrings/handler-template
 author_email: dev@pawamoy.fr
 author_fullname: Timothée Mazzucotelli

.github/FUNDING.yml

@@ -1,4 +1,5 @@
 github: pawamoy
 ko_fi: pawamoy
+polar: pawamoy
 custom:
 - https://www.paypal.me/pawamoy

.github/workflows/ci.yml

@@ -108,10 +108,7 @@ jobs:
       run: pip install uv
 
     - name: Install dependencies
-      run: |
-        uv venv
-        uv pip install -r devdeps.txt
-        uv pip install "mkdocstrings-typescript @ ."
+      run: make setup
 
     - name: Run the test suite
       run: make test

.gitignore

@@ -1,17 +1,24 @@
+# editors
 .idea/
 .vscode/
-__pycache__/
-*.py[cod]
-dist/
+
+# python
 *.egg-info/
-build/
-htmlcov/
+*.py[cod]
+.venv/
+.venvs/
+/build/
+/dist/
+
+# tools
 .coverage*
-pip-wheel-metadata/
+/.pdm-build/
+/htmlcov/
+/site/
+
+# cache
+.cache/
 .pytest_cache/
 .mypy_cache/
 .ruff_cache/
-site/
-.venv/
-.venvs/
-.cache/
+__pycache__/

config/ruff.toml

@@ -3,8 +3,7 @@ line-length = 120
 
 [lint]
 exclude = [
-    "fixtures",
-    "site",
+    "tests/fixtures/*.py",
 ]
 select = [
     "A", "ANN", "ARG",
@@ -78,5 +77,8 @@ known-first-party = ["mkdocstrings_handlers.typescript"]
 convention = "google"
 
 [format]
+exclude = [
+    "tests/fixtures/*.py",
+]
 docstring-code-format = true
 docstring-code-line-length = 80

duties.py

@@ -157,17 +157,16 @@ def clean(ctx: Context) -> None:
     Parameters:
         ctx: The context instance (passed automatically).
     """
-    ctx.run("rm -rf .coverage*")
-    ctx.run("rm -rf .mypy_cache")
-    ctx.run("rm -rf .pytest_cache")
-    ctx.run("rm -rf tests/.pytest_cache")
-    ctx.run("rm -rf build")
-    ctx.run("rm -rf dist")
-    ctx.run("rm -rf htmlcov")
-    ctx.run("rm -rf pip-wheel-metadata")
-    ctx.run("rm -rf site")
-    ctx.run("find . -type d -name __pycache__ | xargs rm -rf")
-    ctx.run("find . -name '*.rej' -delete")
+    def _rm(*targets: str) -> None:
+        for target in targets:
+            ctx.run(f"rm -rf {target}")
+
+    def _find_rm(*targets: str) -> None:
+        for target in targets:
+            ctx.run(f"find . -type d -name '{target}' | xargs rm -rf")
+
+    _rm("build", "dist", ".coverage*", "htmlcov", "site", ".pdm-build")
+    _find_rm(".cache", ".pytest_cache", ".mypy_cache", ".ruff_cache", "__pycache__")
 
 
 @duty

scripts/gen_credits.py

@@ -141,12 +141,12 @@ def _render_credits() -> str:
 
         These projects were used to build *{{ project_name }}*. **Thank you!**
 
-        [`python`](https://www.python.org/) |
-        [`uv`](https://github.com/astral-sh/uv) |
-        [`copier-uv`](https://github.com/pawamoy/copier-uv)
+        [Python](https://www.python.org/) |
+        [uv](https://github.com/astral-sh/uv) |
+        [copier-uv](https://github.com/pawamoy/copier-uv)
 
         {% macro dep_line(dep) -%}
-        [`{{ dep.name }}`](https://pypi.org/project/{{ dep.name }}/) | {{ dep.summary }} | {{ ("`" ~ dep.spec|sort(reverse=True)|join(", ") ~ "`") if dep.spec else "" }} | `{{ dep.version }}` | {{ dep.license }}
+        [{{ dep.name }}](https://pypi.org/project/{{ dep.name }}/) | {{ dep.summary }} | {{ ("`" ~ dep.spec|sort(reverse=True)|join(", ") ~ "`") if dep.spec else "" }} | `{{ dep.version }}` | {{ dep.license }}
         {%- endmacro %}
 
         {% if prod_dependencies -%}

scripts/make

@@ -11,7 +11,11 @@ prefix=""
 # as well as current project in editable mode.
 uv_install() {
     uv pip compile pyproject.toml devdeps.txt | uv pip install -r -
-    uv pip install -e .
+    if [ -z "${CI}" ]; then
+        uv pip install -e .
+    else
+        uv pip install "mkdocstrings-typescript @ ."
+    fi
 }
 
 
@@ -28,13 +32,13 @@ setup() {
     if [ -n "${PYTHON_VERSIONS}" ]; then
         for version in ${PYTHON_VERSIONS}; do
             if [ ! -d ".venvs/${version}" ]; then
-                uv venv --seed --python "${version}" ".venvs/${version}"
+                uv venv --python "${version}" ".venvs/${version}"
             fi
             VIRTUAL_ENV="${PWD}/.venvs/${version}" uv_install
         done
     fi
 
-    if [ ! -d .venv ]; then uv venv --seed --python python; fi
+    if [ ! -d .venv ]; then uv venv --python python; fi
     uv_install
 }
 

src/mkdocstrings_handlers/typescript/debug.py

@@ -37,6 +37,8 @@ class Environment:
     """Python interpreter name."""
     interpreter_version: str
     """Python interpreter version."""
+    interpreter_path: str
+    """Path to Python executable."""
     platform: str
     """Operating System."""
     packages: list[Package]
@@ -83,6 +85,7 @@ def get_debug_info() -> Environment:
     return Environment(
         interpreter_name=py_name,
         interpreter_version=py_version,
+        interpreter_path=sys.executable,
         platform=platform.platform(),
         variables=[Variable(var, val) for var in variables if (val := os.getenv(var))],
         packages=[Package(pkg, get_version(pkg)) for pkg in packages],
@@ -93,7 +96,7 @@ def print_debug_info() -> None:
     """Print debug/environment information."""
     info = get_debug_info()
     print(f"- __System__: {info.platform}")
-    print(f"- __Python__: {info.interpreter_name} {info.interpreter_version}")
+    print(f"- __Python__: {info.interpreter_name} {info.interpreter_version} ({info.interpreter_path})")
     print("- __Environment variables__:")
     for var in info.variables:
         print(f"  - `{var.name}`: `{var.value}`")