ftptool 0.7.1

更改工作目录

更改和获取当前目录是通过一个名为 current_directory 的属性实现的。它是懒加载的；它不会在询问之前询问服务器当前目录是什么。

请注意，由于它是一个属性，这实际上会向上提升一级

>>> a_host.current_directory = ".."

同样，这将进入“foo”目录

>>> a_host.current_directory = "foo"

在大多数情况下，直接指定绝对路径更容易

>>> a_host.current_directory = "/foo"

当前目录（current_directory）始终是服务器端表示；当你更改目录时，它最终会发送一个 CWD 然后一个 PWD 来获取操作的结果（因为 FTP 协议没有定义对 CWD 的回复文本。）

列出和遍历目录树

实现了 os.walk 接口来遍历目录树

>>> for (dirname, subdirs, files) in a_host.walk("/a_dir"):
...     print dirname, "has file(s)", ", ".join(files)
...
/a_dir has file(s) foo, bar
/a_dir/other_dir has file(s) hello
/a_dir/some_dir has file(s)

就像 os.walk 一样，你可以从 subdirs 列表中删除条目以避免进入它们

>>> for (dirname, subdirs, files) in a_host.walk("/a_dir"):
...     for subdir in subdirs:
...         if subdir.startswith("other_"):
...             subdirs.remove(subdir)
...     print dirname, "has file(s)", ", ".join(files)
...
/a_dir has file(s) foo, bar
/a_dir/some_dir has file(s)

你可以使用 listdir 非递归地列出目录

>>> a_host.listdir("/a_dir")
(['other_dir', 'some_dir'], ['foo', 'bar'])

创建、删除和重命名

创建目录最简单的形式是 mkdir。你只需给它一个要创建的目录，然后它就会这样做

>>> a_host.mkdir("/new_dir")

如果你只想确认目录已准备好，即存在以供上传，可以使用 makedirs，它会逐部分尝试创建目录的每个部分。

>>> a_host.makedirs("/a_dir/some_dir/a_new_dir/other_new_dir")

假设会创建 a_new_dir 和 other_new_dir。

ftptool 通过首先尝试更改到给定路径的目录，以查看其是否存在，然后更改回来来实现它。如果存在，它就简单地返回，否则逐部分创建目录。

三种上传和下载方法

ftptool 提供了三种上传或下载文件的方法：* 从/to_str：使用一个 str 对象，* 从/to_file：使用一个文件名，* 以及默认方式：使用文件-like 对象。

给定

>>> f = a_host.file_proxy("/foo.txt")

你可以使用这两个来上传和下载 str

>>> f.upload_from_str("Hi!")
>>> f.download_to_str()
'Hi!'

并且使用这样的文件名

>>> f.upload_from_file("/etc/motd")
>>> f.download_to_file("/tmp/motd")

最后，使用文件-like 对象

>>> f.upload(StringIO("Test!"))
>>> fp = StringIO()
>>> f.download(fp)
>>> fp.getvalue()
'Test!'

重命名文件

重命名是文件代理的方法，称为 rename。它返回一个新文件代理，用于重命名后的文件，所以常见的模式将是

>>> a_file = a_host.file_proxy("hello_world")
>>> a_file = a_file.rename("foobar")

这将发出重命名命令，所以 a_file 将实质上与之前相同，但有新的名称和新实例 ID。

删除文件

删除文件与重命名类似：它是文件代理的方法，称为 delete。然而，它没有有意义的返回值。

>>> a_file.delete()