the Chromium logo

The Chromium Projects

GRIT Regression Test Plan

Multiple projects use GRIT. This document details the regression testing plan employed by the GRIT project to ensure compatibility with all of the projects using it.

The plan is fairly straight forward:

  1. Each change must pass grit.py unit with no errors before being checked in. Ideally, the command should be tested on both Linux and Windows, since some behavior may break on case-insensitive platforms and other behavior may break on case-sensitive platforms, or may break due to different path separator characters.
  2. Projects using GRIT should proactively contribute unit tests and regression tests that will be run as part of grit.py unit to ensure any functionality they require does not get modified by accident.
  3. When a project reports that a new version of GRIT has broken functionality for that project, the GRIT team and folks on the project should work together to get a regression test added.

Individual projects, of course, may put in place extensive tests in their own repository that further help to ensure that a new revision of GRIT does not break them. For example, when the revision of GRIT used is changed in the Chromium project, the change would normally pass through that project's try servers or commit queue which would help catch any new behavior of GRIT breaking the project's test suite.