hobbyrpc 0.1.0__tar.gz

hobbyrpc-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.3
+Name: hobbyrpc
+Version: 0.1.0
+Summary: To make RPC clients and servers with Python
+Author: Anatoly Chernov
+Author-email: Anatoly Chernov <chertoly@gmail.com>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+## Introduction
+
+It is a Python package to make [Hobby-RPC][hobby_rpc] clients and servers.
+
+To install:
+
+```
+pip install hobbyrpc
+```
+
+## Clients
+
+A usage example:
+
+```python
+from hobbyrpc import Client
+
+# via tcp
+call = Client(
+    address='http://127.0.0.1:8080',
+    token="authorization token",
+)
+
+# or via unix socket
+call = Client(
+    address='/tmp/path/to/rpc.socket',
+    token="authorization token",
+)
+
+output = call('SomeNullaryFunction')
+output = call('SomeUnaryFunction', **input)
+
+# a call to Compile that compiles CoffeeScript code to JavaScript
+output = call(
+    'Compile',
+    code='answer = 42',
+    bare=True,
+)
+```
+
+`input` and `output` are Python objects serializable to and deserializable from JSON.
+
+## Servers
+
+Not implemented yet.
+
+[hobby_rpc]: https://github.com/ch1c0t/hobby-rpc.protocol

hobbyrpc-0.1.0/README.md

@@ -0,0 +1,47 @@
+## Introduction
+
+It is a Python package to make [Hobby-RPC][hobby_rpc] clients and servers.
+
+To install:
+
+```
+pip install hobbyrpc
+```
+
+## Clients
+
+A usage example:
+
+```python
+from hobbyrpc import Client
+
+# via tcp
+call = Client(
+    address='http://127.0.0.1:8080',
+    token="authorization token",
+)
+
+# or via unix socket
+call = Client(
+    address='/tmp/path/to/rpc.socket',
+    token="authorization token",
+)
+
+output = call('SomeNullaryFunction')
+output = call('SomeUnaryFunction', **input)
+
+# a call to Compile that compiles CoffeeScript code to JavaScript
+output = call(
+    'Compile',
+    code='answer = 42',
+    bare=True,
+)
+```
+
+`input` and `output` are Python objects serializable to and deserializable from JSON.
+
+## Servers
+
+Not implemented yet.
+
+[hobby_rpc]: https://github.com/ch1c0t/hobby-rpc.protocol

hobbyrpc-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "hobbyrpc"
+version = "0.1.0"
+description = "To make RPC clients and servers with Python"
+readme = "README.md"
+authors = [
+    { name = "Anatoly Chernov", email = "chertoly@gmail.com" }
+]
+requires-python = ">=3.13"
+dependencies = []
+
+[project.scripts]
+hobbyrpc = "hobbyrpc:main"
+
+[build-system]
+requires = ["uv_build>=0.9.26,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.3",
+    "pytest-xprocess>=1.0.2",
+]

hobbyrpc-0.1.0/src/hobbyrpc/__init__.py

@@ -0,0 +1 @@
+from .client import Client

hobbyrpc-0.1.0/src/hobbyrpc/client/__init__.py

@@ -0,0 +1,32 @@
+from urllib.parse import urlparse
+from http.client import HTTPConnection, HTTPSConnection
+
+from .unix import UnixSocketConnection
+from .exceptions import NotImplementedScheme
+
+class Client:
+    def __init__(self, address, token=None):
+        if address.startswith('/'):
+            self.http = UnixSocketConnection(address)
+            self.http_path = '/'
+        else:
+            url = urlparse(address)
+            match url.scheme:
+                case 'http':
+                    Connection = HTTPConnection
+                case 'https':
+                    Connection = HTTPSConnection
+                case _:
+                    raise NotImplementedScheme(f'#{url.scheme} of #{url}')
+            self.http = Connection(url.hostname, url.port)
+            self.http_path = url.path
+
+        self.headers = {
+            'Content-type': 'application/json',
+        }
+
+        if token:
+            self.headers['Authorization'] = token
+
+from .call import call
+Client.__call__ = call

hobbyrpc-0.1.0/src/hobbyrpc/client/call.py

@@ -0,0 +1,30 @@
+import json
+from .exceptions import BadRequest, Forbidden, UnexpectedStatus
+
+def call(self, name, **input):
+    body = {
+        'fn': name,
+    }
+
+    if input:
+        body['in'] = input
+
+    self.http.request(
+        'POST', self.http_path,
+        body=json.dumps(body),
+        headers=self.headers,
+    )
+
+    response = self.http.getresponse()
+    raw_data = response.read()
+
+    match response.status:
+        case 200:
+            data = json.loads(raw_data.decode('utf-8'))
+            return data
+        case 400:
+            raise BadRequest
+        case 403:
+            raise Forbidden
+        case _:
+            raise UnexpectedStatus(f'{response.status} in response {response}')

hobbyrpc-0.1.0/src/hobbyrpc/client/exceptions.py

@@ -0,0 +1,11 @@
+class BadRequest(Exception):
+    pass
+
+class Forbidden(Exception):
+    pass
+
+class UnexpectedStatus(Exception):
+    pass
+
+class NotImplementedScheme(Exception):
+    pass

hobbyrpc-0.1.0/src/hobbyrpc/client/unix.py

@@ -0,0 +1,12 @@
+from http.client import HTTPConnection
+from pathlib import Path
+import socket
+
+class UnixSocketConnection(HTTPConnection):
+    def __init__(self, path):
+        self.socket_path = Path(path)
+        super().__init__(host='0.0.0.0')
+
+    def connect(self):
+        self.sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+        self.sock.connect(self.socket_path.as_posix())