transfer
¶
通过SFTP和/或SCP传输文件。
-
class
fabric.transfer.
Transfer
(connection)¶ Connection
-包装类,负责管理文件上传/下载。2.0 新版功能.
-
__init__
(connection)¶ 初始化自身。请参阅帮助(键入(self))以获得准确的签名。
-
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 新版功能.
- remote (str) -- 要下载的远程文件。可以是绝对的,也可以是相对于远程工作目录的。…注意:大多数sftp服务器将远程工作目录设置为连接用户的主目录,并且(与大多数shell不同)设置为 not 展开倾斜 (
-
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 新版功能.
- local -- 要上载的文件或类似文件的对象的本地路径。 如果给定了字符串 ,它应该是本地(常规)文件(而不是目录)的路径。…注意:当处理不存在的文件路径时,正常的python文件处理问题会起作用-例如,尝试上载不存在的文件
-
__weakref__
¶ 对象的弱引用列表(如果已定义)
-
-
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
对于原始参数值。
-
orig_local
= None¶ 作为返回方法的原始值
local
争论。
-
remote
= None¶ 从下载的远程路径。彻底按摩;看
orig_remote
对于原始参数值。
-
orig_remote
= None¶ 作为返回方法的
remote
争论。
-
connection
= None¶ 这个
Connection
对象此结果是从中获得的。
-
__weakref__
¶ 对象的弱引用列表(如果已定义)
-