mojodna-xmpp4r 0.4.0.2
Sign up to get free protection for your applications and to get access to all the features.
- data/CHANGELOG +83 -0
- data/COPYING +340 -0
- data/LICENSE +59 -0
- data/README.rdoc +133 -0
- data/README_ruby19.txt +43 -0
- data/Rakefile +252 -0
- data/data/doc/xmpp4r/examples/advanced/adventure/README +56 -0
- data/data/doc/xmpp4r/examples/advanced/adventure/adventure.rb +23 -0
- data/data/doc/xmpp4r/examples/advanced/adventure/adventuremuc.rb +136 -0
- data/data/doc/xmpp4r/examples/advanced/adventure/cube.xml +15 -0
- data/data/doc/xmpp4r/examples/advanced/adventure/tower.xml +69 -0
- data/data/doc/xmpp4r/examples/advanced/adventure/world.rb +424 -0
- data/data/doc/xmpp4r/examples/advanced/fileserve.conf +11 -0
- data/data/doc/xmpp4r/examples/advanced/fileserve.rb +346 -0
- data/data/doc/xmpp4r/examples/advanced/getonline.rb +56 -0
- data/data/doc/xmpp4r/examples/advanced/gtkmucclient.rb +315 -0
- data/data/doc/xmpp4r/examples/advanced/migrate.rb +88 -0
- data/data/doc/xmpp4r/examples/advanced/minimuc.rb +266 -0
- data/data/doc/xmpp4r/examples/advanced/pep-aggregator/index.xsl +235 -0
- data/data/doc/xmpp4r/examples/advanced/pep-aggregator/pep-aggregator.rb +147 -0
- data/data/doc/xmpp4r/examples/advanced/recvfile.rb +84 -0
- data/data/doc/xmpp4r/examples/advanced/rosterdiscovery.rb +129 -0
- data/data/doc/xmpp4r/examples/advanced/sendfile.conf +10 -0
- data/data/doc/xmpp4r/examples/advanced/sendfile.rb +72 -0
- data/data/doc/xmpp4r/examples/advanced/shellmgr/shellmgr.rb +51 -0
- data/data/doc/xmpp4r/examples/advanced/shellmgr/shellmgr_jabber.rb +43 -0
- data/data/doc/xmpp4r/examples/advanced/shellmgr/shellmgr_test.rb +10 -0
- data/data/doc/xmpp4r/examples/advanced/versionpoll.rb +109 -0
- data/data/doc/xmpp4r/examples/advanced/xmpping.rb +146 -0
- data/data/doc/xmpp4r/examples/advanced/xmppingrc.sample +14 -0
- data/data/doc/xmpp4r/examples/basic/change_password.rb +41 -0
- data/data/doc/xmpp4r/examples/basic/client.rb +70 -0
- data/data/doc/xmpp4r/examples/basic/component.rb +11 -0
- data/data/doc/xmpp4r/examples/basic/echo.rb +37 -0
- data/data/doc/xmpp4r/examples/basic/jabbersend.rb +41 -0
- data/data/doc/xmpp4r/examples/basic/mass_sender.rb +68 -0
- data/data/doc/xmpp4r/examples/basic/muc_owner_config.rb +12 -0
- data/data/doc/xmpp4r/examples/basic/mucinfo.rb +41 -0
- data/data/doc/xmpp4r/examples/basic/mucsimplebot.rb +82 -0
- data/data/doc/xmpp4r/examples/basic/register.rb +42 -0
- data/data/doc/xmpp4r/examples/basic/remove_registration.rb +18 -0
- data/data/doc/xmpp4r/examples/basic/roster.rb +44 -0
- data/data/doc/xmpp4r/examples/basic/rosterprint.rb +50 -0
- data/data/doc/xmpp4r/examples/basic/rosterrename.rb +34 -0
- data/data/doc/xmpp4r/examples/basic/rosterwatch.rb +171 -0
- data/data/doc/xmpp4r/examples/basic/send_vcard.rb +67 -0
- data/data/doc/xmpp4r/examples/basic/tune_client.rb +56 -0
- data/data/doc/xmpp4r/examples/basic/tune_server.rb +58 -0
- data/data/doc/xmpp4r/examples/basic/versionbot.rb +75 -0
- data/lib/xmpp4r/base64.rb +32 -0
- data/lib/xmpp4r/bytestreams/helper/filetransfer.rb +319 -0
- data/lib/xmpp4r/bytestreams/helper/ibb/base.rb +257 -0
- data/lib/xmpp4r/bytestreams/helper/ibb/initiator.rb +31 -0
- data/lib/xmpp4r/bytestreams/helper/ibb/target.rb +47 -0
- data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/base.rb +152 -0
- data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/initiator.rb +86 -0
- data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/server.rb +198 -0
- data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/socks5.rb +65 -0
- data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/target.rb +73 -0
- data/lib/xmpp4r/bytestreams/iq/bytestreams.rb +170 -0
- data/lib/xmpp4r/bytestreams/iq/si.rb +206 -0
- data/lib/xmpp4r/bytestreams.rb +15 -0
- data/lib/xmpp4r/callbacks.rb +133 -0
- data/lib/xmpp4r/caps/c.rb +67 -0
- data/lib/xmpp4r/caps/helper/generator.rb +160 -0
- data/lib/xmpp4r/caps/helper/helper.rb +87 -0
- data/lib/xmpp4r/caps.rb +1 -0
- data/lib/xmpp4r/client.rb +344 -0
- data/lib/xmpp4r/command/helper/responder.rb +53 -0
- data/lib/xmpp4r/command/iq/command.rb +154 -0
- data/lib/xmpp4r/component.rb +103 -0
- data/lib/xmpp4r/connection.rb +219 -0
- data/lib/xmpp4r/dataforms/x/data.rb +297 -0
- data/lib/xmpp4r/dataforms.rb +5 -0
- data/lib/xmpp4r/debuglog.rb +42 -0
- data/lib/xmpp4r/delay/x/delay.rb +99 -0
- data/lib/xmpp4r/delay.rb +5 -0
- data/lib/xmpp4r/discovery/helper/helper.rb +58 -0
- data/lib/xmpp4r/discovery/helper/responder.rb +165 -0
- data/lib/xmpp4r/discovery/iq/discoinfo.rb +211 -0
- data/lib/xmpp4r/discovery/iq/discoitems.rb +147 -0
- data/lib/xmpp4r/discovery.rb +8 -0
- data/lib/xmpp4r/errors.rb +283 -0
- data/lib/xmpp4r/feature_negotiation/iq/feature.rb +28 -0
- data/lib/xmpp4r/feature_negotiation.rb +5 -0
- data/lib/xmpp4r/framework/base.rb +55 -0
- data/lib/xmpp4r/framework/bot.rb +148 -0
- data/lib/xmpp4r/httpbinding/client.rb +275 -0
- data/lib/xmpp4r/httpbinding.rb +5 -0
- data/lib/xmpp4r/idgenerator.rb +37 -0
- data/lib/xmpp4r/iq.rb +221 -0
- data/lib/xmpp4r/jid.rb +167 -0
- data/lib/xmpp4r/last/helper/helper.rb +37 -0
- data/lib/xmpp4r/last/iq/last.rb +67 -0
- data/lib/xmpp4r/last.rb +2 -0
- data/lib/xmpp4r/location/helper/helper.rb +56 -0
- data/lib/xmpp4r/location/location.rb +179 -0
- data/lib/xmpp4r/location.rb +2 -0
- data/lib/xmpp4r/message.rb +181 -0
- data/lib/xmpp4r/muc/helper/mucbrowser.rb +92 -0
- data/lib/xmpp4r/muc/helper/mucclient.rb +462 -0
- data/lib/xmpp4r/muc/helper/simplemucclient.rb +332 -0
- data/lib/xmpp4r/muc/iq/mucadmin.rb +23 -0
- data/lib/xmpp4r/muc/iq/mucadminitem.rb +20 -0
- data/lib/xmpp4r/muc/iq/mucowner.rb +15 -0
- data/lib/xmpp4r/muc/item.rb +143 -0
- data/lib/xmpp4r/muc/x/muc.rb +70 -0
- data/lib/xmpp4r/muc/x/mucuserinvite.rb +60 -0
- data/lib/xmpp4r/muc/x/mucuseritem.rb +36 -0
- data/lib/xmpp4r/muc.rb +14 -0
- data/lib/xmpp4r/presence.rb +232 -0
- data/lib/xmpp4r/pubsub/children/configuration.rb +86 -0
- data/lib/xmpp4r/pubsub/children/event.rb +49 -0
- data/lib/xmpp4r/pubsub/children/item.rb +35 -0
- data/lib/xmpp4r/pubsub/children/items.rb +53 -0
- data/lib/xmpp4r/pubsub/children/node_config.rb +48 -0
- data/lib/xmpp4r/pubsub/children/publish.rb +38 -0
- data/lib/xmpp4r/pubsub/children/retract.rb +41 -0
- data/lib/xmpp4r/pubsub/children/subscription.rb +62 -0
- data/lib/xmpp4r/pubsub/children/subscription_config.rb +67 -0
- data/lib/xmpp4r/pubsub/children/unsubscribe.rb +48 -0
- data/lib/xmpp4r/pubsub/helper/nodebrowser.rb +130 -0
- data/lib/xmpp4r/pubsub/helper/nodehelper.rb +156 -0
- data/lib/xmpp4r/pubsub/helper/oauth_service_helper.rb +107 -0
- data/lib/xmpp4r/pubsub/helper/servicehelper.rb +456 -0
- data/lib/xmpp4r/pubsub/iq/pubsub.rb +19 -0
- data/lib/xmpp4r/pubsub.rb +8 -0
- data/lib/xmpp4r/query.rb +15 -0
- data/lib/xmpp4r/rexmladdons.rb +157 -0
- data/lib/xmpp4r/roster/helper/roster.rb +519 -0
- data/lib/xmpp4r/roster/iq/roster.rb +215 -0
- data/lib/xmpp4r/roster/x/roster.rb +138 -0
- data/lib/xmpp4r/roster.rb +7 -0
- data/lib/xmpp4r/rpc/helper/client.rb +123 -0
- data/lib/xmpp4r/rpc/helper/server.rb +74 -0
- data/lib/xmpp4r/rpc/helper/xmlrpcaddons.rb +67 -0
- data/lib/xmpp4r/rpc/iq/rpc.rb +23 -0
- data/lib/xmpp4r/rpc.rb +2 -0
- data/lib/xmpp4r/sasl.rb +243 -0
- data/lib/xmpp4r/semaphore.rb +38 -0
- data/lib/xmpp4r/stream.rb +531 -0
- data/lib/xmpp4r/streamparser.rb +81 -0
- data/lib/xmpp4r/tune/helper/helper.rb +58 -0
- data/lib/xmpp4r/tune/tune.rb +113 -0
- data/lib/xmpp4r/tune.rb +2 -0
- data/lib/xmpp4r/vcard/helper/vcard.rb +84 -0
- data/lib/xmpp4r/vcard/iq/vcard.rb +109 -0
- data/lib/xmpp4r/vcard.rb +6 -0
- data/lib/xmpp4r/version/helper/responder.rb +72 -0
- data/lib/xmpp4r/version/helper/simpleresponder.rb +44 -0
- data/lib/xmpp4r/version/iq/version.rb +105 -0
- data/lib/xmpp4r/version.rb +7 -0
- data/lib/xmpp4r/x.rb +37 -0
- data/lib/xmpp4r/xhtml/html.rb +115 -0
- data/lib/xmpp4r/xhtml.rb +1 -0
- data/lib/xmpp4r/xmpp4r.rb +18 -0
- data/lib/xmpp4r/xmppelement.rb +168 -0
- data/lib/xmpp4r/xmppstanza.rb +162 -0
- data/lib/xmpp4r.rb +116 -0
- data/setup.rb +1586 -0
- data/test/bytestreams/tc_ibb.rb +186 -0
- data/test/bytestreams/tc_socks5bytestreams.rb +113 -0
- data/test/caps/tc_helper.rb +156 -0
- data/test/dataforms/tc_data.rb +81 -0
- data/test/delay/tc_xdelay.rb +51 -0
- data/test/discovery/tc_responder.rb +91 -0
- data/test/lib/assert_equal_xml.rb +14 -0
- data/test/lib/clienttester.rb +120 -0
- data/test/muc/tc_muc_mucclient.rb +830 -0
- data/test/muc/tc_muc_simplemucclient.rb +114 -0
- data/test/muc/tc_mucowner.rb +50 -0
- data/test/pubsub/tc_helper.rb +722 -0
- data/test/pubsub/tc_nodeconfig.rb +54 -0
- data/test/pubsub/tc_subscriptionconfig.rb +41 -0
- data/test/roster/tc_helper.rb +514 -0
- data/test/roster/tc_iqqueryroster.rb +173 -0
- data/test/roster/tc_xroster.rb +73 -0
- data/test/rpc/tc_helper.rb +96 -0
- data/test/tc_callbacks.rb +129 -0
- data/test/tc_class_names.rb +146 -0
- data/test/tc_client.rb +30 -0
- data/test/tc_errors.rb +146 -0
- data/test/tc_idgenerator.rb +30 -0
- data/test/tc_iq.rb +113 -0
- data/test/tc_iqquery.rb +31 -0
- data/test/tc_jid.rb +204 -0
- data/test/tc_message.rb +132 -0
- data/test/tc_presence.rb +150 -0
- data/test/tc_rexml.rb +139 -0
- data/test/tc_stream.rb +229 -0
- data/test/tc_streamComponent.rb +95 -0
- data/test/tc_streamError.rb +131 -0
- data/test/tc_streamSend.rb +59 -0
- data/test/tc_streamparser.rb +120 -0
- data/test/tc_xmppstanza.rb +135 -0
- data/test/ts_xmpp4r.rb +53 -0
- data/test/tune/tc_helper_recv.rb +84 -0
- data/test/tune/tc_helper_send.rb +74 -0
- data/test/tune/tc_tune.rb +79 -0
- data/test/vcard/tc_helper.rb +49 -0
- data/test/vcard/tc_iqvcard.rb +62 -0
- data/test/version/tc_helper.rb +60 -0
- data/test/version/tc_iqqueryversion.rb +97 -0
- data/test/xhtml/tc_html.rb +41 -0
- data/tools/gen_requires.bash +31 -0
- data/tools/xmpp4r-gemspec-test.rb +11 -0
- data/xmpp4r.gemspec +304 -0
- metadata +346 -0
@@ -0,0 +1,160 @@
|
|
1
|
+
# =XMPP4R - XMPP Library for Ruby
|
2
|
+
# License:: Ruby's license (see the LICENSE file) or GNU GPL, at your option.
|
3
|
+
# Website::http://home.gna.org/xmpp4r/
|
4
|
+
|
5
|
+
require 'xmpp4r'
|
6
|
+
require 'xmpp4r/discovery'
|
7
|
+
require 'xmpp4r/dataforms'
|
8
|
+
require 'xmpp4r/caps/c'
|
9
|
+
require 'digest'
|
10
|
+
require 'xmpp4r/base64'
|
11
|
+
|
12
|
+
module Jabber
|
13
|
+
module Caps
|
14
|
+
def self.generate_ver_str(identities, features, forms=[])
|
15
|
+
# 1. Initialize an empty string S.
|
16
|
+
s = ''
|
17
|
+
|
18
|
+
# 2. Sort the service discovery identities [14] by category and
|
19
|
+
# then by type (if it exists) and then by xml:lang (if it
|
20
|
+
# exists), formatted as CATEGORY '/' [TYPE] '/' [LANG] '/'
|
21
|
+
# [NAME]. Note that each slash is included even if the TYPE,
|
22
|
+
# LANG, or NAME is not included.
|
23
|
+
identities.sort! do |identity1,identity2|
|
24
|
+
cmp_result = nil
|
25
|
+
[:category, :type, :xml_lang, :iname].each do |field|
|
26
|
+
value1 = identity1.send(field)
|
27
|
+
value2 = identity2.send(field)
|
28
|
+
|
29
|
+
if value1 != value2
|
30
|
+
cmp_result = value1 <=> value2
|
31
|
+
break
|
32
|
+
end
|
33
|
+
end
|
34
|
+
|
35
|
+
|
36
|
+
cmp_result
|
37
|
+
end
|
38
|
+
|
39
|
+
# 3. For each identity, append the 'category/type/lang/name' to
|
40
|
+
# S, followed by the '<' character.
|
41
|
+
s += identities.collect do |identity|
|
42
|
+
[:category, :type, :xml_lang, :iname].collect do |field|
|
43
|
+
identity.send(field).to_s
|
44
|
+
end.join('/') + '<'
|
45
|
+
end.join
|
46
|
+
|
47
|
+
# 4. Sort the supported service discovery features. [15]
|
48
|
+
features.sort! do |feature1,feature2|
|
49
|
+
feature1.var <=> feature2.var
|
50
|
+
end
|
51
|
+
|
52
|
+
# 5. For each feature, append the feature to S, followed by the
|
53
|
+
# '<' character.
|
54
|
+
s += features.collect do |feature|
|
55
|
+
feature.var.to_s + '<'
|
56
|
+
end.join
|
57
|
+
|
58
|
+
# 6. If the service discovery information response includes
|
59
|
+
# XEP-0128 data forms, sort the forms by the FORM_TYPE (i.e., by
|
60
|
+
# the XML character data of the <value/> element).
|
61
|
+
forms.sort! do |form1,form2|
|
62
|
+
fform_type1 = form1.field('FORM_TYPE')
|
63
|
+
fform_type2 = form2.field('FORM_TYPE')
|
64
|
+
form_type1 = fform_type1 ? fform_type1.values.to_s : nil
|
65
|
+
form_type2 = fform_type2 ? fform_type2.values.to_s : nil
|
66
|
+
form_type1 <=> form_type2
|
67
|
+
end
|
68
|
+
|
69
|
+
# 7. For each extended service discovery information form:
|
70
|
+
forms.each do |form|
|
71
|
+
# 7.1. Append the XML character data of the FORM_TYPE field's
|
72
|
+
# <value/> element, followed by the '<' character.
|
73
|
+
fform_type = form.field('FORM_TYPE')
|
74
|
+
form_type = fform_type ? fform_type.values.to_s : nil
|
75
|
+
s += "#{form_type}<"
|
76
|
+
|
77
|
+
# 7.2. Sort the fields by the value of the "var" attribute.
|
78
|
+
fields = form.fields(false).sort do |field1,field2|
|
79
|
+
field1.var <=> field2.var
|
80
|
+
end
|
81
|
+
|
82
|
+
# 7.3. For each field:
|
83
|
+
|
84
|
+
fields.each do |field|
|
85
|
+
# 7.3.1. Append the value of the "var" attribute, followed by
|
86
|
+
# the '<' character.
|
87
|
+
s += "#{field.var}<"
|
88
|
+
|
89
|
+
# 7.3.2. Sort values by the XML character data of the <value/>
|
90
|
+
# element.
|
91
|
+
values = field.values.sort do |value1,value2|
|
92
|
+
value1 <=> value2
|
93
|
+
end
|
94
|
+
|
95
|
+
# 7.3.3. For each <value/> element, append the XML character
|
96
|
+
# data, followed by the '<' character.
|
97
|
+
s += values.collect do |value|
|
98
|
+
"#{value}<"
|
99
|
+
end.join
|
100
|
+
end
|
101
|
+
end
|
102
|
+
|
103
|
+
# 8. Ensure that S is encoded according to the UTF-8 encoding
|
104
|
+
# (RFC 3269 [16]).
|
105
|
+
|
106
|
+
# (given in XMPP4R)
|
107
|
+
|
108
|
+
s
|
109
|
+
end
|
110
|
+
|
111
|
+
##
|
112
|
+
# Implementation of the algorithm defined at:
|
113
|
+
# http://www.xmpp.org/extensions/xep-0115.html#ver-gen
|
114
|
+
def self.generate_ver(identities, features, forms=[], hash='sha-1')
|
115
|
+
s = generate_ver_str(identities, features, forms)
|
116
|
+
|
117
|
+
# 9. Compute the verification string by hashing S using the
|
118
|
+
# algorithm specified in the 'hash' attribute (e.g., SHA-1 as
|
119
|
+
# defined in RFC 3174 [17]). The hashed data MUST be generated
|
120
|
+
# with binary output and encoded using Base64 as specified in
|
121
|
+
# Section 4 of RFC 4648 [18] (note: the Base64 output MUST NOT
|
122
|
+
# include whitespace and MUST set padding bits to zero). [19]
|
123
|
+
|
124
|
+
# See http://www.iana.org/assignments/hash-function-text-names
|
125
|
+
hash_klass = case hash
|
126
|
+
when 'md2' then nil
|
127
|
+
when 'md5' then Digest::MD5
|
128
|
+
when 'sha-1' then Digest::SHA1
|
129
|
+
when 'sha-224' then nil
|
130
|
+
when 'sha-256' then Digest::SHA256
|
131
|
+
when 'sha-384' then Digest::SHA384
|
132
|
+
when 'sha-512' then Digest::SHA512
|
133
|
+
end
|
134
|
+
if hash_klass
|
135
|
+
Base64::encode64(hash_klass::digest(s)).strip
|
136
|
+
else
|
137
|
+
nil
|
138
|
+
end
|
139
|
+
end
|
140
|
+
|
141
|
+
##
|
142
|
+
# Generate a ver hash from a Jabber::Discovery::IqQueryDiscoInfo result
|
143
|
+
# query:: [Jabber::Discovery::IqQueryDiscoInfo]
|
144
|
+
def self.generate_ver_from_discoinfo(query, hash='sha-1')
|
145
|
+
identities = []
|
146
|
+
features = []
|
147
|
+
forms = []
|
148
|
+
query.each_element do |element|
|
149
|
+
if element.kind_of? Discovery::Identity
|
150
|
+
identities << element
|
151
|
+
elsif element.kind_of? Discovery::Feature
|
152
|
+
features << element
|
153
|
+
elsif element.kind_of? Dataforms::XData
|
154
|
+
forms << element
|
155
|
+
end
|
156
|
+
end
|
157
|
+
generate_ver(identities, features, forms, hash)
|
158
|
+
end
|
159
|
+
end
|
160
|
+
end
|
@@ -0,0 +1,87 @@
|
|
1
|
+
# =XMPP4R - XMPP Library for Ruby
|
2
|
+
# License:: Ruby's license (see the LICENSE file) or GNU GPL, at your option.
|
3
|
+
# Website::http://home.gna.org/xmpp4r/
|
4
|
+
|
5
|
+
require 'xmpp4r'
|
6
|
+
require 'xmpp4r/discovery'
|
7
|
+
require 'xmpp4r/caps/c'
|
8
|
+
require 'xmpp4r/caps/helper/generator'
|
9
|
+
|
10
|
+
module Jabber
|
11
|
+
module Caps
|
12
|
+
##
|
13
|
+
# A Helper to manage advertising and discovery of entity capabilities.
|
14
|
+
#
|
15
|
+
# Following XEP-0115 (ver 1.4 http://www.xmpp.org/extensions/xep-0115.html).
|
16
|
+
# you can use this Helper to, for example, advertise that your client
|
17
|
+
# wishes to receive XEP-0118 User Tune notifications, eg:
|
18
|
+
#
|
19
|
+
# caps_helper=Jabber::Caps::Helper(cl,
|
20
|
+
# [Jabber::Discovery::Identity.new('client',nil,'bot')],
|
21
|
+
# [Jabber::Discovery::Feature.new('http://jabber.org/protocol/tune+notify')]
|
22
|
+
# )
|
23
|
+
class Helper
|
24
|
+
attr_accessor :identities, :features, :node
|
25
|
+
|
26
|
+
##
|
27
|
+
# Construct a new Caps Helper.
|
28
|
+
#
|
29
|
+
# This will send a <presence> message containing
|
30
|
+
# a <c/> (Jabber::Caps::C) stanza to your server.
|
31
|
+
# client:: [Jabber::Stream]
|
32
|
+
# i:: [Array] of [Jabber::Discovery::Identity] objects that this entity will advertise
|
33
|
+
# f:: [Array] of [Jabber::Discovery::Feature] objects that this entity will advertise
|
34
|
+
# n:: [String] an identifier representing the software underlying this entity
|
35
|
+
def initialize(client,i=[],f=[],n="http://home.gna.org/xmpp4r/##{Jabber::XMPP4R_VERSION}")
|
36
|
+
@stream = client
|
37
|
+
@identities = i
|
38
|
+
@features = f
|
39
|
+
@node = n
|
40
|
+
|
41
|
+
@stream.add_iq_callback(250) do |iq|
|
42
|
+
if iq.type == :get and iq.query.kind_of? Jabber::Discovery::IqQueryDiscoInfo
|
43
|
+
Thread.new do
|
44
|
+
Thread.abort_on_exception = true
|
45
|
+
handle_discoinfo_query(iq)
|
46
|
+
end
|
47
|
+
true
|
48
|
+
else
|
49
|
+
false
|
50
|
+
end
|
51
|
+
end
|
52
|
+
|
53
|
+
p = Jabber::Presence.new()
|
54
|
+
p.add(c)
|
55
|
+
@stream.send(p)
|
56
|
+
end
|
57
|
+
|
58
|
+
##
|
59
|
+
# Return a <c/> element for inclusion in your own <presence>
|
60
|
+
# stanzas.
|
61
|
+
def c
|
62
|
+
Jabber::Caps::C.new(node, ver)
|
63
|
+
end
|
64
|
+
|
65
|
+
##
|
66
|
+
# Send actual identities/ features back to a requesting entity
|
67
|
+
def handle_discoinfo_query(iq)
|
68
|
+
caps_reply = Jabber::XMPPStanza.answer(iq)
|
69
|
+
caps_reply.type = :result
|
70
|
+
caps_reply.query = Jabber::Discovery::IqQueryDiscoInfo.new
|
71
|
+
@identities.each { |i| caps_reply.query.add(i) }
|
72
|
+
@features.each { |f| caps_reply.query.add(f) }
|
73
|
+
|
74
|
+
@stream.send(caps_reply)
|
75
|
+
end
|
76
|
+
|
77
|
+
##
|
78
|
+
# Generate 'ver', an opaque hash used to represent this entity's
|
79
|
+
# capabilities
|
80
|
+
#
|
81
|
+
# See http://www.xmpp.org/extensions/xep-0115.html#ver
|
82
|
+
def ver
|
83
|
+
Caps::generate_ver(@identities, @features)
|
84
|
+
end
|
85
|
+
end
|
86
|
+
end
|
87
|
+
end
|
data/lib/xmpp4r/caps.rb
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
require 'xmpp4r/caps/helper/helper'
|
@@ -0,0 +1,344 @@
|
|
1
|
+
# =XMPP4R - XMPP Library for Ruby
|
2
|
+
# License:: Ruby's license (see the LICENSE file) or GNU GPL, at your option.
|
3
|
+
# Website::http://home.gna.org/xmpp4r/
|
4
|
+
|
5
|
+
require 'resolv'
|
6
|
+
require 'xmpp4r/connection'
|
7
|
+
require 'xmpp4r/sasl'
|
8
|
+
|
9
|
+
module Jabber
|
10
|
+
|
11
|
+
# The client class provides everything needed to build a basic XMPP
|
12
|
+
# Client.
|
13
|
+
#
|
14
|
+
# If you want your connection to survive disconnects and timeouts,
|
15
|
+
# catch exception in Stream#on_exception and re-call Client#connect
|
16
|
+
# and Client#auth. Don't forget to re-send initial Presence and
|
17
|
+
# everything else you need to setup your session.
|
18
|
+
class Client < Connection
|
19
|
+
|
20
|
+
# The client's JID
|
21
|
+
attr_reader :jid
|
22
|
+
|
23
|
+
##
|
24
|
+
# Create a new Client.
|
25
|
+
#
|
26
|
+
# Remember to *always* put a resource in your JID unless the server can do SASL.
|
27
|
+
def initialize(jid)
|
28
|
+
super()
|
29
|
+
@jid = (jid.kind_of?(JID) ? jid : JID.new(jid.to_s))
|
30
|
+
end
|
31
|
+
|
32
|
+
##
|
33
|
+
# connect to the server
|
34
|
+
# (chaining-friendly)
|
35
|
+
#
|
36
|
+
# If you omit the optional host argument SRV records for your jid will
|
37
|
+
# be resolved. If none works, fallback is connecting to the domain part
|
38
|
+
# of the jid.
|
39
|
+
# host:: [String] Optional c2s host, will be extracted from jid if nil
|
40
|
+
# use_ssl:: [Boolean] Optional. Use (old, deprecated) SSL when connecting.
|
41
|
+
# return:: self
|
42
|
+
def connect(host = nil, port = 5222)
|
43
|
+
if host.nil?
|
44
|
+
begin
|
45
|
+
srv = []
|
46
|
+
Resolv::DNS.open { |dns|
|
47
|
+
# If ruby version is too old and SRV is unknown, this will raise a NameError
|
48
|
+
# which is caught below
|
49
|
+
Jabber::debuglog("RESOLVING:\n_xmpp-client._tcp.#{@jid.domain} (SRV)")
|
50
|
+
srv = dns.getresources("_xmpp-client._tcp.#{@jid.domain}", Resolv::DNS::Resource::IN::SRV)
|
51
|
+
}
|
52
|
+
# Sort SRV records: lowest priority first, highest weight first
|
53
|
+
srv.sort! { |a,b| (a.priority != b.priority) ? (a.priority <=> b.priority) : (b.weight <=> a.weight) }
|
54
|
+
|
55
|
+
srv.each { |record|
|
56
|
+
begin
|
57
|
+
connect(record.target.to_s, record.port)
|
58
|
+
# Success
|
59
|
+
return self
|
60
|
+
rescue SocketError, Errno::ECONNREFUSED
|
61
|
+
# Try next SRV record
|
62
|
+
end
|
63
|
+
}
|
64
|
+
rescue NameError
|
65
|
+
Jabber::debuglog "Resolv::DNS does not support SRV records. Please upgrade to ruby-1.8.3 or later!"
|
66
|
+
end
|
67
|
+
# Fallback to normal connect method
|
68
|
+
end
|
69
|
+
|
70
|
+
super(host.nil? ? jid.domain : host, port)
|
71
|
+
self
|
72
|
+
end
|
73
|
+
|
74
|
+
##
|
75
|
+
# Close the connection,
|
76
|
+
# sends <tt></stream:stream></tt> tag first
|
77
|
+
def close
|
78
|
+
if @status == CONNECTED
|
79
|
+
send("</stream:stream>")
|
80
|
+
end
|
81
|
+
super
|
82
|
+
end
|
83
|
+
|
84
|
+
##
|
85
|
+
# Start the stream-parser and send the client-specific stream opening element
|
86
|
+
def start
|
87
|
+
super
|
88
|
+
send(generate_stream_start(@jid.domain)) { |e|
|
89
|
+
if e.name == 'stream'
|
90
|
+
true
|
91
|
+
else
|
92
|
+
false
|
93
|
+
end
|
94
|
+
}
|
95
|
+
end
|
96
|
+
|
97
|
+
##
|
98
|
+
# Authenticate with the server
|
99
|
+
#
|
100
|
+
# Throws ClientAuthenticationFailure
|
101
|
+
#
|
102
|
+
# Authentication mechanisms are used in the following preference:
|
103
|
+
# * SASL DIGEST-MD5
|
104
|
+
# * SASL PLAIN
|
105
|
+
# * Non-SASL digest
|
106
|
+
# password:: [String]
|
107
|
+
def auth(password)
|
108
|
+
begin
|
109
|
+
if @stream_mechanisms.include? 'DIGEST-MD5'
|
110
|
+
auth_sasl SASL.new(self, 'DIGEST-MD5'), password
|
111
|
+
elsif @stream_mechanisms.include? 'PLAIN'
|
112
|
+
auth_sasl SASL.new(self, 'PLAIN'), password
|
113
|
+
else
|
114
|
+
auth_nonsasl(password)
|
115
|
+
end
|
116
|
+
rescue
|
117
|
+
Jabber::debuglog("#{$!.class}: #{$!}\n#{$!.backtrace.join("\n")}")
|
118
|
+
raise ClientAuthenticationFailure.new, $!.to_s
|
119
|
+
end
|
120
|
+
end
|
121
|
+
|
122
|
+
##
|
123
|
+
# Resource binding (RFC3920bis-06 - section 8.)
|
124
|
+
#
|
125
|
+
# XMPP allows to bind to multiple resources
|
126
|
+
def bind(desired_resource=nil)
|
127
|
+
iq = Iq.new(:set)
|
128
|
+
bind = iq.add REXML::Element.new('bind')
|
129
|
+
bind.add_namespace @stream_features['bind']
|
130
|
+
if desired_resource
|
131
|
+
resource = bind.add REXML::Element.new('resource')
|
132
|
+
resource.text = desired_resource
|
133
|
+
end
|
134
|
+
|
135
|
+
jid = nil
|
136
|
+
send_with_id(iq) do |reply|
|
137
|
+
reply_bind = reply.first_element('bind')
|
138
|
+
if reply_bind
|
139
|
+
reported_jid = reply_bind.first_element('jid')
|
140
|
+
if reported_jid and reported_jid.text
|
141
|
+
jid = JID.new(reported_jid.text)
|
142
|
+
end
|
143
|
+
end
|
144
|
+
end
|
145
|
+
jid
|
146
|
+
end
|
147
|
+
|
148
|
+
##
|
149
|
+
# Resource unbinding (RFC3920bis-06 - section 8.6.3.)
|
150
|
+
def unbind(desired_resource)
|
151
|
+
iq = Iq.new(:set)
|
152
|
+
unbind = iq.add REXML::Element.new('unbind')
|
153
|
+
unbind.add_namespace @stream_features['unbind']
|
154
|
+
resource = unbind.add REXML::Element.new('resource')
|
155
|
+
resource.text = desired_resource
|
156
|
+
|
157
|
+
send_with_id(iq)
|
158
|
+
end
|
159
|
+
|
160
|
+
##
|
161
|
+
# Use a SASL authentication mechanism and bind to a resource
|
162
|
+
#
|
163
|
+
# If there was no resource given in the jid, the jid/resource
|
164
|
+
# generated by the server will be accepted.
|
165
|
+
#
|
166
|
+
# This method should not be used directly. Instead, Client#auth
|
167
|
+
# may look for the best mechanism suitable.
|
168
|
+
# sasl:: Descendant of [Jabber::SASL::Base]
|
169
|
+
# password:: [String]
|
170
|
+
def auth_sasl(sasl, password)
|
171
|
+
sasl.auth(password)
|
172
|
+
|
173
|
+
# Restart stream after SASL auth
|
174
|
+
stop
|
175
|
+
start
|
176
|
+
# And wait for features - again
|
177
|
+
@features_sem.wait
|
178
|
+
|
179
|
+
# Resource binding (RFC3920 - 7)
|
180
|
+
if @stream_features.has_key? 'bind'
|
181
|
+
@jid = bind(@jid.resource)
|
182
|
+
end
|
183
|
+
|
184
|
+
# Session starting
|
185
|
+
if @stream_features.has_key? 'session'
|
186
|
+
iq = Iq.new(:set)
|
187
|
+
session = iq.add REXML::Element.new('session')
|
188
|
+
session.add_namespace @stream_features['session']
|
189
|
+
|
190
|
+
send_with_id(iq)
|
191
|
+
end
|
192
|
+
end
|
193
|
+
|
194
|
+
##
|
195
|
+
# See Client#auth_anonymous_sasl
|
196
|
+
def auth_anonymous
|
197
|
+
auth_anonymous_sasl
|
198
|
+
end
|
199
|
+
|
200
|
+
|
201
|
+
##
|
202
|
+
# Shortcut for anonymous connection to server
|
203
|
+
#
|
204
|
+
# Throws ClientAuthenticationFailure
|
205
|
+
def auth_anonymous_sasl
|
206
|
+
if self.supports_anonymous?
|
207
|
+
begin
|
208
|
+
auth_sasl SASL.new(self, 'ANONYMOUS'), ""
|
209
|
+
rescue
|
210
|
+
Jabber::debuglog("#{$!.class}: #{$!}\n#{$!.backtrace.join("\n")}")
|
211
|
+
raise ClientAuthenticationFailure, $!.to_s
|
212
|
+
end
|
213
|
+
else
|
214
|
+
raise ClientAuthenticationFailure, 'Anonymous authentication unsupported'
|
215
|
+
end
|
216
|
+
end
|
217
|
+
|
218
|
+
##
|
219
|
+
# Reports whether or not anonymous authentication is reported
|
220
|
+
# by the client.
|
221
|
+
#
|
222
|
+
# Returns true or false
|
223
|
+
def supports_anonymous?
|
224
|
+
@stream_mechanisms.include? 'ANONYMOUS'
|
225
|
+
end
|
226
|
+
|
227
|
+
##
|
228
|
+
# Send auth with given password and wait for result
|
229
|
+
# (non-SASL)
|
230
|
+
#
|
231
|
+
# Throws ServerError
|
232
|
+
# password:: [String] the password
|
233
|
+
# digest:: [Boolean] use Digest authentication
|
234
|
+
def auth_nonsasl(password, digest=true)
|
235
|
+
authset = nil
|
236
|
+
if digest
|
237
|
+
authset = Iq.new_authset_digest(@jid, @streamid.to_s, password)
|
238
|
+
else
|
239
|
+
authset = Iq.new_authset(@jid, password)
|
240
|
+
end
|
241
|
+
send_with_id(authset)
|
242
|
+
$defout.flush
|
243
|
+
|
244
|
+
true
|
245
|
+
end
|
246
|
+
|
247
|
+
##
|
248
|
+
# Get instructions and available fields for registration
|
249
|
+
# return:: [instructions, fields] Where instructions is a String and fields is an Array of Strings
|
250
|
+
def register_info
|
251
|
+
instructions = nil
|
252
|
+
fields = []
|
253
|
+
|
254
|
+
reg = Iq.new_registerget
|
255
|
+
reg.to = jid.domain
|
256
|
+
send_with_id(reg) do |answer|
|
257
|
+
if answer.query
|
258
|
+
answer.query.each_element { |e|
|
259
|
+
if e.namespace == 'jabber:iq:register'
|
260
|
+
if e.name == 'instructions'
|
261
|
+
instructions = e.text.strip
|
262
|
+
else
|
263
|
+
fields << e.name
|
264
|
+
end
|
265
|
+
end
|
266
|
+
}
|
267
|
+
end
|
268
|
+
|
269
|
+
true
|
270
|
+
end
|
271
|
+
|
272
|
+
[instructions, fields]
|
273
|
+
end
|
274
|
+
|
275
|
+
##
|
276
|
+
# Register a new user account
|
277
|
+
# (may be used instead of Client#auth)
|
278
|
+
#
|
279
|
+
# This method may raise ServerError if the registration was
|
280
|
+
# not successful.
|
281
|
+
#
|
282
|
+
# password:: String
|
283
|
+
# fields:: {String=>String} additional registration information
|
284
|
+
#
|
285
|
+
# XEP-0077 Defines the following fields for registration information:
|
286
|
+
# http://www.xmpp.org/extensions/xep-0077.html
|
287
|
+
#
|
288
|
+
# 'username' => 'Account name associated with the user'
|
289
|
+
# 'nick' => 'Familiar name of the user'
|
290
|
+
# 'password' => 'Password or secret for the user'
|
291
|
+
# 'name' => 'Full name of the user'
|
292
|
+
# 'first' => 'First name or given name of the user'
|
293
|
+
# 'last' => 'Last name, surname, or family name of the user'
|
294
|
+
# 'email' => 'Email address of the user'
|
295
|
+
# 'address' => 'Street portion of a physical or mailing address'
|
296
|
+
# 'city' => 'Locality portion of a physical or mailing address'
|
297
|
+
# 'state' => 'Region portion of a physical or mailing address'
|
298
|
+
# 'zip' => 'Postal code portion of a physical or mailing address'
|
299
|
+
# 'phone' => 'Telephone number of the user'
|
300
|
+
# 'url' => 'URL to web page describing the user'
|
301
|
+
# 'date' => 'Some date (e.g., birth date, hire date, sign-up date)'
|
302
|
+
#
|
303
|
+
def register(password, fields={})
|
304
|
+
reg = Iq.new_register(jid.node, password)
|
305
|
+
reg.to = jid.domain
|
306
|
+
fields.each { |name,value|
|
307
|
+
reg.query.add(REXML::Element.new(name)).text = value
|
308
|
+
}
|
309
|
+
|
310
|
+
send_with_id(reg)
|
311
|
+
end
|
312
|
+
|
313
|
+
##
|
314
|
+
# Remove the registration of a user account
|
315
|
+
#
|
316
|
+
# *WARNING:* this deletes your roster and everything else
|
317
|
+
# stored on the server!
|
318
|
+
def remove_registration
|
319
|
+
reg = Iq.new_register
|
320
|
+
reg.to = jid.domain
|
321
|
+
reg.query.add(REXML::Element.new('remove'))
|
322
|
+
send_with_id(reg)
|
323
|
+
end
|
324
|
+
|
325
|
+
##
|
326
|
+
# Change the client's password
|
327
|
+
#
|
328
|
+
# Threading is suggested, as this code waits
|
329
|
+
# for an answer.
|
330
|
+
#
|
331
|
+
# Raises an exception upon error response (ServerError from
|
332
|
+
# Stream#send_with_id).
|
333
|
+
# new_password:: [String] New password
|
334
|
+
def password=(new_password)
|
335
|
+
iq = Iq.new_query(:set, @jid.domain)
|
336
|
+
iq.query.add_namespace('jabber:iq:register')
|
337
|
+
iq.query.add(REXML::Element.new('username')).text = @jid.node
|
338
|
+
iq.query.add(REXML::Element.new('password')).text = new_password
|
339
|
+
|
340
|
+
err = nil
|
341
|
+
send_with_id(iq)
|
342
|
+
end
|
343
|
+
end
|
344
|
+
end
|
@@ -0,0 +1,53 @@
|
|
1
|
+
module Jabber
|
2
|
+
|
3
|
+
module Command
|
4
|
+
|
5
|
+
##
|
6
|
+
# The Responder Helper handles the low-level stuff of the
|
7
|
+
# Ad-hoc commands (JEP 0050).
|
8
|
+
class Responder
|
9
|
+
|
10
|
+
##
|
11
|
+
# Initialize a Responder
|
12
|
+
def initialize(stream)
|
13
|
+
@stream = stream
|
14
|
+
@commandsdiscocbs = CallbackList.new
|
15
|
+
@commandexeccbs = CallbackList.new
|
16
|
+
|
17
|
+
stream.add_iq_callback(180, self) { |iq|
|
18
|
+
iq_callback(iq)
|
19
|
+
}
|
20
|
+
end
|
21
|
+
|
22
|
+
##
|
23
|
+
# Add a callback for <query> stanzas asking for the list
|
24
|
+
# of ad-hoc commands
|
25
|
+
def add_commands_disco_callback(priority = 0, ref = nil, &block)
|
26
|
+
@commandsdiscocbs.add(priority, ref, block)
|
27
|
+
end
|
28
|
+
|
29
|
+
##
|
30
|
+
# Add a callback for <command> stanzas asking for the execution
|
31
|
+
# of an ad-hoc command
|
32
|
+
def add_commands_exec_callback(priority = 0, ref = nil, &block)
|
33
|
+
@commandexeccbs.add(priority, ref, block)
|
34
|
+
end
|
35
|
+
|
36
|
+
##
|
37
|
+
# Handles <iq> stanzas and execute callbacks
|
38
|
+
def iq_callback(iq)
|
39
|
+
if iq.type == :get
|
40
|
+
if iq.query.kind_of?(Jabber::Discovery::IqQueryDiscoItems) &&
|
41
|
+
iq.query.node == "http://jabber.org/protocol/commands"
|
42
|
+
@commandsdiscocbs.process(iq)
|
43
|
+
end
|
44
|
+
elsif iq.type == :set && iq.command
|
45
|
+
@commandexeccbs.process(iq)
|
46
|
+
end
|
47
|
+
end
|
48
|
+
|
49
|
+
end
|
50
|
+
|
51
|
+
end
|
52
|
+
|
53
|
+
end
|