Update the development environment

.ci/environment-ci.yml

@@ -15,7 +15,7 @@ dependencies:
   - nbformat>=5.1.2
   - pyyaml
   - toml
-  - markdown-it-py~=1.0
+  - markdown-it-py
   - mdit-py-plugins
   - pip
   - pytest
@@ -25,8 +25,8 @@ dependencies:
   - flake8
   - autopep8
   - black
-  - isort>=5.3.0
-  - pandoc==2.16.2
+  - isort
+  - pandoc>=3.0
   - sphinx-gallery<0.8
   - pre-commit
   - gitpython

.pre-commit-config.yaml

@@ -18,27 +18,27 @@ exclude: >
 repos:
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: v4.5.0
     hooks:
     - id: check-json
     - id: check-yaml
     - id: end-of-file-fixer
     - id: trailing-whitespace
 
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.9.0
+    rev: v3.15.0
     hooks:
     - id: pyupgrade
       args: ["--py38-plus"]
 
   - repo: https://github.com/myint/autoflake
-    rev: v2.2.0
+    rev: v2.2.1
     hooks:
     - id: autoflake
       args: ['--in-place', '--remove-all-unused-imports', '--remove-unused-variable']
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.0
+    rev: v0.1.5
     hooks:
       - id: ruff
         args: ["--fix", "--show-fixes"]
@@ -52,6 +52,6 @@ repos:
       args: ["--profile", "black"]
 
   - repo: https://github.com/psf/black
-    rev: 23.7.0
+    rev: 23.11.0
     hooks:
     - id: black

docs/developing.md

@@ -22,11 +22,14 @@ Most of Jupytext's code is written in Python. To develop the Python part of Jupy
 ```
 conda env create --file environment.yml  # or conda env update --file ...
 conda activate jupytext-dev
-python -m ipykernel install --name jupytext-dev --user
-pip install -e .
 ```
 
-We use the [pre-commit](https://pre-commit.com) package to run pre-commit scripts like `black` and `flake8` on the code.
+Install the `jupytext` package in development mode with
+```
+pip install '.[dev]'
+```
+
+We use the [pre-commit](https://pre-commit.com) package to run pre-commit scripts like `black` and `ruff` on the code.
 Install it with
 ```
 pre-commit install
@@ -37,19 +40,19 @@ Tests are executed with `pytest`. You can run them in parallel with for instance
 pytest -n 5
 ```
 
-Build the `jupytext` package and install it with
+Some tests require a Jupyter kernel pointing to the current environment:
 ```
-pip install -U build wheel
-python -m build
-pip install dist/jupytext-x.x.x-py3-none-any.whl
+python -m ipykernel install --name jupytext-dev --user
 ```
 
-or with
+Finally, you can build the package and install it with
 ```
-pip install .
+pip install -U build wheel
+python -m build
+pip install dist/jupytext-x.x.x-py3-none-any.whl
 ```
 
-Finally, note that you can use `HATCH_BUILD_HOOKS_ENABLE=false` if you don't need the lab extension - the build time will be slightly shorter.
+Note that you can use `HATCH_BUILD_HOOKS_ENABLE=false` if you don't need the lab extension - the build time will be slightly shorter.
 
 ## Jupytext's extension for JupyterLab
 

environment.yml

@@ -12,25 +12,17 @@ dependencies:
   - mdit-py-plugins
   - nbconvert
   - ipykernel
-  - jupyter_contrib_nbextensions
   - pytest
   - pytest-xdist
   - pytest-randomly
   - pytest-cov
   - pre-commit
   - gitpython
   - pylint
-  - flake8==3.9.1
-  - black==21.4b2
-  - isort==5.8.0
+  - flake8
+  - black==23.11.0
+  - isort==5.12.0
   - autopep8
   - sphinx-gallery<0.8
-  - pip
-  - setuptools
-  - twine
-  - pandoc==2.16.2
-  # make html in docs folder
-  - sphinx
-  - tox-conda
-  - pip:
-    - sphinx_copybutton
+  - pandoc>=3.0
+  - nodejs>=20