Allow docstrings given as raw unicode (ur""")

[jbeezley]

Fixes #116.

[Nurdok]

This PR looks good, but I'd like to see some tests for this.

[jbeezley]

I originally put in some tests, but ur is a syntax error in python 3, so there needs to be some mechanism for adding a test file that is only executed on python 2. Do you have any suggestions for how to do this?

[Nurdok]

@jbeezley It's possible to check if the current Python is 2.x or 3.x. I think the "Pythonic" way is to check this specific syntax for SyntaxError, like so:

try:
   eval('ur"foo"')
except SyntaxError:
    print "Python 3"
else:
    print "Python 2"

[jbeezley]

You're right, you can catch syntax errors in an eval, but I tried various iterations of it without success.

These raise missing docstring.

def raw_unicode():
    pass
raw_unicode.__doc__ = eval(r'''ur"""Test unicode \xe9 and raw \\."""''')

def raw_unicode():
    eval(r'''ur"""Test unicode \xe9 and raw \\."""''')

and you can't eval a function definition like this.

eval(r'''def raw_unicode(): ur"""Test unicode \xe9 and raw \\."""''')

You can exec a definition, but that doesn't work with your tests. I.e.

exec('def no_docstring(): pass')

doesn't raise an error.

[Nurdok]

Instead of adding a test in test.py, I suggest you do it in test_pep257.py, where you can do something like this:

def test_unicode_raw():
    if sys.version_info[0] >= 3:
        return
    with Pep257Env() as env:
        with env.open('example.py', 'wt') as example:
            example.write(textwrap.dedent("""\
                def foo():
                    ur"""docstring"""
                    pass
            """))

            # assert stuff

[jbeezley]

@Nurdok Thanks for the hint. I added a test.

[Nurdok]

@jbeezley Merged! Thank you so much!

[jquast]

Thank you @jbeezley !