a
i @ sL d Z ddlZddlZddlmZ g dZdZdZdZG dd d eZ G d
d d e Z
G d d
d
e Z G dd de Z G dd de Z
e eefZdZdZG dd dZz ddlZW n ey dZY n00 ejZG dd deZed e eeejfZdadd Z da dd Z d d Z d d Z d d! Z!d)d$d%Z"d&d' Z#e$d(krHe# dS )*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 @ s e Zd ZdS )ErrorN__name__
__module__ __qualname__ r r /usr/lib64/python3.9/ftplib.pyr 9 r c @ s e Zd ZdS )r Nr
r r r r r : r r c @ s e Zd ZdS )r Nr
r r r r r ; r r c @ s e Zd ZdS )r Nr
r r r r r < r r c @ s e Zd ZdS )r Nr
r r r r r = r r
s
c @ s e Zd ZdZdZdZeZeZ dZ
dZ dZ dZ
dZddddedfddd d
Zd d Zd
d Zd]ddZdd Zdd ZeZdd Zdd Zdd Zd d Zd d Zd d! Z d"d# Z d$d% Z d&d' Z d(d) Z d*d+ Z!d,d- Z"d.d/ Z#d0d1 Z$d2d3 Z%d^d4d5Z&d_d6d7Z'd`d8d9Z(dad;d<Z)dbd=d>Z*dcd?d@Z+dddAdBZ,dCdD Z-dEdF Z.dGdH Z/dg fdIdJZ0dKdL Z1dMdN Z2dOdP Z3dQdR Z4dSdT Z5dUdV Z6dWdX Z7dYdZ Z8d[d\ Z9dS )er 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 C s6 || _ || _|| _|r2| | |r2| ||| dS )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 r r r __init__m s
z FTP.__init__c C s | S Nr r r r r __enter__} s z
FTP.__enter__c G s^ | j d urZz:z | W n ttfy. Y n0 W | j d urZ| n| j d urX| 0 d S r# )sockquitOSErrorEOFErrorclose)r argsr r r __exit__ s
z FTP.__exit__c C s |dkr|| _ |dkr || _|dkr*|| _| jdurB| jsBtd|durP|| _td| | j | j tj| j | jf| j| jd| _ | j j
| _ | j j d| j
d | _| | _| jS )
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 r- Nz0Non-blocking socket (timeout=0) is not supportedzftplib.connectr rr )r portr
ValueErrorr sysauditsocketcreate_connectionr& familyafmakefiler filegetrespwelcome)r r r0 r r r r r r s$
z FTP.connectc C s | j rtd| | j | jS )z`Get the welcome message from the server.
(this is read and squirreled away by connect())z *welcome*) debuggingprintsanitizer; r$ r r r
getwelcome s zFTP.getwelcomec C s
|| _ dS )zSet the debugging level.
The required argument level means:
0: no debugging output (default)
1: print commands and responses but not body text etc.
2: also print raw lines read and sent before stripping CR/LFN)r< )r levelr r r set_debuglevel s zFTP.set_debuglevelc C s
|| _ dS )zUse passive or active mode for data transfers.
With a false argument, use the normal PORT mode,
With a true argument, use the PASV command.N)
passiveserver)r valr r r set_pasv s z FTP.set_pasvc C sJ |d d dv rBt |d}|d d d|d ||d }t|S )N > PASS zpass r *)lenrstriprepr)r sir r r r> s $z FTP.sanitizec C s` d|v sd|v rt dtd| | |t }| jdkrHtd| | | j| | j
d S )N
z4an illegal newline character should not be containedzftplib.sendcmdr z*put*) r1 r2 r3 CRLFr< r= r> r& sendallencoder r liner r r putline s
z FTP.putlinec C s$ | j rtd| | | | d S )Nz*cmd*)r< r= r> rT rR r r r putcmd s z
FTP.putcmdc C s | j | jd }t|| jkr.td| j | jdkrHtd| | |sPt|dd t krn|d d }n |dd t v r|d d }|S )Nr got more than %d bytesz*get*)
r9 readlinemaxlinerH r r< r= r> r) rO rR r r r getline s
z FTP.getlinec C s` | }|dd dkr\|d d }| }|d| }|d d |kr$|dd dkr$q\q$|S )N -rN )r[ )r rS codeZnextliner r r getmultiline s zFTP.getmultilinec C sp | }| jr td| | |d d | _|d d }|dv rD|S |dkrTt||dkrdt|t|d S )Nz*resp*r\ r > 21345)r` r< r= r> Zlastrespr r r )r respcr r r r: s z FTP.getrespc C s$ | }|dd dkr t||S )z%Expect a response beginning with '2'.Nr ra )r: r r rf r r r voidresp s z FTP.voidrespc C sT dt }| jdkr"td| | | j|t | }|dd dvrPt||S )zAbort a file transfer. Uses out-of-band data.
This does not follow the procedure from the RFC to send Telnet
IP and Synch; that doesn't seem to work with the servers I've
tried. Instead, just send the ABOR command as OOB data. ABORr z *put urgent*Nr\ Z426Z225Z226) B_CRLFr< r= r> r& rP MSG_OOBr` r r rS rf r r r abort s
z FTP.abortc C s | | | S )z'Send a command and return the response.)rU r: r cmdr r r sendcmd s
z FTP.sendcmdc C s | | | S )z8Send a command and expect a response beginning with '2'.)rU ri rp r r r voidcmd s
z FTP.voidcmdc C sB | d}t|d t|d g}|| }dd| }| |S )zUSend a PORT command with the current host and the given
port number.
. zPORT ,)splitrJ joinrs )r r r0 ZhbytesZpbytesbytesrq r r r sendport s
z FTP.sendportc C sb d}| j tjkrd}| j tjkr$d}|dkr4tddt||t|dg}dd| }| |S )zESend an EPRT command with the current host and the given port number.r r zunsupported address familyr zEPRT |)r7 r4 AF_INETAF_INET6r rJ rx rs )r r r0 r7 fieldsrq r r r sendeprt* s z FTP.sendeprtc C sl t jd| jdd}| d }| j d }| jt jkrF| ||}n | ||}| jt urh|
| j |S )z3Create a new socket and send a PORT command for it.)r r r )r6 backlogr ) r4
create_serverr7 getsocknamer& r} rz r r r
settimeout)r r& r0 r rf r r r makeport7 s
z FTP.makeportc C s\ | j tjkr:t| d\}}| jr*|}qT| j d }nt| d| j \}}||fS )z