Metadata-Version: 2.1
Name: callosum
Version: 0.9.0
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)
        
        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
        =======
        
        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 :: 3 - Alpha
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: docs
Provides-Extra: thrift
Provides-Extra: zeromq
Provides-Extra: redis
Provides-Extra: snappy
