homepage

$ echo "__author__ = u'Michele Orr\xf9'" > foo.py && python -c "import foo; print foo.__author__; help(foo)"
Michele Orrù
Traceback (most recent call last):
 File "<string>", line 1, in <module>
 File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site.py", line 467, in __call__
 return pydoc.help(*args, **kwds)
 File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/pydoc.py", line 1747, in __call__
 self.help(request)
 File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/pydoc.py", line 1794, in help
 else: doc(request, 'Help on %s:')
 File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/pydoc.py", line 1531, in doc
 pager(render_doc(thing, title, forceload))
 File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/pydoc.py", line 1526, in render_doc
 return title % desc + '\n\n' + text.document(object, name)
 File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/pydoc.py", line 329, in document
 if inspect.ismodule(object): return self.docmodule(*args)
 File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/pydoc.py", line 1126, in docmodule
 result = result + self.section('AUTHOR', str(object.__author__))
UnicodeEncodeError: 'ascii' codec can't encode character u'\xf9' in position 11: ordinal not in range(128)

I think this works if you set PYTTHONIOENCODING=utf-8 in your environment.
(2.6 does not get bugfixes anymore.)

One could argue that since print does respect the terminal encoding if sys.stdin is a tty, pydoc could be as smart and do the same. I think the problem comes from the use of a pager, which means a subprocess, which mean that the streams are not ttys and the encoding can’t be detected. print doesn’t work either with pipes: python -c "import foo; print foo.__author__" | cat
So I fear that this bug may only get a doc note.

There is a proposed patch in issue 1065986 waiting for review.