Skip to content

Commit ab7c84b

Browse files
obestwaltergaborbernat
authored andcommitted
add a warning to avoid confusion about command line tools from parent (#1128)
Addresses confusion apparent in #461.
1 parent 43e3432 commit ab7c84b

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

docs/config.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -403,6 +403,21 @@ Complete list of settings that you can put into ``testenv*`` sections:
403403
Set to ``true`` if you want to create virtual environments that also
404404
have access to globally installed packages.
405405

406+
.. warning::
407+
408+
In cases where a command line tool is also installed globally you have
409+
to make sure that you use the tool installed in the virtualenv by using
410+
``python -m <command line tool>`` (if supported by the tool) or
411+
``{envbindir}/<command line tool>``.
412+
413+
If you forget to do that you will get a warning like this::
414+
415+
WARNING: test command found but not installed in testenv
416+
cmd: /path/to/parent/interpreter/bin/<some command>
417+
env: /foo/bar/.tox/python
418+
Maybe you forgot to specify a dependency? See also the whitelist_externals envconfig setting.
419+
420+
406421
.. conf:: alwayscopy ^ true|false ^ false
407422

408423
Set to ``true`` if you want virtualenv to always copy files rather than

0 commit comments

Comments
 (0)