`transfer`¶

通过SFTP和/或SCP传输文件。

class fabric.transfer.Transfer(connection)¶

Connection -包装类，负责管理文件上传/下载。

2.0 新版功能.

get(remote, local=None, preserve_mode=True)¶

从当前连接下载文件到本地文件系统。

参数:

remote (str) -- 要下载的远程文件。可以是绝对的，也可以是相对于远程工作目录的。…注意：大多数sftp服务器将远程工作目录设置为连接用户的主目录，并且（与大多数shell不同）设置为 not 展开倾斜 (~ ）例如，而不是说 get("~/tmp/archive.tgz") 说 get("tmp/archive.tgz") .
local -- 存储下载文件或类似文件的对象的本地路径。 If None or another 'falsey'/empty value is given （默认），远程文件下载到当前工作目录（如 os.getcwd ）使用其远程文件名。 如果给定了字符串 ，它应该是指向本地目录或文件的路径，并遵循与常见的Unix实用程序或OpenSSH所看到的类似的行为。 sftp 或 scp 工具。例如，如果本地路径是一个目录，远程路径的基文件名将被添加到该目录中（因此 get('foo/bar/file.txt', '/tmp/') 会导致 /tmp/file.txt ）…注意：：当处理不存在的文件路径时，正常的python文件处理问题会起作用-例如， local 包含不存在的非叶目录的路径通常会导致 OSError . If a file-like object is given ，只需将远程文件的内容写入其中。
preserve_mode (bool) -- 是否 os.chmod 本地文件，使其与远程文件的模式匹配（默认： True ）

返回:

A Result 对象。

2.0 新版功能.

put(local, remote=None, preserve_mode=True)¶

将文件从本地文件系统上载到当前连接。

参数:

local -- 要上载的文件或类似文件的对象的本地路径。 如果给定了字符串 ，它应该是本地（常规）文件（而不是目录）的路径。…注意：当处理不存在的文件路径时，正常的python文件处理问题会起作用-例如，尝试上载不存在的文件 local 路径通常会导致 OSError . If a file-like object is given ，其内容将写入远程文件路径。
remote (str) -- 本地文件将写入的远程路径。…注意：大多数sftp服务器将远程工作目录设置为连接用户的主目录，并且（与大多数shell不同）设置为 not 展开倾斜 (~ ）例如，而不是说 put("archive.tgz", "~/tmp/") 说 put("archive.tgz", "tmp/") . 此外，这意味着“假/空值”（例如默认值， None ）允许并导致上载到远程主目录。…注：何时 local 是一个类似文件的对象， remote 是必需的，必须引用有效的文件路径（不是目录）。
preserve_mode (bool) -- 是否 chmod 远程文件，使其与本地文件的模式匹配（默认： True ）

返回:

A Result 对象。

2.0 新版功能.

class fabric.transfer.Result(local, orig_local, remote, orig_remote, connection)¶

文件传输结果信息的容器。

有关详细信息，请参见下面的各个属性/方法文档。

注解

不同于类似的类，如 invoke.runners.Result 或 fabric.runners.Result （它有一个“失败时警告并返回”的概念）这个类没有有用的真实行为。如果文件传输失败，将引发一些异常，或者 OSError 或者是来自Paramiko的错误。

2.0 新版功能.

__init__(local, orig_local, remote, orig_remote, connection)¶: 初始化自身。请参阅帮助（键入（self））以获得准确的签名。

local = None¶

文件保存为的本地路径，或者如果提供类似文件的对象，则保存为的对象。

如果字符串路径，则将该值按摩为绝对值；请参见 orig_local 对于原始参数值。

Fabric