This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author r.david.murray
Recipients docs@python, mouse07410, r.david.murray
Date 2015-10-28.00:52:04
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1445993524.75.0.0352164006805.issue25495@psf.upfronthosting.co.za>
In-reply-to
Content
I agree that the documentation is not optimal.  To give you some background, binascii was primarily implemented to support the email module, and the standard it is referring to is in fact the MIME standard that references base64 (I believe at the time the independent base64 standard did not exist).  The number 57 is derived from the fact that 57 * 4/3 = 76; that is, input data of length 57 will result in an encoded line that is equal to the maximum recommended line length.  Thus in encoding an email the email package (originally, it no longer does this) passed the data in in 57 byte chunks and appended the resulting lines to the output buffer.

So, this documentation is historically correct, but no longer particularly useful.  Suggested improvements are welcome.  

This state of affairs exists because the binascii module doesn't really have a current maintainer. Someday I'd love to have enough time to pick it up, since I maintain email and it is still used by email (and could be used better, with some module improvements).
History
Date User Action Args
2015-10-28 00:52:04r.david.murraysetrecipients: + r.david.murray, docs@python, mouse07410
2015-10-28 00:52:04r.david.murraysetmessageid: <1445993524.75.0.0352164006805.issue25495@psf.upfronthosting.co.za>
2015-10-28 00:52:04r.david.murraylinkissue25495 messages
2015-10-28 00:52:04r.david.murraycreate