Fix docstrings in stub file

This commit is contained in:
Erik Johnston
2026-05-27 16:24:11 +01:00
parent 06b933698f
commit 3e4b11e7f6
+33 -33
View File
@@ -161,60 +161,60 @@ class Signatures:
"""A class representing the signatures on an event."""
def __init__(self, signatures: Mapping[str, Mapping[str, str]] | None = None): ...
def get_signature(self, server_name: str, key_id: str) -> str | None: ...
"""Get the signature for the given server name and key ID, if it exists."""
def get_signature(self, server_name: str, key_id: str) -> str | None:
"""Get the signature for the given server name and key ID, if it exists."""
def __getitem__(self, server_name: str) -> Mapping[str, str]: ...
"""Get the signatures for the given server name. Raises KeyError if there
are no signatures for that server."""
def __getitem__(self, server_name: str) -> Mapping[str, str]:
"""Get the signatures for the given server name. Raises KeyError if there
are no signatures for that server."""
def __contains__(self, server_name: Any) -> bool: ...
"""Check if there are signatures for the given server name."""
def __contains__(self, server_name: Any) -> bool:
"""Check if there are signatures for the given server name."""
def __len__(self) -> int: ...
"""Return the number of servers that have signatures."""
def __len__(self) -> int:
"""Return the number of servers that have signatures."""
def add_signature(self, server_name: str, key_id: str, signature: str) -> None: ...
"""Add a signature for the given server name and key ID."""
def add_signature(self, server_name: str, key_id: str, signature: str) -> None:
"""Add a signature for the given server name and key ID."""
def update(self, signatures: Mapping[str, Mapping[str, str]]) -> None: ...
"""Update the signatures with the given signatures.
def update(self, signatures: Mapping[str, Mapping[str, str]]) -> None:
"""Update the signatures with the given signatures.
Will overwrite all existing signatures for the server names provided.
"""
Will overwrite all existing signatures for the server names provided.
"""
def as_dict(self) -> dict[str, dict[str, str]]: ...
"""Return a copy of the signatures as a dictionary."""
def as_dict(self) -> dict[str, dict[str, str]]:
"""Return a copy of the signatures as a dictionary."""
class Unsigned:
"""A class representing the unsigned data of an event."""
def __init__(self, unsigned_dict: JsonMapping): ...
def __getitem__(self, key: str) -> Any: ...
"""Get the value for the given key.
def __getitem__(self, key: str) -> Any:
"""Get the value for the given key.
Raises KeyError if the key is unset or not recognised."""
Raises KeyError if the key is unset or not recognised."""
def __setitem__(self, key: str, value: Any) -> None: ...
"""Set the value for the given key.
def __setitem__(self, key: str, value: Any) -> None:
"""Set the value for the given key.
Raises KeyError if the key is not recognised."""
Raises KeyError if the key is not recognised."""
def __delitem__(self, key: str) -> None: ...
"""Delete the value for the given key.
def __delitem__(self, key: str) -> None:
"""Delete the value for the given key.
Raises KeyError if the key is unset or not recognised."""
Raises KeyError if the key is unset or not recognised."""
def __contains__(self, key: Any) -> bool: ...
def get(self, key: str, default: Any = None) -> Any: ...
"""Get the value for the given key, or ``default`` if the key is unset."""
def get(self, key: str, default: Any = None) -> Any:
"""Get the value for the given key, or ``default`` if the key is unset."""
def for_persistence(self) -> JsonDict: ...
"""Return a dict of the fields that should be persisted to the database."""
def for_persistence(self) -> JsonDict:
"""Return a dict of the fields that should be persisted to the database."""
def for_event(self) -> JsonDict: ...
"""Return a dict of all unsigned fields, including those only kept in
memory, suitable for inclusion in an event."""
def for_event(self) -> JsonDict:
"""Return a dict of all unsigned fields, including those only kept in
memory, suitable for inclusion in an event."""
class JsonObject(Mapping[str, Any]):
"""Immutable JSON object mapping."""