busline 0.3.1__py3-none-any.whl → 0.5.1__py3-none-any.whl

busline/eventbus_client/publisher/local_eventbus_publisher.py

@@ -1,35 +0,0 @@
-from busline.event.event import Event
-from busline.eventbus.eventbus import EventBus
-from busline.eventbus_client.exceptions import EventBusClientNotConnected
-from busline.eventbus_client.publisher.publisher import Publisher
-
-
-class LocalEventBusPublisher(Publisher):
-    """
-    Publisher which works with local eventbus, this class can be initialized and used stand-alone
-
-    Author: Nicola Ricciardi
-    """
-
-    def __init__(self, eventbus_instance: EventBus):
-        Publisher.__init__(self)
-
-        self._eventbus = eventbus_instance
-        self._connected = False
-
-    async def connect(self):
-        self._connected = True
-
-    async def disconnect(self):
-        self._connected = False
-
-    async def _internal_publish(self, topic_name: str, event: Event, raise_if_not_connected: bool = False, **kwargs):
-
-        if raise_if_not_connected and not self._connected:
-            raise EventBusClientNotConnected()
-        else:
-            await self.connect()
-
-        self.on_publishing(topic_name, event)
-        await self._eventbus.put_event(topic_name, event)
-        self.on_published(topic_name, event)

busline/eventbus_client/publisher/publisher.py

@@ -1,59 +0,0 @@
-import logging
-from abc import ABC, abstractmethod
-from uuid import uuid4
-
-from busline.event.event import Event
-from busline.eventbus_client.eventbus_connector import EventBusConnector
-
-
-class Publisher(EventBusConnector, ABC):
-    """
-    Abstract class which can be implemented by your components which must be able to publish on eventbus
-
-    Author: Nicola Ricciardi
-    """
-
-    def __init__(self, publisher_id: str = str(uuid4())):
-        EventBusConnector.__init__(self, publisher_id)
-
-    @abstractmethod
-    async def _internal_publish(self, topic_name: str, event: Event, **kwargs):
-        """
-        Actual publish on topic the event
-
-        :param topic_name:
-        :param event:
-        :return:
-        """
-
-    async def publish(self, topic_name: str, event: Event, **kwargs):
-        """
-        Publish on topic the event
-
-        :param topic_name:
-        :param event:
-        :return:
-        """
-
-        logging.debug(f"{self._id} publishing on {topic_name}: {event}")
-        self.on_publishing(topic_name, event)
-        await self._internal_publish(topic_name, event, **kwargs)
-        self.on_published(topic_name, event)
-
-    def on_publishing(self, topic_name: str, event: Event):
-        """
-        Callback called on publishing start
-
-        :param topic_name:
-        :param event:
-        :return:
-        """
-
-    def on_published(self, topic_name: str, event: Event):
-        """
-        Callback called on publishing end
-
-        :param topic_name:
-        :param event:
-        :return:
-        """

busline/eventbus_client/subscriber/closure_event_listener.py

@@ -1,19 +0,0 @@
-from typing import Callable
-from busline.event.event import Event
-from busline.eventbus_client.subscriber.event_listener import EventListener
-
-
-class ClosureEventListener(EventListener):
-    """
-    Abstract event listener which use a pre-defined callback as `on_event`
-
-    Author: Nicola Ricciardi
-    """
-
-    def __init__(self, on_event_callback: Callable[[str, Event], None]):
-        EventListener.__init__(self)
-
-        self.__on_event_callback = on_event_callback
-
-    async def on_event(self, topic_name: str, event: Event, **kwargs):
-        self.__on_event_callback(topic_name, event, **kwargs)

busline/eventbus_client/subscriber/event_listener.py

@@ -1,15 +0,0 @@
-from abc import ABC, abstractmethod
-from busline.event.event import Event
-
-
-class EventListener(ABC):
-
-    @abstractmethod
-    async def on_event(self, topic_name: str, event: Event, **kwargs):
-        """
-        Callback called when new event arrives
-
-        :param topic_name:
-        :param event:
-        :return:
-        """

busline/eventbus_client/subscriber/local_eventbus_closure_subscriber.py

@@ -1,17 +0,0 @@
-from typing import Callable
-from busline.event.event import Event
-from busline.eventbus.eventbus import EventBus
-from busline.eventbus_client.subscriber.closure_event_listener import ClosureEventListener
-from busline.eventbus_client.subscriber.local_eventbus_subscriber import LocalEventBusSubscriber
-
-
-class LocalEventBusClosureSubscriber(LocalEventBusSubscriber, ClosureEventListener):
-    """
-    Subscriber which works with local eventbus, this class can be initialized and used stand-alone
-
-    Author: Nicola Ricciardi
-    """
-
-    def __init__(self, eventbus_instance: EventBus, on_event_callback: Callable[[str, Event], None]):
-        LocalEventBusSubscriber.__init__(self, eventbus_instance)
-        ClosureEventListener.__init__(self, on_event_callback)

busline/eventbus_client/subscriber/local_eventbus_subscriber.py

@@ -1,40 +0,0 @@
-from abc import ABC
-from busline.eventbus.eventbus import EventBus
-from busline.eventbus_client.exceptions import EventBusClientNotConnected
-from busline.eventbus_client.subscriber.subscriber import Subscriber
-
-
-class LocalEventBusSubscriber(Subscriber, ABC):
-    """
-    Abstract subscriber which works with local eventbus without implementing `on_event` method
-
-    Author: Nicola Ricciardi
-    """
-
-    def __init__(self, eventbus_instance: EventBus):
-        Subscriber.__init__(self)
-
-        self._eventbus = eventbus_instance
-        self._connected = False
-
-    async def connect(self):
-        self._connected = True
-
-    async def disconnect(self):
-        self._connected = False
-
-    async def _internal_subscribe(self, topic_name: str, raise_if_not_connected: bool = False, **kwargs):
-        if raise_if_not_connected and not self._connected:
-            raise EventBusClientNotConnected()
-        else:
-            await self.connect()
-
-        self._eventbus.add_subscriber(topic_name, self)
-
-    async def _internal_unsubscribe(self, topic_name: str | None = None, raise_if_not_connected: bool = False, **kwargs):
-        if raise_if_not_connected and not self._connected:
-            raise EventBusClientNotConnected()
-        else:
-            await self.connect()
-
-        self._eventbus.remove_subscriber(self, topic_name)

busline/eventbus_client/subscriber/subscriber.py

@@ -1,93 +0,0 @@
-from abc import ABC, abstractmethod
-from uuid import uuid4
-
-from busline.event.event import Event
-from busline.eventbus_client.eventbus_connector import EventBusConnector
-from busline.eventbus_client.subscriber.event_listener import EventListener
-
-
-class Subscriber(EventBusConnector, EventListener, ABC):
-    """
-    Abstract class which can be implemented by your components which must be able to subscribe on eventbus
-
-    Author: Nicola Ricciardi
-    """
-
-    def __init__(self, subscriber_id: str = str(uuid4())):
-        EventBusConnector.__init__(self, subscriber_id)
-        EventListener.__init__(self)
-
-
-    @abstractmethod
-    async def _internal_subscribe(self, topic_name: str, **kwargs):
-        """
-        Actual subscribe to topic
-
-        :param topic_name:
-        :return:
-        """
-
-    @abstractmethod
-    async def _internal_unsubscribe(self, topic_name: str | None = None, **kwargs):
-        """
-        Actual unsubscribe to topic
-
-        :param topic_name:
-        :return:
-        """
-
-    async def subscribe(self, topic_name: str, **kwargs):
-        """
-        Subscribe to topic
-
-        :param topic_name:
-        :return:
-        """
-
-        self.on_subscribing(topic_name)
-        await self._internal_subscribe(topic_name, **kwargs)
-        self.on_subscribed(topic_name)
-
-    async def unsubscribe(self, topic_name: str | None = None, **kwargs):
-        """
-        Unsubscribe to topic
-
-        :param topic_name:
-        :return:
-        """
-
-        self.on_unsubscribing(topic_name)
-        await self._internal_unsubscribe(topic_name, **kwargs)
-        self.on_unsubscribed(topic_name)
-
-    def on_subscribing(self, topic_name: str):
-        """
-        Callback called on subscribing
-
-        :param topic_name:
-        :return:
-        """
-
-    def on_subscribed(self, topic_name: str):
-        """
-        Callback called on subscribed
-
-        :param topic_name:
-        :return:
-        """
-
-    def on_unsubscribing(self, topic_name: str):
-        """
-        Callback called on unsubscribing
-
-        :param topic_name:
-        :return:
-        """
-
-    def on_unsubscribed(self, topic_name: str):
-        """
-        Callback called on unsubscribed
-
-        :param topic_name:
-        :return:
-        """

busline-0.3.1.dist-info/METADATA

@@ -1,111 +0,0 @@
-Metadata-Version: 2.1
-Name: busline
-Version: 0.3.1
-Summary: Agnostic eventbus for Python
-Author-email: Nicola Ricciardi <ricciardincl@gmail.com>
-Project-URL: Homepage, https://github.com/nricciardi/py-busline
-Project-URL: Issues, https://github.com/nricciardi/py-busline/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-# Busline for Python
-
-Agnostic eventbus for Python.
-
-Official eventbus library for [Orbitalis](https://github.com/nricciardi/orbitalis)
-
-## Local EventBus
-
-### Using Publisher/Subscriber
-
-```python
-from busline.eventbus.async_local_eventbus import AsyncLocalEventBus
-from busline.eventbus_client.publisher.local_eventbus_publisher import LocalEventBusPublisher
-from busline.event.event import Event
-from busline.eventbus_client.subscriber.local_eventbus_closure_subscriber import LocalEventBusClosureSubscriber
-
-local_eventbus_instance = AsyncLocalEventBus()  # singleton
-
-
-def callback(topic_name: str, event: Event):
-    print(event)
-
-
-subscriber = LocalEventBusClosureSubscriber(local_eventbus_instance, callback)
-publisher = LocalEventBusPublisher(local_eventbus_instance)
-
-await subscriber.subscribe("test-topic")
-
-await publisher.publish("test-topic", Event())  # publish empty event
-```
-
-### Using EventBusClient
-
-```python
-from busline.event.event import Event
-from busline.eventbus_client.local_eventbus_client import LocalEventBusClient
-
-
-def callback(topic_name: str, event: Event):
-    print(event)
-
-
-client = LocalEventBusClient(callback)
-
-await client.subscribe("test")
-
-await client.publish("test", Event())
-```
-
-
-## Create Agnostic EventBus
-
-Implement business logic of your `Publisher` and `Subscriber` and... done. Nothing more.
-
-```python
-from busline.event.event import Event
-from busline.eventbus_client.publisher.publisher import Publisher
-
-
-class YourEventBusPublisher(Publisher):
-
-    async def _internal_publish(self, topic_name: str, event: Event, **kwargs):
-        pass  # send events to your eventbus (maybe in cloud?)
-```
-
-```python
-from busline.eventbus_client.subscriber.subscriber import Subscriber
-from busline.event.event import Event
-
-
-class YourEventBusSubscriber(Subscriber):
-
-    async def on_event(self, topic_name: str, event: Event, **kwargs):
-        pass  # receive your events
-```
-
-You could create a client to allow components to use it instead of become a publisher or subscriber.
-
-```python
-from busline.eventbus_client.eventbus_client import EventBusClient
-from busline.event.event import Event
-
-
-def client_callback(topic_name: str, e: Event):
-    print(e)
-
-
-subscriber = YourEventBusSubscriber(...)
-publisher = YourEventBusPublisher(...)
-
-client = EventBusClient(publisher, subscriber, ClosureEventListener(client_callback))
-```
-
-
-
-
-

busline-0.3.1.dist-info/RECORD

@@ -1,30 +0,0 @@
-busline/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-busline/event/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-busline/event/event.py,sha256=dwO0MD9jw2ENRcW5TJy8aCayudYH-rf1k9WDxYdJanM,595
-busline/event/event_content.py,sha256=tPvltxfs66yRmUppHvdw5ThYR_K2WitvE5sLybg6vZE,341
-busline/event/event_metadata.py,sha256=7aaSG4Z9uQzJKRe7Jz8zD6jo6WEo3PORNbJA_RElp8I,556
-busline/eventbus/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-busline/eventbus/async_local_eventbus.py,sha256=LnuKtq1bha0yr6ucV_m-bBtldcB0iwVkIFmfFwoPU7w,772
-busline/eventbus/eventbus.py,sha256=Uhcdjcb3EZRYSeV8-I19qFB3CHHR1v8m0BQPkZo0n3Q,2997
-busline/eventbus/exceptions.py,sha256=sjWa3Eyeqyci2yVWO9jSlnaZggM3SFDbTKzMtdBX1-E,40
-busline/eventbus/queued_local_eventbus.py,sha256=PMqTE28fHkx1MYgj5VsxdM3jAQVyKW1elzlUTBM0jtw,1376
-busline/eventbus/topic.py,sha256=rzbdYrv0YLbC6CDoFGhbc8dOVc19OHCQknkTP4fZHh4,950
-busline/eventbus_client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-busline/eventbus_client/eventbus_client.py,sha256=OqfYgmNkrkXQ4Hjoxji4H4YoqDxHxcrUMqHDKlP1TGc,3099
-busline/eventbus_client/eventbus_connector.py,sha256=zys73X8ul1UHyJHbIcmXBLucqCQhnLLVj9xDOVc1arU,702
-busline/eventbus_client/exceptions.py,sha256=gm7oZsXHlymheYDZb209T4FqeZN9Saft0Xklk4rOg54,55
-busline/eventbus_client/local_eventbus_client.py,sha256=k_Nqafe5McHCKwqnZHe52Fy9UFtSaN_A7CUFdOpjTCg,887
-busline/eventbus_client/publisher/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-busline/eventbus_client/publisher/local_eventbus_publisher.py,sha256=Gh50GuArq-jLaJMB-uCfUUFQ9PMKz03wY1NY1YIk3s4,1123
-busline/eventbus_client/publisher/publisher.py,sha256=JtUwIVj0_9SjX3lIzgepVAVrlE0fGqKETnGRGymcxIU,1544
-busline/eventbus_client/subscriber/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-busline/eventbus_client/subscriber/closure_event_listener.py,sha256=KSU2CyKto_wS-zASZ-5qNa5usCrg-iTj7dpWTHixe90,607
-busline/eventbus_client/subscriber/event_listener.py,sha256=EeQSkCuhAQNTLigzh2645tNH59tHneEiFzhmrPIzy-k,331
-busline/eventbus_client/subscriber/local_eventbus_closure_subscriber.py,sha256=LGvUDsiklHritTsblxvWXbyEmwbhDQN7Ze9rAgeVgdc,764
-busline/eventbus_client/subscriber/local_eventbus_subscriber.py,sha256=EyZqeVNe2WqXEnCoInnqhdADrGi3Zlqw-_umLIiAd74,1343
-busline/eventbus_client/subscriber/subscriber.py,sha256=AO3PenhPXrXuxp3jsvyr4r4zZh-zYDpkpoXG5Ut0SUs,2258
-busline-0.3.1.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-busline-0.3.1.dist-info/METADATA,sha256=ezHdhoNgkpGCb2TGedtWYPEh8VF1v6_5DPw_Kirt6uc,2921
-busline-0.3.1.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-busline-0.3.1.dist-info/top_level.txt,sha256=bZY0fK2wgNEI5igR7DBF3CyXHGkzujGvmoqdSzG6Zp0,8
-busline-0.3.1.dist-info/RECORD,,