Testing Documentation Enhancement #2

New Issue

TheOnePath · 2022-09-18T12:42:08+01:00

TheOnePath commented

2022-09-18 12:42:08 +01:00

The statement in TESTING.md outlines the following:

If tox is producing errors, check that all Python interpreters are installed to the local machine, and whose path to executable is located in the Path environment variable. In the case that not all interpreters are available, it would be reasonable to ignore the errors produced by tox and ensure that tox passes for at least the installed interpreters.

The ignorance to interpreter not being found should no longer be deemed acceptable. tox allows for specific interpreters to be used during testing, which the test system supports; such that, if the test system does not support Python 2.x, specifying it as an interpreter is redundant.

Achieving interpreter-specific tox testing, the argument flag -e followed by a Python interpreter version should be the ideal practice.

Example: tox -e py39, to run only Python 3.9 testing.
Example: tox -e py36 -e py310, to run only Python 3.6 and Python 3.10 testing.

The statement in [TESTING.md](https://git.closedless/ClosedLess/clog/testing/TESTING.md) outlines the following: > If tox is producing errors, check that all Python interpreters are installed to the local machine, and whose path to executable is located in the Path environment variable. In the case that not all interpreters are available, it would be reasonable to ignore the errors produced by tox and ensure that tox passes for at least the installed interpreters. The ignorance to interpreter not being found should no longer be deemed acceptable. tox allows for specific interpreters to be used during testing, which the test system supports; such that, if the test system does not support Python 2.x, specifying it as an interpreter is redundant. Achieving interpreter-specific tox testing, the argument flag `-e` followed by a Python interpreter version should be the ideal practice. Example: `tox -e py39`, to run only Python 3.9 testing. Example: `tox -e py36 -e py310`, to run only Python 3.6 and Python 3.10 testing.

TheOnePath added the

enhancement

label 2022-09-18 12:42:08 +01:00

Sign in to join this conversation.