AdaCore · gusthoff · Jun 12, 2026 · Jun 12, 2026 · Jun 12, 2026 · Jun 12, 2026
diff --git a/.github/workflows/code-projects-type-check.yml b/.github/workflows/code-projects-type-check.yml
@@ -3,12 +3,12 @@ name: code_projects Type Check
 on:
   push:
     paths:
-      - 'frontend/py_modules/code_projects/**'
+      - 'frontend/python/rst_code_example_pipeline/**'
   pull_request:
     branches:
       - main
     paths:
-      - 'frontend/py_modules/code_projects/**'
+      - 'frontend/python/rst_code_example_pipeline/**'
 
 jobs:
   pyright:
@@ -27,6 +27,8 @@ jobs:
         python-version: ${{ matrix.python-version }}
     - name: Install pyright
       run: pip install pyright
-    - name: Run pyright on code_projects
-      working-directory: frontend/py_modules/code_projects
+    - name: Install rst_code_example_pipeline
+      run: pip install -e frontend/python/rst_code_example_pipeline
+    - name: Run pyright on rst_code_example_pipeline
+      working-directory: frontend/python/rst_code_example_pipeline
       run: pyright .
diff --git a/.github/workflows/install_toolchain.sh b/.github/workflows/install_toolchain.sh
@@ -2,7 +2,7 @@
 
 GNAT_FSF_BUILDS=https://github.com/alire-project/GNAT-FSF-builds/releases/download
 
-TOOLCHAIN_CONFIG=${GITHUB_WORKSPACE}/frontend/py_modules/code_projects/toolchain.ini
+TOOLCHAIN_CONFIG=${GITHUB_WORKSPACE}/frontend/python/rst_code_example_pipeline/src/rst_code_example_pipeline/data/toolchain.ini
 
 INSTALL_GNATPROVE=NO
 INSTALL_GNAT=NO

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -532,7 +532,7 @@ By default, the standard version of the GNAT toolchain specified in the
 frontend is used in the testing phase. The list of versions for each specific
 tool from the GNAT toolchain can be found in this file:
 
-frontend/py_modules/code_projects/toolchain.ini
+frontend/python/rst_code_example_pipeline/src/rst_code_example_pipeline/data/toolchain.ini
 
 An alternative version of a tool can be selected for a specific code block
 using the `gnat=`, `gnatprove=` or `gprbuild=` parameters. For example:

diff --git a/README.md b/README.md
@@ -111,15 +111,11 @@ website being served from the local Python-based HTTP server.
 The ReST files found in the [content directory](content) have `.. code:: ada`
 blocks that contain source-code examples. To test the expected behavior of
 those examples, a test script called `compile_blocks.py` is available, as well
-as the `code_projects` module.
+as the `rst_code_example_pipeline` package.
 
 To make use of this test infrastructure, the best approach is to start the
-Vagrant publishing server (`epub`) and install the environment:
-
-```sh
-cd /vagrant/frontend
-export PYTHONPATH="$PYTHONPATH:sphinx:py_modules"
-```
+Vagrant publishing server (`epub`). The Python environment is configured
+automatically during provisioning.
 
 
 ### Using the `compile_blocks.py` script
@@ -203,28 +199,28 @@ python3 tests/compile_blocks.py \
 ```
 
 
-### Using the code_projects module
+### Using the rst_code_example_pipeline package
 
-The [code_projects module](frontend/py_modules/code_projects) contains the
+The [rst_code_example_pipeline package](frontend/python/rst_code_example_pipeline) contains the
 actual Python modules that are called by the `compile_blocks.py` script. It's
-possible to use them directly:
+possible to use them directly via the installed entry points:
 
-- `extract_projects.py` extracts all code blocks and stores into the specified
+- `extract-code` extracts all code blocks and stores into the specified
   directory;
 
-- `check_projects.py` checks each code blocks from the specified directory.
+- `check-code` checks each code block from the specified directory.
 
 For example, to build the source-code examples from the
 [Introduction to Ada course](content/courses/intro-to-ada), run:
 
 ```sh
-python3 py_modules/code_projects/extract_projects.py     \
+extract-code                                       \
   --build-dir test_output                                \
   $(find ../content/courses/intro-to-ada/ -name '*.rst')
 
-python3 py_modules/code_projects/check_projects.py       \
+check-code                                         \
   --build-dir test_output
 ```
 
 For more examples and alternative configurations, please refer to the
-[README of the code_projects module](frontend/py_modules/code_projects/README.md)
+[README of the rst_code_example_pipeline package](frontend/python/rst_code_example_pipeline/README.md)
diff --git a/Vagrantfile b/Vagrantfile
@@ -71,6 +71,7 @@ $frontend = <<-SHELL
   python3 -m venv /vagrant/venv
   source /vagrant/venv/bin/activate
   pip3 install -r /vagrant/frontend/requirements_frozen.txt
+  pip3 install -e /vagrant/frontend/python/rst_code_example_pipeline
 
   # File system: increase number of user watches
   # Needed for npm
@@ -205,6 +206,7 @@ $epub = <<-SHELL
   python3 -m venv /vagrant/venv
   source /vagrant/venv/bin/activate
   pip3 install -r /vagrant/frontend/requirements_frozen.txt
+  pip3 install -e /vagrant/frontend/python/rst_code_example_pipeline
 
   # File system: increase number of user watches
   # Needed for npm
@@ -232,7 +234,7 @@ Vagrant.configure("2") do |config|
     web.vm.synced_folder './frontend', '/vagrant/frontend'
     web.vm.synced_folder './content', '/vagrant/content'
 
-    web.vm.provision "file", source: "./frontend/py_modules/code_projects/toolchain.ini", destination: "/home/vagrant/toolchain.ini"
+    web.vm.provision "file", source: "./frontend/python/rst_code_example_pipeline/src/rst_code_example_pipeline/data/toolchain.ini", destination: "/home/vagrant/toolchain.ini"
     web.vm.provision "file", source: "./frontend/vm_apt_web.txt", destination: "/home/vagrant/vm_apt.txt"
     web.vm.provision :shell, inline: $frontend
   end
@@ -244,7 +246,7 @@ Vagrant.configure("2") do |config|
     epub.vm.synced_folder './frontend', '/vagrant/frontend'
     epub.vm.synced_folder './content', '/vagrant/content'
 
-    epub.vm.provision "file", source: "./frontend/py_modules/code_projects/toolchain.ini", destination: "/home/vagrant/toolchain.ini"
+    epub.vm.provision "file", source: "./frontend/python/rst_code_example_pipeline/src/rst_code_example_pipeline/data/toolchain.ini", destination: "/home/vagrant/toolchain.ini"
     epub.vm.provision "file", source: "./frontend/vm_apt_epub.txt", destination: "/home/vagrant/vm_apt.txt"
     epub.vm.provision :shell, inline: $epub
   end

diff --git a/frontend/Makefile b/frontend/Makefile
@@ -6,9 +6,9 @@ SPHINXCONF         = sphinx
 BUILDDIR           = dist
 SRC_TEST_DIR       = $(BUILDDIR)/test_output
 TEST_LAMBDA       ?= 0
-TEST_LOCAL_DRIVER  = PYTHONPATH="$PYTHONPATH:sphinx:py_modules" python3 tests/compile_blocks.py --keep_files -B $(SRC_TEST_DIR)
+TEST_LOCAL_DRIVER  = PYTHONPATH="$PYTHONPATH:sphinx" python3 tests/compile_blocks.py --keep_files -B $(SRC_TEST_DIR)
 TEST_OPTIONS      ?=
-TEST_LAMBDA_DRIVER = PYTHONPATH="$PYTHONPATH:sphinx:py_modules" python3 tests/execute_rst_code_blocks.py --halt-on-failure
+TEST_LAMBDA_DRIVER = PYTHONPATH="$PYTHONPATH:sphinx" python3 tests/execute_rst_code_blocks.py --halt-on-failure
 
 ifeq ($(strip $(TEST_LAMBDA)),1)
 TEST_DRIVER 	:= $(TEST_LAMBDA_DRIVER)

diff --git a/frontend/py_modules/code_projects/README.md b/frontend/py_modules/code_projects/README.md
diff --git a/frontend/py_modules/code_projects/__init__.py b/frontend/py_modules/code_projects/__init__.py
diff --git a/frontend/py_modules/code_projects/pyrightconfig.json b/frontend/py_modules/code_projects/pyrightconfig.json
diff --git a/frontend/python/README.md b/frontend/python/README.md
@@ -0,0 +1,7 @@
+# Python packages
+
+This directory contains Python packages used by the learn infrastructure.
+
+| Package | Description |
+|---------|-------------|
+| [rst_code_example_pipeline](rst_code_example_pipeline/) | Extract, build, and check RST code blocks |