SWAMPy

✎ CARVE FLESH

EDITING: sftp_attr.py

# Copyright (C) 2003-2006 Robey Pointer <robeypointer@gmail.com>
#
# This file is part of paramiko.
#
# Paramiko is free software; you can redistribute it and/or modify it under the
# terms of the GNU Lesser General Public License as published by the Free
# Software Foundation; either version 2.1 of the License, or (at your option)
# any later version.
#
# Paramiko is distributed in the hope that it will be useful, but WITHOUT ANY
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
# A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
# details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with Paramiko; if not, write to the Free Software Foundation, Inc.,
# 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA.

import stat
import time
from paramiko.common import x80000000, o700, o70, xffffffff

class SFTPAttributes:
    """
    Representation of the attributes of a file (or proxied file) for SFTP in
    client or server mode.  It attempts to mirror the object returned by
    `os.stat` as closely as possible, so it may have the following fields,
    with the same meanings as those returned by an `os.stat` object:

- ``st_size``
        - ``st_uid``
        - ``st_gid``
        - ``st_mode``
        - ``st_atime``
        - ``st_mtime``

Because SFTP allows flags to have other arbitrary named attributes, these
    are stored in a dict named ``attr``.  Occasionally, the filename is also
    stored, in ``filename``.
    """

FLAG_SIZE = 1
    FLAG_UIDGID = 2
    FLAG_PERMISSIONS = 4
    FLAG_AMTIME = 8
    FLAG_EXTENDED = x80000000

def __init__(self):
        """
        Create a new (empty) SFTPAttributes object.  All fields will be empty.
        """
        self._flags = 0
        self.st_size = None
        self.st_uid = None
        self.st_gid = None
        self.st_mode = None
        self.st_atime = None
        self.st_mtime = None
        self.attr = {}

@classmethod
    def from_stat(cls, obj, filename=None):
        """
        Create an `.SFTPAttributes` object from an existing ``stat`` object (an
        object returned by `os.stat`).

:param object obj: an object returned by `os.stat` (or equivalent).
        :param str filename: the filename associated with this file.
        :return: new `.SFTPAttributes` object with the same attribute fields.
        """
        attr = cls()
        attr.st_size = obj.st_size
        attr.st_uid = obj.st_uid
        attr.st_gid = obj.st_gid
        attr.st_mode = obj.st_mode
        attr.st_atime = obj.st_atime
        attr.st_mtime = obj.st_mtime
        if filename is not None:
            attr.filename = filename
        return attr

def __repr__(self):
        return "<SFTPAttributes: {}>".format(self._debug_str())

# ...internals...
    @classmethod
    def _from_msg(cls, msg, filename=None, longname=None):
        attr = cls()
        attr._unpack(msg)
        if filename is not None:
            attr.filename = filename
        if longname is not None:
            attr.longname = longname
        return attr

def _unpack(self, msg):
        self._flags = msg.get_int()
        if self._flags & self.FLAG_SIZE:
            self.st_size = msg.get_int64()
        if self._flags & self.FLAG_UIDGID:
            self.st_uid = msg.get_int()
            self.st_gid = msg.get_int()
        if self._flags & self.FLAG_PERMISSIONS:
            self.st_mode = msg.get_int()
        if self._flags & self.FLAG_AMTIME:
            self.st_atime = msg.get_int()
            self.st_mtime = msg.get_int()
        if self._flags & self.FLAG_EXTENDED:
            count = msg.get_int()
            for i in range(count):
                self.attr[msg.get_string()] = msg.get_string()

def _pack(self, msg):
        self._flags = 0
        if self.st_size is not None:
            self._flags |= self.FLAG_SIZE
        if (self.st_uid is not None) and (self.st_gid is not None):
            self._flags |= self.FLAG_UIDGID
        if self.st_mode is not None:
            self._flags |= self.FLAG_PERMISSIONS
        if (self.st_atime is not None) and (self.st_mtime is not None):
            self._flags |= self.FLAG_AMTIME
        if len(self.attr) > 0:
            self._flags |= self.FLAG_EXTENDED
        msg.add_int(self._flags)
        if self._flags & self.FLAG_SIZE:
            msg.add_int64(self.st_size)
        if self._flags & self.FLAG_UIDGID:
            msg.add_int(self.st_uid)
            msg.add_int(self.st_gid)
        if self._flags & self.FLAG_PERMISSIONS:
            msg.add_int(self.st_mode)
        if self._flags & self.FLAG_AMTIME:
            # throw away any fractional seconds
            msg.add_int(int(self.st_atime))
            msg.add_int(int(self.st_mtime))
        if self._flags & self.FLAG_EXTENDED:
            msg.add_int(len(self.attr))
            for key, val in self.attr.items():
                msg.add_string(key)
                msg.add_string(val)
        return

def _debug_str(self):
        out = "[ "
        if self.st_size is not None:
            out += "size={} ".format(self.st_size)
        if (self.st_uid is not None) and (self.st_gid is not None):
            out += "uid={} gid={} ".format(self.st_uid, self.st_gid)
        if self.st_mode is not None:
            out += "mode=" + oct(self.st_mode) + " "
        if (self.st_atime is not None) and (self.st_mtime is not None):
            out += "atime={} mtime={} ".format(self.st_atime, self.st_mtime)
        for k, v in self.attr.items():
            out += '"{}"={!r} '.format(str(k), v)
        out += "]"
        return out

@staticmethod
    def _rwx(n, suid, sticky=False):
        if suid:
            suid = 2
        out = "-r"[n >> 2] + "-w"[(n >> 1) & 1]
        if sticky:
            out += "-xTt"[suid + (n & 1)]
        else:
            out += "-xSs"[suid + (n & 1)]
        return out

def __str__(self):
        """create a unix-style long description of the file (like ls -l)"""
        if self.st_mode is not None:
            kind = stat.S_IFMT(self.st_mode)
            if kind == stat.S_IFIFO:
                ks = "p"
            elif kind == stat.S_IFCHR:
                ks = "c"
            elif kind == stat.S_IFDIR:
                ks = "d"
            elif kind == stat.S_IFBLK:
                ks = "b"
            elif kind == stat.S_IFREG:
                ks = "-"
            elif kind == stat.S_IFLNK:
                ks = "l"
            elif kind == stat.S_IFSOCK:
                ks = "s"
            else:
                ks = "?"
            ks += self._rwx(
                (self.st_mode & o700) >> 6, self.st_mode & stat.S_ISUID
            )
            ks += self._rwx(
                (self.st_mode & o70) >> 3, self.st_mode & stat.S_ISGID
            )
            ks += self._rwx(
                self.st_mode & 7, self.st_mode & stat.S_ISVTX, True
            )
        else:
            ks = "?---------"
        # compute display date
        if (self.st_mtime is None) or (self.st_mtime == xffffffff):
            # shouldn't really happen
            datestr = "(unknown date)"
        else:
            time_tuple = time.localtime(self.st_mtime)
            if abs(time.time() - self.st_mtime) > 15_552_000:
                # (15,552,000s = 6 months)
                datestr = time.strftime("%d %b %Y", time_tuple)
            else:
                datestr = time.strftime("%d %b %H:%M", time_tuple)
        filename = getattr(self, "filename", "?")

# not all servers support uid/gid
        uid = self.st_uid
        gid = self.st_gid
        size = self.st_size
        if uid is None:
            uid = 0
        if gid is None:
            gid = 0
        if size is None:
            size = 0

# TODO: not sure this actually worked as expected beforehand, leaving
        # it untouched for the time being, re: .format() upgrade, until someone
        # has time to doublecheck
        return "%s   1 %-8d %-8d %8d %-12s %s" % (
            ks,
            uid,
            gid,
            size,
            datestr,
            filename,
        )

def asbytes(self):
        return str(self).encode()

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📁 __pycache__/	DIR	—	2025-03-14 05:12
📄 __init__.py	PY	4.3 KB	2025-03-14 05:12	EDIT
📄 _version.py	PY	80 B	2025-03-14 05:12	EDIT
📄 _winapi.py	PY	10.9 KB	2025-03-14 05:12	EDIT
📄 agent.py	PY	15.5 KB	2025-03-14 05:12	EDIT
📄 auth_handler.py	PY	42 KB	2025-03-14 05:12	EDIT
📄 auth_strategy.py	PY	11.2 KB	2025-03-14 05:12	EDIT
📄 ber.py	PY	4.3 KB	2025-03-14 05:12	EDIT
📄 buffered_pipe.py	PY	7.1 KB	2025-03-14 05:12	EDIT
📄 channel.py	PY	48.1 KB	2025-03-14 05:12	EDIT
📄 client.py	PY	33.7 KB	2025-03-14 05:12	EDIT
📄 common.py	PY	7.6 KB	2025-03-14 05:12	EDIT
📄 compress.py	PY	1.3 KB	2025-03-14 05:12	EDIT
📄 config.py	PY	26.7 KB	2025-03-14 05:12	EDIT
📄 dsskey.py	PY	8.1 KB	2025-03-14 05:12	EDIT
📄 ecdsakey.py	PY	11.4 KB	2025-03-14 05:12	EDIT
📄 ed25519key.py	PY	7.3 KB	2025-03-14 05:12	EDIT
📄 file.py	PY	18.6 KB	2025-03-14 05:12	EDIT
📄 hostkeys.py	PY	12.9 KB	2025-03-14 05:12	EDIT
📄 kex_curve25519.py	PY	4.3 KB	2025-03-14 05:12	EDIT
📄 kex_ecdh_nist.py	PY	4.9 KB	2025-03-14 05:12	EDIT
📄 kex_gex.py	PY	10.1 KB	2025-03-14 05:12	EDIT
📄 kex_group1.py	PY	5.6 KB	2025-03-14 05:12	EDIT
📄 kex_group14.py	PY	1.8 KB	2025-03-14 05:12	EDIT
📄 kex_group16.py	PY	2.2 KB	2025-03-14 05:12	EDIT
📄 kex_gss.py	PY	24 KB	2025-03-14 05:12	EDIT
📄 message.py	PY	9.1 KB	2025-03-14 05:12	EDIT
📄 packet.py	PY	23.7 KB	2025-03-14 05:12	EDIT
📄 pipe.py	PY	3.8 KB	2025-03-14 05:12	EDIT
📄 pkey.py	PY	36 KB	2025-03-14 05:12	EDIT
📄 primes.py	PY	5 KB	2025-03-14 05:12	EDIT
📄 proxy.py	PY	4.5 KB	2025-03-14 05:12	EDIT
📄 rsakey.py	PY	7.4 KB	2025-03-14 05:12	EDIT
📄 server.py	PY	29.7 KB	2025-03-14 05:12	EDIT
📄 sftp.py	PY	6.3 KB	2025-03-14 05:12	EDIT
📄 sftp_attr.py	PY	8.1 KB	2025-03-14 05:12	EDIT
📄 sftp_client.py	PY	35 KB	2025-03-14 05:12	EDIT
📄 sftp_file.py	PY	21.3 KB	2025-03-14 05:12	EDIT
📄 sftp_handle.py	PY	7.3 KB	2025-03-14 05:12	EDIT
📄 sftp_server.py	PY	19 KB	2025-03-14 05:12	EDIT
📄 sftp_si.py	PY	12.3 KB	2025-03-14 05:12	EDIT
📄 ssh_exception.py	PY	7.3 KB	2025-03-14 05:12	EDIT
📄 ssh_gss.py	PY	28.2 KB	2025-03-14 05:12	EDIT
📄 transport.py	PY	132.5 KB	2025-03-14 05:12	EDIT
📄 util.py	PY	9.3 KB	2025-03-14 05:12	EDIT
📄 win_openssh.py	PY	1.9 KB	2025-03-14 05:12	EDIT
📄 win_pageant.py	PY	4.1 KB	2025-03-14 05:12	EDIT