TclXMPP

Check-in [9b41e52763]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
SHA1:9b41e52763c2a3546ddf949e29eae82890ee04a4
Date: 2015-06-02 08:28:09
User: sgolovan
Comment:Added a short manpage for the rssbot RSS/XMPP gateway example.
Tags And Properties
Context
2015-06-02
08:29
[e8ee93c2c5] Replaced the literal rssbot.tcl string by $argv0 in short help notice. (user: sgolovan, tags: trunk)
08:28
[9b41e52763] Added a short manpage for the rssbot RSS/XMPP gateway example. (user: sgolovan, tags: trunk)
2015-06-01
19:36
[bdec1069ef] Allow one to rename the jsend.tcl to jsend when installing the examples. (user: sgolovan, tags: trunk)
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to ChangeLog.






1
2
3
4
5
6
7





2015-06-01  Sergei Golovan  <sgolovan@nes.ru>

	* examples/jsend.tcl: Allow one to rename the jsend.tcl to jsend when
	  installing the examples.

	* examples/jsend.man: Added a short manual page for the jsend
	  command line client example.
>
>
>
>
>







1
2
3
4
5
6
7
8
9
10
11
12
2015-06-02  Sergei Golovan  <sgolovan@nes.ru>

	* examples/rssbot.man: Added a short manpage for the rssbot RSS/XMPP
	  gateway example.

2015-06-01  Sergei Golovan  <sgolovan@nes.ru>

	* examples/jsend.tcl: Allow one to rename the jsend.tcl to jsend when
	  installing the examples.

	* examples/jsend.man: Added a short manual page for the jsend
	  command line client example.

Added examples/rssbot.man.





























































































































































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
[comment {-*- tcl -*- doctools manpage}]
[manpage_begin rssbot 1 0.1]
[copyright {2015 Sergei Golovan <sgolovan@nes.ru>}]
[moddesc {Tcl XMPP library}]
[titledesc {Tcl command line RSS/XMPP gateway}]
[description]
[para]

This gateway is a part of the Tcl XMPP library. It implements a command
line bot which perodically polls a set of RSS feeds and resend the new
messages to its roster items via XMPP network. To do that it connects
to an XMPP server using specified login and password.

[list_begin definitions]
[call [cmd rssbot] [opt "[option -option] [arg value] ..."]]

[para]

The required Tcl packages for the [cmd rssbot] utility are [arg tls]
and quite a few modules from the [arg Tcllib] collection.

[para]

After the [cmd rssbot] is connected to the XMPP server, it parses chat
messages from its roster contacts. These messages may contain the following
commands:

[list_begin definitions]
[def "[cmd subscribe] [arg URL] [opt [arg URL]\ ...]"]
[para]
Subscribe to the specified RSS feeds and send its messages to the subscriber's
JID. Only members of the rssbot roster can subscribe to RSS feeds, though
the bot doesn't manage the roster itself. Note that all the subscription
data is stored server-side using the mechanism described in XEP-0049
(Private XML Storage).

[def "[cmd unsubscribe] [opt [arg URL]\ ...]"]
[para]
Unsubscribe from the specified RSS feeds (or from all the feeds).

[def "[cmd list]"]
[para]
List all subscribed feeds.

[def "[cmd reset] [opt [arg TIME]]"]
[para]
Reset the RSS history to the specified time (or to zero).

[def "[cmd flush]"]
[para]
Drop all unsent RSS articles.

[def "[cmd dump]"]
[para]
Dump all the current subscriptions to XML.

[list_end]

[para]

The client takes a few option-value pairs as its command line arguments.
The full list of the command line options follows below:

[list_begin definitions]
[def "[option -from] [arg jid]"]
[para]
The sender JID. If there's no [option -host] option then the server part
of the specified JID is used to connect to.

[def "[option -password] [arg string]"]
[para]
The sender password.

[def "[option -type] [arg headline|normal|chat]"]
[para]
The message type. Must be one of [const headline], [const normal]
or [const chat]. Defaults to [const headline].

[def "[option -pidfile] [arg file]"]
[para]
Create the specified file with the PID of the running process. This
option is useful together with [option -follow] option.

[def "[option -host] [arg hostname]"]
[para]
Explicit hostname to connect to.

[def "[option -port] [arg number]"]
[para]
Explicit port to connect to.

[def "[option -tls] [arg boolean]"]
[para]
Whether the old legacy SSL encryption is to be used (defaults to [const false]).

[def "[option -starttls] [arg boolean]"]
[para]
Whether the STARTTLS and therefore the TLS encryption is to be used (defaults
to [const true]).

[def "[option -sasl] [arg boolean]"]
[para]
Whether the SASL authentication is to be used (defaults to [const true]).

[list_end]
[list_end]

[section "FILES"]

The file .jsendrc.tcl in the current directory or in the current user's home
directory is sourced if it's available and is not world readable. It can contain
any Tcl code and modify the [cmd rssbot] behavior in any way but its primary
goal is to define [var args] list of option-value pairs, e.g.

[example {
set args {-from fred@example.com/bedrock -password wilma}
}]

[section "AUTHORS"]

Marshall T. Rose,
Sergei Golovan

[keywords Tcl XMPP]
[comment { vim: set ft=tcl ts=8 sw=4 sts=4 et: }]
[manpage_end]