11.4 Standard Module ftplib

  

このモジュールでは、FTPクラスと関連するいくつかの項目が 定義されています。 FTPクラスは FTPプロトコルのクライアントを実装しています。 これを使うと、 他の ftpサーバのミラーをするといったような、 Pythonでさまざまな自動的な FTPジョブを実行させることができます。 このモジュールはまた、 FTPを使う URLsを取り扱うために、 urllibによって使用されることもあります。 詳しくは、インターネットのRFC 959 FTP (File Transfer Protocol)を参照してください。

サンプルセッション:

>>> from ftplib import FTP
>>> ftp = FTP('ftp.cwi.nl')   # デフォルトポート番号でホストに接続
>>> ftp.login()               # ユーザ名 anonymous, パスワード user@hostname
>>> ftp.retrlines('LIST')     # ディレクトリの内容をリスト
total 24418
drwxrwsr-x   5 ftp-usr  pdmaint     1536 Mar 20 09:48 .
dr-xr-srwt 105 ftp-usr  pdmaint     1536 Mar 21 14:32 ..
-rw-r--r--   1 ftp-usr  pdmaint     5305 Mar 20 09:48 INDEX
 .
 .
 .
>>> ftp.quit()

このモジュールでは以下が定義されています。

FTP ([host[, user[, passwd[, acct]]]])

FTPクラスの新しいインスタンスを返します。 hostが与えられると、connect(host)メソッドが呼ばれます。 userが与えられると、login(user, passwd, acct) が呼ばれます。(passwd と acctはデフォルトは空です。)

all_errors

FTPインスタンスのメソッドのすべての例外が、(タプルとして) FTP接続の問題の結果として例外を (呼ぶ側によって起きるプログラム上のエラーではなく) 発生させます。 このセットは、以下に示される socket.errとIOErrorと同じような ４つの例外を含んでいます。

error_reply

サーバから予期しない応答を受け取った。

error_temp

エラーコード 400-499を受け取った。

error_perm

エラーコード 500-599を受け取った。

error_proto

サーバから、1-5の範囲以外で始まる応答を受け取った。