SWAMPy

✎ CARVE FLESH

EDITING: common.py

# -*- test-case-name: twisted.conch.test.test_ssh -*-
# Copyright (c) Twisted Matrix Laboratories.
# See LICENSE for details.

"""
Common functions for the SSH classes.

Maintainer: Paul Swartz
"""

import struct

from cryptography.utils import int_to_bytes

from twisted.python.deprecate import deprecated
from twisted.python.versions import Version

__all__ = ["NS", "getNS", "MP", "getMP", "ffs"]

def NS(t):
    """
    net string
    """
    if isinstance(t, str):
        t = t.encode("utf-8")
    return struct.pack("!L", len(t)) + t

def getNS(s, count=1):
    """
    get net string
    """
    ns = []
    c = 0
    for i in range(count):
        (l,) = struct.unpack("!L", s[c : c + 4])
        ns.append(s[c + 4 : 4 + l + c])
        c += 4 + l
    return tuple(ns) + (s[c:],)

def MP(number):
    if number == 0:
        return b"\000" * 4
    assert number > 0
    bn = int_to_bytes(number)
    if ord(bn[0:1]) & 128:
        bn = b"\000" + bn
    return struct.pack(">L", len(bn)) + bn

def getMP(data, count=1):
    """
    Get multiple precision integer out of the string.  A multiple precision
    integer is stored as a 4-byte length followed by length bytes of the
    integer.  If count is specified, get count integers out of the string.
    The return value is a tuple of count integers followed by the rest of
    the data.
    """
    mp = []
    c = 0
    for i in range(count):
        (length,) = struct.unpack(">L", data[c : c + 4])
        mp.append(int.from_bytes(data[c + 4 : c + 4 + length], "big"))
        c += 4 + length
    return tuple(mp) + (data[c:],)

def ffs(c, s):
    """
    first from second
    goes through the first list, looking for items in the second, returns the first one
    """
    for i in c:
        if i in s:
            return i

@deprecated(Version("Twisted", 16, 5, 0))
def install():
    # This used to install gmpy, but is technically public API, so just do
    # nothing.
    pass

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📁 __pycache__/	DIR	—	2026-06-05 06:59
📄 __init__.py	PY	182 B	2026-05-22 14:58	EDIT
📄 _kex.py	PY	8.4 KB	2026-05-22 14:58	EDIT
📄 address.py	PY	1.1 KB	2026-05-22 14:58	EDIT
📄 agent.py	PY	9.3 KB	2026-05-22 14:58	EDIT
📄 channel.py	PY	9.7 KB	2026-05-22 14:58	EDIT
📄 common.py	PY	1.9 KB	2026-05-22 14:58	EDIT
📄 connection.py	PY	25 KB	2026-05-22 14:58	EDIT
📄 factory.py	PY	4.1 KB	2026-05-22 14:58	EDIT
📄 filetransfer.py	PY	37.2 KB	2026-05-22 14:58	EDIT
📄 forwarding.py	PY	8 KB	2026-05-22 14:58	EDIT
📄 keys.py	PY	62.4 KB	2026-05-22 14:58	EDIT
📄 service.py	PY	1.5 KB	2026-05-22 14:58	EDIT
📄 session.py	PY	13.3 KB	2026-05-22 14:58	EDIT
📄 sexpy.py	PY	944 B	2026-05-22 14:58	EDIT
📄 transport.py	PY	80 KB	2026-05-22 14:58	EDIT
📄 userauth.py	PY	27.1 KB	2026-05-22 14:58	EDIT