UncountablePythonSDK 0.0.69__tar.gz → 0.0.71__tar.gz

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: UncountablePythonSDK
-Version: 0.0.69
+Version: 0.0.71
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git
@@ -35,6 +35,8 @@ Requires-Dist: paramiko==3.*
 Requires-Dist: boto3==1.*
 Requires-Dist: flask==3.*
 Requires-Dist: simplejson==3.*
+Requires-Dist: grpcio==1.*
+Requires-Dist: protobuf==4.*
 Provides-Extra: test
 Requires-Dist: mypy==1.*; extra == "test"
 Requires-Dist: ruff==0.*; extra == "test"

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/UncountablePythonSDK.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: UncountablePythonSDK
-Version: 0.0.69
+Version: 0.0.71
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git
@@ -35,6 +35,8 @@ Requires-Dist: paramiko==3.*
 Requires-Dist: boto3==1.*
 Requires-Dist: flask==3.*
 Requires-Dist: simplejson==3.*
+Requires-Dist: grpcio==1.*
+Requires-Dist: protobuf==4.*
 Provides-Extra: test
 Requires-Dist: mypy==1.*; extra == "test"
 Requires-Dist: ruff==0.*; extra == "test"

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/UncountablePythonSDK.egg-info/SOURCES.txt

@@ -1,5 +1,4 @@
 .gitignore
-Dockerfile.testing
 README.md
 pyproject.toml
 .github/workflows/documentation.yml
@@ -107,10 +106,29 @@ uncountable/integration/server.py
 uncountable/integration/telemetry.py
 uncountable/integration/db/__init__.py
 uncountable/integration/db/connect.py
+uncountable/integration/db/session.py
 uncountable/integration/executors/__init__.py
 uncountable/integration/executors/executors.py
 uncountable/integration/executors/generic_upload_executor.py
 uncountable/integration/executors/script_executor.py
+uncountable/integration/queue_runner/__init__.py
+uncountable/integration/queue_runner/job_scheduler.py
+uncountable/integration/queue_runner/queue_runner.py
+uncountable/integration/queue_runner/types.py
+uncountable/integration/queue_runner/worker.py
+uncountable/integration/queue_runner/command_server/__init__.py
+uncountable/integration/queue_runner/command_server/command_client.py
+uncountable/integration/queue_runner/command_server/command_server.py
+uncountable/integration/queue_runner/command_server/types.py
+uncountable/integration/queue_runner/command_server/protocol/__init__.py
+uncountable/integration/queue_runner/command_server/protocol/command_server.proto
+uncountable/integration/queue_runner/command_server/protocol/command_server_pb2.py
+uncountable/integration/queue_runner/command_server/protocol/command_server_pb2.pyi
+uncountable/integration/queue_runner/command_server/protocol/command_server_pb2_grpc.py
+uncountable/integration/queue_runner/datastore/__init__.py
+uncountable/integration/queue_runner/datastore/datastore_sqlite.py
+uncountable/integration/queue_runner/datastore/interface.py
+uncountable/integration/queue_runner/datastore/model.py
 uncountable/integration/secret_retrieval/__init__.py
 uncountable/integration/secret_retrieval/retrieve_secret.py
 uncountable/integration/webhook_server/entrypoint.py
@@ -159,6 +177,8 @@ uncountable/types/phases.py
 uncountable/types/phases_t.py
 uncountable/types/post_base.py
 uncountable/types/post_base_t.py
+uncountable/types/queued_job.py
+uncountable/types/queued_job_t.py
 uncountable/types/recipe_identifiers.py
 uncountable/types/recipe_identifiers_t.py
 uncountable/types/recipe_inputs.py

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/UncountablePythonSDK.egg-info/requires.txt

@@ -17,6 +17,8 @@ paramiko==3.*
 boto3==1.*
 flask==3.*
 simplejson==3.*
+grpcio==1.*
+protobuf==4.*
 
 [test]
 mypy==1.*

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/examples/integration-server/jobs/materials_auto/example_cron.py

@@ -1,11 +1,11 @@
-from uncountable.integration.job import CronJob, CronJobArguments, register_job
+from uncountable.integration.job import CronJob, JobArguments, register_job
 from uncountable.types import entity_t
 from uncountable.types.job_definition_t import JobResult
 
 
 @register_job
 class MyCronJob(CronJob):
-    def run(self, args: CronJobArguments) -> JobResult:
+    def run(self, args: JobArguments) -> JobResult:
         matfam = args.client.get_entities_data(
             entity_ids=[1],
             entity_type=entity_t.EntityType.MATERIAL_FAMILY,

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/pyproject.toml

@@ -67,7 +67,9 @@ dependencies = [
     "paramiko == 3.*",
     "boto3 == 1.*",
     "flask == 3.*",
-    "simplejson == 3.*"
+    "simplejson == 3.*",
+    "grpcio == 1.*",
+    "protobuf == 4.*"
 ]
 dynamic = ["version"]
 

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/uncountable/core/environment.py

@@ -17,7 +17,11 @@ def get_integration_env() -> str | None:
 
 
 def get_webhook_server_port() -> int:
-    return int(os.environ.get("UNC_WEBHOOK_SERVER_PORT") or 5001)
+    return int(os.environ.get("UNC_WEBHOOK_SERVER_PORT", 5001))
+
+
+def get_local_admin_server_port() -> int:
+    return int(os.environ.get("UNC_ADMIN_SERVER_PORT", 50051))
 
 
 def get_otel_enabled() -> bool:

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/uncountable/integration/cli.py

@@ -58,6 +58,7 @@ def main() -> None:
                             client=client,
                             batch_processor=batch_processor,
                             logger=job_logger,
+                            payload=None,
                         )
                         job_result = execute_job(
                             job_definition=job,

uncountablepythonsdk-0.0.71/uncountable/integration/cron.py

@@ -0,0 +1,29 @@
+from dataclasses import dataclass
+
+from pkgs.argument_parser import CachedParser
+from uncountable.core.environment import get_local_admin_server_port
+from uncountable.integration.queue_runner.command_server.command_client import (
+    send_job_queue_message,
+)
+from uncountable.types import queued_job_t
+from uncountable.types.job_definition_t import JobDefinition, ProfileMetadata
+
+
+@dataclass
+class CronJobArgs:
+    definition: JobDefinition
+    profile_metadata: ProfileMetadata
+
+
+cron_args_parser = CachedParser(CronJobArgs)
+
+
+def cron_job_executor(**kwargs: dict) -> None:
+    args_passed = cron_args_parser.parse_storage(kwargs)
+    send_job_queue_message(
+        job_ref_name=args_passed.definition.id,
+        payload=queued_job_t.QueuedJobPayload(
+            invocation_context=queued_job_t.InvocationContextCron()
+        ),
+        port=get_local_admin_server_port(),
+    )

uncountablepythonsdk-0.0.71/uncountable/integration/db/connect.py

@@ -0,0 +1,18 @@
+import os
+from enum import StrEnum
+
+from sqlalchemy import create_engine
+from sqlalchemy.engine.base import Engine
+
+
+class IntegrationDBService(StrEnum):
+    CRON = "cron"
+    RUNNER = "runner"
+
+
+def create_db_engine(service: IntegrationDBService) -> Engine:
+    match service:
+        case IntegrationDBService.CRON:
+            return create_engine(os.environ["UNC_CRON_SQLITE_URI"])
+        case IntegrationDBService.RUNNER:
+            return create_engine(os.environ["UNC_RUNNER_SQLITE_URI"])

uncountablepythonsdk-0.0.71/uncountable/integration/db/session.py

@@ -0,0 +1,25 @@
+from contextlib import _GeneratorContextManager, contextmanager
+from typing import Callable, Generator
+
+from sqlalchemy.engine import Engine
+from sqlalchemy.orm import Session, sessionmaker
+
+DBSessionMaker = Callable[[], _GeneratorContextManager[Session]]
+
+
+def get_session_maker(engine: Engine) -> DBSessionMaker:
+    session_maker = sessionmaker(bind=engine)
+
+    @contextmanager
+    def session_manager() -> Generator[Session, None, None]:
+        session = session_maker()
+        try:
+            yield session
+            session.commit()
+        except Exception:
+            session.rollback()
+            raise
+        finally:
+            session.close()
+
+    return session_manager

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/uncountable/integration/entrypoint.py

@@ -1,10 +1,10 @@
-from uncountable.integration.db.connect import create_db_engine
+from uncountable.integration.db.connect import IntegrationDBService, create_db_engine
 from uncountable.integration.scan_profiles import load_profiles
 from uncountable.integration.server import IntegrationServer
 
 
-def main(blocking: bool) -> None:
-    with IntegrationServer(create_db_engine()) as server:
+def main() -> None:
+    with IntegrationServer(create_db_engine(IntegrationDBService.CRON)) as server:
         for profile_details in load_profiles():
             server.register_profile(
                 profile_name=profile_details.name,
@@ -14,8 +14,8 @@ def main(blocking: bool) -> None:
                 client_options=profile_details.definition.client_options,
             )
 
-        if blocking:
-            server.serve_forever()
+        server.serve_forever()
 
 
-main(__name__ == "__main__")
+if __name__ == "__main__":
+    main()

{uncountablepythonsdk-0.0.69 → uncountablepythonsdk-0.0.71}/uncountable/integration/executors/generic_upload_executor.py

@@ -165,7 +165,7 @@ def _move_files_post_upload(
     filesystem_session.move_files([*success_file_transfers, *failed_file_transfers])
 
 
-class GenericUploadJob(Job):
+class GenericUploadJob(Job[None]):
     def __init__(
         self,
         data_source: GenericUploadDataSource,
@@ -177,6 +177,10 @@ class GenericUploadJob(Job):
         self.upload_strategy = upload_strategy
         self.data_source = data_source
 
+    @property
+    def payload_type(self) -> type[None]:
+        return type(None)
+
     def _construct_filesystem_session(self, args: JobArguments) -> FileSystemSession:
         match self.data_source:
             case GenericUploadDataSourceSFTP():

uncountablepythonsdk-0.0.71/uncountable/integration/job.py

@@ -0,0 +1,87 @@
+import functools
+import typing
+from abc import ABC, abstractmethod
+from dataclasses import dataclass
+
+from pkgs.argument_parser import CachedParser
+from uncountable.core.async_batch import AsyncBatchProcessor
+from uncountable.core.client import Client
+from uncountable.integration.telemetry import JobLogger
+from uncountable.types import base_t, webhook_job_t
+from uncountable.types.job_definition_t import JobDefinition, JobResult, ProfileMetadata
+
+
+@dataclass(kw_only=True)
+class JobArguments:
+    job_definition: JobDefinition
+    profile_metadata: ProfileMetadata
+    client: Client
+    batch_processor: AsyncBatchProcessor
+    logger: JobLogger
+    payload: base_t.JsonValue
+
+
+# only for compatibility:
+CronJobArguments = JobArguments
+
+
+PT = typing.TypeVar("PT")
+
+
+class Job(ABC, typing.Generic[PT]):
+    _unc_job_registered: bool = False
+
+    @property
+    @abstractmethod
+    def payload_type(self) -> type[PT]: ...
+
+    @abstractmethod
+    def run_outer(self, args: JobArguments) -> JobResult: ...
+
+    @functools.cached_property
+    def _cached_payload_parser(self) -> CachedParser[PT]:
+        return CachedParser(self.payload_type)
+
+    def get_payload(self, payload: base_t.JsonValue) -> PT:
+        return self._cached_payload_parser.parse_storage(payload)
+
+
+class CronJob(Job):
+    @property
+    def payload_type(self) -> type[None]:
+        return type(None)
+
+    def run_outer(self, args: JobArguments) -> JobResult:
+        assert isinstance(args, CronJobArguments)
+        return self.run(args)
+
+    @abstractmethod
+    def run(self, args: JobArguments) -> JobResult: ...
+
+
+WPT = typing.TypeVar("WPT")
+
+
+class WebhookJob(Job[webhook_job_t.WebhookEventPayload], typing.Generic[WPT]):
+    @property
+    def payload_type(self) -> type[webhook_job_t.WebhookEventPayload]:
+        return webhook_job_t.WebhookEventPayload
+
+    @property
+    @abstractmethod
+    def webhook_payload_type(self) -> type[WPT]: ...
+
+    def run_outer(self, args: JobArguments) -> JobResult:
+        webhook_body = self.get_payload(args.payload)
+        inner_payload = CachedParser(self.webhook_payload_type).parse_api(
+            webhook_body.data
+        )
+        return self.run(args, inner_payload)
+
+    @abstractmethod
+    def run(self, args: JobArguments, payload: WPT) -> JobResult: ...
+
+
+def register_job(cls: type[Job]) -> type[Job]:
+    cls._unc_job_registered = True
+    return cls

uncountablepythonsdk-0.0.71/uncountable/integration/queue_runner/command_server/__init__.py

@@ -0,0 +1,24 @@
+from .command_client import check_health, send_job_queue_message
+from .command_server import serve
+from .types import (
+    CommandEnqueueJob,
+    CommandEnqueueJobResponse,
+    CommandQueue,
+    CommandServerBadResponse,
+    CommandServerException,
+    CommandServerTimeout,
+    CommandTask,
+)
+
+__all__: list[str] = [
+    "serve",
+    "check_health",
+    "send_job_queue_message",
+    "CommandEnqueueJob",
+    "CommandEnqueueJobResponse",
+    "CommandTask",
+    "CommandQueue",
+    "CommandServerTimeout",
+    "CommandServerException",
+    "CommandServerBadResponse",
+]

uncountablepythonsdk-0.0.71/uncountable/integration/queue_runner/command_server/command_client.py

@@ -0,0 +1,68 @@
+from contextlib import contextmanager
+from typing import Generator
+
+import grpc
+import simplejson as json
+
+from pkgs.serialization_util import serialize_for_api
+from uncountable.integration.queue_runner.command_server.protocol.command_server_pb2 import (
+    CheckHealthRequest,
+    CheckHealthResult,
+    EnqueueJobRequest,
+    EnqueueJobResult,
+)
+from uncountable.integration.queue_runner.command_server.types import (
+    CommandServerBadResponse,
+    CommandServerTimeout,
+)
+from uncountable.types import queued_job_t
+
+from .protocol.command_server_pb2_grpc import CommandServerStub
+
+_LOCAL_RPC_HOST = "localhost"
+_DEFAULT_MESSAGE_TIMEOUT_SECS = 2
+
+
+@contextmanager
+def command_server_connection(
+    host: str, port: int
+) -> Generator[CommandServerStub, None, None]:
+    try:
+        with grpc.insecure_channel(f"{host}:{port}") as channel:
+            stub = CommandServerStub(channel)
+            yield stub
+    except grpc._channel._InactiveRpcError as e:
+        raise CommandServerTimeout() from e
+
+
+def send_job_queue_message(
+    *,
+    job_ref_name: str,
+    payload: queued_job_t.QueuedJobPayload,
+    host: str = "localhost",
+    port: int,
+) -> str:
+    with command_server_connection(host=host, port=port) as stub:
+        request = EnqueueJobRequest(
+            job_ref_name=job_ref_name,
+            serialized_payload=json.dumps(serialize_for_api(payload)),
+        )
+
+        response = stub.EnqueueJob(request, timeout=_DEFAULT_MESSAGE_TIMEOUT_SECS)
+
+        assert isinstance(response, EnqueueJobResult)
+        if not response.successfully_queued:
+            raise CommandServerBadResponse("queue operation was not successful")
+
+        return response.queued_job_uuid
+
+
+def check_health(*, host: str = _LOCAL_RPC_HOST, port: int) -> bool:
+    with command_server_connection(host=host, port=port) as stub:
+        request = CheckHealthRequest()
+
+        response = stub.CheckHealth(request, timeout=_DEFAULT_MESSAGE_TIMEOUT_SECS)
+
+        assert isinstance(response, CheckHealthResult)
+
+        return response.success

uncountablepythonsdk-0.0.71/uncountable/integration/queue_runner/command_server/command_server.py

@@ -0,0 +1,64 @@
+import asyncio
+
+import simplejson as json
+from grpc import aio
+
+from pkgs.argument_parser import CachedParser
+from uncountable.core.environment import get_local_admin_server_port
+from uncountable.integration.queue_runner.command_server.protocol.command_server_pb2 import (
+    CheckHealthRequest,
+    CheckHealthResult,
+    EnqueueJobRequest,
+    EnqueueJobResult,
+)
+from uncountable.integration.queue_runner.command_server.types import (
+    CommandEnqueueJob,
+    CommandEnqueueJobResponse,
+    CommandQueue,
+)
+from uncountable.types import queued_job_t
+
+from .protocol.command_server_pb2_grpc import (
+    CommandServerServicer,
+    add_CommandServerServicer_to_server,
+)
+
+queued_job_payload_parser = CachedParser(queued_job_t.QueuedJobPayload)
+
+
+async def serve(command_queue: CommandQueue) -> None:
+    server = aio.server()
+
+    class CommandServerHandler(CommandServerServicer):
+        async def EnqueueJob(
+            self, request: EnqueueJobRequest, context: aio.ServicerContext
+        ) -> EnqueueJobResult:
+            payload_json = json.loads(request.serialized_payload)
+            payload = queued_job_payload_parser.parse_api(payload_json)
+            response_queue: asyncio.Queue[CommandEnqueueJobResponse] = asyncio.Queue()
+            await command_queue.put(
+                CommandEnqueueJob(
+                    job_ref_name=request.job_ref_name,
+                    payload=payload,
+                    response_queue=response_queue,
+                )
+            )
+            response = await response_queue.get()
+            result = EnqueueJobResult(
+                successfully_queued=True, queued_job_uuid=response.queued_job_uuid
+            )
+            return result
+
+        async def CheckHealth(
+            self, request: CheckHealthRequest, context: aio.ServicerContext
+        ) -> CheckHealthResult:
+            return CheckHealthResult(success=True)
+
+    add_CommandServerServicer_to_server(CommandServerHandler(), server)
+
+    listen_addr = f"[::]:{get_local_admin_server_port()}"
+
+    server.add_insecure_port(listen_addr)
+
+    await server.start()
+    await server.wait_for_termination()

uncountablepythonsdk-0.0.71/uncountable/integration/queue_runner/command_server/protocol/command_server.proto

@@ -0,0 +1,22 @@
+syntax = "proto3";
+
+service CommandServer {
+	rpc EnqueueJob(EnqueueJobRequest) returns (EnqueueJobResult) {}
+	rpc CheckHealth(CheckHealthRequest) returns (CheckHealthResult) {}
+}
+
+message EnqueueJobRequest {
+	string job_ref_name = 1;
+	string serialized_payload = 2;
+}
+
+message EnqueueJobResult {
+	bool successfully_queued = 1;
+	string queued_job_uuid = 2;
+}
+
+message CheckHealthRequest {}
+
+message CheckHealthResult {
+	bool success = 1;
+}

uncountablepythonsdk-0.0.71/uncountable/integration/queue_runner/command_server/protocol/command_server_pb2.py

@@ -0,0 +1,40 @@
+# ruff: noqa
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: uncountable/integration/queue_runner/command_server/protocol/command_server.proto
+# Protobuf Python Version: 4.25.1
+"""Generated protocol buffer code."""
+
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(
+    b'\nQuncountable/integration/queue_runner/command_server/protocol/command_server.proto"E\n\x11\x45nqueueJobRequest\x12\x14\n\x0cjob_ref_name\x18\x01 \x01(\t\x12\x1a\n\x12serialized_payload\x18\x02 \x01(\t"H\n\x10\x45nqueueJobResult\x12\x1b\n\x13successfully_queued\x18\x01 \x01(\x08\x12\x17\n\x0fqueued_job_uuid\x18\x02 \x01(\t"\x14\n\x12\x43heckHealthRequest"$\n\x11\x43heckHealthResult\x12\x0f\n\x07success\x18\x01 \x01(\x08\x32\x80\x01\n\rCommandServer\x12\x35\n\nEnqueueJob\x12\x12.EnqueueJobRequest\x1a\x11.EnqueueJobResult"\x00\x12\x38\n\x0b\x43heckHealth\x12\x13.CheckHealthRequest\x1a\x12.CheckHealthResult"\x00\x62\x06proto3'
+)
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(
+    DESCRIPTOR,
+    "uncountable.integration.queue_runner.command_server.protocol.command_server_pb2",
+    _globals,
+)
+if _descriptor._USE_C_DESCRIPTORS == False:
+    DESCRIPTOR._options = None
+    _globals["_ENQUEUEJOBREQUEST"]._serialized_start = 85
+    _globals["_ENQUEUEJOBREQUEST"]._serialized_end = 154
+    _globals["_ENQUEUEJOBRESULT"]._serialized_start = 156
+    _globals["_ENQUEUEJOBRESULT"]._serialized_end = 228
+    _globals["_CHECKHEALTHREQUEST"]._serialized_start = 230
+    _globals["_CHECKHEALTHREQUEST"]._serialized_end = 250
+    _globals["_CHECKHEALTHRESULT"]._serialized_start = 252
+    _globals["_CHECKHEALTHRESULT"]._serialized_end = 288
+    _globals["_COMMANDSERVER"]._serialized_start = 291
+    _globals["_COMMANDSERVER"]._serialized_end = 419
+# @@protoc_insertion_point(module_scope)

uncountablepythonsdk-0.0.71/uncountable/integration/queue_runner/command_server/protocol/command_server_pb2.pyi

@@ -0,0 +1,38 @@
+# ruff: noqa
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class EnqueueJobRequest(_message.Message):
+    __slots__ = ("job_ref_name", "serialized_payload")
+    JOB_REF_NAME_FIELD_NUMBER: _ClassVar[int]
+    SERIALIZED_PAYLOAD_FIELD_NUMBER: _ClassVar[int]
+    job_ref_name: str
+    serialized_payload: str
+    def __init__(
+        self,
+        job_ref_name: _Optional[str] = ...,
+        serialized_payload: _Optional[str] = ...,
+    ) -> None: ...
+
+class EnqueueJobResult(_message.Message):
+    __slots__ = ("successfully_queued", "queued_job_uuid")
+    SUCCESSFULLY_QUEUED_FIELD_NUMBER: _ClassVar[int]
+    QUEUED_JOB_UUID_FIELD_NUMBER: _ClassVar[int]
+    successfully_queued: bool
+    queued_job_uuid: str
+    def __init__(
+        self, successfully_queued: bool = ..., queued_job_uuid: _Optional[str] = ...
+    ) -> None: ...
+
+class CheckHealthRequest(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class CheckHealthResult(_message.Message):
+    __slots__ = ("success",)
+    SUCCESS_FIELD_NUMBER: _ClassVar[int]
+    success: bool
+    def __init__(self, success: bool = ...) -> None: ...