Metadata-Version: 2.1
Name: callosum
Version: 0.9.3
Summary: Callosum RPC Library
Home-page: https://github.com/lablup/callosum
Author: Lablup Inc.
Author-email: joongi@lablup.com
License: MIT
Description: Callosum
        ========
        
        An RPC Transport Library
        
        It provides an asynchronous multi-channel order-preserving message and data
        streaming transport for *upper* RPC layers (e.g., Apache Thrift) by wrapping
        *lower* transport implementations (e.g., ZeroMQ).
        
        It aims to follow the latest coding style and conventions in Python asyncio.
        
        *Corpus callosum* is a bundle of neuron fibers that connects two cerebral
        hemispheres of a human brain.
        
        Prerequisite
        ------------
        
        Python 3.8 or higher.
        
        Features
        --------
        
        * RPC
          - Native timeout and cancellation support
          - Explicit server-to-client error propagation including stringified tracebacks
          - Order preserving based on user-defined keys while keeping executions asynchronous
          - Concurrency limits based on [aiojobs](https://github.com/aio-libs/aiojobs)
        * Streaming
          - Broadcast & shared pipelines
        * Optional client authentication and encrypted communication
          - Currently supported for only ZeroMQ with its CURVE library
        * Optional message compression using [snappy](https://pypi.org/project/python-snappy/)
        * Replacible and combinable lower/upper layers (ZeroMQ/Redis + JSON/msgpack/Thrift)
        
        Planned features
        ----------------
        
        * Managed streaming (with acks)
        * Tunneling to bundle other channels and generic network traffic in a single connection
        * Bidirectional RPC
        * Chunked transfer of large messages
        
        Installation
        ------------
        
        To install the core:
        
        ```console
        $ pip install -U pip setuptools
        $ pip install callosum
        ```
        
        You may add extra dependencies like:
        
        ```console
        $ pip install 'callosum[zeromq,redis,thrift,snappy]'
        ```
        
        Examples
        --------
        
        Please check out [the examples directory.](https://github.com/lablup/callosum/tree/master/examples)
        
        Development
        -----------
        
        Use the editable installation of Python setuptools.
        
        ```console
        $ pip install -U pip setuptools
        $ pip install -U -e '.[dev,build,test,zeromq,redis,thrift,snappy]'
        ```
        
        
        Changes
        =======
        
        v0.9.3 (2020-03-20)
        -------------------
        
        * FIX: Mitigate bogus KeyError when cleaning up task futures in RPC servers that has caused event
          loop spinning.
        
        v0.9.2 (2020-02-28)
        -------------------
        
        * MAINTENANCE: Update dependencies and only specify the minimum versions since
          Callosum is a library.
        
        v0.9.1 (2020-01-05)
        -------------------
        
        * FIX: wrong typing of `RPCMessage.body` field
        
        * IMPROVE: Add `debug_rpc` option to `rpc.Peer` for logging exceptions in RPC
          scheduler and user-defined handlers explicitly.
        
        * Update dependencies and remove unused ones.
        
        v0.9.0 (2019-12-06)
        -------------------
        
        * First public release with a working RPC based on ZeroMQ DEALER/ROUTER sockets.
        
        2018-05-02
        ----------
        
        * Started the project.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Communications
Classifier: Topic :: Internet
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: build
Provides-Extra: test
Provides-Extra: dev
Provides-Extra: lint
Provides-Extra: typecheck
Provides-Extra: docs
Provides-Extra: thrift
Provides-Extra: zeromq
Provides-Extra: redis
Provides-Extra: snappy
