معرفی شرکت ها
cobras-2.9.93
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A realtime messaging server using WebSockets and Redis.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | cobras-2.9.93 |
| نام | cobras |
| نسخه کتابخانه | 2.9.93 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Benjamin Sergeant |
| ایمیل نویسنده | bsergean@gmail.com |
| آدرس صفحه اصلی | https://github.com/machinezone/cobra |
| آدرس اینترنتی | https://pypi.org/project/cobras/ |
| مجوز | BSD 3 |
# General
[](https://badge.fury.io/py/cobras)
[](https://travis-ci.org/machinezone/cobra)
[](https://img.shields.io/pypi/pyversions/cobras)
[](https://img.shields.io/pypi/l/cobras)
[](https://img.shields.io/pypi/wheel/cobras)
[](https://codecov.io/gh/machinezone/cobra)
Cobra is a realtime messaging server using Python3, WebSockets and Redis Streams. It was presented in great details during [RedisConf 2019](https://events.redislabs.com/redis-conf/redis-conf-2019/). Since then we've added history support which let cobra retain messages published to a channel that no-one is subscribed to. This makes it easier to blow up your systems through [OOMs](https://en.wikipedia.org/wiki/Out_of_memory) and fill your hard drives, but it makes cobra much more useful.
* [slides](https://bsergean.github.io/redis_conf_2019/slides.html)
* [youtube](https://www.youtube.com/watch?v=o8CC8qYfRQE&t=147s)
[](https://www.youtube.com/watch?v=o8CC8qYfRQE)
Cobra has been used in production receiving heavy traffic for about a year. Since it was written in Python it was named after a snake as an hommage to a great programming language.
There are 4 operations that a client can execute against a cobra server: *publish*, *subscribe*, *read* and *write*. *publish* and *subscribe* are the 2 operations core to a group-chat. *read* and *write* are the typical operations that key value stores (such as memcached), or a python dictionnary provide.
* *publish*: send data to a channel, which will be broadcasted to anyone subscribed to that channel
* *subscribe*: receive events sent to a channel in real time.
* *write*: record some data (addressed by a key)
* *read*: retrieve data
Interested ? Go read the [docs](https://machinezone.github.io/cobra/) ! If things don't work as expected, please create an issue in github, or even better a pull request if you know how to fix your problem.
# News
Cobra is actively being developed, check out the [changelog](docs/CHANGELOG.md) to know what's cooking.
# Installation
## UNIX one liner
```
/bin/sh -c "`curl -fsSL https://raw.githubusercontent.com/machinezone/cobra/master/tools/install.sh`"
```
You can see what the install script is doing first [here](https://github.com/machinezone/cobra/blob/master/tools/install.sh).
## With pip
```
pip install cobras
```
## With docker
```
docker pull bsergean/cobra
```
## With docker-compose
Clone this repo first, then:
```
make docker
docker-compose up
```
Or as a one-liner:
```
(cd /tmp && curl -O https://raw.githubusercontent.com/machinezone/cobra/master/docker-compose.yml && echo 'DOCKER_REPO=bsergean\nTAG=latest' > .env && docker-compose up)
```
## For development
```
git clone <url>
cd cobra
python3 -m venv venv
source venv/bin/activate
make dev
make test
```
# Usage
## Cobra server and test clients
```
$ cobra
Usage: cobra [OPTIONS] COMMAND [ARGS]...
Cobra is a realtime messaging server using Python3, WebSockets and Redis
PubSub.
Options:
--version Show the version and exit.
--help Show this message and exit.
Commands:
admin Run admin commands.
health Health check
init Setup cobra
monitor Monitor cobra
publish Publish to a channel
run Run the cobra server
redis_subscribe Subscribe to a channel (with redis)
subscribe Subscribe to a channel
secret Generate secrets used for authentication...
```
To run the server use `cobra run`. You can run a health-check against the server with `cobra health`.
```
cobra health --endpoint ws://jeanserge.com --appkey _health --rolesecret A5a3BdEfbc6Df5AAFFcadE7F9Dd7F17E --rolename health
```
## bavarde
*bavarde* is a chat client that runs against the public cobra server. Bring up 2 terminals, runs the 2 commands below and start typing.
```
$ bavarde client
...
```
```
$ bavarde client --username bob
...
```
# Setup
`cobras init` needs to be run once to generate an app configuration file, in `~/.cobra.yaml`. That file contains all the roles, secrets and apps configured. Clients will use this data to authenticate.
To run in production you will need a redis (version > 5) instance. Here are environment variables that you will likely want to tweak, to connect to 2 redis instances (for scalabity), and to bind on 0.0.0.0 so that the internet can see your instance.
```
- name: COBRA_HOST
value: 0.0.0.0
- name: COBRA_REDIS_URLS
value: redis://redis1;redis://redis2
# config can be a path to a file
- name: COBRA_APPS_CONFIG_PATH
value: /path/to/your/cobra.yaml
# config can be a blob of gziped + base64 data (if you do not want to mount volumes)
# Generate it with:
# `gzip -c ~/.cobra.yaml | base64`
- name: COBRA_APPS_CONFIG_CONTENT
value: BIGBLOGOFDATA
```
# Thank you
There would be no cobra without some other amazing open-source projects and tech. Here are 3 very remarkable ones.
- [Python](https://www.python.org/) (and [asyncio](https://realpython.com/async-io-python/), one of the killer python3 feature !)
- [Redis](https://redis.io/), the swiss army knife of the internet which provide a very scalable publish/subscribe feature to dispatch messages while retaining them and allowing lookups of old messages (see [Redis Streams] (https://redis.io/topics/streams-intro).
- The python [websockets](https://websockets.readthedocs.io/en/stable/intro.html) library, very elegantly implementing the [WebSockets](https://tools.ietf.org/html/rfc6455) protocol using **asyncio**.
- The python [aioredis](https://aioredis.readthedocs.io/en/v1.2.0/) library used to talk to Redis. This [redis labs](https://redislabs.com/blog/async-await-programming-basics-python-examples/) article explains some pitfalls with asyncio and how to get the best performance out of it.
نیازمندی
| مقدار | نام |
|---|---|
| ==1.3.1 | aioredis |
| ==1.1.8 | aredis |
| >=7.0 | click |
| ==10.0 | coloredlogs |
| ==2.5.0 | daemonize |
| ==1.0.1 | hiredis |
| ==4.18 | humanfriendly |
| ==1.1.0 | klaxon |
| ==5.6.6 | psutil |
| ==1.6.1 | pyaes |
| ==5.2 | PyYAML |
| ==0.9.154 | rcc |
| >=0.13.5 | sentry-sdk |
| ==0.8.5 | tabulate |
| ==1.1 | uhashring |
| ==8.1 | websockets |
| - | wheel |
| - | isort |
| - | mypy |
| - | twine |
| - | black |
| - | pre-commit |
نحوه نصب
نصب پکیج whl cobras-2.9.93:
pip install cobras-2.9.93.whl
نصب پکیج tar.gz cobras-2.9.93:
pip install cobras-2.9.93.tar.gz