ephaptic 0.2.0__tar.gz → 0.2.2__tar.gz

{ephaptic-0.2.0 → ephaptic-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ephaptic
-Version: 0.2.0
+Version: 0.2.2
 Summary: The Python client/server package for ephaptic.
 Author-email: uukelele <robustrobot11@gmail.com>
 License: MIT License
@@ -132,6 +132,8 @@ async def add(num1: int, num2: int) -> int:
     return num1 + num2
 ```
 
+###### If you're trying to expose functions statelessly, e.g. in a different file, feel free to instead import and use the `expose` function from the library instead of the instance. Please note that if you do this, you must define all exposed functions *before* creating the ephaptic instance - easily done by simply placing your import line above the ephaptic constructor. The same thing can be done with the global `identity_loader` decorator.
+
 Yep, it's really that simple.
 
 But what if your code throws an error? No sweat, it just throws up on the frontend, with the error name.

{ephaptic-0.2.0 → ephaptic-0.2.2}/README.md

@@ -90,6 +90,8 @@ async def add(num1: int, num2: int) -> int:
     return num1 + num2
 ```
 
+###### If you're trying to expose functions statelessly, e.g. in a different file, feel free to instead import and use the `expose` function from the library instead of the instance. Please note that if you do this, you must define all exposed functions *before* creating the ephaptic instance - easily done by simply placing your import line above the ephaptic constructor. The same thing can be done with the global `identity_loader` decorator.
+
 Yep, it's really that simple.
 
 But what if your code throws an error? No sweat, it just throws up on the frontend, with the error name.
@@ -178,4 +180,4 @@ const client = connect(...);
 
 <p align="center">
     &copy; ephaptic 2025
-</p>
+</p>

{ephaptic-0.2.0 → ephaptic-0.2.2}/ephaptic/__init__.py

@@ -1,6 +1,8 @@
 from .ephaptic import (
     Ephaptic,
-    active_user
+    active_user,
+    expose,
+    identity_loader,
 )
 
 from .client import (

{ephaptic-0.2.0 → ephaptic-0.2.2}/ephaptic/ephaptic.py

@@ -51,9 +51,12 @@ class ConnectionManager:
         for user_id in user_ids:
             if user_id in self.active:
                 for transport in list(self.active[user_id]):
-                    try:
-                        await transport.send(payload)
-                    except: pass
+                    asyncio.create_task(self._safe_send(transport, payload))
+
+    async def _safe_send(self, transport: Transport, payload: bytes):
+        try:
+            await transport.send(payload)
+        except: ...
 
     async def start_redis(self):
         if not self.redis: return
@@ -67,6 +70,9 @@ class ConnectionManager:
 
 manager = ConnectionManager()
 
+_EXPOSED_FUNCTIONS = {}
+_IDENTITY_LOADER: Optional[Callable] = None
+
 class EphapticTarget:
     def __init__(self, user_ids: list[str]):
         self.user_ids = user_ids
@@ -76,6 +82,14 @@ class EphapticTarget:
             await manager.broadcast(self.user_ids, name, list(args), dict(kwargs))
         return emitter
     
+def expose(func: Callable):
+    _EXPOSED_FUNCTIONS[func.__name__] = func
+    return func
+    
+def identity_loader(func: Callable):
+    _IDENTITY_LOADER = func
+    return func
+
 class Ephaptic:
     _exposed_functions: Dict[str, Callable] = {}
     _identity_loader: Optional[Callable] = None
@@ -111,6 +125,9 @@ class Ephaptic:
             case _:
                 raise TypeError(f"Unsupported app type: {module}")
             
+        cls._exposed_functions = _EXPOSED_FUNCTIONS.copy()
+        cls._identity_loader = _IDENTITY_LOADER
+
         return instance
 
             
@@ -178,7 +195,7 @@ class Ephaptic:
 
                     if func_name in self._exposed_functions:
                         target_func = self._exposed_functions[func_name]
-                        sig = inspect.signature(target_func)
+                        sig = inspect.signature(target_func)                      
                         try:
                             bound = sig.bind(*args, **kwargs)
                             bound.apply_defaults()
@@ -188,6 +205,8 @@ class Ephaptic:
 
                         hints = typing.get_type_hints(target_func)
 
+                        return_type = hints.get("return", typing.Any)
+
                         errors = []
 
                         for name, val in bound.arguments.items():
@@ -202,7 +221,11 @@ class Ephaptic:
                         if errors:
                             await transport.send(msgpack.dumps({
                                 "id": call_id,
-                                "error": errors,
+                                "error": {
+                                    "code": "VALIDATION_ERROR",
+                                    "message": "Validation failed.",
+                                    "data": errors,
+                                },
                             }))
                             continue
 
@@ -211,9 +234,21 @@ class Ephaptic:
 
                         try:
                             result = await self._async(target_func)(**bound.arguments)
-                            if isinstance(result, pydantic.BaseModel):
-                                result = result.model_dump()
+
+                            if return_type is not inspect.Signature.empty:
+                                try:
+                                    adapter = pydantic.TypeAdapter(return_type)
+                                    validated = adapter.validate_python(result, from_attributes=True)
+                                    result = adapter.dump_python(validated, mode='json')
+                                except: ...
+                            elif isinstance(result, pydantic.BaseModel):
+                                result = result.model_dump(mode='json')
+
                             await transport.send(msgpack.dumps({"id": call_id, "result": result}))
+                        # except pydantic.ValidationError as e:
+                            # Should we really treat this separately?
+                            # For input it's understandable, but for server responses it feels like a server issue.
+                            # Ok, let's treat this like any other server error.
                         except Exception as e:
                             await transport.send(msgpack.dumps({"id": call_id, "error": str(e)}))
                         finally:

{ephaptic-0.2.0 → ephaptic-0.2.2}/ephaptic.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ephaptic
-Version: 0.2.0
+Version: 0.2.2
 Summary: The Python client/server package for ephaptic.
 Author-email: uukelele <robustrobot11@gmail.com>
 License: MIT License
@@ -132,6 +132,8 @@ async def add(num1: int, num2: int) -> int:
     return num1 + num2
 ```
 
+###### If you're trying to expose functions statelessly, e.g. in a different file, feel free to instead import and use the `expose` function from the library instead of the instance. Please note that if you do this, you must define all exposed functions *before* creating the ephaptic instance - easily done by simply placing your import line above the ephaptic constructor. The same thing can be done with the global `identity_loader` decorator.
+
 Yep, it's really that simple.
 
 But what if your code throws an error? No sweat, it just throws up on the frontend, with the error name.

{ephaptic-0.2.0 → ephaptic-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ephaptic"
-version = "0.2.0"
+version = "0.2.2"
 authors = [
     { name="uukelele", email="robustrobot11@gmail.com" },
 ]