README.md

tibrv

A CGO wrapper for TIBCO RendezVous C API

Introduction

It's a CGO wrapper to C library. For building and using this package a valid TIBCO Rendezvous installation is needed. This package permits to send and receive messages with regular, certified message delivery and distribuited queue transports. The dispatcher library section is not included, use goroutines instead.

Configuration

This file:

scripts/test_profile

references 2 enviroments variables :

TEST_DIR = temporary test directory

TIBRV_HOME = path to valid tibrv C api installation

Test & Build

Test and coverage information:

scripts/cover.bash

Benchmarks:

scripts/benchmark.bash

Profiling:

scripts/profile.bash

Examples and tools:

scripts/build.bash

Getting started

Publish a message

    var transport tibrv.RvNetTransport

    // Parameters are option, use
    // Create() 
    // for default values
	err := transport.Create(
		tibrv.Service("<service>"),
		tibrv.Network("<network>"),
		tibrv.Daemon("<daemon>"),
		tibrv.Description("<description>"),
    )
    if err != nil {
        fmt.Println(err)
        os.Exit(-1)
    }   

    var msg  tibrv.RvMessage
    // [...] message composing

    err = transport.Send(msg)
    if err != nil {
        fmt.Println(err)
        os.Exit(-1)
    }   

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Disclaimer

This project has been an exercise for improving my GO skills, wrapping up things I already knew.

The package has never been used, it needs deep testing.