connectd

A service for managing communication flow patterns, data processing and visualization

Latest Release: 0.0.1

Release Notes - August 11, 2017

Initial release
This release exposes a pub/sub scheme using unix named pipes.
The interface is designed to test IPC flow between Connect and Capture Kiosk using a schemeless message structure using a serialized JSON string using Unicode characters, wrapped in double quotes, using backslash escapes.

Binaries:

linux (amd64)
darwin (amd64)

Functional Requirements
Background
Install
Build
Usage
API
Maintainers
Contribute
License

Functional Requirements

Should receive command line flags (non positional arguments): pipe, string
Should receive and parse URI scheme requests as URL parameters
Should receive a string from a given named pipe (fifo)
Should send a string to a given named pipe (fifo)
Should register URI protocol (pipe://) that's accessible from a Chrome browser
Should be executable on linux (amd64): GOOS=linux GOARCH=amd64 go build main.go

Security

Background

Install

Requires go version > 1.3. Tested 1.8.3 (darwin/amd64). Installation instructions

Dependencies

go get github.com/Sirupsen/logrus
go get github.com/tzmartin/namedpiper
go get -u cloud.google.com/go/storage

Build

Run make.

make darwin version=0.0.1
make linux version=0.0.1

// Output
releases/connectd.0.0.1-linux.tar.gz

Releases

Releases are available in /releases folder.

To update a release:

Update this README with latest version
Build with version flag
Tag the repo with version

Tag a release using semantic versioning.

git tag 0.0.0
git push origin <tag>

BitBucket does not support binary file attachments as a release feature (ie, Github). There is soft limit to 1GB and an hard limit to 2GB.

For binary or executable storage, the recommendation is host the release binary on a CDN (ie, Google Cloud Storage).

Usage

// Ensure binary is executable
chmodx connectd

// Subscribe to a channel
./connectd -sub=hooli

// Publish to a channel
./connectd -pub=hooli -message="{\"foo\":\"bar\"}"

API

Usage of ./connectd:
  -dir string
    	FIFO directory absolute path (default "/tmp/pipes")
  -message string
    	JSON encoded string (default "{\"foo\":\"bar\"}")
  -pub string
    	Publish to unix named pipe (fifo)
  -sub string
    	Subscribe to unix named pipe (fifo)

Maintainers

@tzmartin @sophrinix

Contribute

Small note: If editing the README, please conform to the standard-readme specification.

tzmartin/connectd