crossbar

Crossbar.io is a decentralized data plane for XBR/WAMP based application service and data routing, built on Crossbar.io OSS.

Submodules

Functions

personalities()

Return a map from personality names to actual available (=installed) Personality classes.

run()

CLI entry point into crossbar.

Package Contents

personalities()[source]

Return a map from personality names to actual available (=installed) Personality classes.

run()[source]

CLI entry point into crossbar.

  • when called with no arguments, the arguments are read from the command line

  • when called with an explicit arguments list, use the same arguments in the list as on the command line, leaving out the initial crossbar command.

twisted.internet.error.ReactorNotRestartable

Examples

To start Crossbar.io programmatically from a given node directory:

import crossbar

crossbar.run(['start', '--cbdir', '/tmp/mynode1/.crossbar'])

To start Crossbar.io with log output at level “debug”

$ crossbar start --loglevel=debug

To chose a specific event reactor and print version information

$ CROSSBAR_REACTOR="kqueue" crossbar version

To start from a specified node directory (instead of the default $CWD/.crossbar):

$ CROSSBAR_DIR="/tmp/test/.crossbar" crossbar start

which is the same as

$ crossbar start --cbdir=/tmp/test/.crossbar

Influential command line options and environment variables include:

Command line arg:

Environment variable:

Description:

n.a.

CROSSBAR_REACTOR

Event reactor:

  • auto

  • select

  • poll

  • epoll

  • kqueue

  • iocp

n.a.

CROSSBAR_PERSONALITY

Node personality:

  • standalone

  • edge

  • master

--cbdir

CROSSBAR_DIR

Node directory (local directory)

--config

CROSSBAR_CONFIG

Node configuration (local filename)

--color

n.a.

Enable colored terminal output

--loglevel

n.a.

Select log level

--logformat

n.a.

Select log format

--logdir

n.a.

Log to this local directory

--logtofile

n.a.

Enable logging to file

See also

TwistedMatrix: Choosing a Reactor and GUI Toolkit Integration

Note

The Twisted reactor to use can only be explicitly chosen via an environment variable, not a command line option.