Centralize Moodle version compatibility for HTML-driven session and module flows

[Copilot]

This change introduces a compatibility layer for Moodle versions so selector- and workflow-sensitive logic is no longer scattered across scraping code. It detects the Moodle version during session bootstrap and routes fragile HTML parsing through centralized strategies with selector fallbacks.

• Compatibility layer

  • Added py_moodle.compat to centralize version parsing, compatibility context, and selector strategy selection.
  • Supports legacy (3.x) and modern (4.x+) strategy ranges, with feature probing when version detection is incomplete.

• Version detection at login/session initialization

  • Detects Moodle version as part of authentication/session setup.
  • Prefers core_webservice_get_site_info when a token is available, then falls back to dashboard HTML metadata/JS probing.
  • Attaches moodle_version and moodle_compat to the authenticated session so downstream code can use a single compatibility entry point.

• Refactored fragile flows

  • Replaced hardcoded login token and sesskey extraction with compatibility helpers.
  • Moved generic module edit-form discovery and Moodle error extraction to the compatibility layer.
  • Migrated folder-specific scraping to compatibility-managed selectors for:
    • current user fullname discovery
    • folder file listing from activity pages

• Regression coverage

  • Added focused tests for representative version-sensitive behavior:
    • version detection from webservice responses
    • version detection from dashboard HTML
    • fallback module form selection
    • fallback folder file extraction
    • fallback user-menu fullname extraction

• Documentation

  • Added a README compatibility section describing:
    • supported strategy ranges
    • how version detection works
    • where future Moodle HTML changes should be absorbed

Example of the new compatibility entry point:

from py_moodle.compat import get_session_compatibility

compat = get_session_compatibility(session)
sesskey = compat.extract_sesskey(html)
form = compat.find_modedit_form(soup)
files = compat.extract_folder_filenames(soup)

This keeps version-sensitive behavior centralized and makes future Moodle UI changes easier to adapt by updating one module instead of patching individual flows.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• example.com
  • Triggering command: /home/REDACTED/.local/bin/pytest pytest -q tests/test_compat.py (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 Send tasks to Copilot coding agent from Slack and Teams to turn conversations into code. Copilot posts an update in your thread when it's finished.