authentication

.coveragerc

@@ -8,10 +8,11 @@ omit = src/klein/test/typing_*.py
 source=
    src/klein
    .tox/*/lib/python*/site-packages/klein
+   .tox/*/lib/pypy*/site-packages/klein
    .tox/*/Lib/site-packages/klein
-   .tox/pypy*/site-packages/klein
 
 [report]
 exclude_lines =
     pragma: no cover
     if TYPE_CHECKING:
+    \s*\.\.\.$

.github/workflows/cicd.yml

@@ -194,7 +194,7 @@ jobs:
       matrix:
         os: ["ubuntu-latest"]
         python-version: ["3.7", "3.9", "3.10", "3.11"]
-        twisted-version: ["21.2", "22.1", "23.8"]
+        twisted-version: ["21.2", "22.1", "23.8", "23.10"]
         tox-prefix: ["coverage"]
         optional: [false]
         include:
@@ -225,7 +225,9 @@ jobs:
       - name: Install Python
         uses: actions/setup-python@v4
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: |
+            ${{ matrix.python-version }}
+            3.11
 
       - name: System Python Information
         uses: twisted/python-info-action@v1
@@ -264,6 +266,16 @@ jobs:
       - name: Run unit tests
         run: tox run -e ${TOX_ENV}
 
+      - name: Combine coverage
+        run: tox run -e coverage_combine,coverage_report
+        if: ${{ matrix.tox-prefix == 'coverage' }}
+
+      - name: Upload Coverage XML
+        uses: actions/upload-artifact@v3
+        with:
+          name: coverage-debug
+          path: coverage.xml
+
       - name: Upload Trial log artifact
         if: ${{ failure() }}
         uses: actions/upload-artifact@v3

MANIFEST.in

@@ -20,3 +20,4 @@ recursive-include docs *.rst
 recursive-include docs *.txt
 recursive-exclude docs/_build *
 recursive-exclude requirements *
+recursive-include src *.sql

docs/index.rst

@@ -19,6 +19,8 @@ This is an introduction to Klein, going through from creating a simple web site
 
     introduction/1-gettingstarted
     introduction/2-twistdtap
+    introduction/3-forms
+    introduction/4-auth
 
 
 Klein Examples

docs/introduction/1-gettingstarted.rst

@@ -103,6 +103,8 @@ If you run this example and then visit ``http://localhost:8080/``, you will get
 Streamlined Apps With HTML and JSON
 ===================================
 
+.. _htmljson:
+
 For a typical web application, the first order of business is generating some
 simple HTML pages that users can interact with and that search engines can
 easily index.