Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zeromq/lzmq
Lua binding to ZeroMQ
https://github.com/zeromq/lzmq
ffi lua lua-bindings messaging zeromq zmq
Last synced: about 1 month ago
JSON representation
Lua binding to ZeroMQ
- Host: GitHub
- URL: https://github.com/zeromq/lzmq
- Owner: zeromq
- License: mit
- Created: 2012-08-13T11:29:53.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2020-07-20T18:34:06.000Z (over 4 years ago)
- Last Synced: 2024-12-07T07:11:47.293Z (about 2 months ago)
- Topics: ffi, lua, lua-bindings, messaging, zeromq, zmq
- Language: Lua
- Homepage:
- Size: 646 KB
- Stars: 137
- Watchers: 13
- Forks: 46
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Lua binding to [ZeroMQ](http://zeromq.org) library.
[](https://travis-ci.org/zeromq/lzmq)
[](https://coveralls.io/r/zeromq/lzmq?branch=master)
[](LICENCE.txt)
Support ZeroMQ version 3.2.x/4.x
This library is not dropin replacement for [lua-zmq](https://github.com/Neopallium/lua-zmq) library.
This library has C and FFI version of binding.
## Source Code
https://github.com/zeromq/lzmq
## Install
If you plan use `lzmq.threads` module then you should also install [llthreads2](https://github.com/moteus/lua-llthreads2)
* Using *LuaRocks*:
`luarocks install lua-llthreads2` or `luarocks install lua-llthreads2-compat`
`luarocks install lzmq` or install only ffi version `luarocks install lzmq-ffi`
* Using *LuaDist*:
`luadist install lua-llthreads2` or `luadist install lua-llthreads2-compat`
`luadist install lzmq` or `luadist install lzmq-ffi`
## API
This is short [API](http://moteus.github.io/lzmq/index.html) description.
See also [exampes](https://github.com/moteus/lzmq-zguide) from [OMQ - The Guide](http://zguide.zeromq.org).
## Performance
To run same test you should copy original performance tests to `exampes/perf2/libzmq`
and run `runner.lua` from `exampes/perf2`. For now it require LuaJIT and exists
C and FFI version of `lzmq` library.
Of course you can run any test manually.
### Inproc Throughput Test:
message size: 30 [B]
message count: 10000
mean throughput [Mb/s]:
| # | libzmq | str | str(ffi) | msg | msg(ffi) |
|---|------------|------------|------------|------------|------------|
| 1 |349.396 |307.141 |393.636 |186.162 |239.617 |
| 2 |350.007 |310.398 |412.371 |188.132 |248.011 |
| 3 |377.596 |311.284 |413.010 |205.076 |281.228 |
| 4 |422.535 |308.206 |414.007 |174.406 |248.679 |
| 5 |392.477 |311.324 |411.876 |181.722 |274.946 |
| 6 |382.470 |309.917 |395.127 |177.528 |631.413 |
| 7 |393.636 |324.851 |415.010 |186.437 |282.686 |
| 8 |386.910 |303.298 |379.627 |116.919 |268.908 |
| 9 |397.022 |311.931 |415.945 |187.749 |244.998 |
| 10|438.196 |302.763 |412.229 |189.813 |255.646 |
### Inproc Latency Test:
message size: 1 [B]
message count: 10000
average latency [us]:
| # | libzmq | str | str(ffi) | msg | msg(ffi) |
|---|------------|------------|------------|------------|------------|
| 1 |97.356 |97.378 |98.221 |94.274 |96.880 |
| 2 |95.828 |96.736 |95.957 |100.711 |96.992 |
| 3 |99.656 |100.347 |95.672 |97.981 |95.312 |
| 4 |96.649 |99.943 |94.543 |96.198 |94.674 |
| 5 |96.013 |102.196 |94.184 |97.575 |94.990 |
| 6 |96.371 |97.925 |98.377 |95.350 |97.165 |
| 7 |96.253 |93.625 |97.198 |94.856 |94.544 |
| 8 |95.155 |96.371 |94.904 |96.792 |95.507 |
| 9 |94.703 |96.698 |96.924 |97.951 |95.527 |
| 10|95.635 |97.946 |95.684 |96.429 |92.629 |
----
### Incompatibility list with lua-zmq (this is not full)
| Feature | lua-zmq | lzmq |
|----------------------|------------------------|--------------------------|
|global zmq variable | create | does not create |
|zmq.init | io_threads optional | io_threads require |
|create message | zmq.zmq_msg_t.init_XXX | zmq.msg_init_XXX |
|message as string | tostring(msg) | msg:data()/tostring(msg) |
|message as ud | msg:data() | msg:pointer() |
|msg:close();msg:data()| AV | lua error |