Message 338097 - Python tracker (original) (raw)
Reading the documentation for dbm.gnu.open I noticed that there were a typo in the flags argument, it was documented as flag, in plural form.
The same typo was present for dbm.ndbm.open, but in this case, flag makes more sense than flags, since the function accepts only one option as a flag.
I opened a PR [1] fixing both typos, but I’d like to discuss if makes sense to rename the argument on dbm.ndbm.open from flags to flag. As point out by @remilapeyre, this change would be backwards compatible, since we cannot use the function with keyword arguments.
dbm.ndbm.open(filename=‘foo’, flags=‘r’, mode=438) Traceback (most recent call last): File “”, line 1, in TypeError: open() takes no keyword arguments
What do you folks think about it?