test0908
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Specified 'csv and unicode' note as Python 2 only

This commit is contained in:
Claude Paroz 2014-04-26 16:09:19 +02:00
parent 680a0f08b1
commit 2128b3a688
1 changed files with 13 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/howto/outputting-csv.txt
View File

@ -54,26 +54,25 @@ mention:
about escaping strings with quotes or commas in them. Just pass about escaping strings with quotes or commas in them. Just pass
``writerow()`` your raw strings, and it'll do the right thing. ``writerow()`` your raw strings, and it'll do the right thing.
Handling Unicode .. admonition:: Handling Unicode on Python 2
~~~~~~~~~~~~~~~~
Python's :mod:`csv` module does not support Unicode input. Since Django uses Python 2's :mod:`csv` module does not support Unicode input. Since Django
Unicode internally this means strings read from sources such as uses Unicode internally this means strings read from sources such as
:class:`~django.http.HttpRequest` are potentially problematic. There are a few :class:`~django.http.HttpRequest` are potentially problematic. There are a
options for handling this: few options for handling this:
* Manually encode all Unicode objects to a compatible encoding. * Manually encode all Unicode objects to a compatible encoding.
* Use the ``UnicodeWriter`` class provided in the `csv module's examples * Use the ``UnicodeWriter`` class provided in the `csv module's examples
section`_. section`_.
* Use the `python-unicodecsv module`_, which aims to be a drop-in * Use the `python-unicodecsv module`_, which aims to be a drop-in
replacement for :mod:`csv` that gracefully handles Unicode. replacement for :mod:`csv` that gracefully handles Unicode.
For more information, see the Python documentation of the :mod:`csv` module. For more information, see the Python documentation of the :mod:`csv` module.
.. _`csv module's examples section`: http://docs.python.org/library/csv.html#examples .. _`csv module's examples section`: http://docs.python.org/2/library/csv.html#examples
.. _`python-unicodecsv module`: https://github.com/jdunck/python-unicodecsv .. _`python-unicodecsv module`: https://github.com/jdunck/python-unicodecsv
.. _streaming-csv-files: .. _streaming-csv-files: