Gecko [ tsuru-no-tsurugi.tokyo ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2026-06-05 06:15
_pydoctortemplates	[ DIR ]	drwxr-xr-x	2026-06-05 06:15
test	[ DIR ]	drwxr-xr-x	2026-06-05 06:15
__init__.py	598 B	-rw-r--r--	2022-02-07 22:12
_appdirs.py	820 B	-rw-r--r--	2022-02-07 22:12
_inotify.py	3.41 KB	-rw-r--r--	2022-02-07 22:12
_pydoctor.py	6.58 KB	-rw-r--r--	2022-02-07 22:12
_release.py	18.44 KB	-rw-r--r--	2022-02-07 22:12
_shellcomp.py	24.69 KB	-rw-r--r--	2022-02-07 22:12
_textattributes.py	8.88 KB	-rw-r--r--	2022-02-07 22:12
_tzhelper.py	3.05 KB	-rw-r--r--	2022-02-07 22:12
_url.py	228 B	-rw-r--r--	2022-02-07 22:12
compat.py	16.53 KB	-rw-r--r--	2022-02-07 22:12
components.py	13.87 KB	-rw-r--r--	2022-02-07 22:12
constants.py	513 B	-rw-r--r--	2022-02-07 22:12
context.py	3.96 KB	-rw-r--r--	2022-02-07 22:12
deprecate.py	27.02 KB	-rw-r--r--	2022-02-07 22:12
failure.py	26.37 KB	-rw-r--r--	2022-02-07 22:12
fakepwd.py	6.57 KB	-rw-r--r--	2022-02-07 22:12
filepath.py	52.76 KB	-rw-r--r--	2022-02-07 22:12
formmethod.py	11.82 KB	-rw-r--r--	2022-02-07 22:12
htmlizer.py	3.54 KB	-rw-r--r--	2022-02-07 22:12
lockfile.py	7.84 KB	-rw-r--r--	2022-02-07 22:12
log.py	21.78 KB	-rw-r--r--	2022-02-07 22:12
logfile.py	9.88 KB	-rw-r--r--	2022-02-07 22:12
modules.py	26.09 KB	-rw-r--r--	2022-02-07 22:12
monkey.py	2.11 KB	-rw-r--r--	2022-02-07 22:12
procutils.py	1.34 KB	-rw-r--r--	2022-02-07 22:12
randbytes.py	3.38 KB	-rw-r--r--	2022-02-07 22:12
rebuild.py	6.96 KB	-rw-r--r--	2022-02-07 22:12
reflect.py	20 KB	-rw-r--r--	2022-02-07 22:12
release.py	1.08 KB	-rw-r--r--	2022-02-07 22:12
roots.py	7.01 KB	-rw-r--r--	2022-02-07 22:12
runtime.py	5.79 KB	-rw-r--r--	2022-02-07 22:12
sendmsg.py	2.62 KB	-rw-r--r--	2022-02-07 22:12
shortcut.py	2.25 KB	-rw-r--r--	2022-02-07 22:12
syslog.py	3.57 KB	-rw-r--r--	2022-02-07 22:12
systemd.py	2.92 KB	-rw-r--r--	2022-02-07 22:12
text.py	5.29 KB	-rw-r--r--	2022-02-07 22:12
threadable.py	3.25 KB	-rw-r--r--	2022-02-07 22:12
threadpool.py	9.96 KB	-rw-r--r--	2022-02-07 22:12
twisted-completion.zsh	1.34 KB	-rw-r--r--	2022-02-07 22:12
url.py	244 B	-rw-r--r--	2022-02-07 22:12
urlpath.py	8.25 KB	-rw-r--r--	2022-02-07 22:12
usage.py	33.77 KB	-rw-r--r--	2022-02-07 22:12
util.py	26.79 KB	-rw-r--r--	2022-02-07 22:12
versions.py	273 B	-rw-r--r--	2022-02-07 22:12
win32.py	4.68 KB	-rw-r--r--	2022-02-07 22:12
zippath.py	8.82 KB	-rw-r--r--	2022-02-07 22:12
zipstream.py	9.45 KB	-rw-r--r--	2022-02-07 22:12

Rename

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

"""
L{twisted.python.fakepwd} provides a fake implementation of the L{pwd} API.
"""

from typing import List

__all__ = ["UserDatabase", "ShadowDatabase"]

class _UserRecord:
    """
    L{_UserRecord} holds the user data for a single user in L{UserDatabase}.
    It corresponds to the C{passwd} structure from the L{pwd} module.
    See that module for attribute documentation.
    """

def __init__(
        self,
        name: str,
        password: str,
        uid: int,
        gid: int,
        gecos: str,
        home: str,
        shell: str,
    ) -> None:
        self.pw_name = name
        self.pw_passwd = password
        self.pw_uid = uid
        self.pw_gid = gid
        self.pw_gecos = gecos
        self.pw_dir = home
        self.pw_shell = shell

def __len__(self) -> int:
        return 7

def __getitem__(self, index):
        return (
            self.pw_name,
            self.pw_passwd,
            self.pw_uid,
            self.pw_gid,
            self.pw_gecos,
            self.pw_dir,
            self.pw_shell,
        )[index]

class UserDatabase:
    """
    L{UserDatabase} holds a traditional POSIX user data in memory and makes it
    available via the same API as L{pwd}.

@ivar _users: A C{list} of L{_UserRecord} instances holding all user data
        added to this database.
    """

_users: List[_UserRecord]

def __init__(self) -> None:
        self._users = []

def addUser(
        self,
        username: str,
        password: str,
        uid: int,
        gid: int,
        gecos: str,
        home: str,
        shell: str,
    ) -> None:
        """
        Add a new user record to this database.

@param username: The value for the C{pw_name} field of the user
            record to add.

@param password: The value for the C{pw_passwd} field of the user
            record to add.

@param uid: The value for the C{pw_uid} field of the user record to
            add.

@param gid: The value for the C{pw_gid} field of the user record to
            add.

@param gecos: The value for the C{pw_gecos} field of the user record
            to add.

@param home: The value for the C{pw_dir} field of the user record to
            add.

@param shell: The value for the C{pw_shell} field of the user record to
            add.
        """
        self._users.append(
            _UserRecord(username, password, uid, gid, gecos, home, shell)
        )

def getpwuid(self, uid: int) -> _UserRecord:
        """
        Return the user record corresponding to the given uid.
        """
        for entry in self._users:
            if entry.pw_uid == uid:
                return entry
        raise KeyError()

def getpwnam(self, name: str) -> _UserRecord:
        """
        Return the user record corresponding to the given username.
        """
        if not isinstance(name, str):
            raise TypeError(f"getpwuam() argument must be str, not {type(name)}")
        for entry in self._users:
            if entry.pw_name == name:
                return entry
        raise KeyError()

def getpwall(self) -> List[_UserRecord]:
        """
        Return a list of all user records.
        """
        return self._users

class _ShadowRecord:
    """
    L{_ShadowRecord} holds the shadow user data for a single user in
    L{ShadowDatabase}.  It corresponds to C{spwd.struct_spwd}.  See that class
    for attribute documentation.
    """

def __init__(
        self,
        username: str,
        password: str,
        lastChange: int,
        min: int,
        max: int,
        warn: int,
        inact: int,
        expire: int,
        flag: int,
    ) -> None:
        self.sp_nam = username
        self.sp_pwd = password
        self.sp_lstchg = lastChange
        self.sp_min = min
        self.sp_max = max
        self.sp_warn = warn
        self.sp_inact = inact
        self.sp_expire = expire
        self.sp_flag = flag

def __len__(self) -> int:
        return 9

def __getitem__(self, index):
        return (
            self.sp_nam,
            self.sp_pwd,
            self.sp_lstchg,
            self.sp_min,
            self.sp_max,
            self.sp_warn,
            self.sp_inact,
            self.sp_expire,
            self.sp_flag,
        )[index]

class ShadowDatabase:
    """
    L{ShadowDatabase} holds a shadow user database in memory and makes it
    available via the same API as C{spwd}.

@ivar _users: A C{list} of L{_ShadowRecord} instances holding all user data
        added to this database.

@since: 12.0
    """

_users: List[_ShadowRecord]

def __init__(self) -> None:
        self._users = []

def addUser(
        self,
        username: str,
        password: str,
        lastChange: int,
        min: int,
        max: int,
        warn: int,
        inact: int,
        expire: int,
        flag: int,
    ) -> None:
        """
        Add a new user record to this database.

@param username: The value for the C{sp_nam} field of the user record to
            add.

@param password: The value for the C{sp_pwd} field of the user record to
            add.

@param lastChange: The value for the C{sp_lstchg} field of the user
            record to add.

@param min: The value for the C{sp_min} field of the user record to add.

@param max: The value for the C{sp_max} field of the user record to add.

@param warn: The value for the C{sp_warn} field of the user record to
            add.

@param inact: The value for the C{sp_inact} field of the user record to
            add.

@param expire: The value for the C{sp_expire} field of the user record
            to add.

@param flag: The value for the C{sp_flag} field of the user record to
            add.
        """
        self._users.append(
            _ShadowRecord(
                username, password, lastChange, min, max, warn, inact, expire, flag
            )
        )

def getspnam(self, username: str) -> _ShadowRecord:
        """
        Return the shadow user record corresponding to the given username.
        """
        if not isinstance(username, str):
            raise TypeError(f"getspnam() argument must be str, not {type(username)}")
        for entry in self._users:
            if entry.sp_nam == username:
                return entry
        raise KeyError(username)

def getspall(self):
        """
        Return a list of all shadow user records.
        """
        return self._users