{|j d Z ddlZddlZddlmZ g dZdZdZdZ G d d e Z G d
d e Z
G d d
e Z G d de Z G d de Z
e eefZdZdZ G d d Z ddlZej* Z G d de Zej1 d e eeej2 fZdad Z da d Z d Z d Z d Z!d d Z"d Z#e$d k( r e# yy# e$ r dZY 1w xY w)!aS An FTP client class and some helper functions.
Based on RFC 959: File Transfer Protocol (FTP), by J. Postel and J. Reynolds
Example:
>>> from ftplib import FTP
>>> ftp = FTP('ftp.python.org') # connect to host, default port
>>> ftp.login() # default, i.e.: user anonymous, passwd anonymous@
'230 Guest login ok, access restrictions apply.'
>>> ftp.retrlines('LIST') # list directory contents
total 9
drwxr-xr-x 8 root wheel 1024 Jan 3 1994 .
drwxr-xr-x 8 root wheel 1024 Jan 3 1994 ..
drwxr-xr-x 2 root wheel 1024 Jan 3 1994 bin
drwxr-xr-x 2 root wheel 1024 Jan 3 1994 etc
d-wxrwxr-x 2 ftp wheel 1024 Sep 5 13:43 incoming
drwxr-xr-x 2 root wheel 1024 Nov 17 1993 lib
drwxr-xr-x 6 1094 wheel 1024 Sep 13 19:07 pub
drwxr-xr-x 3 root wheel 1024 Jan 3 1994 usr
-rw-r--r-- 1 root root 312 Aug 1 1994 welcome.msg
'226 Transfer complete.'
>>> ftp.quit()
'221 Goodbye.'
>>>
A nice test that reveals some of the network dialogue would be:
python ftplib.py -d localhost -l -p -l
N)_GLOBAL_DEFAULT_TIMEOUT)FTP error_reply
error_temp
error_perm error_proto
all_errors c e Zd Zy)ErrorN__name__
__module__ __qualname__ /usr/lib64/python3.12/ftplib.pyr r 9 r r c e Zd Zy)r Nr r r r r r : r r r c e Zd Zy)r Nr r r r r r ; r r r c e Zd Zy)r Nr r r r r r < r r r c e Zd Zy)r Nr r r r r r = r r r
s
c X e Zd ZdZdZdZeZeZ dZ
dZ dZ dZ
dZddddedfddd Zd
Zd Zd2d Zd
Zd ZeZd Zd Zd Zd Zd Zd Z d Z d Z d Z d Z d Z!d Z"d Z#d Z$d Z%d3d Z&d3d Z'd4d Z(d5d!Z)d3d"Z*d6d#Z+d3d$Z,d% Z-d& Z.d' Z/dg fd(Z0d) Z1d* Z2d+ Z3d, Z4d- Z5d. Z6d/ Z7d0 Z8d1 Z9y)7r u An FTP client class.
To create a connection, call the class using these arguments:
host, user, passwd, acct, timeout, source_address, encoding
The first four arguments are all strings, and have default value ''.
The parameter ´timeout´ must be numeric and defaults to None if not
passed, meaning that no timeout will be set on any ftp socket(s).
If a timeout is passed, then this is now the default timeout for all ftp
socket operations for this instance.
The last parameter is the encoding of filenames, which defaults to utf-8.
Then use self.connect() with optional host and port argument.
To download a file, use ftp.retrlines('RETR ' + filename),
or ftp.retrbinary() with slightly different arguments.
To upload a file, use ftp.storlines() or ftp.storbinary(),
which have an open file as argument (see their definitions
below for details).
The download/upload functions first issue appropriate TYPE
and PORT or PASV commands.
r NTFutf-8encodingc || _ || _ || _ |r(| j | |r| j ||| yyy)zInitialization method (called by class instantiation).
Initialize host to localhost, port to standard ftp port.
Optional arguments are host (for connect()),
and user, passwd, acct (for login()).
N)r source_addresstimeoutconnectlogin)selfhostuserpasswdacctr# r" r s r __init__z FTP.__init__m sF !
, LL
4. r c | S Nr r& s r __enter__z
FTP.__enter__} s r c | j / | j | j | j y y y # t t f$ r Y 0w xY w# | j | j w w xY wr- )sockquitOSErrorEOFErrorclose)r& argss r __exit__z FTP.__exit__ sm 99
! 99(JJL )
! X&
99(JJL )s! = A A AA A1c X |dk7 r|| _ |dkD r|| _ |dk7 r|| _ | j | j s t d ||| _ t j d| | j | j t j | j | j f| j | j | _ | j j | _ | j j d| j | _ | j | _ | j S ) aw Connect to host. Arguments are:
- host: hostname to connect to (string, default previous host)
- port: port to connect to (integer, default previous port)
- timeout: the timeout to set against the ftp socket(s)
- source_address: a 2-tuple (host, port) for the socket to bind
to as its source address before connecting.
r r z0Non-blocking socket (timeout=0) is not supportedzftplib.connectr" rr )r' portr#
ValueErrorr" sysauditsocketcreate_connectionr1 familyafmakefiler filegetrespwelcome)r& r' r< r# r" s r r$ z FTP.connect s 2: DI !8 DI d?"DL << #DLL OP P %"0D "D$))TYY?,,dii-CT\\<@