[Python-Dev] PEP 460 reboot

Ethan Furman ethan at stoneleaf.us
Tue Jan 14 19:17:12 CET 2014

On 01/14/2014 10:11 AM, Jim J. Jewett wrote:
> But in terms of explaining the text model, that
> separation is important enough that

>      (2)  It *may* be worth creating a virtual
>           split in the documentation.

I think (2) is a great idea.

> I'm willing ot work on (2) if there is general consensus
> that it would be a good idea.  As a rough sketch, I
> would change places like
>      http://docs.python.org/3/library/stdtypes.html#typebytes
> from:
>      Bytes objects are immutable sequences of single bytes.
>      Since many major binary protocols are based on the ASCII
>      text encoding, bytes objects offer several methods that
>      are only valid when working with ASCII compatible data
>      and are closely related to string objects in a variety
>      of other ways.
> to something more like:
>      Bytes objects are immutable sequences of single bytes.
>      A Bytes object could represent anything, and is
>      appropriate as the underlying storage for a sound sample
>      or image file.
>      Virtual subclass ASCIIStructuredBytes
>      ====================================
>      One particularly common use of bytes is to represent
>      the contents of a file, or of a network message.  In
>      these cases, the bytes will often represent Text
>      *in a specific encoding* and that encoding will usually
>      be a superset of ASCII.  Rather than create and support
>      an ASCIIStructuredBytes subclass, Python simply added
>      support for these use cases straight to Bytes objects,
>      and assumes that this support simply won't be used when
>      when it does not make sense. For example, bytes literals
>      *could* be used to construct a sound sample, but the
>      literals will be far easier to read when they are used
>      to represent (encoded) ASCII text, such as "OPEN".

I find the Virtual subclass in the title to be confusing, but I otherwise it's great.  We should have that even if we do 
add formatting to bytes, as that message is even more important then.


More information about the Python-Dev mailing list