Event Publisher¶
comet-sendvo
is a simple event publisher: it forwards messages from an
author to a broker.
After installation, it should be possible to execute comet-sendvo
directly
from the command line. Use the --help
option to display a brief usage
message:
$ comet-sendvo --help
usage: comet-sendvo [-h] [--verbose] target event
positional arguments:
target Address of receiver to which to send as an endpoint string.
event File containing event text to send; '-' for stdin.
optional arguments:
-h, --help show this help message and exit
--verbose, -v Increase verbosity (may be specified more than once).
To use, simply supply comet-sendvo
with the details of the broker to which
to submit the event (the target
argument) and with the text of a VOEvent
message to send (the event
argument).
target
accepts a string describing a Twisted client endpoint. For
example, possible targets include:
tcp:hostname:8098
, to make a TCP connection on port 8099 to the hostnamehostname
;unix:/some/file/name
, to connect over a Unix domain socket at path/some/file/name
.
For convenience, a TCP connection on port 8098 is assumed if alternatives are
not explicitly specified; thus, a target of example.voevent.broker.com
is
equivalent to tcp:example.voevent.broker.com:8098
.
event
accepts the name of a file containing the text of the event to be
sent. The file must exist on the filesystem. Alternatively, the special value
-
may be specified to indicate that event text should be read from
standard input.
Thus, for example, the following invocations are equivalent:
$ comet-sendvo tcp:remote.invalid:8098 - < voevent_to_publish.xml
and:
$ comet-sendvo remote.invalid voevent_to_publish.xml