homepage

Hi there,
I'm sure I reported this before, but it's a couple of
major releases later, and there's still no usage docs
for urllib2.
The examples given are too trivial to be helpful, but
I'm guessing people are using the module so there must
be some examples out there somewhere ;-)
With a bit o fhelp from Moshez, I found the docstring
in the module source. At the very least, it'd be handy
if that appeared somewhere at:
http://docs.python.org/lib/module-urllib2.html
But really, mroe extensive and helpful documentation on
this cool new module would be very handy.
Chris

Logged In: YES 
user_id=21627
Are you willing to provide examples?

Logged In: YES 
user_id=24723
I'm certainly willing, but I am totally incapable :-S
The reason I opened this issue is because it would seem that
urllib2 is better the urllib, but seems to be severely
underdocumented, and hence I don't understand how to use it
and so can't provide examples.
As I said in the original submission, including the module's
docstring in the Python module documentation would be a
start, but doesn't cover what appears to be the full
potential of a great module...

Logged In: YES 
user_id=261020
Examples for urllib2 were added some time ago, so I suggest
this bug is closed.

Logged In: YES 
user_id=24723
Where are these examples you're referring to?
I don't see any at:
http://docs.python.org/lib/module-urllib2.html
I've already commented that the existing ones in the
docstring would be a start but still don't really much help
in taking full advantage of this module.

Logged In: YES 
user_id=261020
They are here: http://docs.python.org/lib/urllib2-examples.html 

Logged In: YES 
user_id=24723
I still feel there could be more.
I guess the best course, for me, would be to leave this open
but at a really low priority.
However, I probably wouldn't scream too much if the issue
was closed.

Logged In: YES 
user_id=261020
Do you have any specific suggestions for what is unhelpful
and/or missing?
Otherwise, nothing is likely to change.
Note that a little was added at the bottom of this page in
2.4, explaining how OpenerDirector uses the handlers to open
URLs:
http://docs.python.org/lib/opener-director-objects.html
Looking at the top-level page, I guess an introduction /
overview would help? Did you have other stuff in mind too?

Logged In: YES 
user_id=849994
Chris, I concur with jjlee that suggesting examples is the
best way to get something done. Perhaps, if you're using
urllib2, you could flesh out some examples from your code?

Logged In: YES 
user_id=1312539
This Tracker item was closed automatically by the system. It was
previously set to a Pending status, and the original submitter
did not respond within 14 days (the time period specified by
the administrator of this Tracker).

Logged In: YES 
user_id=24723
wtf?

Logged In: YES 
user_id=21627
fresh, you haven't responded to jjlee's questions from
2006年04月17日 16:26, so it is unclear what precisely it is that
you want. In absence of a specific problem description, I'm
closing this as "works for me".

Logged In: YES 
user_id=261020
Is this helpful, Chris?
http://svn.python.org/view/python/trunk/Doc/howto/urllib2.rst?view=markup