GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing github.com — Documented parameter names of some email.utils functions don't match the implementation · Issue #161816 · python/cpython

Documented parameter names of some email.utils functions don't match the implementation #161816

New issue

Copy link

New issue

Copy link

Open

Documented parameter names of some email.utils functions don't match the implementation#161816

Copy link

Description

thejesh23

opened

on Nov 11, 2026

Issue body actions

Documentation

A few functions in the email.utils docs show a parameter name that differs from the real one. Anyone copying the name from the docs gets a TypeError:

>>> from email.utils import parsedate
>>> parsedate(date='Mon, 20 Nov 1995 19:12:08 -0500')
TypeError: parsedate() got an unexpected keyword argument 'date'. Did you mean 'data'?
>>> parsedate(data='Mon, 20 Nov 1995 19:12:08 -0500')
(1995, 11, 20, 19, 12, 8, 0, 1, -1)

Function	Docs	Code
`parseaddr()`	`address`	`addr`
`parsedate()`, `parsedate_tz()`, `parsedate_to_datetime()`	`date`	`data`
`mktime_tz()`	`tuple`	`data`

Linked PRs

gh-161816: Fix documented parameter names in email.utils #161818

Activity

Metadata

Assignees

No one assigned

Labels

No labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.