snekrpc
snekrpc is a lightweight Python RPC toolkit focused on fast prototyping for microservices and distributed systems. It ships a small core, with pluggable transports and codecs. A client-side Python library and CLI are generated at runtime based on metadata from services.
Features
- Simple service model with metadata and runtime introspection
- Bi-directional streaming
- Built-in transports: TCP, Unix domain sockets, and HTTP (not REST)
- Built-in codecs: JSON and MessagePack (based on msgspec)
- Built-in services:
health,file, andremote(service pivoting/forwarding) - Runtime generated client API
- Runtime generated client CLI
- Pre-generated typed client API
Requirements
- Python 3.11+.
Installation
$ pip install snekrpc
For development:
$ git clone https://github.com/dhagrow/snekrpc.git
$ cd snekrpc
$ uv sync
Quick start
Define a service and start a server
import snekrpc
class EchoService(snekrpc.Service, name='echo'):
@snekrpc.command()
def echo(self, value: str) -> str:
return value
server = snekrpc.Server()
server.add_service(EchoService())
server.serve()
The server will bind to tcp://127.0.0.1:12321, by default. The client API and CLI will also connect to this, by default.
You can pass in a different address in the same URL format, where the scheme determines the transport to use (e.g. http://localhost:5000).
Call with a client API
import snekrpc
client = snekrpc.Client()
echo_svc = client.service('echo')
print(echo_svc.echo('hello'))
Call with a client CLI
List available services and call a command:
$ snekrpc
usage: snekrpc [-h] ...
{echo} ...
# snekrpc <service-name> <command-name> <command-argument>
$ snekrpc echo echo hello
hello
Streaming
If a command accepts or returns an iterable/generator, it is streamed over the transport. Note that streaming to the server is only supported in the first argument of a command.
class FileService(snekrpc.Service, name='file'):
@snekrpc.command()
def download(self, path: str) -> Iterable[bytes]:
with open(path, 'rb') as fp:
for chunk in iter(lambda: fp.read(8192), b''):
yield chunk
@snekrpc.command()
def upload(self, data: Iterable[bytes], path: str) -> None:
with open(path, 'wb') as fp:
for chunk in data:
fp.write(chunk)
On the CLI, streaming arguments accept a file path or - for stdin.
What about asyncio?
There is not currently any support provided for asyncio. This is primarily due to the fact that I don't personally use asyncio in either my personal or professional work. Where I need asynchronous IO, I first reach for gevent. However I have found fewer and fewer appropriate use-cases for it over the years.
I'm not opposed to making changes that simplify the integration of snekrpc with a project that uses asyncio, and will consider any PR to that end. However, I'm not willing to take on the maintenance burden of a feature I don't need or use. Besides, I'd rather be working on the projects this library enables.
See also:
AI disclosure
I used AI to support some of the documentation for this project. I reviewed all of it and rewrote much of it. I have not yet used AI to write any of the code, though I do have branches I may experiment with.
Contributing
Issues and pull requests are welcome. Please include tests for behavioral changes and keep the public API backwards compatible where possible.
Source code is available at https://github.com/dhagrow/snekrpc.
License
MIT
Metadata
Release files for snekrpc 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| snekrpc-0.8.1.tar.gz | 29.6 kB | Without provenance | Details for snekrpc-0.8.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| snekrpc-0.8.1-py3-none-any.whl | Python 3 | none | any | Details for snekrpc-0.8.1-py3-none-any.whl |
Total release size: 72.0 kB
Release files / snekrpc-0.8.1.tar.gz
| Download URL | snekrpc-0.8.1.tar.gz |
|---|---|
| Size | 29.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cd8c8eadea8536754f272354218783df8c05807860468272974c46fbaad05707
|
|
BLAKE2b-256 checksum How to use checksums |
9e69f10038f90fe0a457b0ea024f3d5e60d1635a926caef2a86a40a760c8c43c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.24
|
Release files / snekrpc-0.8.1-py3-none-any.whl
| Download URL | snekrpc-0.8.1-py3-none-any.whl |
|---|---|
| Size | 42.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
39c16a1ab97f9d5321054291ae4e550731ae1518ef4727ee671ab0bbb40a00a2
|
|
BLAKE2b-256 checksum How to use checksums |
00eacd32dc0d9f5b9ebbe2c75df0049a3e0b874470ef42d51f754f357ef5bd15
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.24
|
Security for snekrpc 0.8.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.