mangos-v2 is version 2 of an implementation in pure Go of the SP ("Scalable Protocols") protocols
Switch branches/tags
Nothing to show
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci fixes #28 CircleCI working directory busted Oct 30, 2018
errors Clean up req and xreq. Add common errors package. Oct 16, 2018
examples fixes #46 Context demos needed Nov 2, 2018
internal/core fixes #69 Accept spinning terribly Nov 2, 2018
macat Git ignore binary programs. Oct 16, 2018
perf fixes #51 Changing queue depths should just discard queue contents Oct 30, 2018
protocol fixes #62 REP and RESPONDENT backtrace header collision Nov 1, 2018
test fixes #69 Benchmark tests are busted Nov 2, 2018
transport fixes #42 Use net.Buffers Nov 2, 2018
.appveyor.yml fixes #48 Figure out appveyor again Oct 31, 2018
.codecov.yml Exclude test files from coverage analysis. Oct 31, 2018
.gitignore Add circleci workflow. May 24, 2018
.travis.yml Don't test old versions. Oct 12, 2018
AUTHORS fixes #46 Context demos needed Nov 2, 2018
CHANGES-v2.adoc fixes #38 Applications should not have to call socket.AddTransport() Oct 31, 2018
CODE_OF_CONDUCT.md Add CODE_OF_CONDUCT, fix type in CONTRIBUTING. Nov 27, 2017
CONTRIBUTING fixes #34 Update warnings about release Oct 30, 2018
LICENSE fixes #65 Need a LICENSE file added to repo. Feb 4, 2015
README.adoc fixes #34 Update warnings about release Oct 30, 2018
device.go Sometimes messages misordered by device. Oct 22, 2018
dialer.go Dialer doco fix Sep 17, 2018
doc.go fixes #229 gopkg.in import broken. Jun 8, 2018
errors.go Clean up req and xreq. Add common errors package. Oct 16, 2018
go.mod fixes #78 Issue with using v2 in go module project Dec 1, 2018
go.sum fixes #78 Issue with using v2 in go module project Dec 1, 2018
listener.go Dialer doco fix Sep 17, 2018
mangos.jpg fixes #121 Add Appveyor status image. Mar 20, 2015
message.go fixes #3 Refactor the PortHook API. Oct 30, 2018
options.go fixes #1 Dial should be synchronous by default Oct 28, 2018
pipe.go fixes #51 Changing queue depths should just discard queue contents Oct 30, 2018
protocol.go fixes #23 Remove protocol.ProtocolName() Oct 30, 2018
socket.go fixes #38 Applications should not have to call socket.AddTransport() Oct 31, 2018
transport.go fixes #33 Kill off the impl.pipe.IsOpen Oct 30, 2018

README.adoc

mangos v2

Linux Status Apache License Gitter Coverage GoDoc Go Report Card

Mangos™ v2 is an implementation in pure Go of the SP (“Scalability Protocols”) messaging system. These are colloquially known as a “nanomsg”.

mangos
ℹ️
This is version 2 of mangos, and contains breaking changes and rather different API in some circumstances relative to version 1. To use the original version of mangos please see https://github.com/nanomsg/mangos

The modern C implemenation of the SP protocols is available as NNG™.

The original implementation of the SP protocols is available as nanomsg™.

Generally (modulo a few caveats) all of these implementations can interoperate.

The design is intended to make it easy to add new transports with almost trivial effort, as well as new topologies (“protocols” in SP parlance.)

At present, all of the Req/Rep, Pub/Sub, Pair, Bus, Push/Pull, and Surveyor/Respondent patterns are supported. This project also supports an experimental protocol called Star.

Supported transports include TCP, inproc, IPC, WebSocket, WebSocket/TLS and TLS. Forcing the local TCP port in Dial is not supported yet (this is rarely useful).

Basic interoperability with nanomsg and NNG has been verified (you can do so yourself with nanocat and macat) for all protocols and transports that NNG and nanomsg support. Additionally there are a number of projects that use the two products together.

Installing

Using go get

$ go get -u nanomsg.org/go/mangos/v2

You can use go get -u -a to update all installed packages.

Documentation

$ godoc nanomsg.org/go/mangos/v2

Testing

This package supports internal self tests, which can be run in the idiomatic Go way. (Note that most of the tests are in a test subdirectory.)

$ go test nanomsg.org/go/mangos/v2/...

There are also internal benchmarks available:

$ go test -bench=. nanomsg.org/go/mangos/v2/test

Commercial Support

Examples

Some examples are posted in the directories under examples/ in this project.

These examples are rewrites (in Go) of Tim Dysinger’s Getting Started with Nanomsg.

Running godoc in the example directories will yield information about how to run each example program.

Enjoy!


Copyright 2018 The Mangos Authors

mangos™, Nanomsg™ and NNG™ are trademarks of Garrett D’Amore.