jararaca 0.2.37a11__py3-none-any.whl → 0.3.0__py3-none-any.whl

{jararaca-0.2.37a11.dist-info → jararaca-0.3.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
-LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-README.md,sha256=mte30I-ZEJJp-Oax-OganNgl6G9GaCZPL6JVFAvZGz4,7034
-pyproject.toml,sha256=6qmtrXrdw7bJZOL_-RGgWJtkCmz7b42Xbc-NwubeGTQ,1840
-jararaca/__init__.py,sha256=VBrN25GHJ3gDG95CcJWe3dmGcA-X2agzOCIBbjzc1Iw,15312
+jararaca/__init__.py,sha256=4WO-Th3vY1_0SKdLyviZN2rftiX7R5yPVNPGJ9Mf5Y0,15633
 jararaca/__main__.py,sha256=-O3vsB5lHdqNFjUtoELDF81IYFtR-DSiiFMzRaiSsv4,67
-jararaca/cli.py,sha256=JKk4xrRbtX2fM8yYw794lbxvJFH73bWw3GGIvrpAkeE,5706
+jararaca/broker_backend/__init__.py,sha256=GzEIuHR1xzgCJD4FE3harNjoaYzxHMHoEL0_clUaC-k,3528
+jararaca/broker_backend/mapper.py,sha256=vTsi7sWpNvlga1PWPFg0rCJ5joJ0cdzykkIc2Tuvenc,696
+jararaca/broker_backend/redis_broker_backend.py,sha256=a7DHchy3NAiD71Ix8SwmQOUnniu7uup-Woa4ON_4J7I,5786
+jararaca/cli.py,sha256=8opY0_YOKGaglDxIg9ijTWKcTvgHlBY9x3xiJGEo1xk,8964
 jararaca/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 jararaca/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 jararaca/core/providers.py,sha256=wktH84FK7c1s2wNq-fudf1uMfi3CQBR0neU2czJ_L0U,434
@@ -11,15 +11,18 @@ jararaca/core/uow.py,sha256=WrA50VWzfJIyZHeUhSs8IOpSA4T-D8VV6YPLlFTF5V4,2026
 jararaca/di.py,sha256=h3IsXdYZjJj8PJfnEDn0ZAwdd4EBfh8jU-wWO8ko_t4,76
 jararaca/files/entity.py.mako,sha256=tjQ-1udAMvVqgRokhsrR4uy3P_OVnbk3XZ8X69ixWhE,3098
 jararaca/lifecycle.py,sha256=qKlzLQQioS8QkxNJ_FC_5WbmT77cNbc_S7OcQeOoHkI,1895
-jararaca/messagebus/__init__.py,sha256=Zdl74HcS9K0FW6XUt7bVvaHEyxL8pWsqqakeRENIn0w,54
+jararaca/messagebus/__init__.py,sha256=5jAqPqdcEMYBfQyfZDWPnplYdrfMyJLMcacf3qLyUhk,56
 jararaca/messagebus/bus_message_controller.py,sha256=Xd_qwnX5jUvgBTCarHR36fvtol9lPTsYp2IIGKyQQaE,1487
-jararaca/messagebus/decorators.py,sha256=GHlaXRuHtrz6R0HgcG2gJybpGYtdts9meDVSRPwN74I,4245
+jararaca/messagebus/consumers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+jararaca/messagebus/decorators.py,sha256=y-w4dWbP9ZW3ZJ4mE9iIaxw01ZC5snEbOuBY5NC-Bn0,5626
 jararaca/messagebus/interceptors/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-jararaca/messagebus/interceptors/aiopika_publisher_interceptor.py,sha256=BPH5wOlj_CyHtJ7W4NWF2h0gYMwzOPNzFhGADk618N4,4373
-jararaca/messagebus/publisher.py,sha256=5ay9Znwybqt981OOykdWkFisSvGiTeTpPXDFLMnaiqg,1109
-jararaca/messagebus/types.py,sha256=iYLyLxWqOHkDadxyMqQPWy3itLNQfvD6oQe8jcq9nzo,887
-jararaca/messagebus/worker.py,sha256=hKACTyrIMHcuaySpmI3UhDCja6va1gGkFRoZJ7kYfoA,13613
-jararaca/microservice.py,sha256=1TvDKVMMREH27Ly8eTEheMmSfro4_Az_JKM_NdDvrgc,6636
+jararaca/messagebus/interceptors/aiopika_publisher_interceptor.py,sha256=1pSaifCT6TnuKWH7u80llRcUvyFlS-G9p1AU83CxGuA,5315
+jararaca/messagebus/interceptors/publisher_interceptor.py,sha256=fQFFW9hH6ZU3UOyR7kMPrNp9wA71qEy5XlgrBQdBMS4,1230
+jararaca/messagebus/message.py,sha256=U6cyd2XknX8mtm0333slz5fanky2PFLWCmokAO56vvU,819
+jararaca/messagebus/publisher.py,sha256=K7WsOMVTyLmdms3ZKEshqrQc_DhNreiFK-HnmOT9Ce0,1965
+jararaca/messagebus/worker.py,sha256=SGd7Mng33ivcaAP7cwmF_2loQPuHIfTwkCZtCNJ5G-I,13523
+jararaca/messagebus/worker_v2.py,sha256=F7Hl92h5PezxNUY3_lfv9jNhboyQouuk6hXocPGeyXY,20341
+jararaca/microservice.py,sha256=C_Txqm3xSmdHIghJigKk6TOycL5eTJv9PF6XP7TA8j4,6638
 jararaca/observability/decorators.py,sha256=XffBinFXdiNkY6eo8_1nkr_GapM0RUGBg0aicBIelag,2220
 jararaca/observability/interceptor.py,sha256=GHkuGKFWftN7MDjvYeGFGEPnuJETNhtxRK6yuPrCrpU,1462
 jararaca/observability/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -52,15 +55,19 @@ jararaca/rpc/http/backends/otel.py,sha256=Uc6CjHSCZ5hvnK1fNFv3ota5xzUFnvIl1JOpG3
 jararaca/rpc/http/decorators.py,sha256=oUSzgMGI8w6SoKiz3GltDbd3BWAuyY60F23cdRRNeiw,11897
 jararaca/rpc/http/httpx.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 jararaca/scheduler/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-jararaca/scheduler/decorators.py,sha256=V6VtLA44HPEbevEcEGiHDHM3HZvka1P5kpvIm9nCMkc,2268
-jararaca/scheduler/scheduler.py,sha256=r1_OPTOsL9WkxTLBaxLiq1csujUqepvPg-8I4m28amU,4845
+jararaca/scheduler/decorators.py,sha256=cRwnQHtlo9iC-2c30t7GGTEURFmdtDPkkVrr5cRVblM,3645
+jararaca/scheduler/scheduler.py,sha256=ll3ifOZ9QZcyCX1jfuNagHMVAbhRoE9VAl0ox3MWnwo,5295
+jararaca/scheduler/scheduler_v2.py,sha256=5-_O6EzG95y_3aIw5SA4W_ppbPIIszBrCYM7cFvXgBo,11166
+jararaca/scheduler/types.py,sha256=4HEQOmVIDp-BYLSzqmqSFIio1bd51WFmgFPIzPpVu04,135
 jararaca/tools/app_config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 jararaca/tools/app_config/decorators.py,sha256=-ckkMZ1dswOmECdo1rFrZ15UAku--txaNXMp8fd1Ndk,941
 jararaca/tools/app_config/interceptor.py,sha256=nfFZiS80hrbnL7-XEYrwmp2rwaVYBqxvqu3Y-6o_ov4,2575
 jararaca/tools/metadata.py,sha256=7nlCDYgItNybentPSSCc2MLqN7IpBd0VyQzfjfQycVI,1402
 jararaca/tools/typescript/interface_parser.py,sha256=4SHt094P-QawMFHSyMCiujQf8Niw7xACIO1RHBM8-w4,29192
-jararaca-0.2.37a11.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-jararaca-0.2.37a11.dist-info/METADATA,sha256=o0sSsRaTx6-ySotULbIhDQtza302CTjxCc9jdAJxbJ8,8555
-jararaca-0.2.37a11.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-jararaca-0.2.37a11.dist-info/entry_points.txt,sha256=WIh3aIvz8LwUJZIDfs4EeH3VoFyCGEk7cWJurW38q0I,45
-jararaca-0.2.37a11.dist-info/RECORD,,
+jararaca/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+jararaca/utils/rabbitmq_utils.py,sha256=zFqZE-j6TSWFOEPbkIaB2hy2sqsXup-5421jIiPLfXY,2543
+jararaca-0.3.0.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+jararaca-0.3.0.dist-info/METADATA,sha256=szUO6pqKIKDGAmJC1ppYnRXm-xVr2hoT49yCqLmf4o0,4951
+jararaca-0.3.0.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+jararaca-0.3.0.dist-info/entry_points.txt,sha256=WIh3aIvz8LwUJZIDfs4EeH3VoFyCGEk7cWJurW38q0I,45
+jararaca-0.3.0.dist-info/RECORD,,

{jararaca-0.2.37a11.dist-info → jararaca-0.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.9.1
+Generator: poetry-core 2.1.2
 Root-Is-Purelib: true
 Tag: py3-none-any

README.md

@@ -1,243 +0,0 @@
-<img src="https://raw.githubusercontent.com/LuscasLeo/jararaca/main/docs/assets/_f04774c9-7e05-4da4-8b17-8be23f6a1475.jpeg" alt="README.md" width="250" float="right">
-
-# Jararaca Microservice Framework
-
-## Overview
-
-Jararaca is a aio-first microservice framework that provides a set of tools to build and deploy microservices in a simple and clear way.
-
-## Features
-
-### Hexagonal Architecture
-
-The framework is based on the hexagonal architecture, which allows you to separate the business logic from the infrastructure, making the code more testable and maintainable.
-
-### Dependency Injection
-
-The framework uses the dependency injection pattern to manage the dependencies between the components of the application.
-
-```py
-    app = Microservice(
-        providers=[
-            ProviderSpec(
-                provide=Token(AuthConfig, "AUTH_CONFIG"),
-                use_value=AuthConfig(
-                    secret="secret",
-                    identity_refresh_token_expires_delta_seconds=60 * 60 * 24 * 30,
-                    identity_token_expires_delta_seconds=60 * 60,
-                ),
-            ),
-            ProviderSpec(
-                provide=Token(AppConfig, "APP_CONFIG"),
-                use_factory=AppConfig.provider,
-            ),
-            ProviderSpec(
-                provide=TokenBlackListService,
-                use_value=InMemoryTokenBlackListService(),
-            ),
-        ],
-    )
-```
-
-### Web Server Port
-
-The framework provides a web server that listens on a specific port and routes the requests to the appropriate handler. It uses [FastAPI](https://fastapi.tiangolo.com/) as the web framework.
-
-```py
-    @Delete("/{task_id}")
-    async def delete_task(self, task_id: TaskId) -> None:
-        await self.tasks_crud.delete_by_id(task_id)
-
-        await use_ws_manager().broadcast(("Task %s deleted" % task_id).encode())
-```
-
-### Message Bus
-
-The framework provides a topic-based message bus that allows you to send messages between the components of the application. It uses [AIO Pika](https://aio-pika.readthedocs.io/) as the message broker worker and publisher.
-
-```py
-    @IncomingHandler("task")
-    async def process_task(self, message: Message[Identifiable[TaskSchema]]) -> None:
-        name = generate_random_name()
-        now = asyncio.get_event_loop().time()
-        print("Processing task: ", name)
-
-        task = message.payload()
-
-        print("Received task: ", task)
-        await asyncio.sleep(random.randint(1, 5))
-
-        await use_publisher().publish(task, topic="task")
-
-        then = asyncio.get_event_loop().time()
-        print("Task Finished: ", name, " Time: ", then - now)
-```
-
-### Distributed Websocket
-
-You can setup a room-based websocket server that allows you to send messages to a specific room or broadcast messages to all connected clients. All backend instances communicates with each other using a pub/sub mechanism (such as Redis).
-
-```py
-    @WebSocketEndpoint("/ws")
-    async def ws_endpoint(self, websocket: WebSocket) -> None:
-        await websocket.accept()
-        counter.increment()
-        await use_ws_manager().add_websocket(websocket)
-        await use_ws_manager().join(["tasks"], websocket)
-        await use_ws_manager().broadcast(
-            ("New Connection (%d) from %s" % (counter.count, self.hostname)).encode()
-        )
-
-        print("New Connection (%d)" % counter.count)
-
-        while True:
-            try:
-                await websocket.receive_text()
-            except WebSocketDisconnect:
-                counter.decrement()
-                await use_ws_manager().remove_websocket(websocket)
-
-                await use_ws_manager().broadcast(
-                    (
-                        "Connection Closed (%d) from %s"
-                        % (counter.count, self.hostname)
-                    ).encode()
-                )
-                print("Connection Closed (%d)" % counter.count)
-                break
-```
-
-### Scheduled Routine
-
-You can setup a scheduled routine that runs a specific task at a specific time or interval.
-
-```py
-...
-    @ScheduledAction("* * * * * */3", allow_overlap=False)
-    async def scheduled_task(self) -> None:
-        print("Scheduled Task at ", asyncio.get_event_loop().time())
-
-        print("sleeping")
-        await asyncio.sleep(5)
-
-        await use_publisher().publish(
-            message=Identifiable(
-                id=uuid4(),
-                data=TaskSchema(name=generate_random_name()),
-            ),
-            topic="task",
-        )
-```
-
-### Observability
-
-You can setup Observability Interceptors for logs, traces and metric collection with [OpenTelemetry](https://opentelemetry.io/docs)-based Protocols
-
-```python
-class HelloService:
-    def __init__(
-        self,
-        hello_rpc: Annotated[HelloRPC, Token(HelloRPC, "HELLO_RPC")],
-    ):
-        self.hello_rpc = hello_rpc
-
-    @TracedFunc("ping") # Decorator for tracing
-    async def ping(self) -> HelloResponse:
-        return await self.hello_rpc.ping()
-
-    @TracedFunc("hello-service")
-    async def hello(
-        self,
-        gather: bool,
-    ) -> HelloResponse:
-        now = asyncio.get_event_loop().time()
-        if gather:
-            await asyncio.gather(*[self.random_await(a) for a in range(10)])
-        else:
-            for a in range(10):
-                await self.random_await(a)
-        return HelloResponse(
-            message="Elapsed time: {}".format(asyncio.get_event_loop().time() - now)
-        )
-
-    @TracedFunc("random-await")
-    async def random_await(self, index: int) -> None:
-        logger.info("Random await %s", index, extra={"index": index})
-        await asyncio.sleep(random.randint(1, 3))
-        logger.info("Random await %s done", index, extra={"index": index})
-```
-
-## Installation
-
-```bash
-pip install jararaca
-```
-
-## Usage
-
-### Create a Microservice
-
-```python
-# app.py
-
-from jararaca import Microservice, create_http_server, create_messagebus_worker
-from jararaca.presentation.http_microservice import HttpMicroservice
-
-app = Microservice(
-    providers=[
-        ProviderSpec(
-            provide=Token[AppConfig],
-            use_factory=AppConfig.provider,
-        )
-    ],
-    controllers=[TasksController],
-    interceptors=[
-        AIOSqlAlchemySessionInterceptor(
-            AIOSQAConfig(
-                connection_name="default",
-                url="sqlite+aiosqlite:///db.sqlite3",
-            )
-        ),
-    ],
-)
-
-
-# App for specific Http Configuration Context
-http_app = HttpMicroservice(app)
-
-web_app = create_http_server(app)
-
-```
-
-### Run as a Web Server
-
-```bash
-uvicorn app:web_app --reload
-# or
-jararaca server app:app
-# or
-jararaca server app:http_app
-
-```
-
-### Run as a Message Bus Worker
-
-```bash
-jararaca worker app:app
-```
-
-### Run as a scheduled routine
-
-```bash
-jararaca scheduler app:app
-```
-
-### Generate Typescript intefaces from microservice app controllers
-
-```bash
-jararaca gen-tsi app.main:app app.ts
-```
-
-### Documentation
-
-Documentation is under construction [here](https://luscasleo.github.io/jararaca/).

jararaca/messagebus/types.py

@@ -1,30 +0,0 @@
-from typing import ClassVar, Generic, Literal, Protocol, TypeVar
-
-from pydantic import BaseModel
-
-from jararaca.messagebus.publisher import use_publisher
-
-
-class Message(BaseModel):
-    """
-    Base class for messages representing tasks.
-    A Task is a message that represents a unit of work to be done.
-    It is published to a TaskPublisher and consumed by a TaskHandler, wrapped in TaskData.
-    Note: A Task is not an Event.
-    """
-
-    MESSAGE_TOPIC: ClassVar[str] = "__unset__"
-
-    MESSAGE_TYPE: ClassVar[Literal["task", "event"]] = "task"
-
-    async def publish(self) -> None:
-        task_publisher = use_publisher()
-        await task_publisher.publish(self, self.MESSAGE_TOPIC)
-
-
-INHERITS_MESSAGE_CO = TypeVar("INHERITS_MESSAGE_CO", bound=Message, covariant=True)
-
-
-class MessageOf(Protocol, Generic[INHERITS_MESSAGE_CO]):
-
-    def payload(self) -> INHERITS_MESSAGE_CO: ...