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.

classification
Title: time.struct_time undocumented
Type: Stage:
Components: Extension Modules Versions: Python 2.3
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: fdrake Nosy List: barry, brett.cannon, fdrake
Priority: normal Keywords:

Created on 2002-09-03 18:49 by barry, last changed 2022-04-10 16:05 by admin. This issue is now closed.

Messages (4)
msg12251 - (view) Author: Barry A. Warsaw (barry) * (Python committer) Date: 2002-09-03 18:49
The time module has a mystery name <wink> called
"struct_time" which is undocumented.  It is used in a
couple of places such as imaplib.py, test_structseq.py
and test_strptime.py.  It should be documented.
msg12252 - (view) Author: Barry A. Warsaw (barry) * (Python committer) Date: 2002-09-04 01:57
Logged In: YES 
user_id=12800

It should also be renamed to be something like TimeStructType.
msg12253 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2002-11-02 19:47
Logged In: YES 
user_id=357491

If an agreement can be reached on what it should be renamed to (I 
thought we had agreed on a name already?  I, of course, don't have the 
email to prove this, though), I am willing to help grep Lib/ and generate 
patches to replace the calls with the new name (and I will even use 
unified diffs this time! =).

Personally, I think TimeStructType is fine, but we must make sure that 
it won't be mistaken for the forthcoming datetime type.  I would wager 
that the datetime type would have something named DateTimeType if 
there is going to be a name that might conflict.

I am also willing to write the blurb to document this sucker.
msg12254 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2002-11-13 19:06
Logged In: YES 
user_id=3066

We'll skip renaming the type for now, since there's no
consistency regarding the names of the "structured sequence"
types.  Since the type was already named and released in the
2.2.x series, we can't really get rid of the old name anyway.

I've updated the documentation to reflect the addition of
the struct_time type and the attribute names for fields in
Doc/lib/libtime.tex revisions 1.51 and 1.48.6.2.
History
Date User Action Args
2022-04-10 16:05:38adminsetgithub: 37128
2002-09-03 18:49:34barrycreate