#30481: Document that force_str() allows lone surrogates.
--------------------------------------+------------------------------------
     Reporter:  Adam Hooper           |                    Owner:  nobody
         Type:  Cleanup/optimization  |                   Status:  new
    Component:  Documentation         |                  Version:  2.2
     Severity:  Normal                |               Resolution:
     Keywords:  force_text unicode    |             Triage Stage:  Accepted
    Has patch:  0                     |      Needs documentation:  0
  Needs tests:  0                     |  Patch needs improvement:  0
Easy pickings:  0                     |                    UI/UX:  0
--------------------------------------+------------------------------------

Comment (by Baptiste Mispelon):

 I think the original issue came up because of the confusing usage of the
 word "text" in `force_text()`
 Django used "text" in opposition to "bytes" but the reporter understood
 "text" in the context of Unicode which has a slightly different meaning.

 The original report said:
     [...] Python allows me to create _non-text_ str objects

 So I think the renaming of `force_text` to `force_str` fixed this issue by
 removing the association with the concept of "text".
 As things are now, `force_str` has the same limitations as python's `str`
 when it comes to Unicode issues like lone surrogates so I don't believe we
 need to document them.

-- 
Ticket URL: <https://code.djangoproject.com/ticket/30481#comment:7>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/068.ca3329bcfefe78dfe085ef235b38aafe%40djangoproject.com.

Reply via email to