dev/nixpkgs
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

doc/languages-frameworks/python: update the description for tests

Browse Source
This commit is contained in:
natsukium 2024-06-02 00:48:50 +09:00
parent 0a509b237a
commit 130da0dd42
No known key found for this signature in database
GPG Key ID: 9EA45A31DB994C53
1 changed files with 20 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/languages-frameworks/python.section.md
View File

@ -140,7 +140,7 @@ The `buildPythonPackage` mainly does four things:
* In the [`postFixup`](#var-stdenv-postFixup) phase, the `wrapPythonPrograms` bash function is called to * In the [`postFixup`](#var-stdenv-postFixup) phase, the `wrapPythonPrograms` bash function is called to
wrap all programs in the `$out/bin/*` directory to include `$PATH` wrap all programs in the `$out/bin/*` directory to include `$PATH`
environment variable and add dependent libraries to script's `sys.path`. environment variable and add dependent libraries to script's `sys.path`.
* In the [`installCheck`](#ssec-installCheck-phase) phase, `${python.interpreter} setup.py test` is run. * In the [`installCheck`](#ssec-installCheck-phase) phase, `${python.interpreter} -m pytest` is run.
By default tests are run because [`doCheck = true`](#var-stdenv-doCheck). Test dependencies, like By default tests are run because [`doCheck = true`](#var-stdenv-doCheck). Test dependencies, like
e.g. the test runner, should be added to [`nativeCheckInputs`](#var-stdenv-nativeCheckInputs). e.g. the test runner, should be added to [`nativeCheckInputs`](#var-stdenv-nativeCheckInputs).
@ -964,7 +964,7 @@ order to build [`datashape`](https://github.com/blaze/datashape).
, numpy, multipledispatch, python-dateutil , numpy, multipledispatch, python-dateutil
# tests # tests
, pytest , pytestCheckHook
}: }:
buildPythonPackage rec { buildPythonPackage rec {
@ -989,7 +989,7 @@ buildPythonPackage rec {
]; ];
nativeCheckInputs = [ nativeCheckInputs = [
pytest pytestCheckHook
]; ];
meta = { meta = {
@ -1002,8 +1002,8 @@ buildPythonPackage rec {
``` ```
We can see several runtime dependencies, `numpy`, `multipledispatch`, and We can see several runtime dependencies, `numpy`, `multipledispatch`, and
`python-dateutil`. Furthermore, we have [`nativeCheckInputs`](#var-stdenv-nativeCheckInputs) with `pytest`. `python-dateutil`. Furthermore, we have [`nativeCheckInputs`](#var-stdenv-nativeCheckInputs) with `pytestCheckHook`.
`pytest` is a test runner and is only used during the [`checkPhase`](#ssec-check-phase) and is `pytestCheckHook` is a test runner hook and is only used during the [`checkPhase`](#ssec-check-phase) and is
therefore not added to `dependencies`. therefore not added to `dependencies`.
In the previous case we had only dependencies on other Python packages to consider. In the previous case we had only dependencies on other Python packages to consider.
@ -1127,10 +1127,8 @@ Note also the line [`doCheck = false;`](#var-stdenv-doCheck), we explicitly disa
It is highly encouraged to have testing as part of the package build. This It is highly encouraged to have testing as part of the package build. This
helps to avoid situations where the package was able to build and install, helps to avoid situations where the package was able to build and install,
but is not usable at runtime. Currently, all packages will use the `test` but is not usable at runtime.
command provided by the setup.py (i.e. `python setup.py test`). However, Your package should provide its own [`checkPhase`](#ssec-check-phase).
this is currently deprecated https://github.com/pypa/setuptools/pull/1878
and your package should provide its own [`checkPhase`](#ssec-check-phase).
::: {.note} ::: {.note}
The [`checkPhase`](#ssec-check-phase) for python maps to the `installCheckPhase` on a The [`checkPhase`](#ssec-check-phase) for python maps to the `installCheckPhase` on a
@ -1201,9 +1199,11 @@ been removed, in this case, it's recommended to use `pytestCheckHook`.
#### Using pytestCheckHook {#using-pytestcheckhook} #### Using pytestCheckHook {#using-pytestcheckhook}
`pytestCheckHook` is a convenient hook which will substitute the setuptools `pytestCheckHook` is a convenient hook which will set up (or configure)
`test` command for a [`checkPhase`](#ssec-check-phase) which runs `pytest`. This is also beneficial a [`checkPhase`](#ssec-check-phase) to run `pytest`. This is also beneficial
when a package may need many items disabled to run the test suite. when a package may need many items disabled to run the test suite.
Most packages use `pytest` or `unittest`, which is compatible with `pytest`,
so you will most likely use `pytestCheckHook`.
Using the example above, the analogous `pytestCheckHook` usage would be: Using the example above, the analogous `pytestCheckHook` usage would be:
@ -1361,7 +1361,7 @@ work with any of the [existing hooks](#setup-hooks).
#### Using unittestCheckHook {#using-unittestcheckhook} #### Using unittestCheckHook {#using-unittestcheckhook}
`unittestCheckHook` is a hook which will substitute the setuptools `test` command for a [`checkPhase`](#ssec-check-phase) which runs `python -m unittest discover`: `unittestCheckHook` is a hook which will set up (or configure) a [`checkPhase`](#ssec-check-phase) to run `python -m unittest discover`:
```nix ```nix
{ {
@ -1375,6 +1375,8 @@ work with any of the [existing hooks](#setup-hooks).
} }
``` ```
`pytest` is compatible with `unittest`, so in most cases you can use `pytestCheckHook` instead.
#### Using sphinxHook {#using-sphinxhook} #### Using sphinxHook {#using-sphinxhook}
The `sphinxHook` is a helpful tool to build documentation and manpages The `sphinxHook` is a helpful tool to build documentation and manpages
@ -1929,16 +1931,15 @@ Both are also exported in `nix-shell`.
It is recommended to test packages as part of the build process. It is recommended to test packages as part of the build process.
Source distributions (`sdist`) often include test files, but not always. Source distributions (`sdist`) often include test files, but not always.
By default the command `python setup.py test` is run as part of the The best practice today is to pass a test hook (e.g. pytestCheckHook, unittestCheckHook) into nativeCheckInputs.
[`checkPhase`](#ssec-check-phase), but often it is necessary to pass a custom [`checkPhase`](#ssec-check-phase). An This will reconfigure the checkPhase to make use of that particular test framework.
example of such a situation is when `py.test` is used. Occasionally packages don't make use of a common test framework, which may then require a custom checkPhase.
#### Common issues {#common-issues} #### Common issues {#common-issues}
* Non-working tests can often be deselected. By default [`buildPythonPackage`](#buildpythonpackage-function) * Non-working tests can often be deselected. Most Python modules
runs `python setup.py test`. which is deprecated. Most Python modules however do follow the standard test protocol where the pytest runner can be used.
do follow the standard test protocol where the pytest runner can be used `pytest` supports the `-k` and `--ignore` parameters to ignore test
instead. `pytest` supports the `-k` and `--ignore` parameters to ignore test
methods or classes as well as whole files. For `pytestCheckHook` these are methods or classes as well as whole files. For `pytestCheckHook` these are
conveniently exposed as `disabledTests` and `disabledTestPaths` respectively. conveniently exposed as `disabledTests` and `disabledTestPaths` respectively.