Issue 22812: Documentation of unittest -p usage wrong on windows.

From https://code.google.com/p/unittest-ext/issues/detail?id=13

The following is incorrect on Windows:

    python -m unittest discover -p '*.py'

It should be without the single quotes around the .py:

    python -m unittest discover -p *.py

This needs to be documented.

Why doesn't it work with the quotes?  Wouldn't it be better to make it work?  Or is it as simple as changing the example to use double quotes?

I agree. IIRC the windows shell passes the argument as "'*.py'" rather than as "*.py", so when we glob it we get no files, as no python files end with an apostrophe.

Remove quotes from quoted patterns only on windows systems (since if the quotes get parsed into the pattern field on a non-windows system, one should respect the user's command line efforts).

Test uses unittest.mock.patch to test "windows" path.

I left a comment on Rietveld.  Also, the test doesn't pass on Windows:

test test_unittest failed -- Traceback (most recent call last):
  File "C:\Data\code\CPython\hg.python.org\devinabox\cpython\lib\unittest\test\t
est_discovery.py", line 677, in test_command_line_handling_do_discovery_calls_lo
ader
    self.assertEqual(Loader.args, [('.', "'test*.py'", None)])
AssertionError: Lists differ: [('.', 'test*.py', None)] != [('.', "'test*.py'",
None)]

First differing element 0:
('.', 'test*.py', None)
('.', "'test*.py'", None)

- [('.', 'test*.py', None)]
+ [('.', "'test*.py'", None)]
?        +          +

As an aside: Pam, I got a bounce notice from the email that Rietveld tried to send you.  It claims that your email account is disabled, though I suspect that might be it's way of saying it thinks Rietveld is spam (since it tries to send in the reviewer's name).

Looking deeper at this, I think the best solution is to use '"*.py"' instead of "'*.py'" without changing the code at all.  Quoting on the Windows shell is somewhat of a nightmare (see my example on Rietveld), but using double quotes works on both Windows and Linux.

This version of the patch just updates the docs.  Since the quotes aren't really necessary for the example to work, the patch removes the single quotes from the example.  

I don't think that the python unittest documentation should explain/document the various command-line quoting rules, so let's not add un-necessary confusion.

Ah, but the quotes *are* necessary on unix.  Without the quotes, the shell will try to fill in the glob, which will either fail with an error that no files match or (worse) succeed and turn the pattern into a list of filenames.  Which is why Zach is suggesting using double quotes, which have the (same) documented result on both unix and windows, even though *why* they have the same result is slightly different on the two systems.

I should clarify that some unix shells will pass the glob through if there are no files that match, while some will generate the 'no matching files' error message.  The former is actually worse, since that means that sometimes it works without the quotes, and sometimes it doesn't.

Thanks, Zach for both the comments and the mention of the email bounce.  I changed jobs and didn't have this site listed in my "must update email address list"  (fixed now)

Should I re-update the doc patch and put in double quotes?

Here's a version of the docs with double quotes

New changeset 3256764fadae by Robert Collins in branch '2.7':
Issue #22812: Fix unittest discovery examples.
https://hg.python.org/cpython/rev/3256764fadae

New changeset e285606efb82 by Robert Collins in branch '3.4':
Issue #22812: Fix unittest discovery examples.
https://hg.python.org/cpython/rev/e285606efb82

New changeset 875a851b9d5a by Robert Collins in branch '3.5':
Issue #22812: Fix unittest discovery examples.
https://hg.python.org/cpython/rev/875a851b9d5a

New changeset d9ec88a1e5d6 by Robert Collins in branch 'default':
Issue #22812: Fix unittest discovery examples.
https://hg.python.org/cpython/rev/d9ec88a1e5d6

Thanks for the patch!

stage: needs patch -> resolved

messages: + msg241095

messages: + msg241059

nosy: + Pam.McANulty
messages: + msg240682

keywords: + patch