communica

Name	communica JSON
Version	0.3.2.post2 JSON
	download
home_page	None
Summary	Easy to use IPC library
upload_time	2024-08-27 21:22:45
maintainer	None
docs_url	None
author	None
requires_python	>=3.8
license	None
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Easy to use IPC library

Sometimes there is no need for complicated
blazingly fast connections with incredible throughput
and even more incredible configuration.
You just want made your processes **communicate** with each other. And that's what this library for.

### Idea

There is two main _entities_: `Client` and `Server`,
which uses `Connectors` to create `Connections`.

The only way client and server differs is who initiate a connection. After successful connect there is
no difference between them, any side can make requests to other.

### Entities

Pairs of Client and Server entities.

| Entity | Description |
| --- | --- |
| Simple | These entities have only one handler and two operations: `request` (send message, wait response, return it) and `throw` (send message and notify responder, that response can be dropped). They use `Serializers` to serialize request data. |
| Route | Similar to simple, but have multiple handlers, identified by exact string match. |

### Connectors:

Things which making connections. Connector can be serialized and passed to other processes, e.g. parent process creates connector, run server with it and start childs, which run clients with same connector.

| Connector | Description |
| --- | --- |
| LocalConnector | Uses Named Pipes on Windows and Unix domain sockets on other systems, if available. This is similar to multiprocessing's connection, but LocalConnector doesn't fallback to TCP. |
| TcpConnector | Uses TCP/IP protocol. |
| RmqConnector | Uses AMQP message broker, can be scaled. |

### Extras

You can install additional dependencies for various features

`pip install communica[extraname1, extraname2]`
| Extra name | Feature |
| --- | --- |
| orjson | Faster JSON library, recommended with CPython. |
| rabbitmq | RmqConnector, which use AMQP server for communication. |

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "communica",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Elchin Sarkarov <elchin751@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/02/1e/9e449cb5e6ae2797b361d1da515d48ab2e5b4d16bb452633d65da02332fe/communica-0.3.2.post2.tar.gz",
    "platform": null,
    "description": "# Easy to use IPC library\r\n\r\nSometimes there is no need for complicated\r\nblazingly fast connections with incredible throughput\r\nand even more incredible configuration.\r\nYou just want made your processes **communicate** with each other. And that's what this library for.\r\n\r\n### Idea\r\n\r\nThere is two main _entities_: `Client` and `Server`,\r\nwhich uses `Connectors` to create `Connections`.\r\n\r\nThe only way client and server differs is who initiate a connection. After successful connect there is\r\nno difference between them, any side can make requests to other.\r\n\r\n### Entities\r\n\r\nPairs of Client and Server entities.\r\n\r\n| Entity | Description |\r\n| --- | --- |\r\n| Simple | These entities have only one handler and two operations: `request` (send message, wait response, return it) and `throw` (send message and notify responder, that response can be dropped). They use `Serializers` to serialize request data. |\r\n| Route | Similar to simple, but have multiple handlers, identified by exact string match. |\r\n\r\n### Connectors:\r\n\r\nThings which making connections. Connector can be serialized and passed to other processes, e.g. parent process creates connector, run server with it and start childs, which run clients with same connector.\r\n\r\n| Connector | Description |\r\n| --- | --- |\r\n| LocalConnector | Uses Named Pipes on Windows and Unix domain sockets on other systems, if available. This is similar to multiprocessing's connection, but LocalConnector doesn't fallback to TCP. |\r\n| TcpConnector | Uses TCP/IP protocol. |\r\n| RmqConnector | Uses AMQP message broker, can be scaled. |\r\n\r\n### Extras\r\n\r\nYou can install additional dependencies for various features\r\n\r\n`pip install communica[extraname1, extraname2]`\r\n| Extra name | Feature |\r\n| --- | --- |\r\n| orjson | Faster JSON library, recommended with CPython. |\r\n| rabbitmq | RmqConnector, which use AMQP server for communication. |\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Easy to use IPC library",
    "version": "0.3.2.post2",
    "project_urls": {
        "Bug Tracker": "https://github.com/Elchinchel/communica/issues",
        "Homepage": "https://github.com/Elchinchel/communica"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "230430be4857eca3cb78d9b9148392c75a98130db87670d88adae44de828097f",
                "md5": "7063a41aca205ec769e4b3feb751f67d",
                "sha256": "b21e413de5686af1dd8447f6cf5f738f0d555eb63039ca9b93bb16eeef411c0c"
            },
            "downloads": -1,
            "filename": "communica-0.3.2.post2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7063a41aca205ec769e4b3feb751f67d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 40128,
            "upload_time": "2024-08-27T21:22:43",
            "upload_time_iso_8601": "2024-08-27T21:22:43.816087Z",
            "url": "https://files.pythonhosted.org/packages/23/04/30be4857eca3cb78d9b9148392c75a98130db87670d88adae44de828097f/communica-0.3.2.post2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "021e9e449cb5e6ae2797b361d1da515d48ab2e5b4d16bb452633d65da02332fe",
                "md5": "f7a6efa912e28112b857d5388b8acedd",
                "sha256": "31ea2023542c88a32de031e6c525fd79a82d35c2786a6b07268ea9cc496e20f8"
            },
            "downloads": -1,
            "filename": "communica-0.3.2.post2.tar.gz",
            "has_sig": false,
            "md5_digest": "f7a6efa912e28112b857d5388b8acedd",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 32852,
            "upload_time": "2024-08-27T21:22:45",
            "upload_time_iso_8601": "2024-08-27T21:22:45.493532Z",
            "url": "https://files.pythonhosted.org/packages/02/1e/9e449cb5e6ae2797b361d1da515d48ab2e5b4d16bb452633d65da02332fe/communica-0.3.2.post2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-27 21:22:45",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Elchinchel",
    "github_project": "communica",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "communica"
}