add a new convert workflow that will supplant the docs build

.github/workflows/convert.yml

@@ -0,0 +1,53 @@
+name: build nbconvert_html5 and export samples
+
+on: 
+  push:
+    branches-ignore:
+      - gh-pages
+    paths:
+      - .github/workflows/**
+      - nbconvert_html5/**
+      - "pyproject.toml"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10"]
+
+    steps:
+      - uses: actions/checkout@v3
+        name: Fetch all history for all tags and branches
+        with:
+          fetch-depth: 0
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+          cache-dependency-path: |
+            pyproject.toml
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install hatch
+      - name: Convert
+        run: |
+          python -m hatch run task:convert
+      - name: Build the docs
+        run: |
+          python -m hatch run docs:build
+      - name: Deploy main 🚀
+        uses: JamesIves/github-pages-deploy-action@v4
+        if: ${{ github.ref_name == 'main' }}
+        with:
+          folder: site # The folder the action should deploy.
+          single-commit: true
+      - name: Deploy non-main 🚀
+        uses: JamesIves/github-pages-deploy-action@v4
+        if: ${{ github.ref_name != 'main' }}
+        with:
+          folder: site # The folder the action should deploy.
+          single-commit: true
+          target-folder: branch/${{ github.ref_name }}        

.github/workflows/test.yml

@@ -12,16 +12,31 @@ jobs:
       uses: actions/checkout@v2
       with:
         fetch-depth: 0
-    - name: setup python
-      uses: actions/setup-python@v4
+    - name: Cache conda
+      uses: actions/cache@v2
+      env:
+        # Increase this value to reset cache if etc/example-environment.yml has not changed
+        CACHE_NUMBER: 0
       with:
-        cache: pip
-        cache-dependency-path: pyproject.toml
-        python-version: "${{ matrix.python-version}}"
-    - name: upgrade dependencies
-      run: |-
-        python -m pip install --upgrade pip hatch
-        pip install -e.[test]
+        path: ~/conda_pkgs_dir
+        key:
+          ${{ runner.os }}-conda-${{ env.CACHE_NUMBER }}-${{
+          hashFiles('test-environment.yml') }}
+    - uses: conda-incubator/setup-miniconda@v2
+      with:
+        activate-environment: test-nbconvert-a11y
+        channel-priority: strict
+        auto-activate-base: true
+        environment-file: test-environment.yml
+        use-only-tar-bz2: true 
+        miniforge-variant: Mambaforge
+        use-mamba: true
+    - name: init playwright nbconvert-a11y
+      run: |
+        conda activate test-nbconvert-a11y
+        playwright install --with-deps chrome
+        pip install -e.
     - name: test with pytest
       run: |
-        hatch run test:run
+        conda activate test-nbconvert-a11y
+        pytest

pyproject.toml

@@ -29,29 +29,25 @@ dependencies = [
     "IPython",
     "markdown-it-py[plugins,linkify]",
     "python-slugify",
-    "html5lib"
+    "html5lib",
 ]
 dynamic = ["version"]
 
 [project.optional-dependencies]
 test = [
     "pytest",
+    "pytest-xdist",
+    "pytest-sugar",
+    "pytest-playwright",
     "nbval",
     "matplotlib",
     "numpy",
     "ipywidgets",
     "beautifulsoup4",
     "scipy",
 ]
-audit = [
-    "doit",
-    "tomli",
-    "requests",
-    "requests_cache",
-    "playwright",
-    "pandas",
-    "tabulate",
-]
+task = ["doit", "tomli", "pandas", "tabulate"]
+audit = ["requests", "requests_cache", "playwright"]
 docs = ["mkdocs-material", "mkdocstrings[python]"]
 
 
@@ -68,9 +64,7 @@ serve = "mkdocs serve -v"
 
 [project.entry-points."nbconvert.exporters"]
 html5_test = "nbconvert_html5.exporters:Html5Test"
-# html5 = "nbconvert_html5.form_exporter:FormExporter"
 a11y = "nbconvert_html5.form_exporter:A11yExporter"
-# html_post = "nbconvert_html5.exporters:PostProcessExporter"
 
 [tool.hatch.build.targets.wheel.shared-data]
 "nbconvert_html5/templates" = "share/jupyter/nbconvert/templates"
@@ -86,18 +80,23 @@ version-file = "nbconvert_html5/_version.py"
 source = "vcs"
 
 # testing setttings
+[tool.hatch.envs.test.scripts]
+run = "pytest"
+
 [tool.pytest.ini_options]
 minversion = "6.0"
-addopts = "--nbval --current-env -pno:importnb --rootdir=tests --sanitize-with=sanitize.cfg"
-testpaths = ["tests"]
-norecursedirs = ["tests/notebooks", "*checkpoints"]
+addopts = "--nbval --nbval-current-env -pno:importnb -n auto --nbval-sanitize-with=sanitize.cfg"
+testpaths = ["tests", "test_playwright.py"]
+norecursedirs = ["tests/exports", "tests/notebooks", "*checkpoints"]
 
 [tool.hatch.envs.test]
-features = ["test"]
-
-[tool.hatch.envs.test.scripts]
-run = "pytest "
+features = ["test", "audit"]
+post-install-commands = ["python -m playwright install chrome"]
 
+[tool.hatch.envs.test.overrides]
+env.CI.post-install-commands = [
+    "python -m playwright install --with-deps chrome",
+]
 
 # formatting settings
 [tool.isort]
@@ -109,17 +108,22 @@ line_length = 100
 # doit tasks
 [tool.hatch.envs.task.scripts]
 list = "doit list"
-export = "doit copy convert audit report"
+convert = "doit convert"
 run = "doit run"
 
 [tool.hatch.envs.task]
-features = ["audit"]
+features = ["task"]
+
+[tool.hatch.envs.audit]
+features = ["task", "audit"]
 post-install-commands = ["- python -m playwright install chrome-beta"]
 
-[tool.hatch.envs.task.overrides]
+[tool.hatch.envs.audit.overrides]
 env.CI.post-install-commands = [
     "python -m playwright install --with-deps chrome-beta",
 ]
+[tool.hatch.envs.audit.scripts]
+axe = "doit audit"
 
 [tool.doit.commands.list]
 status = true

test-environment.yml

@@ -0,0 +1,27 @@
+name: test-nbconvert-a11y
+channels:
+  - conda-forge
+  - microsoft
+dependencies:
+  - python=3.11
+  - openjdk
+  - pip
+  - pip:
+    - html5validator
+    - pytest-playwright
+    - nbval
+    - accessible-pygments
+    - requests-cache
+    - markdown-it-py[plugins,linkify]
+    - python-slugify
+    - html5lib
+  - playwright
+  - nbconvert
+  - pytest
+  - pytest-xdist
+  - pytest-sugar
+  - matplotlib
+  - numpy
+  - ipywidgets
+  - beautifulsoup4
+  - scipy