v/TESTS.md

2.0 KiB

Automated tests

TLDR: run v test-all locally, after making your changes, and before submitting PRs.

Notes

In the v repo there are several different tests. The main types are:

  • _test.v tests - check that test_ functions succeed. These can be run per directory or individually.
  • .out tests - run a .vv file and check the output matches the contents of the .out file with the same base name. This is particularly useful for checking that errors are printed.

Tip: use v -cc tcc when compiling tests for speed.

vlib/v/tests

General runnable tests for different features of the V compiler.

Test building of actual V programs (examples, tools, V itself)

  • v build-tools
  • v build-examples
  • v build-vbinaries

vfmt tests

In vlib/v/fmt/ there are::

  • v vlib/v/fmt/fmt_test.v

This checks .out tests.

  • v vlib/v/fmt/fmt_keep_test.v

This verifies that _keep.v files would be unchanged by vfmt -w.

  • v vlib/v/fmt/fmt_vlib_test.v

This checks all source files are formatted and prints a summary. This is not required.

Other

  • v test-fmt

Test all files in the current directory are formatted.

  • v check-md -hide-warnings .

Ensure that all .md files in the project are formatted properly, and that the V code block examples in them can be compiled/formatted too.

.github/workflows/ci.yml

This runs various CI tests, e.g.:

  • v vet vlib/v - style checker
  • v fmt -verify on certain source files

v test-cleancode

Check that most .v files, are invariant of v fmt runs.

v test-self

Run vlib module tests, including the compiler tests.

v vlib/v/compiler_errors_test.v

This runs tests for:

  • checker/tests/*.vv
  • parser/tests/*.vv

v test-all

Test and build everything. Usefull to verify locally, that the CI will most likely pass. Slowest, but most comprehensive.

It works, by running these in succession:

  • v test-cleancode
  • v test-self
  • v test-fmt
  • v build-tools
  • v build-examples
  • v check-md -hide-warnings .
  • v install nedpals.args