[Python-checkins] python/dist/src/Doc/lib liburllib.tex,1.52,1.53

Tue Jul 13 02:48:44 CEST 2004

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv26039/Doc/lib
Modified Files:
	liburllib.tex 
Log Message:
Add another point in the "Restrictions" section about how the handling of FTP
URLs will seemingly succeed to read a URL that points to a file whose
permissions you do not have to read.
Backport candidate once everyone agrees with the wording.
Index: liburllib.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/liburllib.tex,v
retrieving revision 1.52
retrieving revision 1.53
diff -C2 -d -r1.52 -r1.53
*** liburllib.tex	25 Mar 2004 16:51:12 -0000	1.52
--- liburllib.tex	13 Jul 2004 00:48:42 -0000	1.53
***************
*** 330,333 ****
--- 330,350 ----
 
 \item
+ The code handling the FTP\index{FTP} protocol cannot differentiate between a
+ file and a directory and can lead to unexpected behavior when attempting to
+ read a URL that points to a file that is not accessible.
+ If the URL ends in a \code{/} then it is assumed to be a
+ directory and will be handled as such only. But if an attempt to read a file
+ leads to a 550 error (signaling the URL cannot be found or is not accessible,
+ often for permission reasons), then the path is treated as a directory in order
+ to handle the case of when a directory is specified by a URL but a trailing
+ \code{/} is left off.
+ This can lead to the apparent successful fetching of a file whose read
+ permissions you do not have by still succeeding by returning the directory
+ listing for the file from treating it as a directory.
+ If more fine-grained control is needed, consider using the \module{ftplib}
+ module, subclassing \class{FancyURLOpener}, or changing \var{_urlopener} to
+ meet your needs.
+ 
+ \item
 This module does not support the use of proxies which require
 authentication. This may be implemented in the future.