Author mgedmin
Recipients docs@python, mgedmin
Date 2013-10-22.08:58:22
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1382432303.67.0.186570774383.issue19342@psf.upfronthosting.co.za>
In-reply-to
Content
This patch gives grp.getgrnam and grp.getgrgid sligtly more useful docstrings, and brings them in line with pwd.getpwnam/pwd.getpwuid.

Compare pydoc pwd.getpwnam:

    pwd.getpwnam = getpwnam(...)
        getpwnam(name) -> (pw_name,pw_passwd,pw_uid,
                            pw_gid,pw_gecos,pw_dir,pw_shell)
        Return the password database entry for the given user name.
        See help(pwd) for more on password database entries.

After looking at it I know that I can convert a name to an UID by doing pwd.getpwnam(name).pw_uid.

Meanwhile pydoc grp.getgrnam:

    grp.getgrnam = getgrnam(...)
        getgrnam(name) -> tuple
        Return the group database entry for the given group name.  If
        name is not valid, raise KeyError.

is rather unfriendly and makes me reach for Google just so that I could find out the names of the namedtuple members.
History
Date User Action Args
2013-10-22 08:58:23mgedminsetrecipients: + mgedmin, docs@python
2013-10-22 08:58:23mgedminsetmessageid: <1382432303.67.0.186570774383.issue19342@psf.upfronthosting.co.za>
2013-10-22 08:58:23mgedminlinkissue19342 messages
2013-10-22 08:58:23mgedmincreate