koi-net 1.1.0b7__py3-none-any.whl → 1.2.0b1__py3-none-any.whl

koi_net/processor/knowledge_pipeline.py

@@ -1,11 +1,9 @@
 import logging
-from typing import Callable
-from rid_lib.core import RIDType
 from rid_lib.types import KoiNetEdge, KoiNetNode
 from rid_lib.ext import Cache
 from ..protocol.event import EventType
 from ..network.request_handler import RequestHandler
-from ..network.event_queue import NetworkEventQueue
+from ..network.event_queue import EventQueue
 from ..network.graph import NetworkGraph
 from ..identity import NodeIdentity
 from .handler import (
@@ -28,42 +26,26 @@ class KnowledgePipeline:
     cache: Cache
     identity: NodeIdentity
     request_handler: RequestHandler
-    event_queue: NetworkEventQueue
+    event_queue: EventQueue
     graph: NetworkGraph
-    handlers: list[KnowledgeHandler]
+    knowledge_handlers: list[KnowledgeHandler]
     
     def __init__(
         self, 
         handler_context: "HandlerContext",
         cache: Cache, 
         request_handler: RequestHandler,
-        event_queue: NetworkEventQueue,
+        event_queue: EventQueue,
         graph: NetworkGraph,
-        default_handlers: list[KnowledgeHandler] = []
+        knowledge_handlers: list[KnowledgeHandler] = []
     ):
         self.handler_context = handler_context
         self.cache = cache
         self.request_handler = request_handler
         self.event_queue = event_queue
         self.graph = graph
-        self.handlers = default_handlers
+        self.knowledge_handlers = knowledge_handlers
     
-    def add_handler(self, handler: KnowledgeHandler):
-        self.handlers.append(handler)
-            
-    def register_handler(
-        self,
-        handler_type: HandlerType,
-        rid_types: list[RIDType] | None = None,
-        event_types: list[EventType | None] | None = None
-    ):
-        """Assigns decorated function as handler for this processor."""
-        def decorator(func: Callable) -> Callable:
-            handler = KnowledgeHandler(func, handler_type, rid_types, event_types)
-            self.add_handler(handler)
-            return func
-        return decorator
-            
     def call_handler_chain(
         self, 
         handler_type: HandlerType,
@@ -79,7 +61,7 @@ class KnowledgePipeline:
         Handlers will only be called in the chain if their handler and RID type match that of the inputted knowledge object. 
         """
         
-        for handler in self.handlers:
+        for handler in self.knowledge_handlers:
             if handler_type != handler.handler_type: 
                 continue
             
@@ -215,6 +197,5 @@ class KnowledgePipeline:
         
         for node in kobj.network_targets:
             self.event_queue.push_event_to(kobj.normalized_event, node)
-            self.event_queue.flush_webhook_queue(node)
         
         kobj = self.call_handler_chain(HandlerType.Final, kobj)

koi_net/processor/kobj_queue.py

@@ -0,0 +1,51 @@
+import logging
+from queue import Queue
+from rid_lib.core import RID
+from rid_lib.ext import Bundle, Manifest
+from rid_lib.types import KoiNetNode
+from ..protocol.event import Event, EventType
+from .knowledge_object import KnowledgeObject
+
+logger = logging.getLogger(__name__)
+
+
+class KobjQueue:
+    """Provides access to this node's knowledge processing pipeline."""
+    q: Queue[KnowledgeObject]
+    
+    def __init__(self):
+        self.q = Queue()
+                
+    def put_kobj(
+        self,
+        rid: RID | None = None,
+        manifest: Manifest | None = None,
+        bundle: Bundle | None = None,
+        event: Event | None = None,
+        kobj: KnowledgeObject | None = None,
+        event_type: EventType | None = None,
+        source: KoiNetNode | None = None
+    ):
+        """Queues knowledge object to be handled by processing pipeline.
+        
+        Knowledge may take the form of an RID, manifest, bundle, event, 
+        or knowledge object (with an optional event type for RID, 
+        manifest, or bundle objects). All objects will be normalized 
+        to knowledge objects and queued. If `flush` is `True`, the queue 
+        will be flushed immediately after adding the new knowledge.
+        """
+        if rid:
+            _kobj = KnowledgeObject.from_rid(rid, event_type, source)
+        elif manifest:
+            _kobj = KnowledgeObject.from_manifest(manifest, event_type, source)
+        elif bundle:
+            _kobj = KnowledgeObject.from_bundle(bundle, event_type, source)
+        elif event:
+            _kobj = KnowledgeObject.from_event(event, source)
+        elif kobj:
+            _kobj = kobj
+        else:
+            raise ValueError("One of 'rid', 'manifest', 'bundle', 'event', or 'kobj' must be provided")
+        
+        self.q.put(_kobj)
+        logger.debug(f"Queued {_kobj!r}")

koi_net/protocol/api_models.py

@@ -1,4 +1,4 @@
-"""Pydantic models for request and response/payload objects in the KOI-net API."""
+"""Pydantic models for request and response objects in the KOI-net API."""
 
 from typing import Literal
 from pydantic import BaseModel, Field
@@ -59,4 +59,5 @@ class ErrorResponse(BaseModel):
 # TYPES
 
 type RequestModels = EventsPayload | PollEvents | FetchRids | FetchManifests | FetchBundles
-type ResponseModels = RidsPayload | ManifestsPayload | BundlesPayload | EventsPayload | ErrorResponse
+type ResponseModels = RidsPayload | ManifestsPayload | BundlesPayload | EventsPayload | ErrorResponse
+type ApiModels = RequestModels | ResponseModels

koi_net/protocol/node.py

@@ -1,5 +1,5 @@
 from enum import StrEnum
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 from rid_lib import RIDType
 
 
@@ -8,8 +8,8 @@ class NodeType(StrEnum):
     PARTIAL = "PARTIAL"
 
 class NodeProvides(BaseModel):
-    event: list[RIDType] = []
-    state: list[RIDType] = []
+    event: list[RIDType] = Field(default_factory=list)
+    state: list[RIDType] = Field(default_factory=list)
 
 class NodeProfile(BaseModel):
     base_url: str | None = None

koi_net/secure.py

@@ -2,12 +2,13 @@ import logging
 from functools import wraps
 
 import cryptography.exceptions
-from rid_lib.ext import Bundle
+from rid_lib.ext import Bundle, Cache
 from rid_lib.ext.utils import sha256_hash
+from rid_lib.types import KoiNetNode
 from .identity import NodeIdentity
 from .protocol.envelope import UnsignedEnvelope, SignedEnvelope
 from .protocol.secure import PublicKey
-from .protocol.api_models import EventsPayload
+from .protocol.api_models import ApiModels, EventsPayload
 from .protocol.event import EventType
 from .protocol.node import NodeProfile
 from .protocol.secure import PrivateKey
@@ -17,31 +18,32 @@ from .protocol.errors import (
     InvalidSignatureError,
     InvalidTargetError
 )
-from .effector import Effector
 from .config import NodeConfig
 
 logger = logging.getLogger(__name__)
 
 
 class Secure:
+    """Subsystem handling secure protocol logic."""
     identity: NodeIdentity
-    effector: Effector
+    cache: Cache
     config: NodeConfig
     priv_key: PrivateKey
     
     def __init__(
         self, 
         identity: NodeIdentity, 
-        effector: Effector,
+        cache: Cache,
         config: NodeConfig
     ):
         self.identity = identity
-        self.effector = effector
+        self.cache = cache
         self.config = config
 
         self.priv_key = self._load_priv_key()
         
     def _load_priv_key(self) -> PrivateKey:
+        """Loads private key from PEM file path in config."""
         with open(self.config.koi_net.private_key_pem_path, "r") as f:
             priv_key_pem = f.read()
         
@@ -51,6 +53,14 @@ class Secure:
         )
         
     def _handle_unknown_node(self, envelope: SignedEnvelope) -> Bundle | None:
+        """Attempts to find node profile in proided envelope.
+        
+        If an unknown node sends an envelope, it may still be able to be
+        validated if that envelope contains their node profile. This is
+        essential for allowing unknown nodes to handshake and introduce
+        themselves. Only an `EventsPayload` contain a `NEW` event for a 
+        node profile for the source node is permissible.
+        """
         if type(envelope.payload) != EventsPayload:
             return None
             
@@ -64,7 +74,10 @@ class Secure:
             return event.bundle
         return None
         
-    def create_envelope(self, payload, target) -> SignedEnvelope:
+    def create_envelope(
+        self, payload: ApiModels, target: KoiNetNode
+    ) -> SignedEnvelope:
+        """Returns signed envelope to target from provided payload."""
         return UnsignedEnvelope(
             payload=payload,
             source_node=self.identity.rid,
@@ -72,8 +85,10 @@ class Secure:
         ).sign_with(self.priv_key)
         
     def validate_envelope(self, envelope: SignedEnvelope):
+        """Validates signed envelope from another node."""
+        
         node_bundle = (
-            self.effector.deref(envelope.source_node) or
+            self.cache.read(envelope.source_node) or
             self._handle_unknown_node(envelope)
         )
         
@@ -98,6 +113,11 @@ class Secure:
             raise InvalidTargetError(f"Envelope target {envelope.target_node!r} is not me")
         
     def envelope_handler(self, func):
+        """Wrapper function validates envelopes for server endpoints.
+        
+        Validates incoming envelope and passes payload to endpoint
+        handler. Resulting payload is returned as a signed envelope.
+        """
         @wraps(func)
         async def wrapper(req: SignedEnvelope, *args, **kwargs) -> SignedEnvelope | None:
             logger.info("Validating envelope")

koi_net/server.py

@@ -3,9 +3,10 @@ import uvicorn
 from contextlib import asynccontextmanager
 from fastapi import FastAPI, APIRouter
 from fastapi.responses import JSONResponse
-from .network.event_queue import NetworkEventQueue
+
+from koi_net.poll_event_buffer import PollEventBuffer
 from .network.response_handler import ResponseHandler
-from .processor.interface import ProcessorInterface
+from .processor.kobj_queue import KobjQueue
 from .protocol.api_models import (
     PollEvents,
     FetchRids,
@@ -34,27 +35,35 @@ logger = logging.getLogger(__name__)
 
 
 class NodeServer:
+    """Manages FastAPI server and event handling for full nodes."""
+    config: NodeConfig
     lifecycle: NodeLifecycle
+    secure: Secure
+    kobj_queue: KobjQueue
+    poll_event_buf: PollEventBuffer
+    response_handler: ResponseHandler
+    app: FastAPI
+    router: APIRouter
     
     def __init__(
         self,
         config: NodeConfig,
         lifecycle: NodeLifecycle,
         secure: Secure,
-        processor: ProcessorInterface,
-        event_queue: NetworkEventQueue,
+        kobj_queue: KobjQueue,
+        poll_event_buf: PollEventBuffer,
         response_handler: ResponseHandler
     ):
         self.config = config
         self.lifecycle = lifecycle
         self.secure = secure
-        self.processor = processor
-        self.event_queue = event_queue
+        self.kobj_queue = kobj_queue
+        self.poll_event_buf = poll_event_buf
         self.response_handler = response_handler
         self._build_app()
         
     def _build_app(self):
-        
+        """Builds FastAPI app and adds endpoints."""
         @asynccontextmanager
         async def lifespan(*args, **kwargs):
             async with self.lifecycle.async_run():
@@ -86,6 +95,7 @@ class NodeServer:
         self.app.include_router(self.router)
     
     def run(self):
+        """Starts FastAPI server and event handler."""
         uvicorn.run(
             app=self.app,
             host=self.config.server.host,
@@ -93,6 +103,7 @@ class NodeServer:
         )
         
     def protocol_error_handler(self, request, exc: ProtocolError):
+        """Catches `ProtocolError` and returns as `ErrorResponse`."""
         logger.info(f"caught protocol error: {exc}")
         resp = ErrorResponse(error=exc.error_type)
         logger.info(f"returning error response: {resp}")
@@ -102,28 +113,33 @@ class NodeServer:
         )
 
     async def broadcast_events(self, req: SignedEnvelope[EventsPayload]):
+        """Handles events broadcast endpoint."""
         logger.info(f"Request to {BROADCAST_EVENTS_PATH}, received {len(req.payload.events)} event(s)")
         for event in req.payload.events:
-            self.processor.handle(event=event, source=req.source_node)
+            self.kobj_queue.put_kobj(event=event, source=req.source_node)
         
     async def poll_events(
         self, req: SignedEnvelope[PollEvents]
     ) -> SignedEnvelope[EventsPayload] | ErrorResponse:
+        """Handles poll events endpoint."""
         logger.info(f"Request to {POLL_EVENTS_PATH}")
-        events = self.event_queue.flush_poll_queue(req.source_node)
+        events = self.poll_event_buf.flush(req.source_node)
         return EventsPayload(events=events)
 
     async def fetch_rids(
         self, req: SignedEnvelope[FetchRids]
     ) -> SignedEnvelope[RidsPayload] | ErrorResponse:
+        """Handles fetch RIDs endpoint."""
         return self.response_handler.fetch_rids(req.payload, req.source_node)
 
     async def fetch_manifests(
         self, req: SignedEnvelope[FetchManifests]
     ) -> SignedEnvelope[ManifestsPayload] | ErrorResponse:
+        """Handles fetch manifests endpoint."""
         return self.response_handler.fetch_manifests(req.payload, req.source_node)
 
     async def fetch_bundles(
         self, req: SignedEnvelope[FetchBundles]
     ) -> SignedEnvelope[BundlesPayload] | ErrorResponse:
+        """Handles fetch bundles endpoint."""
         return self.response_handler.fetch_bundles(req.payload, req.source_node)

koi_net/utils.py

@@ -0,0 +1,18 @@
+from typing import Callable
+
+from rid_lib import RID
+from rid_lib.ext import Bundle, Cache
+
+cache = Cache()
+
+def build_dereferencer(
+    *funcs: list[Callable[[RID], Bundle | None]]
+) -> Callable[[RID], Bundle | None]:
+    def any_of(rid: RID):
+        return any(
+            f(rid) for f in funcs
+        )
+    return any_of
+
+deref = build_dereferencer(cache.read)
+deref(RID.from_string("string:hello_world"))

koi_net/worker.py

@@ -0,0 +1,10 @@
+import threading
+
+class ThreadWorker:
+    thread: threading.Thread
+    
+    def __init__(self):
+        self.thread = threading.Thread(target=self.run)
+        
+    def run(self):
+        ...

{koi_net-1.1.0b7.dist-info → koi_net-1.2.0b1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: koi-net
-Version: 1.1.0b7
+Version: 1.2.0b1
 Summary: Implementation of KOI-net protocol in Python
 Project-URL: Homepage, https://github.com/BlockScience/koi-net/
 Author-email: Luke Miller <luke@block.science>
@@ -33,14 +33,18 @@ Requires-Dist: httpx>=0.28.1
 Requires-Dist: networkx>=3.4.2
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: rich>=14.1.0
 Requires-Dist: rid-lib>=3.2.7
 Requires-Dist: ruamel-yaml>=0.18.10
 Requires-Dist: uvicorn>=0.34.2
 Provides-Extra: dev
 Requires-Dist: build; extra == 'dev'
 Requires-Dist: twine>=6.0; extra == 'dev'
-Provides-Extra: examples
-Requires-Dist: rich; extra == 'examples'
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == 'docs'
+Requires-Dist: sphinx-autoapi>=3.6.0; extra == 'docs'
+Requires-Dist: sphinx-autodoc-typehints>=3.0.1; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=3.0.2; extra == 'docs'
 Description-Content-Type: text/markdown
 
 # KOI-net

koi_net-1.2.0b1.dist-info/RECORD

@@ -0,0 +1,49 @@
+koi_net/__init__.py,sha256=S6Ew8CDhwaysGFJGX19tgkXLcJiJR2R5fwz449gaXFY,31
+koi_net/behaviors.py,sha256=_2yeX3IdDQWiOsXoehiFjr2jPj58oZTnBX28M32LM4w,1955
+koi_net/config.py,sha256=yV53GFQrJchyKKRs3sOhj27pyM6rwiUhIgDZ81rvZ48,5238
+koi_net/context.py,sha256=z24-pwYE3YDIznqNkRBIZuqT-JpksHnkuUfDOH034j0,1429
+koi_net/core.py,sha256=qUq87KfL-DKUu0NVfJPFBiNYpD35ODzvP6bV7F5ijd4,7252
+koi_net/default_actions.py,sha256=y9oaDeb3jJGSvVbuonmyGWkKWlzpEX3V32MjgEuYWc8,622
+koi_net/effector.py,sha256=iFX34Tq9Byev22CUbGnQU1MUccyNH5ebmQzoovwY_aE,4738
+koi_net/handshaker.py,sha256=e5bzWGWvU7w5gQ4kBEiU6ShCXwc-XXgfvx3c1RxMguA,1238
+koi_net/identity.py,sha256=FvIWksGTqwM7HCevIwmo_6l-t-2tnYkaaR4CanZatL4,569
+koi_net/kobj_worker.py,sha256=p_1QJDDoz-cIDoTQ3qCptPTbuvqou5BAPEQqZjH8niE,1306
+koi_net/lifecycle.py,sha256=WP3XiiCtSG8ZGa4oBnNBxwsmQ35QRQEgeYqwnGRxcsI,4379
+koi_net/models.py,sha256=_hL-ohrlH-kZRV9B0PWjYyZbb_Ef1z14HOLI5RK_Dto,274
+koi_net/poll_event_buffer.py,sha256=DMuEnaoH7nZccXY0LwHaGEyecrWfW1z0s7AbVHMGM88,441
+koi_net/poller.py,sha256=zBHWPXvca-Ia9ggE5emu8rJx5c8Jdi1ZAYB7lTyezv8,1395
+koi_net/secure.py,sha256=1t1WtHeqmoHfi4siW1jFCmIhKFsQGactITkEmVYKqnc,4919
+koi_net/server.py,sha256=iP9agexIjqmNlCOXs50cLkyEWHth7cGlQRN593rBOhU,4955
+koi_net/utils.py,sha256=4K6BqtifExDUfPP8zJAICgPV1mcabz_MaFB0P0fSnic,411
+koi_net/worker.py,sha256=G3JLlILN0cyY7Fv3eA5y8uf9rImy4e21OQ1mEKFoVVo,191
+koi_net/cli/__init__.py,sha256=Vpq0yLN0ROyF0qQYsyiuWFbjs-zsa90G1DpAv13qaiw,25
+koi_net/cli/commands.py,sha256=5eVsvJAnHjwJdt8MNYrk5zSzWWm1ooiP35bJeQxYIq4,2592
+koi_net/cli/models.py,sha256=ON-rqMgHDng3J2hbBbGYzkynaWc9Tq4QfOJIu_6pFuA,1190
+koi_net/network/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+koi_net/network/error_handler.py,sha256=8XgOljFBJ4lzXdEO5I-spND9iRln9309lwgpPV1pMnM,1802
+koi_net/network/event_queue.py,sha256=rvTuMuG-QicKHGSfB2FOyFMngmnESovec1TOPIowvss,780
+koi_net/network/graph.py,sha256=8hweEivCwxnagFoUrefE7Hnz06MWScF3XJHeXU2Qqnw,4178
+koi_net/network/request_handler.py,sha256=1Sp0-OCqcQXM-fAE5sFH4_M9FP1EbJh69P8gB56BSKg,7102
+koi_net/network/resolver.py,sha256=MqUMwG5snZp4QLV7d-gZ7tRJDQ0uJZ_IhssozTc9JkU,5309
+koi_net/network/response_handler.py,sha256=tbTqHmwXUEZIqiYqVL2vi4q6eDH0bPRrAO6G4XpbMic,2123
+koi_net/processor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+koi_net/processor/default_handlers.py,sha256=siRZl_Ww7QA9MhJR4_nmrSHOG8ejfS0NjiF6braA338,11020
+koi_net/processor/event_worker.py,sha256=bS_Xgkg4s1e_5dG0qtHY3d79JsYEyGzbI6F7JSZbSws,4297
+koi_net/processor/handler.py,sha256=PJlQCPfKm3zYsJrwmGIw5xZmc6vArKz_UoeJuXBj16Y,2356
+koi_net/processor/knowledge_object.py,sha256=0VyBOqkCoINMK3fqYhLlXU-Ri7gKEpJloDHfhaGITxg,4172
+koi_net/processor/knowledge_pipeline.py,sha256=sz8T12nAcJ1tbF2jHf0Wmi6ffnQPMrIl64xif4WP7fc,8784
+koi_net/processor/kobj_queue.py,sha256=LIh9Sz3EaEZj9qJBd4iLPlzYBO6aH-6qt_JHCxAzAJU,1839
+koi_net/protocol/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+koi_net/protocol/api_models.py,sha256=AIFT49fyNAnOsHep9bgjga2M0S38-PouBaqfQI2zcKY,1795
+koi_net/protocol/consts.py,sha256=bisbVEojPIHlLhkLafBzfIhH25TjNfvTORF1g6YXzIM,243
+koi_net/protocol/edge.py,sha256=PzdEhC43T1KO5iMSEu7I4tiz-7sZxtz41dJfWf-oHA0,1034
+koi_net/protocol/envelope.py,sha256=UVHlO2BDyDiP5eixqx9xD6xUsCfFRi0kZyzC4BC-DOw,1886
+koi_net/protocol/errors.py,sha256=uKPQ-TGLouZuK0xd2pXuCQoRTyu_JFsydSCLml13Cz8,595
+koi_net/protocol/event.py,sha256=HxzLN-iCXPyr2YzrswMIkgZYeUdFbBpa5v98dAB06lQ,1328
+koi_net/protocol/node.py,sha256=KH_SjHDzW-V4pn2tqpTDhIzfuCgKgM1YqCafyofLN3k,466
+koi_net/protocol/secure.py,sha256=6sRLWxG5EDF0QLBj29gk3hPmZnPXATrTTFdwx39wQfY,5127
+koi_net-1.2.0b1.dist-info/METADATA,sha256=reMf5147lyI17Gu5Ca98sQFZsoMk9pL5mV2BHZKtpV0,37314
+koi_net-1.2.0b1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+koi_net-1.2.0b1.dist-info/entry_points.txt,sha256=l7He_JTyXrfKIHkttnPWXHI717v8WpLLfCduL5QcEWA,40
+koi_net-1.2.0b1.dist-info/licenses/LICENSE,sha256=03mgCL5qth2aD9C3F3qNVs4sFJSpK9kjtYCyOwdSp7s,1069
+koi_net-1.2.0b1.dist-info/RECORD,,

koi_net-1.2.0b1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+koi = koi_net.cli:app

koi_net/processor/interface.py

@@ -1,101 +0,0 @@
-import logging
-import queue
-import threading
-from rid_lib.core import RID
-from rid_lib.ext import Bundle, Manifest
-from rid_lib.types import KoiNetNode
-from ..protocol.event import Event, EventType
-from .knowledge_object import KnowledgeObject
-from .knowledge_pipeline import KnowledgePipeline
-
-
-logger = logging.getLogger(__name__)
-
-
-class ProcessorInterface:
-    """Provides access to this node's knowledge processing pipeline."""
-    pipeline: KnowledgePipeline
-    kobj_queue: queue.Queue[KnowledgeObject]
-    use_kobj_processor_thread: bool
-    worker_thread: threading.Thread | None = None
-    
-    def __init__(
-        self,
-        pipeline: KnowledgePipeline,
-        use_kobj_processor_thread: bool,
-    ):
-        self.pipeline = pipeline
-        self.use_kobj_processor_thread = use_kobj_processor_thread
-        self.kobj_queue = queue.Queue()
-        
-        if self.use_kobj_processor_thread:
-            self.worker_thread = threading.Thread(
-                target=self.kobj_processor_worker,
-                daemon=True
-            )
-    
-    def flush_kobj_queue(self):
-        """Flushes all knowledge objects from queue and processes them.
-        
-        NOTE: ONLY CALL THIS METHOD IN SINGLE THREADED NODES, OTHERWISE THIS WILL CAUSE RACE CONDITIONS.
-        """
-        if self.use_kobj_processor_thread:
-            logger.warning("You are using a worker thread, calling this method can cause race conditions!")
-        
-        while not self.kobj_queue.empty():
-            kobj = self.kobj_queue.get()
-            logger.debug(f"Dequeued {kobj!r}")
-            
-            try:
-                self.pipeline.process(kobj)
-            finally:
-                self.kobj_queue.task_done()
-            logger.debug("Done")
-    
-    def kobj_processor_worker(self, timeout=0.1):
-        while True:
-            try:
-                kobj = self.kobj_queue.get(timeout=timeout)
-                logger.debug(f"Dequeued {kobj!r}")
-                
-                try:
-                    self.pipeline.process(kobj)
-                finally:
-                    self.kobj_queue.task_done()
-                logger.debug("Done")
-            
-            except queue.Empty:
-                pass
-            
-            except Exception as e:
-                logger.warning(f"Error processing kobj: {e}")
-        
-    def handle(
-        self,
-        rid: RID | None = None,
-        manifest: Manifest | None = None,
-        bundle: Bundle | None = None,
-        event: Event | None = None,
-        kobj: KnowledgeObject | None = None,
-        event_type: EventType | None = None,
-        source: KoiNetNode | None = None
-    ):
-        """Queues provided knowledge to be handled by processing pipeline.
-        
-        Knowledge may take the form of an RID, manifest, bundle, event, or knowledge object (with an optional event type for RID, manifest, or bundle objects). All objects will be normalized into knowledge objects and queued. If `flush` is `True`, the queue will be flushed immediately after adding the new knowledge.
-        """
-        if rid:
-            _kobj = KnowledgeObject.from_rid(rid, event_type, source)
-        elif manifest:
-            _kobj = KnowledgeObject.from_manifest(manifest, event_type, source)
-        elif bundle:
-            _kobj = KnowledgeObject.from_bundle(bundle, event_type, source)
-        elif event:
-            _kobj = KnowledgeObject.from_event(event, source)
-        elif kobj:
-            _kobj = kobj
-        else:
-            raise ValueError("One of 'rid', 'manifest', 'bundle', 'event', or 'kobj' must be provided")
-        
-        self.kobj_queue.put(_kobj)
-        logger.debug(f"Queued {_kobj!r}")

koi_net-1.1.0b7.dist-info/RECORD

@@ -1,38 +0,0 @@
-koi_net/__init__.py,sha256=b0Ze0pZmJAuygpWUFHM6Kvqo3DkU_uzmkptv1EpAArw,31
-koi_net/config.py,sha256=47XbQ59GRYFi4rlsoWKlnzMQATcnK70i3qmKTZAGOQk,4087
-koi_net/context.py,sha256=FwkzjmsyNqUeOeGCuZXtONqs5_MSl1R8-e3IxHuyzTI,1531
-koi_net/core.py,sha256=aO9caoS8dLafRGheJWzhbp_ym7o7bi_wxds683bly48,7150
-koi_net/default_actions.py,sha256=TkQR9oj9CpO37Gb5bZLmFNl-Q8n3OxGiX4dvxQR7SaA,421
-koi_net/effector.py,sha256=gSyZgRxQ91X04UL261e2pXWUfBHnQTGtjSHpc2JufxA,4097
-koi_net/identity.py,sha256=FvIWksGTqwM7HCevIwmo_6l-t-2tnYkaaR4CanZatL4,569
-koi_net/lifecycle.py,sha256=GL2zltmh-aeBuNVg_rbIgsXMch672w7xkWAXCTjxst4,3550
-koi_net/poller.py,sha256=bIrlqdac5vLQYAid35xiQJLDMR85GnOSPCXSTQ07-Mc,1173
-koi_net/secure.py,sha256=cGNF2assqCaYq0i0fhQBm7aREoAdpY-XVypDsE1ALaU,3970
-koi_net/server.py,sha256=PrR_cXQV5YMKa6FXwiJXwMZJ52VQVzLPYYPVl-Miuw8,4315
-koi_net/network/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-koi_net/network/behavior.py,sha256=NZLvWlrxR0uWriE3ZzCXmocUVccQthy7Xx8E_8KBwsg,1208
-koi_net/network/error_handler.py,sha256=_dAl2ovpUZEVhPc8_dcLA7I-FoMNqQNwFy0QLa4uTSY,1617
-koi_net/network/event_queue.py,sha256=DWs26C235iYkP4koKcdbhmIOHGZRJ48d072BoNWyiHo,7325
-koi_net/network/graph.py,sha256=60SLiR3aNXIOGe-URzMGgx8abmMEJtz37EJs6jeImEM,4143
-koi_net/network/request_handler.py,sha256=_SM5MuYkS636wGJeFkesapQsW5x_kt_1o9KTXB0wksU,6869
-koi_net/network/resolver.py,sha256=coIp4M6k0-8sUfAy4h2NMx_7zCNroWlCHKOj3AXZVhc,5412
-koi_net/network/response_handler.py,sha256=__R_EvEpjaMz3PCDvkNgWF_EAHe2nePGk-zK_cT4C4g,2077
-koi_net/processor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-koi_net/processor/default_handlers.py,sha256=1OTC4p0luTadNm90q6Fr_dbvysFzgRCbltp-YP6cRXo,9562
-koi_net/processor/handler.py,sha256=_loaHjgVGVUxtCQdvAY9dQ0iqiq5co7wB2tK-usuv3Y,2355
-koi_net/processor/interface.py,sha256=ebDwqggznFRfp2PT8-UJPUAvCwX8nZaaQ68FUeWQvmw,3682
-koi_net/processor/knowledge_object.py,sha256=avQnsaeqqiJxy40P1VGljuQMtAGmJB-TBa4pmBXTaIs,3863
-koi_net/processor/knowledge_pipeline.py,sha256=i7FpCFl0UIOwCI5zhP1i8M4PX4A48VN28iV9jruvN5k,9486
-koi_net/protocol/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-koi_net/protocol/api_models.py,sha256=jzRZWW_ZB5YsBAiwCom882-WIbr0rPyelJxExRgHZGc,1755
-koi_net/protocol/consts.py,sha256=bisbVEojPIHlLhkLafBzfIhH25TjNfvTORF1g6YXzIM,243
-koi_net/protocol/edge.py,sha256=PzdEhC43T1KO5iMSEu7I4tiz-7sZxtz41dJfWf-oHA0,1034
-koi_net/protocol/envelope.py,sha256=UVHlO2BDyDiP5eixqx9xD6xUsCfFRi0kZyzC4BC-DOw,1886
-koi_net/protocol/errors.py,sha256=uKPQ-TGLouZuK0xd2pXuCQoRTyu_JFsydSCLml13Cz8,595
-koi_net/protocol/event.py,sha256=HxzLN-iCXPyr2YzrswMIkgZYeUdFbBpa5v98dAB06lQ,1328
-koi_net/protocol/node.py,sha256=7GQzHORFr9cP4BqJgir6EGSWCskL-yqmvJksIiLfcWU,409
-koi_net/protocol/secure.py,sha256=6sRLWxG5EDF0QLBj29gk3hPmZnPXATrTTFdwx39wQfY,5127
-koi_net-1.1.0b7.dist-info/METADATA,sha256=nHdoaFbZodVbTgjEuZeMxi8as2JOWP0Fyhoj05tn7e8,37118
-koi_net-1.1.0b7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-koi_net-1.1.0b7.dist-info/licenses/LICENSE,sha256=03mgCL5qth2aD9C3F3qNVs4sFJSpK9kjtYCyOwdSp7s,1069
-koi_net-1.1.0b7.dist-info/RECORD,,