[GRASS-git] [OSGeo/grass] fd71b0: contributing: Add a testing guide (#7851)

[Vaclav Petras]

  Branch: refs/heads/main
  Home:   https://github.com/OSGeo/grass
  Commit: fd71b0267cd563c719f117c54f56353a5bff74e5
      https://github.com/OSGeo/grass/commit/fd71b0267cd563c719f117c54f56353a5bff74e5
  Author: Vaclav Petras <wenzeslaus at gmail.com>
  Date:   2026-08-27 (Thu, 27 Aug 2026)

  Changed paths:
    M AGENTS.md
    M CONTRIBUTING.md
    M doc/development/CMakeLists.txt
    M doc/development/Makefile
    M doc/development/README.md
    M doc/development/style_guide.md
    A doc/development/testing.md
    M man/mkdocs/docs/development_intro.md
    M testsuite/README.md

  Log Message:
  -----------
  contributing: Add a testing guide (#7851)

The most complete statement of GRASS testing conventions lived in AGENTS.md, written for AI agents, and a contributor following the documented path never saw it. style_guide.md had no testing section, testsuite/README.md gave pytest a single sentence, and the Testing section in development_intro.md linked only the gunittest manual.

This adds testing.md covering the choice between pytest and gunittest, test placement and naming, session fixtures, grass.tools, test data, running the tests, and tests which cannot run in parallel. AGENTS.md now points at the guide and keeps only its agent-specific notes, so the two cannot drift too much.

Trim the testsuite README to minimum. testsuite/README.md described which testing frameworks exist and how to run pytest, which testing.md now covers, and the export commands in its Running tests section had stray backslashes which made them set literal strings when copied. The directory still needs a README since it is a top level and has unclear content (a shell script). This keeps what the directory is for and the pointer to the CI, names raster_md5test.sh, and links testing.md for everything else. The North Carolina sample dataset URL moves to testing.md, next to the command which uses the dataset.



To unsubscribe from these emails, change your notification settings at https://github.com/OSGeo/grass/settings/notifications