�
�|�g� � �p � S SK Jr S SKrS SKrS SKrS SKrS SKrS SKrS SKJ r S SK
J r S SK J
r
S SKJrJrJr S SKJrJrJrJrJrJrJrJrJrJ r J r J r J r J r J!r!J"r"J#r#J$r$J%r%J&r&J'r'J(r(J)r)J*r*J+r+J,r,J-r-J.r.J/r/J0r0J1r1J2r2 S SK3J4r4 S S K5J6r6 S S
K7J8r8 S S K9J:r:J;r;J<r< S r=S
r> " S S\\:5 r? " S S\?5 r@g)� )�hexlifyN)�util)�Channel)�Message)�INFO�DEBUG�o777) �BaseSFTP� CMD_OPENDIR�
CMD_HANDLE� SFTPError� CMD_READDIR�CMD_NAME� CMD_CLOSE�SFTP_FLAG_READ�SFTP_FLAG_WRITE�SFTP_FLAG_CREATE�SFTP_FLAG_TRUNC�SFTP_FLAG_APPEND�SFTP_FLAG_EXCL�CMD_OPEN�
CMD_REMOVE�
CMD_RENAME� CMD_MKDIR� CMD_RMDIR�CMD_STAT� CMD_ATTRS� CMD_LSTAT� CMD_SYMLINK� CMD_SETSTAT� CMD_READLINK� CMD_REALPATH�
CMD_STATUS� CMD_EXTENDED�SFTP_OK�SFTP_EOF�SFTP_NO_SUCH_FILE�SFTP_PERMISSION_DENIED�int64)�SFTPAttributes)� SSHException)�SFTPFile)�ClosingContextManager�b�uc � � U R S5 $ ! [ [ 4 a) U R S5 s $ ! [ a U s s $ f = ff = f)z�
decode a string as ascii or utf8 if possible (as required by the sftp
protocol). if neither works, just return a byte string because the server
probably doesn't know the filename's encoding.
�asciizutf-8)�encode� UnicodeError�AttributeError�decode)�ss �6/usr/lib/python3/dist-packages/paramiko/sftp_client.py� _to_unicoder8 H sR � � ��x�x�� � �� �.� )� � ��8�8�G�$� $��� ��H� ���s) � �A �7�A � A�A �A�A � /c �N ^ � \ rS rSrSrS r\S(S j5 rU 4S jrS r S r
S)S jr S)S jr S*S
jr
S+S jr\rS r\rS
rS r\4S jrS rS rS rS rS rS rS r S r S r S r S,S jr S r!S r"S-S jr#S.S jr$ S/S jr% S/S jr&S! r'S" r(S,S# jr)S$ r*S% r+S& r,S'r-U =r.$ )0�
SFTPClient�Z z�
SFTP client object.
Used to open an SFTP session across an open SSH `.Transport` and perform
remote file operations.
Instances of this class may be used as context managers.
c �F � [ R " U 5 Xl SU l SU l [
R " 5 U l SU l [ R " 5 U l [ U5 [ L a[ U R R 5 n[ R " UR# 5 S- 5 U l UR' 5 U l U R) 5 nU R/ [0 SR3 U5 5 g! [* a [- S5 ef = f)ac
Create an SFTP client from an existing `.Channel`. The channel
should already have requested the ``"sftp"`` subsystem.
An alternate way to create an SFTP client context is by using
`from_transport`.
:param .Channel sock: an open `.Channel` using the ``"sftp"`` subsystem
:raises:
`.SSHException` -- if there's an exception while negotiating sftp
F� Nz.sftpzEOF during negotiationz*Opened sftp connection (server version {}))r
�__init__�sock� ultra_debug�request_number� threading�Lock�_lock�_cwd�weakref�WeakValueDictionary�
_expecting�typer �
get_transportr �
get_logger�get_log_channel�logger� get_hexdump�
_send_version�EOFErrorr+ �_logr �format)�selfr@ � transport�server_versions r7 r? �SFTPClient.__init__d s� � � ���$� �� � ��� ��� �^�^�%��
��� �!�5�5�7��� ��:�� � � � �/�/�1�I� �/�/��)�)�+�g�5��D�K� )� 4� 4� 6�D� � 9� !� /� /� 1�N�
� � � � 8� ?� ?� �
�
�� � 9� � 7�8� 8� 9�s �D
�
D c �Z � UR X#S9nUc gUR S5 U " U5 $ )a�
Create an SFTP client channel from an open `.Transport`.
Setting the window and packet sizes might affect the transfer speed.
The default settings in the `.Transport` class are the same as in
OpenSSH and should work adequately for both files transfers and
interactive sessions.
:param .Transport t: an open `.Transport` which is already
authenticated
:param int window_size:
optional window size for the `.SFTPClient` session.
:param int max_packet_size:
optional max packet size for the `.SFTPClient` session..
:return:
a new `.SFTPClient` object, referring to an sftp session (channel)
across the transport
.. versionchanged:: 1.15
Added the ``window_size`` and ``max_packet_size`` arguments.
)� window_size�max_packet_sizeN�sftp)� open_session�invoke_subsystem)�cls�trY rZ �chans r7 �from_transport�SFTPClient.from_transport� s< � �0 �~�~�#� �
�� �<�� � � �f�%��4�y�� c � >� [ U[ 5 ( a U H nU R " X/UQ76 M g UR SS5 n[ TU ] " USU- /U R
R
5 /[ U5 - Q76 g )N�%z%%z
[chan %s] )�
isinstance�listrR �replace�superr@ �get_name)rT �level�msg�args�m� __class__s �r7 rR �SFTPClient._log� sw �� � �c�4� � ���� � �%�*�T�*� � �+�+�c�4�(�C� �G�L�� �s�"�
� �9�9�%�%�'�(�4��:�5�
rc c �d � U R [ S5 U R R 5 g)zK
Close the SFTP session and its underlying channel.
.. versionadded:: 1.4
zsftp session closed.N)rR r r@ �close�rT s r7 rr �SFTPClient.close� s! � �
� � �$�.�/� � � ���rc c � � U R $ )z�
Return the underlying `.Channel` object for this SFTP session. This
might be useful for doing things like setting a timeout on the channel.
.. versionadded:: 1.7.1
)r@ rs s r7 � get_channel�SFTPClient.get_channel� s � � �y�y�rc c �b � U R U5 Vs/ s H o"R PM sn$ s snf )a�
Return a list containing the names of the entries in the given
``path``.
The list is in arbitrary order. It does not include the special
entries ``'.'`` and ``'..'`` even if they are present in the folder.
This method is meant to mirror ``os.listdir`` as closely as possible.
For a list of full `.SFTPAttributes` objects, see `listdir_attr`.
:param str path: path to list (defaults to ``'.'``)
)� listdir_attr�filename)rT �path�fs r7 �listdir�SFTPClient.listdir� s+ � � %)�$5�$5�d�$;�<�$;�q�
�
�$;�<�<��<s �,c � � U R U5 nU R [ SR U5 5 U R [
U5 u p#U[ :w a [ S5 eUR 5 n/ n U R [ U5 u p#U[ :w a [ S5 eUR 5 n[ U5 H[ nUR 5 nUR 5 n [ R " X8U 5 n
US:w d MB US:w d MJ UR# U
5 M] M� ! [ a Of = fU R [$ U5 U$ )a]
Return a list containing `.SFTPAttributes` objects corresponding to
files in the given ``path``. The list is in arbitrary order. It does
not include the special entries ``'.'`` and ``'..'`` even if they are
present in the folder.
The returned `.SFTPAttributes` objects will each have an additional
field: ``longname``, which may contain a formatted string of the file's
attributes, in unix format. The content of this string will probably
depend on the SFTP server implementation.
:param str path: path to list (defaults to ``'.'``)
:return: list of `.SFTPAttributes` objects
.. versionadded:: 1.2
�
listdir({!r})�Expected handle�Expected name response�.�..)� _adjust_cwdrR r rS �_requestr r r
�
get_binaryr rQ r �get_int�range�get_textr* � _from_msg�appendr ) rT r{ r_ rl �handle�filelist�count�irz �longname�attrs r7 ry �SFTPClient.listdir_attr� s � �" � � ��%�� � � �%� �/�/��5�6�� � �{�D�1��� �
�?�� -�.� .�� � �!�����
� � � �{�F�;��� �H�}� � 8�9�9��K�K�M�E��5�\�� �<�<�>�� �<�<�>��%�/�/��x�H�� ��O�(�d�*:� �O�O�D�)� "� �� �
��
��
�
�
�i��(��s �8D! �!
D.�-D.c # �z # � U R U5 nU R [ SR U5 5 U R [
U5 u p4U[ :w a [ S5 eUR 5 n[ 5 n [ U5 H4 nU R [ S5 [ U5 nUR U5 M6 U H� nU R 5 u p9[! U 5 nUR# 5 n
X�:X a U[$ :X a U R' U5 UR# 5 n [ U 5 HN nUR) 5 n UR) 5 n
[* R, " XLU
5 nU S:w d MB U S:w d MJ Uv � MP M� [ 5 nGM ! [. a U R [0 U5 gf = f7f)a�
Generator version of `.listdir_attr`.
See the API docs for `.listdir_attr` for overall details.
This function adds one more kwarg on top of `.listdir_attr`:
``read_aheads``, an integer controlling how many
``SSH_FXP_READDIR`` requests are made to the server. The default of 50
should suffice for most file listings as each request/response cycle
may contain multiple files (dependent on server implementation.)
.. versionadded:: 1.15
r� r� Nr� r� )r� rR r rS r� r r r
�
get_stringrg r� �_async_requestrJ r r� � _read_packetr r� r# �_convert_statusr� r* r� rQ r )rT r{ � read_aheadsr_ rl r� �numsr� �num�pkt_data�new_numr� rz r� r� s r7 � listdir_iter�SFTPClient.listdir_iter sz � � � � � ��%�� � � �%� �/�/��5�6�� � �{�D�1��� �
�?�� -�.� .�� � �!���v���%
�
�{�+�A� �-�-�d�4�j�+�v�N�C��K�K��$� ,� �C�"&�"3�"3�"5�K�A�!�(�+�C� !�k�k�m�G��~� �
�?� � 0� 0�� 5� �K�K�M�E� "�5�\��#&�<�<�>��#&�<�<�>�� -� 7� 7� �8� �� %��O�(�d�2B�"&�J� *� �$ �v��E ��H �
��
�
�i��0��
�s7 �A?F;�C.F �4F �<F �F;� F8�5F;�7F8�8F;c �n � U R U5 nU R [ SR X5 5 SnSU; d SU; a U[ - nSU; d SU; d SU; a U[
- nSU; a U[ [ - - nSU; a U[ [ - - nSU; a U[ [ - - n[ 5 nU R [ XU5 u pgU[ :w a [ S5 eUR 5 nU R [ S R X[! [# U5 5 5 5 [% XX#5 $ )
a�
Open a file on the remote server. The arguments are the same as for
Python's built-in `python:file` (aka `python:open`). A file-like
object is returned, which closely mimics the behavior of a normal
Python file object, including the ability to be used as a context
manager.
The mode indicates how the file is to be opened: ``'r'`` for reading,
``'w'`` for writing (truncating an existing file), ``'a'`` for
appending, ``'r+'`` for reading/writing, ``'w+'`` for reading/writing
(truncating an existing file), ``'a+'`` for reading/appending. The
Python ``'b'`` flag is ignored, since SSH treats all files as binary.
The ``'U'`` flag is supported in a compatible way.
Since 1.5.2, an ``'x'`` flag indicates that the operation should only
succeed if the file was created and did not previously exist. This has
no direct mapping to Python's file flags, but is commonly known as the
``O_EXCL`` flag in posix.
The file will be buffered in standard Python style by default, but
can be altered with the ``bufsize`` parameter. ``<=0`` turns off
buffering, ``1`` uses line buffering, and any number greater than 1
(``>1``) uses that specific buffer size.
:param str filename: name of the file to open
:param str mode: mode (Python-style) to open in
:param int bufsize: desired buffering (default: ``-1``)
:return: an `.SFTPFile` object representing the open file
:raises: ``IOError`` -- if the file could not be opened.
zopen({!r}, {!r})r �r�+�w�a�xr� zopen({!r}, {!r}) -> {})r� rR r rS r r r r r r r* r� r r r
r� r/ r r, ) rT rz �mode�bufsize�imode� attrblockr_ rl r� s r7 �open�SFTPClient.openF s# � �@ �#�#�H�-�� � � �%�+�2�2�8�B�C��� �4�K�S�D�[� �^� #�E� �4�K�S�D�[�c�T�k� �_� $�E� �$�;� �%��7� 7�E� �$�;� �%�(8�8� 8�E� �$�;� �%��6� 6�E�"�$� �� � �x��)�D��� �
�?�� -�.� .�� � �!�� � � � � $� +� +���'�&�/� 2�
�
� ��d�4�4rc c � � U R U5 nU R [ SR U5 5 U R [
U5 g)z�
Remove the file at the given path. This only works on files; for
removing folders (directories), use `rmdir`.
:param str path: path (absolute or relative) of the file to remove
:raises: ``IOError`` -- if the path refers to a folder (directory)
z remove({!r})N)r� rR r rS r� r �rT r{ s r7 �remove�SFTPClient.remove� s; � � � � ��%�� � � �%� �.�.�t�4�5� �
�
�j�$�'rc c � � U R U5 nU R U5 nU R [ SR X5 5 U R [
X5 g)a�
Rename a file or folder from ``oldpath`` to ``newpath``.
.. note::
This method implements 'standard' SFTP ``RENAME`` behavior; those
seeking the OpenSSH "POSIX rename" extension behavior should use
`posix_rename`.
:param str oldpath:
existing name of the file or folder
:param str newpath:
new name for the file or folder, must not exist already
:raises:
``IOError`` -- if ``newpath`` is a folder, or something else goes
wrong
zrename({!r}, {!r})N)r� rR r rS r� r �rT �oldpath�newpaths r7 �rename�SFTPClient.rename� sL � �$ �"�"�7�+���"�"�7�+�� � � �%�-�4�4�W�F�G� �
�
�j�'�3rc c � � U R U5 nU R U5 nU R [ SR X5 5 U R [
SX5 g)a�
Rename a file or folder from ``oldpath`` to ``newpath``, following
posix conventions.
:param str oldpath: existing name of the file or folder
:param str newpath: new name for the file or folder, will be
overwritten if it already exists
:raises:
``IOError`` -- if ``newpath`` is a folder, posix-rename is not
supported by the server or something else goes wrong
:versionadded: 2.2
zposix_rename({!r}, {!r})z[email protected])r� rR r rS r� r$ r� s r7 � posix_rename�SFTPClient.posix_rename� sR � � �"�"�7�+���"�"�7�+�� � � �%�3�:�:�7�L�M� �
�
� �4�g�
rc c � � U R U5 nU R [ SR X5 5 [ 5 nX#l U R
[ X5 g)aC
Create a folder (directory) named ``path`` with numeric mode ``mode``.
The default mode is 0777 (octal). On some systems, mode is ignored.
Where it is used, the current umask value is first masked out.
:param str path: name of the folder to create
:param int mode: permissions (posix-style) for the newly-created folder
zmkdir({!r}, {!r})N)r� rR r rS r* �st_moder� r �rT r{ r� r� s r7 �mkdir�SFTPClient.mkdir� sI � � � � ��%�� � � �%�,�3�3�D�?�@� � ��� � �
�
�i��,rc c � � U R U5 nU R [ SR U5 5 U R [
U5 g)zR
Remove the folder named ``path``.
:param str path: name of the folder to remove
z rmdir({!r})N)r� rR r rS r� r r� s r7 �rmdir�SFTPClient.rmdir� s; � � � � ��%�� � � �%� �-�-�d�3�4� �
�
�i��&rc c �� � U R U5 nU R [ SR U5 5 U R [
U5 u p#U[ :w a [ S5 e[ R " U5 $ )a�
Retrieve information about a file on the remote system. The return
value is an object whose attributes correspond to the attributes of
Python's ``stat`` structure as returned by ``os.stat``, except that it
contains fewer fields. An SFTP server may return as much or as little
info as it wants, so the results may vary from server to server.
Unlike a Python `python:stat` object, the result may not be accessed as
a tuple. This is mostly due to the author's slack factor.
The fields supported are: ``st_mode``, ``st_size``, ``st_uid``,
``st_gid``, ``st_atime``, and ``st_mtime``.
:param str path: the filename to stat
:return:
an `.SFTPAttributes` object containing attributes about the given
file
z
stat({!r})�Expected attributes)
r� rR r rS r� r r r
r* r� �rT r{ r_ rl s r7 �stat�SFTPClient.stat� sc � �& � � ��%�� � � �%� �,�,�T�2�3�� � �x��.��� � �>�� 1�2� 2� �'�'��,�,rc c �� � U R U5 nU R [ SR U5 5 U R [
U5 u p#U[ :w a [ S5 e[ R " U5 $ )a
Retrieve information about a file on the remote system, without
following symbolic links (shortcuts). This otherwise behaves exactly
the same as `stat`.
:param str path: the filename to stat
:return:
an `.SFTPAttributes` object containing attributes about the given
file
z lstat({!r})r� )
r� rR r rS r� r r r
r* r� r� s r7 �lstat�SFTPClient.lstat� sc � � � � ��%�� � � �%� �-�-�d�3�4�� � �y�$�/��� � �>�� 1�2� 2� �'�'��,�,rc c � � U R U5 nU R [ SR X5 5 [ U5 nU R [ X5 g)z�
Create a symbolic link to the ``source`` path at ``destination``.
:param str source: path of the original file
:param str dest: path of the newly created symlink
zsymlink({!r}, {!r})N)r� rR r rS r. r� r )rT �source�dests r7 �symlink�SFTPClient.symlink sE � � � � ��%�� � � �%�.�5�5�f�C�D��6��� �
�
�k�6�0rc c � � U R U5 nU R [ SR X5 5 [ 5 nX#l U R
[ X5 g)z�
Change the mode (permissions) of a file. The permissions are
unix-style and identical to those used by Python's `os.chmod`
function.
:param str path: path of the file to change the permissions of
:param int mode: new permissions
zchmod({!r}, {!r})N)r� rR r rS r* r� r� r r� s r7 �chmod�SFTPClient.chmod sI � � � � ��%�� � � �%�,�3�3�D�?�@� � ��� � �
�
�k�4�.rc c �� � U R U5 nU R [ SR XU5 5 [ 5 nX#sUl Ul U R [ X5 g)a^
Change the owner (``uid``) and group (``gid``) of a file. As with
Python's `os.chown` function, you must pass both arguments, so if you
only want to change one, use `stat` first to retrieve the current
owner and group.
:param str path: path of the file to change the owner and group of
:param int uid: new owner's uid
:param int gid: new group id
zchown({!r}, {!r}, {!r})N) r� rR r rS r* �st_uid�st_gidr� r )rT r{ �uid�gidr� s r7 �chown�SFTPClient.chown sT � � � � ��%�� � � �%�2�9�9�$�S�I�J� � ��#&� �� �T�[� �
�
�k�4�.rc c �( � U R U5 nUc* [ R " 5 [ R " 5 4nU R [ SR X5 5 [ 5 nUu Ul Ul U R [ X5 g)aT
Set the access and modified times of the file specified by ``path``.
If ``times`` is ``None``, then the file's access and modified times
are set to the current time. Otherwise, ``times`` must be a 2-tuple
of numbers, of the form ``(atime, mtime)``, which is used to set the
access and modified times, respectively. This bizarre API is mimicked
from Python for the sake of consistency -- I apologize.
:param str path: path of the file to modify
:param tuple times:
``None`` or a tuple of (access time, modified time) in standard
internet epoch time (seconds since 01 January 1970 GMT)
Nzutime({!r}, {!r}))
r� �timerR r rS r* �st_atime�st_mtimer� r )rT r{ �timesr� s r7 �utime�SFTPClient.utime0 sm � � � � ��%�� �=��Y�Y�[�$�)�)�+�.�E� � � �%�,�3�3�D�@�A� � ��',�$��
�t�}� �
�
�k�4�.rc c � � U R U5 nU R [ SR X5 5 [ 5 nX#l U R
[ X5 g)a
Change the size of the file specified by ``path``. This usually
extends or shrinks the size of the file, just like the `~file.truncate`
method on Python file objects.
:param str path: path of the file to modify
:param int size: the new size of the file
ztruncate({!r}, {!r})N)r� rR r rS r* �st_sizer� r )rT r{ �sizer� s r7 �truncate�SFTPClient.truncateF sI � � � � ��%�� � � �%�/�6�6�t�B�C� � ��� � �
�
�k�4�.rc c �h � U R U5 nU R [ SR U5 5 U R [
U5 u p#U[ :w a [ S5 eUR 5 nUS:X a gUS:w a [ SR U5 5 e[ UR 5 5 $ )z�
Return the target of a symbolic link (shortcut). You can use
`symlink` to create these. The result may be either an absolute or
relative pathname.
:param str path: path of the symbolic link file
:return: target path, as a `str`
zreadlink({!r})r� r Nr> z Readlink returned {} results) r� rR r rS r� r! r r
r� r8 r� �rT r{ r_ rl r� s r7 �readlink�SFTPClient.readlinkU s� � � � � ��%�� � � �%�)�0�0��6�7�� � �|�T�2��� ��=�� 4�5� 5�� � �
�� �A�:�� �A�:�� :� A� A�%� H�I� I��3�>�>�+�,�,rc c �H � U R U5 nU R [ SR U5 5 U R [
U5 u p#U[ :w a [ S5 eUR 5 nUS:w a [ SR U5 5 eUR 5 $ )a
Return the normalized path (on the server) of a given path. This
can be used to quickly resolve symbolic links or determine what the
server is considering to be the "current folder" (by passing ``'.'``
as ``path``).
:param str path: path to be normalized
:return: normalized form of the given path (as a `str`)
:raises: ``IOError`` -- if the path can't be resolved on the server
znormalize({!r})r� r> z Realpath returned {} results)
r� rR r rS r� r" r r
r� r� r� s r7 � normalize�SFTPClient.normalizej s� � � � � ��%�� � � �%�*�1�1�$�7�8�� � �|�T�2��� ��=�� 4�5� 5�� � �
�� �A�:�� :� A� A�%� H�I� I��|�|�~� rc c �@ � Uc SU l g[ R " U R U5 R 5 ( d@ [ R
n[
USR [ R " U5 U5 5 e[ U R U5 5 U l g)a�
Change the "current directory" of this SFTP session. Since SFTP
doesn't really have the concept of a current working directory, this is
emulated by Paramiko. Once you use this method to set a working
directory, all operations on this `.SFTPClient` object will be relative
to that path. You can pass in ``None`` to stop using a current working
directory.
:param str path: new current working directory
:raises:
``IOError`` -- if the requested path doesn't exist on the server
.. versionadded:: 1.4
Nz{}: {}) rF r� �S_ISDIRr� �errno�ENOTDIRr
rS �os�strerrorr. r� )rT r{ �codes r7 �chdir�SFTPClient.chdir� so � � �<� �D�I� ��|�|�D�I�I�d�O� 3� 3�4�4��=�=�D��D�(�/�/�"�+�+�d�2C�T�"J�K� K��d�n�n�T�*�+�� rc c �R � U R =( a [ U R 5 $ )z�
Return the "current working directory" for this SFTP session, as
emulated by Paramiko. If no directory has been set with `chdir`,
this method will return ``None``.
.. versionadded:: 1.4
)rF r/ rs s r7 �getcwd�SFTPClient.getcwd� s � � �y�y�)�Q�t�y�y�\�)rc c � � Sn UR S5 nUR U5 U[ U5 -
n[ U5 S:X a U$ Ub U" XS5 MO )Nr i � )�read�write�len)rT �reader�writer� file_size�callbackr� �datas r7 �_transfer_with_callback�"SFTPClient._transfer_with_callback� s\ � �����;�;�u�%�D� �L�L�� � �C��I� �D��4�y�A�~�� � � �#���)� rc c �T � U R US5 nUR S5 U R XX4S9nSSS5 U( aI U R U5 nUR W:w a% [ SR
UR U5 5 e U$ [ 5 nU$ ! , ( d f Nj= f)aG
Copy the contents of an open file object (``fl``) to the SFTP server as
``remotepath``. Any exception raised by operations will be passed
through.
The SFTP operations use pipelining for speed.
:param fl: opened file or file-like object to copy
:param str remotepath: the destination path on the SFTP server
:param int file_size:
optional size parameter passed to callback. If none is specified,
size defaults to 0
:param callable callback:
optional callback function (form: ``func(int, int)``) that accepts
the bytes transferred so far and the total bytes to be transferred
(since 1.7.4)
:param bool confirm:
whether to do a stat() on the file afterwards to confirm the file
size (since 1.7.7)
:return:
an `.SFTPAttributes` object containing attributes about the given
file.
.. versionadded:: 1.10
�wbT�r� r� r� r� Nz size mismatch in put! {} != {})�file�
set_pipelinedr r� r� �IOErrorrS r* ) rT �fl�
remotepathr� r� �confirm�frr� r6 s r7 �putfo�SFTPClient.putfo� s� � �6 �Y�Y�z�4�
(�B� � � �T� "��/�/�� � 0� �D� )�
�� � �*�%�A��y�y�D� � �5�<�<�Q�Y�Y��M�� � !� �� � �A��� )�
(�s �"B�
B'c � � [ R " U5 R n[ US5 nU R XbXSU5 sSSS5 $ ! , ( d f g= f)a�
Copy a local file (``localpath``) to the SFTP server as ``remotepath``.
Any exception raised by operations will be passed through. This
method is primarily provided as a convenience.
The SFTP operations use pipelining for speed.
:param str localpath: the local file to copy
:param str remotepath: the destination path on the SFTP server. Note
that the filename should be included. Only specifying a directory
may result in an error.
:param callable callback:
optional callback function (form: ``func(int, int)``) that accepts
the bytes transferred so far and the total bytes to be transferred
:param bool confirm:
whether to do a stat() on the file afterwards to confirm the file
size
:return: an `.SFTPAttributes` object containing attributes about the
given file
.. versionadded:: 1.4
.. versionchanged:: 1.7.4
``callback`` and rich attribute return value added.
.. versionchanged:: 1.7.7
``confirm`` param added.
�rbN)r� r� r� r� r )rT � localpathr r� r
r� r s r7 �put�SFTPClient.put� s@ � �8 �G�G�I�&�.�.� �
�)�T�
"�b��:�:�b�i�7�K� #�
"�
"�s �A
�
Ac �� � U R U5 R nU R US5 nU( a UR Xe5 U R XrXcS9sSSS5 $ ! , ( d f g= f)a'
Copy a remote file (``remotepath``) from the SFTP server and write to
an open file or file-like object, ``fl``. Any exception raised by
operations will be passed through. This method is primarily provided
as a convenience.
:param object remotepath: opened file or file-like object to copy to
:param str fl:
the destination path on the local host or open file object
:param callable callback:
optional callback function (form: ``func(int, int)``) that accepts
the bytes transferred so far and the total bytes to be transferred
:param bool prefetch:
controls whether prefetching is performed (default: True)
:param int max_concurrent_prefetch_requests:
The maximum number of concurrent read requests to prefetch. See
`.SFTPClient.get` (its ``max_concurrent_prefetch_requests`` param)
for details.
:return: the `number <int>` of bytes written to the opened file object
.. versionadded:: 1.10
.. versionchanged:: 2.8
Added the ``prefetch`` keyword argument.
.. versionchanged:: 3.3
Added ``max_concurrent_prefetch_requests``.
r r N)r� r� r� �prefetchr )rT r r r� r � max_concurrent_prefetch_requestsr� r s r7 �getfo�SFTPClient.getfo� s\ � �D �I�I�j�)�1�1� �
�Y�Y�z�4�
(�B��� � �I�H��/�/�� � 0� � )�
(�
(�s �(A �
A.c � � [ US5 nU R UUUUU5 nSSS5 [ R " U5 nUR W:w a% [ SR
UR U5 5 eg! , ( d f NZ= f)a�
Copy a remote file (``remotepath``) from the SFTP server to the local
host as ``localpath``. Any exception raised by operations will be
passed through. This method is primarily provided as a convenience.
:param str remotepath: the remote file to copy
:param str localpath: the destination path on the local host
:param callable callback:
optional callback function (form: ``func(int, int)``) that accepts
the bytes transferred so far and the total bytes to be transferred
:param bool prefetch:
controls whether prefetching is performed (default: True)
:param int max_concurrent_prefetch_requests:
The maximum number of concurrent read requests to prefetch.
When this is ``None`` (the default), do not limit the number of
concurrent prefetch requests. Note: OpenSSH's sftp internally
imposes a limit of 64 concurrent requests, while Paramiko imposes
no limit by default; consider setting a limit if a file can be
successfully received with sftp but hangs with Paramiko.
.. versionadded:: 1.4
.. versionchanged:: 1.7.4
Added the ``callback`` param
.. versionchanged:: 2.8
Added the ``prefetch`` keyword argument.
.. versionchanged:: 3.3
Added ``max_concurrent_prefetch_requests``.
r Nz size mismatch in get! {} != {})r� r r� r� r� r rS ) rT r r r� r r r r� r6 s r7 �get�SFTPClient.get# s~ � �H �)�T�
"�b��:�:�����0� �D� #�
�G�G�I� �� �9�9�� ��1�8�8����D�I��
� � #�
"�s �A7�7
Bc �^ � U R " [ S 5 U/UQ76 nU R U5 $ �N)r� rJ �_read_response)rT r_ rm r� s r7 r� �SFTPClient._requestW s. � ��!�!�$�t�*�a�7�$�7���"�"�3�'�'rc c � � U R R 5 [ 5 nUR U R 5 U H� n[ U[ 5 ( a UR U5 M+ [ U[ 5 ( a UR U5 MS [ U[ 5 ( a UR U5 M{ UR U5 M� U R nXR U' U =R S-
sl U R R 5 U R X$5 U$ ! U R R 5 f = f)Nr> )rE �acquirer �add_intrB rf r) � add_int64�intr* �_pack�
add_stringrI �release� _send_packet)rT �fileobjr_ rm rl �itemr� s r7 r� �SFTPClient._async_request[ s� � � �
�
��� � !��)�C� �K�K��+�+� ,� �� �d�E�*�*��M�M�$�'� ��c�*�*��K�K��%� ��n�5�5��J�J�s�O� �N�N�4�(� � �%�%�C�#*�O�O�C� � � � �1� $� � �J�J� � � � ���!�!��
��
�J�J� � � �s �C&D/ �/ E c � � U R 5 u p#[ U5 nUR 5 nU R R 5 X`R ; aa U R [ SR U5 5 Uc U R R 5 g U R R 5 M� U R U nU R U U R R 5 Xa:X a U[ :X a U R U5 X%4$ U[ S 5 La UR X%U5 Uc gGM: ! [ a n[ SR U5 5 eS nAff = f! U R R 5 f = f)Nz Server connection dropped: {}zUnexpected response #{}�NN)r� rQ r+ rS r r� rE r rI rR r r& r# r� rJ �_async_response)rT �waitforr_ r� �erl r� r( s r7 r �SFTPClient._read_responset s\ � ��
N� �+�+�-��� �$�-�C��+�+�-�C� �J�J� � � �
%��o�o�-� �I�I�e�%>�%E�%E�c�%J�K� �� �
�
�
�"�"�$� �% � �
�
�"�"�$� �/�/�#�.���O�O�C�(��
�
�"�"�$��~��
�?��(�(��-��v�
� �d�4�j�(��'�'���4�����E �� �
N�"�#B�#I�#I�!�#L�M�M��
N��" �
�
�"�"�$�s) �D< � 7E( �; E( �<
E%�E � E%�( Fc � � XR R 5 ; a@ U R 5 UR 5 XR R 5 ; a M? g g r )rI �valuesr �_check_exception)rT r( s r7 �_finish_responses� SFTPClient._finish_responses� sB � �� � �/�/�1�1� � � � !� � $� $� &� � � �/�/�1�1rc c �( � UR 5 nUR 5 nU[ :X a gU[ :X a [ U5 eU[
:X a [
[ R U5 eU[ :X a [
[ R U5 e[
U5 e)zE
Raises EOFError or IOError on error status; otherwise does nothing.
N) r� r� r% r& rQ r' r r� �ENOENTr( �EACCES)rT rl r� �texts r7 r� �SFTPClient._convert_status� st � � �{�{�}���|�|�~�� �7�?� �
�X�
��4�.� �
�&�
&��%�,�,��-� -�
�+�
+��%�,�,��-� -��$�-� rc c �� � [ U5 nU R c U$ [ U5 ( a USS [ :X a U$ U R [ :X a U R U- $ U R [ - U- $ )zZ
Return an adjusted path if we're emulating a "current working
directory" for the server.
r r> )r. rF r� �b_slashr� s r7 r� �SFTPClient._adjust_cwd� sf � �
��w�� �9�9� ��K� �t�9�9��a���g�-��K� �9�9�� ��9�9�t�#� #��y�y�7�"�T�)�)rc )rF rI rE rN rB r@ rA r, )r� )r� �2 )r� ���r )r NT)NT)NTN)/�__name__�
__module__� __qualname__�__firstlineno__�__doc__r? � classmethodra rR rr rv r} ry r� r� r r� �unlinkr� r� r r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r� r� r r4 r� r� �__static_attributes__�
__classcell__)ro s @r7 r; r; Z s �� ��&
�P � � � �>� �� =� (�T>�@85�v �D� (� �F�4�.
�, $�
-� '�-�4-�$
1�
/� /�"/�,
/� -�* �,,�0 *�
�(�T L�H ��)-�
(�\ ��)-�
0�h(��2#�J'�
�$
*�
*rc r; c � � \ rS rSrSrSrg)�SFTPi� z9
An alias for `.SFTPClient` for backwards compatibility.
� N)r@ rA rB rC rD rG rK rc r7 rJ rJ � s � �� rc rJ )A�binasciir r� r� r� rC r� rG �paramikor �paramiko.channelr �paramiko.messager �paramiko.commonr r r �
paramiko.sftpr
r r r
r r r r r r r r r r r r r r r r r r r r! r" r# r$ r% r& r' r( r) �paramiko.sftp_attrr* �paramiko.ssh_exceptionr+ �paramiko.sftp_filer, �
paramiko.utilr- r. r/ r8 r< r; rJ rK rc r7 �<module>rV s� ��( � � � � � � � � $� $� -� -�!� !� !� !� !� !� !� !� !�F .� /� '� 5� 5� � ��c
*��0� c
*�L �:� rc