/g 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 Ze d e eeej fZn
# e$ r dZY nw xY wdad Z da d Z d Z d Z d Z!d"d Z"d Z#e$d!k r e# dS 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 e Zd ZdS )ErrorN__name__
__module__ __qualname__ -/opt/alt/python311/lib64/python3.11/ftplib.pyr r 9 r r c e Zd ZdS )r Nr r r r r r : r r r c e Zd ZdS )r Nr r r r r r ; r r r c e Zd ZdS )r Nr r r r r r < r r r c e Zd ZdS )r Nr r r r r r = r r r
s
c Z e Zd ZdZdZdZeZeZ dZ
dZ dZ dZ
dZddddedfddd Zd
Zd Zd4d
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%d5d Z&d5d Z'd6d!Z(d7d#Z)d5d$Z*d8d%Z+d5d&Z,d' Z-d( Z.d) Z/dg fd*Z0d+ Z1d, Z2d- Z3d. Z4d/ Z5d0 Z6d1 Z7d2 Z8d3 Z9dS )9r 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 || _ || _ || _ |r0| | |r| ||| dS dS 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 s r __init__z FTP.__init__m sl !
, / LL
/
4..... / /
/
/r c | S Nr r& s r __enter__z
FTP.__enter__} s r c | j m | n# t t f$ r Y nw xY w| j | d S d S # | j | w w xY wd S r- )sockquitOSErrorEOFErrorclose)r& argss r __exit__z FTP.__exit__ s 9
! X&
9(JJLLLLL )(49(JJLLLL )
! s! A 2A 2A A2c |dk r|| _ |dk r|| _ |dk r|| _ | j | j st d ||| _ t j d| | j | j t j | j | j f| j | j | _ | j j
| _ | j d| 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 r8 Nz0Non-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 !88 DI d??"DL < #DL # OPP P %"0D "D$)TY???,di-CT\<@