New submission from hello world <qp3...@gmail.com>:

According to the documentation of base64 
(https://docs.python.org/3/library/base64.html),

> Optional altchars must be a bytes-like object of at least length 2 
> (additional characters are ignored) which specifies an alternative alphabet 
> for the + and / characters.

but this explanation is out-dated.

Actually this had been correct until the commit 
`4581ae5fa2450db3f00384e4b2e86654605100d4` was made for cpython in "2007".
(Thus, the explanation has been incorrect for about 15 years.)

The current implementation requires the length of `altchars` to be exactly two, 
as explicitly written in the comment:

> Optional altchars should be a byte string of length 2 which specifies an 
> alternative alphabet for the '+' and '/' characters.

and the corresponding assertion is:

> assert len(altchars) == 2, repr(altchars)

----------
assignee: docs@python
components: Documentation
messages: 411967
nosy: docs@python, qp3839
priority: normal
severity: normal
status: open
title: base64 documentation is out-dated; altchars has to have the exact length 
of 2.
versions: Python 3.10

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue46559>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to