Publish docs on GitHub Pages and report coverage via Codecov

Replace the (unused) Read the Docs setup with a GitHub Actions workflow
(.github/workflows/docs.yml) that builds the Sphinx docs and deploys them to
GitHub Pages, and extend the tests workflow to upload coverage to Codecov
(pytest --cov-report=xml + codecov-action on the 3.12 job). Add codecov.yml
(informational coverage, excluding tests/gui/notebooks) and swap the README
RTD badge for GitHub Pages docs and Codecov badges; remove .readthedocs.yaml.

Author: dmeoli

.github/workflows/docs.yml

@@ -0,0 +1,42 @@
+name: docs
+
+on:
+  push:
+    branches: [master]
+
+# allow the workflow to publish to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install documentation dependencies
+        run: pip install -r docs/requirements.txt
+      - name: Build the Sphinx documentation
+        run: sphinx-build -b html docs docs/_build/html
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/tests.yml

@@ -37,4 +37,11 @@ jobs:
         continue-on-error: true
 
       - name: Run tests
-        run: pytest --cov=./
+        run: pytest --cov=./ --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.12'
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false

.readthedocs.yaml

@@ -1,6 +1,6 @@
 
 
-# `aima-python` [![tests](https://github.com/aimacode/aima-python/actions/workflows/tests.yml/badge.svg)](https://github.com/aimacode/aima-python/actions/workflows/tests.yml) [![Documentation Status](https://readthedocs.org/projects/aima-python/badge/?version=latest)](https://aima-python.readthedocs.io/en/latest/?badge=latest) [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/aimacode/aima-python/master)
+# `aima-python` [![tests](https://github.com/aimacode/aima-python/actions/workflows/tests.yml/badge.svg)](https://github.com/aimacode/aima-python/actions/workflows/tests.yml) [![docs](https://github.com/aimacode/aima-python/actions/workflows/docs.yml/badge.svg)](https://aimacode.github.io/aima-python/) [![codecov](https://codecov.io/gh/aimacode/aima-python/branch/master/graph/badge.svg)](https://codecov.io/gh/aimacode/aima-python) [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/aimacode/aima-python/master)
 
 
 Python code for the book *[Artificial Intelligence: A Modern Approach](http://aima.cs.berkeley.edu).* You can use this in conjunction with a course on AI, or for study on your own. We're looking for [solid contributors](https://github.com/aimacode/aima-python/blob/master/CONTRIBUTING.md) to help.

README.md

@@ -0,0 +1,15 @@
+# Codecov configuration. Coverage is reported but never fails CI (informational),
+# and non-library files are excluded from the percentage.
+coverage:
+  status:
+    project:
+      default:
+        informational: true
+    patch:
+      default:
+        informational: true
+
+ignore:
+  - "tests/**"
+  - "gui/**"
+  - "**/*.ipynb"