FTP - File Transfer Protocol

 FTP - File Transfer Protocol
     FTP 实际上使用了两个 TCP 链接. 一个作为控制信道用, 主要传输一些指令和响应,
     比如 ACK 或 错误码. 另一个链接是数据信道, 用来传输文件和一些诸如目录列表的
     信息等.

     from ftplib import FTP, all_errors
     FtpServerAddr = ''
     user = ''
     PW = ''
     acct = ''

     FH = FTP(FtpServerAddr)
     FH.login(user, PW, acct) # 不带参数表示 anonymous 登入

     FH.getwelcome()  # 获取问候语
     FH.pwd()         # 获取当前工作目录
     FH.cwd()         # 更换工作目录
     FH.retrlines('cmd', 'callable')    # 以 ASCII 模式下载, 文件被一行一行的传输.
                                        # 一般 callable 是一个保存文件到本地的函数,
                                        # 省略 callable, 数据将被打印到屏幕.
                                        # cmd = 'RETR filename'
     FH.retrbinary('cmd', 'callable', 'blocksize', 'rest')
                                        # 以二进制模式下载数据
         # If optional rest is given, a REST command is sent to the server,
         # passing rest as an argument. rest is usually a byte offset into
         # the requested file, telling the server to restart sending the file’s
         # bytes at the requested offset, skipping over the initial bytes.
         # Note however that RFC 959 requires only that rest be a string containing
         # characters in the printable range from ASCII code 33 to ASCII code 126.
         # The method, therefore, converts rest to a string, but no check is performed
         # on the string’s contents. If the server does not recognize the REST command,
         # an error_reply exception will be raised. If this happens, simply call method
         # without a rest argument.

     FH.storbinary('cmd', 'FH', 'blocksize', 'callable', 'rest')
                                        # 对应 socket 的 read() 方法, 二进制模式.
                                        # cmd = 'STOR filename'
     FH.storlines('cmd', 'FH', 'callable')
                                        # 对应 socket 的 readline() 方法, ACSII 模式.
                                        # cmd = 'STOR filename'
     FH.nlst()                          # 获取路径下的条目
     FH.dir()                           # 获取路径下的条目及相信信息, ls - la / dir

     FH.delete('filename')              # 删除 filename 文件
     FH.rmd('dirname')                  # 删除 dirname 目录
     FH.mkd('dirname')                  # 建立 dirname 目录
     FH.rename('fromname', 'toname')    # 重命名
     FH.quit()        # 断开 FTP 链接

 Error Handling,
     ftplib.all_errors 包含累所有的有可能由 fitplib 产生的异常.
     可以在 try: except 代码块中通过 ftplib.all_errors 来捕捉
     处理可能发生的错误.

 Reference,
     Python doc,
         https://docs.python.org/3/library/ftplib.html