eric-api 0.0.1__tar.gz

eric_api-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Luca Stretti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eric_api-0.0.1/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.3
+Name: eric-api
+Version: 0.0.1
+Summary: A Server side events based messaging microservice implementation
+License: MIT
+Keywords: Server side events,microservice,messaging
+Author: Luca Stretti
+Author-email: laxertu@gmail.com
+Requires-Python: >=3.10,<3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Dist: dotenv (>=0.9.9,<0.10.0)
+Requires-Dist: eric-sse (>=0.7.1,<0.8.0)
+Requires-Dist: fastapi (>=0.115.12,<0.116.0)
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: sse-starlette (>=2.2.1,<3.0.0)
+Requires-Dist: uvicorn (>=0.34.1,<0.35.0)
+Project-URL: Issues, https://github.com/laxertu/eric-api/issues
+Project-URL: Repository, https://github.com/laxertu/eric-api
+Description-Content-Type: text/markdown
+
+A ready-to-use SSE messaging microservice implementation. 
+Intended for internal use only (all is public here by the moment).
+
+Backend relies on https://github.com/laxertu/eric  
+REST services rely on FastApi + Uvicorn
+
+Features:
+* channel subscription
+* broadcasting
+* message deliver to one client
+* SSE compliant streaming
+
+Installation:
+
+    pip install eric-api
+
+Start webserver
+
+    start-ws
+
+Some configuration is allowed by the following environment variables.
+You can set them in a .env file:
+
+    ERIC_API_HOST
+    ERIC_API_PORT
+    ERIC_API_LOG_LEVEL
+
+See correspondant uvicorn configuration https://www.uvicorn.org/deployment/#running-from-the-command-line for ERIC_API_LOG_LEVEL 
+
+

eric_api-0.0.1/README.md

@@ -0,0 +1,29 @@
+A ready-to-use SSE messaging microservice implementation. 
+Intended for internal use only (all is public here by the moment).
+
+Backend relies on https://github.com/laxertu/eric  
+REST services rely on FastApi + Uvicorn
+
+Features:
+* channel subscription
+* broadcasting
+* message deliver to one client
+* SSE compliant streaming
+
+Installation:
+
+    pip install eric-api
+
+Start webserver
+
+    start-ws
+
+Some configuration is allowed by the following environment variables.
+You can set them in a .env file:
+
+    ERIC_API_HOST
+    ERIC_API_PORT
+    ERIC_API_LOG_LEVEL
+
+See correspondant uvicorn configuration https://www.uvicorn.org/deployment/#running-from-the-command-line for ERIC_API_LOG_LEVEL 
+

eric_api-0.0.1/eric_api.py

@@ -0,0 +1,71 @@
+import os
+import uvicorn
+from logging import getLogger
+
+from dotenv import load_dotenv
+from fastapi import FastAPI, Request
+from eric_sse.entities import Message
+from eric_sse.servers import SSEChannelContainer
+from pydantic import BaseModel
+from sse_starlette.sse import EventSourceResponse
+
+logger = getLogger(__name__)
+load_dotenv()
+
+channel_container = SSEChannelContainer()
+
+class MessageDto(BaseModel):
+    type: str
+    payload: dict | list | str | int | float | None
+
+    def to_message(self) -> Message:
+        return Message(msg_type=self.type, msg_payload=self.payload)
+
+app = FastAPI()
+
+@app.put("/create")
+async def create():
+    channel = channel_container.add()
+    return {"channel_id": channel.id}
+
+
+@app.post("/subscribe")
+async def subscribe(channel_id: str):
+    l = channel_container.get(channel_id).add_listener()
+    return {"listener_id": l.id}
+
+@app.post("/broadcast")
+async def broadcast(channel_id: str, msg: MessageDto):
+    channel_container.get(channel_id).broadcast(msg.to_message())
+    return None
+
+@app.post("/dispatch")
+async def send(channel_id: str, listener_id: str, msg: MessageDto):
+    channel_container.get(channel_id).dispatch(listener_id, msg.to_message())
+
+@app.get("/stream/{channel_id}/{listener_id}")
+async def stream(request: Request, channel_id: str, listener_id: str):
+    channel = channel_container.get(channel_id)
+    listener = channel.get_listener(listener_id)
+    await listener.start()
+    #logger.info(f"wget -q -S -O - 127.0.0.1:8000/stream/{channel_id}/{listener_id} 2>&1")
+    if await request.is_disconnected():
+        await listener.stop()
+    return EventSourceResponse(await channel.message_stream(listener))
+
+@app.delete("/listener/{channel_id}/{listener_id}")
+async def delete_listener(channel_id: str, listener_id: str):
+    channel_container.get(channel_id).remove_listener(listener_id)
+
+@app.delete("/channel/{channel_id}")
+async def delete_channel(channel_id: str):
+    channel_container.rm(channel_id)
+
+
+
+def run():
+    host = os.getenv("ERIC_API_HOST", "0.0.0.0")
+    port = int(os.getenv("ERIC_API_PORT", 8000))
+    log_level = os.getenv("ERIC_API_LOG_LEVEL", "info")
+
+    uvicorn.run(app=app, host=host, port=port, log_level=log_level)

eric_api-0.0.1/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "eric-api"
+version = "0.0.1"
+description = "A Server side events based messaging microservice implementation"
+keywords = ["Server side events", "microservice", "messaging"]
+
+authors = [
+    {name = "Luca Stretti",email = "laxertu@gmail.com"}
+]
+
+
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.10,<3.12"
+dependencies = [
+    "requests (>=2.32.3,<3.0.0)",
+    "eric-sse (>=0.7.1,<0.8.0)",
+    "fastapi (>=0.115.12,<0.116.0)",
+    "sse-starlette (>=2.2.1,<3.0.0)",
+    "uvicorn (>=0.34.1,<0.35.0)",
+    "dotenv (>=0.9.9,<0.10.0)"
+]
+
+[project.urls]
+Repository = "https://github.com/laxertu/eric-api"
+Issues = "https://github.com/laxertu/eric-api/issues"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.scripts]
+start-ws = 'eric_api:run'
+
+[tool.setuptools_scm]
+