[ python-Bugs-1656581 ] tarfile.TarFile fileobject use needs clarification

[SourceForge.net]

Bugs item #1656581, was opened at 2007-02-10 00:45
Message generated for change (Comment added) made by herrwitten
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1656581&group_id=5470

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: Python 2.5
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Witten (herrwitten)
Assigned to: Lars Gustäbel (gustaebel)
Summary: tarfile.TarFile fileobject use needs clarification

Initial Comment:
The constructor of a TarFile object expects an existing file object to have its file position at 0. This is not documented.

----------------------------------------------------------------------

>Comment By: Witten (herrwitten)
Date: 2007-02-11 00:35

Message:
Logged In: YES 
user_id=1595909
Originator: YES

I suppose I could make this clearer:

The user needs to know that the file object will be used from the current
file position.

----------------------------------------------------------------------

Comment By: Witten (herrwitten)
Date: 2007-02-10 00:47

Message:
Logged In: YES 
user_id=1595909
Originator: YES

A clarification: When an existing file object is used to create a TarFile
object, the TarFile object expects the existing file object to have its
file position at 0.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1656581&group_id=5470