Python implementation of fastrpc protocol
Project description
Pyfrpc
Pyfrpc is a Python implementation of FastRPC protocol/library ( @github or @sourceforge ). The original library contains Python bindings, but:
- I prefer python packages without dependencies on debian packages.
- Its flexibility is limited in some points. E.g. the library provides its own implementation of HTTP server and client, which is nice to have in C++, but not in Python I would say as there are already full-featured and more mature libraries available for those tasks.
- In my opinion it's not worth to wrap such a library for python anyway (at least not from today's perspective). The original binding itself is 3500 lines of code. So this is an alternative aproach.
- And I want to use it as a showcase for cython as well.
This library provides FastRPC encoding/decoding functions, FastRPC client (based on 'requests') and an interactive FastRPC client/terminal 'pyfrpc' (an alternative to 'fastrpc-netcat' based on 'IPython'). API mostly differs and is not meant to be a drop-in replacement.
It is compatible with protocol versions 1.0, 2.0, 2.1 and 3.0.
Package provides both cython (C extencion) and pure python implementations.
Cython implementation is faster but requires C toolchain (or available python
wheels). To use pure python implementation set env variable PYFRPC_NOEXT=1
during installation.
Some features missing are:
- handling of base64 encoded FastRPC
- helper to build a server
Interactive client
Interactive client opens na ipython session with varible client
initialized to
FastFRPC connection. It supports tab-based completion of remote procedures'
names as well as shownig their documentation using question mark notation as is
usual in ipython.
$ pyfrpc --help
usage: pyfrpc [-h] [--insecure] URL
FRPC netcat for interactive connection to FRPC server
positional arguments:
URL URL of FRPC server to connect to
optional arguments:
-h, --help show this help message and exit
--insecure Do not check server's cert
$ pyfrpc http://my-avesome-server
In [1]: client.greeting?
...
Docstring: Prints greeting.
In [2]: client.greeting()
Out[2]:
'hello from server'
Benchmark
2020-12-02, Python3.7 @ debian buster:
+------------------------+----------+----------+----------+
| description | encoding | decoding | total |
+------------------------+----------+----------+----------+
| pyfrpc | 1.6ms | 3.6ms | 5.3ms |
| ujson | 5.1ms | 4.7ms | 9.9ms |
| fastrpc | 3.2ms | 7.0ms | 10.2ms |
| json | 7.0ms | 5.2ms | 12.3ms |
| pyfastrpc | 59.2ms | 77.2ms | 136.3ms |
+------------------------+----------+----------+----------+
2017-12-29, benchmarks during library development:
+------------------------+----------+----------+----------+
| description | encoding | decoding | total |
+========================+==========+==========+==========+
| fastrpc (original lib) | 1.7 ms | 5.7 ms | 7.5 ms |
+------------------------+----------+----------+----------+
| python | 35.1 ms | 25.8 ms | 60.8 ms |
+------------------------+----------+----------+----------+
| pypy | 12.6 ms | 5.2 ms | 17.8 ms |
+------------------------+----------+----------+----------+
| cython (naive) | 17.9 ms | 43.1 ms | 61.0 ms |
| cython (cdef) | 11.9 ms | 22.6 ms | 34.4 ms |
| cython (static typing) | 2.2 ms | 3.7 ms | 5.9 ms |
| cython (low level api) | 1.3 ms | 3.7 ms | 4.9 ms |
+------------------------+----------+----------+----------+
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for pyfrpc-0.2.10-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | db48ccecbd5965a5ffadad6f2b792417571c49855172607767018bc2b3c77ed9 |
|
MD5 | e88a7aaaf891efb4f0c9ff48a6fbba5e |
|
BLAKE2b-256 | cddb9fbd1697b20e770df5f0dfbf44fbf144b24a3d690a453fe59152d1a2d625 |
Hashes for pyfrpc-0.2.10-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c2a931f7081733df3c7d7d6a9c3f520ad9a03368166ad1d80e22a1d3bee95919 |
|
MD5 | 6813a0059d76c074744d0506b38f3fdf |
|
BLAKE2b-256 | d9e447d43d7e333b45694955b19bc737daa543486470733d0d1ff4e24cb6fd68 |
Hashes for pyfrpc-0.2.10-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8b743abf2a5e5ae7dc52a7b3e8b887069f0e9da2fb97c24b4cb491ed63159572 |
|
MD5 | f131259adad672960cc99b3c6e8e96d7 |
|
BLAKE2b-256 | 7cdeb79329bdff7fb297729c88fbd0f017b1f65a192da2454b7a060647074793 |
Hashes for pyfrpc-0.2.10-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 28a7f205768f597c50a0becbaf8634829a7604bbd1d7fdf129406594ff929cbe |
|
MD5 | 24831a0a56c1810bd1bcf73712185b22 |
|
BLAKE2b-256 | b84efa8992efac12847890605bd307406b698e5d0947a84e00dc001ca2320318 |
Hashes for pyfrpc-0.2.10-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 48e5bc1c67ae6755f0aa070e2144d1c26616e2c313c785354cae4152053feeac |
|
MD5 | a0364dab4f2971242a1747e1896351ab |
|
BLAKE2b-256 | 7fe5e4fd9b32bcbd63bab13eb349eb916929ecd8c0bc5122a09153dee9c2cf53 |
Hashes for pyfrpc-0.2.10-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7805dfb3e0ff7d80e987659013ce479cc3e8c2e9ebcb22ae5f821ade8ad81b62 |
|
MD5 | cbb301981804a3cc044ec0d1c4253e67 |
|
BLAKE2b-256 | 718c21014c6b9a7b878e474e432b26bbc0aff9f98652404306c9bd9bfcbb3110 |