From f8177ff97d77e29fa52ed55fb340fc63af90001f Mon Sep 17 00:00:00 2001 From: Alexander Pickering Date: Mon, 13 Jul 2020 16:38:42 -0400 Subject: Add readme Add a readme with a usage example --- README.md | 27 +++++++++++++++++++++++++++ lua-nng-dev-1.rockspec | 3 ++- 2 files changed, 29 insertions(+), 1 deletion(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..188af88 --- /dev/null +++ b/README.md @@ -0,0 +1,27 @@ +# lua-nng + +This is a simple binding of [Nanomessage Next Generation](https://github.com/nanomsg/nng) to lua. + +## Installation + +The easiest way to download lua-nng is with [luarocks](https://github.com/luarocks/luarocks) + +``` +luarocks install --server=http://rocks.cogarr.net lua-nng +``` + +## Example + + local s1 = nng.pair1_open() + local s2 = nng.pair1_open() + + s1:listen("ipc:///tmp/pair.ipc") + s2:dial("ipc://tmp/pair.ipc") + + s2:send("hello") + print(s1:recv()) + +prints "hello" + +For more examples, see sepc/start\_spec.lua + diff --git a/lua-nng-dev-1.rockspec b/lua-nng-dev-1.rockspec index 5cf013f..0be82f6 100644 --- a/lua-nng-dev-1.rockspec +++ b/lua-nng-dev-1.rockspec @@ -2,7 +2,8 @@ package = "lua-nng" rockspec_format="3.0" version = "dev-1" source = { - url = "*** please add URL for source tarball, zip or repository here ***" + url = "git+https://cogarr.net/source/cgit.cgi/lua-nng", + tag = "v0.1" } description = { summary = "A simple binding for Nanomessage Next Generation", -- cgit v1.2.3-70-g09d2