Support uv and fix defects that previously caused program to crash

.env.example

@@ -0,0 +1,5 @@
+# Cellveyor environment file — copy to .env and set your token
+# .env is gitignored; never commit real tokens. Run: chmod 600 .env
+# Generate a fine-grained PAT scoped to your org with contents:write + pull-requests:write, 7-day expiry
+CELLVEYOR_GITHUB_TOKEN=ghp_your_token_here
+# Alternative alias (also supported): GITHUB_TOKEN=ghp_your_token_here

.github/workflows/build.yml

@@ -11,80 +11,70 @@ env:
 # Focuses on the master branch only
 on:
   push:
-    branches: [ master ]
+    branches: [master]
   pull_request:
-    branches: [ master ]
+    branches: [master]
 
 # Create one single job
 # This job performs all of the necessary checks
 jobs:
   build:
     # Use the latest version of Ubuntu, MacOS, and Windows
-    # Use the latest and most stable version of Python
-    # Important: test coverage monitoring and reporting
-    # through a badge and the GitHub Actions job summary
-    # only takes place with the Linux operating system.
-    # Important: the MacOS and Windows operating systems
-    # have test coverage calculation take place but they
-    # do not report the test coverage beyond its display
-    # inside of the GitHub Actions panel for that job.
+    # Use the most recent stable Python versions in the supported range
+    # Important: the coverage threshold is enforced on the Linux runner;
+    # the MacOS and Windows runners run linting, type checking, and tests
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest]
-        python-version: ["3.11"]
-        include:
-          - os: macos-latest
-            python-version: "3.11"
-          - os: windows-latest
-            python-version: "3.11"
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
     # Define the workflow steps
     steps:
-    # Checkout the code of the repository
-        - name: Check out Repository Code
-          uses: actions/checkout@v3
-          with:
-            fetch-depth: 0
-        # Run the mdl linting tool
-        # Refers to .mdlrc file in repository
-        - name: Run Markdown Linting
-          if: matrix.os == 'ubuntu-latest'
-          uses: actionshub/markdownlint@main
-        # Setup Python for the current language version
-        - name: Setup Python ${{ matrix.python-version }}
-          if: always()
-          uses: actions/setup-python@v4
-          with:
-            python-version: ${{ matrix.python-version }}
-        # Install pip
-        - name: Install Pip
-          if: always()
-          run: |
-            python -m pip install --upgrade pip
-        # Install poetry
-        - name: Install Poetry
-          if: always()
-          uses: abatilo/actions-poetry@v2.0.0
-          with:
-            poetry-version: 1.4.0
-        # Install dependencies
-        - name: Install dependencies
-          if: always()
-          run: |
-            poetry install
-        # Run the linters
-        - name: Run Linters
-          if: always()
-          run: |
-            poetry run task lint
-        # Run the program
-        - name: Run program
-          if: always()
-          run: |
-            poetry run cellveyor --spreadsheet-directory $PWD/spreadsheets/ --spreadsheet-file $PWD/spreadsheets/fake_spreadsheet.xlsx/ --sheet-name Main --key-attribute "Student GitHub" --key-value "gkapfham" --column-regexp '^(Summary Grade|Final Grade) .*$' --feedback-regexp "Summary Grade 1 - Feedback" --feedback-file $PWD/spreadsheets/feedback.yml/ 
-        # Run the tests
-        - name: Run Tests
-          if: always()
-          run: |
-            poetry run task test
+      # Checkout the code of the repository
+      - name: Check out Repository Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      # Setup Python for the current language version
+      - name: Setup Python ${{ matrix.python-version }}
+        if: always()
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      # Install uv
+      - name: Install uv
+        if: always()
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      # Install dependencies
+      - name: Install dependencies
+        if: always()
+        run: |
+          uv sync --group dev
+      # Run the linters (including the rumdl markdown linter)
+      - name: Run Linters
+        if: always()
+        run: |
+          uv run task lint
+      # Run the type checkers
+      - name: Run Type Checks
+        if: always()
+        run: |
+          uv run task typecheck
+      # Run the program
+      - name: Run program
+        if: always()
+        run: |
+          uv run cellveyor --spreadsheet-directory $PWD/spreadsheets/ --spreadsheet-file $PWD/spreadsheets/fake_spreadsheet.xlsx --sheet-name Main --key-attribute "Student GitHub" --key-value "gkapfham" --column-regexp '^(Summary Grade|Final Grade) .*$' --feedback-regexp "Summary Grade 1 - Feedback" --feedback-file $PWD/spreadsheets/feedback.yml
+      # Run the tests
+      - name: Run Tests
+        if: always()
+        run: |
+          uv run task test
+      # Enforce the coverage threshold (Linux only)
+      - name: Run Coverage Check
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          uv run task test-coverage

.gitignore

@@ -375,3 +375,10 @@ credentials.json
 
 # poetry.toml file
 poetry.toml
+
+# Workflow file
+WORKFLOW.md
+
+# Coverage files
+tsc.json
+cosmic-ray.toml

.rumdl.toml

@@ -0,0 +1,69 @@
+# rumdl configuration file
+
+# Inherit settings from another config file (relative to this file's directory)
+# extends = "../base.rumdl.toml"
+
+# Global configuration options
+[global]
+# List of rules to disable (uncomment and modify as needed)
+disable = ["MD013", "MD033", "MD041"]
+
+# List of rules to enable exclusively (replaces defaults; only these rules will run)
+# enable = ["MD001", "MD003", "MD004"]
+
+# Additional rules to enable on top of defaults (additive, does not replace)
+# Use this to activate opt-in rules like MD060, MD063, MD072, MD073, MD074
+# extend-enable = ["MD060", "MD063"]
+
+# Additional rules to disable on top of the disable list (additive)
+# extend-disable = ["MD041"]
+
+# List of file/directory patterns to include for linting (if provided, only these will be linted)
+# include = [
+#    "docs/*.md",
+#    "src/**/*.md",
+#    "README.md"
+# ]
+
+# List of file/directory patterns to exclude from linting
+exclude = [
+    # Common directories to exclude
+    ".git",
+    ".github",
+    "node_modules",
+    "vendor",
+    "dist",
+    "build",
+
+    # Specific files or patterns
+    "CHANGELOG.md",
+    "LICENSE.md",
+]
+
+# Respect .gitignore files when scanning directories (default: true)
+respect-gitignore = true
+
+# Markdown flavor/dialect (uncomment to enable)
+# Options: standard (default), gfm, commonmark, mkdocs, mdx, pandoc, quarto, obsidian, kramdown, azure_devops
+# flavor = "mkdocs"
+
+# Rule-specific configurations (uncomment and modify as needed)
+
+# [MD003]
+# style = "atx"  # Heading style (atx, atx_closed, setext)
+
+# [MD004]
+# style = "asterisk"  # Unordered list style (asterisk, plus, dash, consistent)
+
+# [MD007]
+# indent = 4  # Unordered list indentation
+
+# [MD013]
+# line-length = 100  # Line length
+# code-blocks = false  # Exclude code blocks from line length check
+# tables = false  # Exclude tables from line length check
+# headings = true  # Include headings in line length check
+
+# [MD044]
+# names = ["rumdl", "Markdown", "GitHub"]  # Proper names that should be capitalized correctly
+# code-blocks = false  # Check code blocks for proper names (default: false, skips code blocks)