Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nanomsg/mangos

mangos is a pure Golang implementation of nanomsg's "Scalablilty Protocols"
https://github.com/nanomsg/mangos

golang-network message nanomsg nng pubsub queue

Last synced: 6 days ago
JSON representation

mangos is a pure Golang implementation of nanomsg's "Scalablilty Protocols"

Host: GitHub
URL: https://github.com/nanomsg/mangos
Owner: nanomsg
License: apache-2.0
Created: 2018-10-12T17:35:46.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2024-07-26T21:40:27.000Z (5 months ago)
Last Synced: 2024-09-28T13:34:30.846Z (2 months ago)
Topics: golang-network, message, nanomsg, nng, pubsub, queue
Language: Go
Homepage:
Size: 2.64 MB
Stars: 671
Watchers: 24
Forks: 78
Open Issues: 26
Metadata Files:
- Readme: README.md
- Changelog: CHANGES-v2.adoc
- Contributing: CONTRIBUTING
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Authors: AUTHORS

Awesome Lists containing this project

awesome-go - mangos - Pure go implementation of the Nanomsg ("Scalability Protocols") with transport interoperability. (Messaging / Search and Analytic Databases)
zero-alloc-awesome-go - mangos - Pure go implementation of the Nanomsg ("Scalability Protocols") with transport interoperability. (Messaging / Search and Analytic Databases)
awesome-go-extra - mangos - 10-12T17:35:46Z|2022-08-20T15:55:55Z| (Messaging / Advanced Console UIs)

README

        # mangos™ v3

[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://stand-with-ukraine.pp.ua)

[![Linux](https://img.shields.io/github/actions/workflow/status/nanomsg/mangos/linux.yml?branch=master&logoColor=grey&logo=linux&label=)](https://github.com/nanomsg/mangos/actions)

[![Windows](https://img.shields.io/github/actions/workflow/status/nanomsg/mangos/windows.yml?branch=master&logoColor=grey&logo=windows&label=)](https://github.com/nanomsg/mangos/actions)

[![macOS](https://img.shields.io/github/actions/workflow/status/nanomsg/mangos/darwin.yml?branch=master&logoColor=grey&logo=apple&label=)](https://github.com/nanomsg/mangos/actions)

[![Coverage](https://img.shields.io/codecov/c/github/nanomsg/mangos?logoColor=grey&logo=codecov&label=)](https://codecov.io/gh/nanomsg/mangos)

[![Discord](https://img.shields.io/discord/639573728212156478?label=&logo=discord)](https://discord.gg/wewTkby)

[![Documentation](https://img.shields.io/badge/godoc-docs-blue.svg?label=&logo=go)](https://pkg.go.dev/go.nanomsg.org/mangos/v3)

[![License](https://img.shields.io/github/license/nanomsg/mangos.svg?logoColor=silver&logo=opensourceinitiative&label=&color=blue)](https://github.com/nanomsg/mangos/blob/master/LICENSE)

[![Version](https://img.shields.io/github/v/tag/nanomsg/mangos?logo=github&sort=semver&label=)](https://github.com/nanomsg/mangos/releases)

Please see [here](UKRAINE.md) for an important message for the people of Russia.

_Mangos™_ is an implementation in pure Go of the _SP_

(`Scalability Protocols`) messaging system.

These are colloquially known as `nanomsg`.

> _NOTE_: The import path has changed! Please change any references

> to `go.nanomsg.org/mangos/v3`.

> The old v2 imports will still work for old applications, provided that

> a sufficiently modern version of Go is used. However, no further work

> will be done on earlier versions.

> Earlier versions will still inter-operate with this version, except that

> within the same process the `inproc` transport can only be used by

> consumers using the same version of mangos.

The modern C implementation of the SP protocols is available as

[NNG™](https://github.com/nanomsg/nng).

The original implementation of the SP protocols is available as

[nanomsg™](http://www.nanomsg.org).

Generally (modulo a few caveats) all of these implementations can inter-operate.

The design is intended to make it easy to add new transports,

as well as new topologies (`protocols` in SP parlance.)

At present, all 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.

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, except for the _ZeroTier_ transport and the PAIRv1

protocol, which are only supported in _NNG_ at this time.

There are a number of projects that use these products together.

## Documentation

For API documentation, see https://pkg.go.dev/go.nanomsg.org/mangos/v3.

## 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 go.nanomsg.org/mangos/v3/...

There are also internal benchmarks available:

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

## Commercial Support

[Staysail Systems, Inc.](mailto:[email protected]) offers

[commercial support](http://staysail.tech/support/mangos) for mangos.

## 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](http://nanomsg.org/gettingstarted/index.html).

Running `go doc` in the example directories will yield information about how

to run each example program.

Enjoy!

---

Copyright 2021 The Mangos Authors

mangos™, Nanomsg™ and NNG™ are [trademarks](http://nanomsg.org/trademarks.html) of Garrett D'Amore.