wool 0.1rc7__py3-none-any.whl → 0.1rc9__py3-none-any.whl

wool/_mempool/_service.py

@@ -0,0 +1,227 @@
+from __future__ import annotations
+
+import asyncio
+from typing import AsyncGenerator
+from typing import Final
+from weakref import WeakSet
+from weakref import WeakValueDictionary
+
+import shortuuid
+from grpc.aio import ServicerContext
+
+from wool._mempool import MemoryPool
+
+try:
+    from wool._protobuf.mempool import service_pb2 as pb
+    from wool._protobuf.mempool import service_pb2_grpc as rpc
+except ImportError as e:
+    from wool._protobuf import ProtobufImportError
+
+    raise ProtobufImportError(e) from e
+
+
+class _Session:
+    id: Final[str]
+    queue: Final[asyncio.Queue[pb.SessionResponse]]
+    references: Final[set[_Reference]]
+
+    _sessions: Final[WeakValueDictionary[str, _Session]] = (
+        WeakValueDictionary()
+    )
+
+    @classmethod
+    def get(cls, id: str) -> _Session | None:
+        return cls._sessions.get(id)
+
+    def __init__(self):
+        self.id = shortuuid.uuid()
+        self.queue = asyncio.Queue()
+        self.references = set()
+        self._sessions[self.id] = self
+
+    def __eq__(self, other) -> bool:
+        if isinstance(other, _Session):
+            return self.id == other.id
+        return False
+
+    def __hash__(self) -> int:
+        return hash(self.id)
+
+
+class _Reference:
+    id: Final[str]
+    sessions: Final[WeakSet[_Session]]
+
+    _mempool: Final[MemoryPool]
+    _references: Final[WeakValueDictionary[str, _Reference]] = (
+        WeakValueDictionary()
+    )
+    _to_delete: Final[set[str]] = set()
+    _initialized: bool = False
+
+    @classmethod
+    def get(cls, id: str) -> _Reference | None:
+        return cls._references.get(id)
+
+    @classmethod
+    def new(cls, id: str, *, mempool: MemoryPool) -> _Reference:
+        if id in cls._references:
+            raise ValueError(f"Reference {id} already exists")
+        return cls(id, mempool=mempool)
+
+    def __new__(cls, id: str, *, mempool: MemoryPool):
+        if id in cls._references:
+            if id in cls._to_delete:
+                cls._to_delete.remove(id)
+            return cls._references[id]
+        return super().__new__(cls)
+
+    def __init__(self, id: str, *, mempool: MemoryPool):
+        if not self._initialized:
+            self.id = id
+            self.sessions = WeakSet()
+            self._mempool = mempool
+            self._references[id] = self
+            self._initialized = True
+
+    def __eq__(self, other) -> bool:
+        if isinstance(other, _Reference):
+            return self.id == other.id
+        return False
+
+    def __hash__(self) -> int:
+        return hash(self.id)
+
+    def __del__(self):
+        self._to_delete.add(self.id)
+
+        async def _delete(id, to_delete, mempool):
+            if id in to_delete:
+                try:
+                    to_delete.remove(id)
+                    await mempool.delete(id)
+                except FileNotFoundError:
+                    pass
+
+        try:
+            asyncio.get_running_loop().create_task(
+                _delete(self.id, self._to_delete, self._mempool)
+            )
+        except RuntimeError:
+            asyncio.new_event_loop().run_until_complete(
+                _delete(self.id, self._to_delete, self._mempool)
+            )
+
+
+class MemoryPoolService(rpc.MemoryPoolServicer):
+    def __init__(self, mempool: MemoryPool | None = None):
+        self._mempool = mempool or MemoryPool()
+        self._shutdown = asyncio.Event()
+
+    async def session(
+        self, request: pb.SessionRequest, context: ServicerContext
+    ) -> AsyncGenerator[pb.SessionResponse]:
+        session = _Session()
+        yield pb.SessionResponse(session=pb.Session(id=session.id))
+        while True:
+            yield await session.queue.get()
+
+    async def map(
+        self, request: pb.AcquireRequest, context: ServicerContext
+    ) -> pb.AcquireResponse:
+        if not (session := _Session.get(request.session.id)):
+            raise ValueError(f"Session {request.session.id} not found")
+        await self._mempool.map(request.reference.id or None)
+        reference = _Reference(request.reference.id, mempool=self._mempool)
+        await self.acquire(
+            pb.AcquireRequest(
+                session=pb.Session(id=session.id),
+                reference=pb.Reference(id=reference.id),
+            ),
+            context,
+        )
+        return pb.AcquireResponse()
+
+    async def put(
+        self, request: pb.PutRequest, context: ServicerContext
+    ) -> pb.PutResponse:
+        if not (session := _Session.get(request.session.id)):
+            raise ValueError(f"Session {request.session.id} not found")
+        reference = _Reference(
+            id=await self._mempool.put(request.dump, mutable=request.mutable),
+            mempool=self._mempool,
+        )
+        await self.acquire(
+            pb.AcquireRequest(
+                session=pb.Session(id=session.id),
+                reference=pb.Reference(id=reference.id),
+            ),
+            context,
+        )
+        return pb.PutResponse(reference=pb.Reference(id=reference.id))
+
+    async def get(
+        self, request: pb.GetRequest, context: ServicerContext
+    ) -> pb.GetResponse:
+        if not (session := _Session.get(request.session.id)):
+            raise ValueError(f"Session {request.session.id} not found")
+        if _Reference.get(request.reference.id) is None:
+            await self.acquire(
+                pb.AcquireRequest(
+                    session=pb.Session(id=session.id),
+                    reference=pb.Reference(id=request.reference.id),
+                ),
+                context,
+            )
+        dump = await self._mempool.get(request.reference.id)
+        return pb.GetResponse(dump=dump)
+
+    async def post(
+        self, request: pb.PostRequest, context: ServicerContext
+    ) -> pb.PostResponse:
+        if not (session := _Session.get(request.session.id)):
+            raise ValueError(f"Session {request.session.id} not found")
+        if not (reference := _Reference.get(request.reference.id)):
+            raise ValueError(f"Reference {request.reference.id} not found")
+        if reference not in session.references:
+            await self.acquire(
+                pb.AcquireRequest(
+                    session=pb.Session(id=session.id),
+                    reference=pb.Reference(id=reference.id),
+                ),
+                context,
+            )
+        updated = await self._mempool.post(request.reference.id, request.dump)
+        if updated:
+            for session in _Reference(
+                id=request.reference.id, mempool=self._mempool
+            ).sessions:
+                if session.id is not request.session.id:
+                    event = pb.Event(
+                        reference=request.reference,
+                        event_type="post",
+                    )
+                    await session.queue.put(pb.SessionResponse(event=event))
+        return pb.PostResponse(updated=updated)
+
+    async def acquire(
+        self, request: pb.AcquireRequest, context: ServicerContext
+    ) -> pb.AcquireResponse:
+        if not (session := _Session.get(request.session.id)):
+            raise ValueError(f"Session {request.session.id} not found")
+        if not (reference := _Reference.get(request.reference.id)):
+            raise ValueError(f"Reference {request.reference.id} not found")
+        session.references.add(reference)
+        reference.sessions.add(session)
+        return pb.AcquireResponse()
+
+    async def release(
+        self, request: pb.ReleaseRequest, context: ServicerContext
+    ) -> pb.ReleaseResponse:
+        if not (session := _Session.get(request.session.id)):
+            raise ValueError(f"Session {request.session.id} not found")
+        if not (reference := _Reference.get(request.reference.id)):
+            raise ValueError(f"Reference {request.reference.id} not found")
+        session.references.remove(reference)
+        reference.sessions.remove(session)
+        return pb.ReleaseResponse()

wool/_protobuf/__init__.py

@@ -0,0 +1,11 @@
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath(os.path.dirname(__file__)))
+
+
+class ProtobufImportError(ImportError):
+    def __init__(self, exception: ImportError):
+        super().__init__(
+            f"{str(exception)} - ensure protocol buffers are compiled."
+        )

wool/_protobuf/{_mempool/_metadata/_metadata_pb2.py → mempool/metadata_pb2.py}

@@ -1,8 +1,8 @@
 # -*- coding: utf-8 -*-
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
-# source: _mempool/_metadata/_metadata.proto
-# Protobuf Python Version: 6.30.0
+# source: mempool/metadata.proto
+# Protobuf Python Version: 6.31.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,10 +12,10 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     6,
-    30,
+    31,
     0,
     '',
-    '_mempool/_metadata/_metadata.proto'
+    'mempool/metadata.proto'
 )
 # @@protoc_insertion_point(imports)
 
@@ -24,13 +24,13 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\"_mempool/_metadata/_metadata.proto\x12\x17wool._mempool._metadata\"K\n\x10_MetadataMessage\x12\x0b\n\x03ref\x18\x01 \x01(\t\x12\x0f\n\x07mutable\x18\x02 \x01(\x08\x12\x0c\n\x04size\x18\x03 \x01(\x03\x12\x0b\n\x03md5\x18\x04 \x01(\x0c\x62\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x16mempool/metadata.proto\x12\x16wool._protobuf.mempool\"J\n\x0fMetadataMessage\x12\x0b\n\x03ref\x18\x01 \x01(\t\x12\x0f\n\x07mutable\x18\x02 \x01(\x08\x12\x0c\n\x04size\x18\x03 \x01(\x03\x12\x0b\n\x03md5\x18\x04 \x01(\x0c\x62\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
-_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, '_mempool._metadata._metadata_pb2', _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'mempool.metadata_pb2', _globals)
 if not _descriptor._USE_C_DESCRIPTORS:
   DESCRIPTOR._loaded_options = None
-  _globals['__METADATAMESSAGE']._serialized_start=63
-  _globals['__METADATAMESSAGE']._serialized_end=138
+  _globals['_METADATAMESSAGE']._serialized_start=50
+  _globals['_METADATAMESSAGE']._serialized_end=124
 # @@protoc_insertion_point(module_scope)

wool/_protobuf/{_mempool/_metadata/_metadata_pb2.pyi → mempool/metadata_pb2.pyi}

@@ -4,7 +4,7 @@ from typing import ClassVar as _ClassVar, Optional as _Optional
 
 DESCRIPTOR: _descriptor.FileDescriptor
 
-class _MetadataMessage(_message.Message):
+class MetadataMessage(_message.Message):
     __slots__ = ("ref", "mutable", "size", "md5")
     REF_FIELD_NUMBER: _ClassVar[int]
     MUTABLE_FIELD_NUMBER: _ClassVar[int]

wool/_protobuf/mempool/metadata_pb2_grpc.py

@@ -0,0 +1,24 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+
+GRPC_GENERATED_VERSION = '1.73.1'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + f' but the generated code in mempool/metadata_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )

wool/_protobuf/mempool/service_pb2.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: mempool/service.proto
+# Protobuf Python Version: 6.31.0
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    0,
+    '',
+    'mempool/service.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x15mempool/service.proto\x12\x16wool._protobuf.mempool\"\x10\n\x0eSessionRequest\"\x81\x01\n\x0fSessionResponse\x12\x32\n\x07session\x18\x01 \x01(\x0b\x32\x1f.wool._protobuf.mempool.SessionH\x00\x12.\n\x05\x65vent\x18\x02 \x01(\x0b\x32\x1d.wool._protobuf.mempool.EventH\x00\x42\n\n\x08response\"x\n\x0e\x41\x63quireRequest\x12\x34\n\treference\x18\x01 \x01(\x0b\x32!.wool._protobuf.mempool.Reference\x12\x30\n\x07session\x18\x02 \x01(\x0b\x32\x1f.wool._protobuf.mempool.Session\"\x11\n\x0f\x41\x63quireResponse\"]\n\nPutRequest\x12\x30\n\x07session\x18\x01 \x01(\x0b\x32\x1f.wool._protobuf.mempool.Session\x12\x0f\n\x07mutable\x18\x02 \x01(\x08\x12\x0c\n\x04\x64ump\x18\x03 \x01(\x0c\"C\n\x0bPutResponse\x12\x34\n\treference\x18\x01 \x01(\x0b\x32!.wool._protobuf.mempool.Reference\"\x83\x01\n\x0bPostRequest\x12\x30\n\x07session\x18\x01 \x01(\x0b\x32\x1f.wool._protobuf.mempool.Session\x12\x34\n\treference\x18\x02 \x01(\x0b\x32!.wool._protobuf.mempool.Reference\x12\x0c\n\x04\x64ump\x18\x03 \x01(\x0c\"\x1f\n\x0cPostResponse\x12\x0f\n\x07updated\x18\x01 \x01(\x08\"t\n\nGetRequest\x12\x34\n\treference\x18\x01 \x01(\x0b\x32!.wool._protobuf.mempool.Reference\x12\x30\n\x07session\x18\x02 \x01(\x0b\x32\x1f.wool._protobuf.mempool.Session\"\x1b\n\x0bGetResponse\x12\x0c\n\x04\x64ump\x18\x01 \x01(\x0c\"x\n\x0eReleaseRequest\x12\x34\n\treference\x18\x01 \x01(\x0b\x32!.wool._protobuf.mempool.Reference\x12\x30\n\x07session\x18\x02 \x01(\x0b\x32\x1f.wool._protobuf.mempool.Session\"\x11\n\x0fReleaseResponse\"\x17\n\tReference\x12\n\n\x02id\x18\x01 \x01(\t\"\x15\n\x07Session\x12\n\n\x02id\x18\x01 \x01(\t\"Q\n\x05\x45vent\x12\x34\n\treference\x18\x01 \x01(\x0b\x32!.wool._protobuf.mempool.Reference\x12\x12\n\nevent_type\x18\x02 \x01(\t2\xed\x04\n\nMemoryPool\x12\\\n\x07session\x12&.wool._protobuf.mempool.SessionRequest\x1a\'.wool._protobuf.mempool.SessionResponse0\x01\x12Z\n\x07\x61\x63quire\x12&.wool._protobuf.mempool.AcquireRequest\x1a\'.wool._protobuf.mempool.AcquireResponse\x12V\n\x03map\x12&.wool._protobuf.mempool.AcquireRequest\x1a\'.wool._protobuf.mempool.AcquireResponse\x12N\n\x03put\x12\".wool._protobuf.mempool.PutRequest\x1a#.wool._protobuf.mempool.PutResponse\x12Q\n\x04post\x12#.wool._protobuf.mempool.PostRequest\x1a$.wool._protobuf.mempool.PostResponse\x12N\n\x03get\x12\".wool._protobuf.mempool.GetRequest\x1a#.wool._protobuf.mempool.GetResponse\x12Z\n\x07release\x12&.wool._protobuf.mempool.ReleaseRequest\x1a\'.wool._protobuf.mempool.ReleaseResponseb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'mempool.service_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_SESSIONREQUEST']._serialized_start=49
+  _globals['_SESSIONREQUEST']._serialized_end=65
+  _globals['_SESSIONRESPONSE']._serialized_start=68
+  _globals['_SESSIONRESPONSE']._serialized_end=197
+  _globals['_ACQUIREREQUEST']._serialized_start=199
+  _globals['_ACQUIREREQUEST']._serialized_end=319
+  _globals['_ACQUIRERESPONSE']._serialized_start=321
+  _globals['_ACQUIRERESPONSE']._serialized_end=338
+  _globals['_PUTREQUEST']._serialized_start=340
+  _globals['_PUTREQUEST']._serialized_end=433
+  _globals['_PUTRESPONSE']._serialized_start=435
+  _globals['_PUTRESPONSE']._serialized_end=502
+  _globals['_POSTREQUEST']._serialized_start=505
+  _globals['_POSTREQUEST']._serialized_end=636
+  _globals['_POSTRESPONSE']._serialized_start=638
+  _globals['_POSTRESPONSE']._serialized_end=669
+  _globals['_GETREQUEST']._serialized_start=671
+  _globals['_GETREQUEST']._serialized_end=787
+  _globals['_GETRESPONSE']._serialized_start=789
+  _globals['_GETRESPONSE']._serialized_end=816
+  _globals['_RELEASEREQUEST']._serialized_start=818
+  _globals['_RELEASEREQUEST']._serialized_end=938
+  _globals['_RELEASERESPONSE']._serialized_start=940
+  _globals['_RELEASERESPONSE']._serialized_end=957
+  _globals['_REFERENCE']._serialized_start=959
+  _globals['_REFERENCE']._serialized_end=982
+  _globals['_SESSION']._serialized_start=984
+  _globals['_SESSION']._serialized_end=1005
+  _globals['_EVENT']._serialized_start=1007
+  _globals['_EVENT']._serialized_end=1088
+  _globals['_MEMORYPOOL']._serialized_start=1091
+  _globals['_MEMORYPOOL']._serialized_end=1712
+# @@protoc_insertion_point(module_scope)

wool/_protobuf/mempool/service_pb2.pyi

@@ -0,0 +1,108 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class SessionRequest(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class SessionResponse(_message.Message):
+    __slots__ = ("session", "event")
+    SESSION_FIELD_NUMBER: _ClassVar[int]
+    EVENT_FIELD_NUMBER: _ClassVar[int]
+    session: Session
+    event: Event
+    def __init__(self, session: _Optional[_Union[Session, _Mapping]] = ..., event: _Optional[_Union[Event, _Mapping]] = ...) -> None: ...
+
+class AcquireRequest(_message.Message):
+    __slots__ = ("reference", "session")
+    REFERENCE_FIELD_NUMBER: _ClassVar[int]
+    SESSION_FIELD_NUMBER: _ClassVar[int]
+    reference: Reference
+    session: Session
+    def __init__(self, reference: _Optional[_Union[Reference, _Mapping]] = ..., session: _Optional[_Union[Session, _Mapping]] = ...) -> None: ...
+
+class AcquireResponse(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class PutRequest(_message.Message):
+    __slots__ = ("session", "mutable", "dump")
+    SESSION_FIELD_NUMBER: _ClassVar[int]
+    MUTABLE_FIELD_NUMBER: _ClassVar[int]
+    DUMP_FIELD_NUMBER: _ClassVar[int]
+    session: Session
+    mutable: bool
+    dump: bytes
+    def __init__(self, session: _Optional[_Union[Session, _Mapping]] = ..., mutable: bool = ..., dump: _Optional[bytes] = ...) -> None: ...
+
+class PutResponse(_message.Message):
+    __slots__ = ("reference",)
+    REFERENCE_FIELD_NUMBER: _ClassVar[int]
+    reference: Reference
+    def __init__(self, reference: _Optional[_Union[Reference, _Mapping]] = ...) -> None: ...
+
+class PostRequest(_message.Message):
+    __slots__ = ("session", "reference", "dump")
+    SESSION_FIELD_NUMBER: _ClassVar[int]
+    REFERENCE_FIELD_NUMBER: _ClassVar[int]
+    DUMP_FIELD_NUMBER: _ClassVar[int]
+    session: Session
+    reference: Reference
+    dump: bytes
+    def __init__(self, session: _Optional[_Union[Session, _Mapping]] = ..., reference: _Optional[_Union[Reference, _Mapping]] = ..., dump: _Optional[bytes] = ...) -> None: ...
+
+class PostResponse(_message.Message):
+    __slots__ = ("updated",)
+    UPDATED_FIELD_NUMBER: _ClassVar[int]
+    updated: bool
+    def __init__(self, updated: bool = ...) -> None: ...
+
+class GetRequest(_message.Message):
+    __slots__ = ("reference", "session")
+    REFERENCE_FIELD_NUMBER: _ClassVar[int]
+    SESSION_FIELD_NUMBER: _ClassVar[int]
+    reference: Reference
+    session: Session
+    def __init__(self, reference: _Optional[_Union[Reference, _Mapping]] = ..., session: _Optional[_Union[Session, _Mapping]] = ...) -> None: ...
+
+class GetResponse(_message.Message):
+    __slots__ = ("dump",)
+    DUMP_FIELD_NUMBER: _ClassVar[int]
+    dump: bytes
+    def __init__(self, dump: _Optional[bytes] = ...) -> None: ...
+
+class ReleaseRequest(_message.Message):
+    __slots__ = ("reference", "session")
+    REFERENCE_FIELD_NUMBER: _ClassVar[int]
+    SESSION_FIELD_NUMBER: _ClassVar[int]
+    reference: Reference
+    session: Session
+    def __init__(self, reference: _Optional[_Union[Reference, _Mapping]] = ..., session: _Optional[_Union[Session, _Mapping]] = ...) -> None: ...
+
+class ReleaseResponse(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class Reference(_message.Message):
+    __slots__ = ("id",)
+    ID_FIELD_NUMBER: _ClassVar[int]
+    id: str
+    def __init__(self, id: _Optional[str] = ...) -> None: ...
+
+class Session(_message.Message):
+    __slots__ = ("id",)
+    ID_FIELD_NUMBER: _ClassVar[int]
+    id: str
+    def __init__(self, id: _Optional[str] = ...) -> None: ...
+
+class Event(_message.Message):
+    __slots__ = ("reference", "event_type")
+    REFERENCE_FIELD_NUMBER: _ClassVar[int]
+    EVENT_TYPE_FIELD_NUMBER: _ClassVar[int]
+    reference: Reference
+    event_type: str
+    def __init__(self, reference: _Optional[_Union[Reference, _Mapping]] = ..., event_type: _Optional[str] = ...) -> None: ...