gmcmillan-xmpp4r 0.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (215) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG +91 -0
  3. data/COPYING +340 -0
  4. data/LICENSE +59 -0
  5. data/README.rdoc +122 -0
  6. data/README_ruby19.txt +43 -0
  7. data/Rakefile +258 -0
  8. data/data/doc/xmpp4r/examples/advanced/adventure/README +56 -0
  9. data/data/doc/xmpp4r/examples/advanced/adventure/adventure.rb +23 -0
  10. data/data/doc/xmpp4r/examples/advanced/adventure/adventuremuc.rb +136 -0
  11. data/data/doc/xmpp4r/examples/advanced/adventure/cube.xml +15 -0
  12. data/data/doc/xmpp4r/examples/advanced/adventure/tower.xml +69 -0
  13. data/data/doc/xmpp4r/examples/advanced/adventure/world.rb +424 -0
  14. data/data/doc/xmpp4r/examples/advanced/fileserve.conf +11 -0
  15. data/data/doc/xmpp4r/examples/advanced/fileserve.rb +346 -0
  16. data/data/doc/xmpp4r/examples/advanced/getonline.rb +56 -0
  17. data/data/doc/xmpp4r/examples/advanced/gtkmucclient.rb +315 -0
  18. data/data/doc/xmpp4r/examples/advanced/migrate.rb +88 -0
  19. data/data/doc/xmpp4r/examples/advanced/minimuc.rb +266 -0
  20. data/data/doc/xmpp4r/examples/advanced/pep-aggregator/index.xsl +235 -0
  21. data/data/doc/xmpp4r/examples/advanced/pep-aggregator/pep-aggregator.rb +147 -0
  22. data/data/doc/xmpp4r/examples/advanced/recvfile.rb +85 -0
  23. data/data/doc/xmpp4r/examples/advanced/rosterdiscovery.rb +129 -0
  24. data/data/doc/xmpp4r/examples/advanced/sendfile.conf +10 -0
  25. data/data/doc/xmpp4r/examples/advanced/sendfile.rb +72 -0
  26. data/data/doc/xmpp4r/examples/advanced/shellmgr/shellmgr.rb +51 -0
  27. data/data/doc/xmpp4r/examples/advanced/shellmgr/shellmgr_jabber.rb +43 -0
  28. data/data/doc/xmpp4r/examples/advanced/shellmgr/shellmgr_test.rb +10 -0
  29. data/data/doc/xmpp4r/examples/advanced/versionpoll.rb +109 -0
  30. data/data/doc/xmpp4r/examples/advanced/xmpping.rb +146 -0
  31. data/data/doc/xmpp4r/examples/advanced/xmppingrc.sample +14 -0
  32. data/data/doc/xmpp4r/examples/basic/change_password.rb +41 -0
  33. data/data/doc/xmpp4r/examples/basic/client.rb +70 -0
  34. data/data/doc/xmpp4r/examples/basic/component.rb +11 -0
  35. data/data/doc/xmpp4r/examples/basic/echo.rb +37 -0
  36. data/data/doc/xmpp4r/examples/basic/jabbersend.rb +41 -0
  37. data/data/doc/xmpp4r/examples/basic/mass_sender.rb +68 -0
  38. data/data/doc/xmpp4r/examples/basic/muc_owner_config.rb +12 -0
  39. data/data/doc/xmpp4r/examples/basic/mucinfo.rb +41 -0
  40. data/data/doc/xmpp4r/examples/basic/mucsimplebot.rb +82 -0
  41. data/data/doc/xmpp4r/examples/basic/register.rb +42 -0
  42. data/data/doc/xmpp4r/examples/basic/remove_registration.rb +18 -0
  43. data/data/doc/xmpp4r/examples/basic/roster.rb +44 -0
  44. data/data/doc/xmpp4r/examples/basic/rosterprint.rb +50 -0
  45. data/data/doc/xmpp4r/examples/basic/rosterrename.rb +34 -0
  46. data/data/doc/xmpp4r/examples/basic/rosterwatch.rb +171 -0
  47. data/data/doc/xmpp4r/examples/basic/send_vcard.rb +67 -0
  48. data/data/doc/xmpp4r/examples/basic/tune_client.rb +56 -0
  49. data/data/doc/xmpp4r/examples/basic/tune_server.rb +58 -0
  50. data/data/doc/xmpp4r/examples/basic/versionbot.rb +75 -0
  51. data/lib/xmpp4r.rb +118 -0
  52. data/lib/xmpp4r/base64.rb +32 -0
  53. data/lib/xmpp4r/bytestreams.rb +15 -0
  54. data/lib/xmpp4r/bytestreams/helper/filetransfer.rb +321 -0
  55. data/lib/xmpp4r/bytestreams/helper/ibb/base.rb +257 -0
  56. data/lib/xmpp4r/bytestreams/helper/ibb/initiator.rb +31 -0
  57. data/lib/xmpp4r/bytestreams/helper/ibb/target.rb +54 -0
  58. data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/base.rb +153 -0
  59. data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/initiator.rb +86 -0
  60. data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/server.rb +198 -0
  61. data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/socks5.rb +65 -0
  62. data/lib/xmpp4r/bytestreams/helper/socks5bytestreams/target.rb +82 -0
  63. data/lib/xmpp4r/bytestreams/iq/bytestreams.rb +170 -0
  64. data/lib/xmpp4r/bytestreams/iq/si.rb +206 -0
  65. data/lib/xmpp4r/callbacks.rb +133 -0
  66. data/lib/xmpp4r/caps.rb +1 -0
  67. data/lib/xmpp4r/caps/c.rb +67 -0
  68. data/lib/xmpp4r/caps/helper/generator.rb +160 -0
  69. data/lib/xmpp4r/caps/helper/helper.rb +84 -0
  70. data/lib/xmpp4r/client.rb +345 -0
  71. data/lib/xmpp4r/command/helper/responder.rb +53 -0
  72. data/lib/xmpp4r/command/iq/command.rb +154 -0
  73. data/lib/xmpp4r/component.rb +103 -0
  74. data/lib/xmpp4r/connection.rb +231 -0
  75. data/lib/xmpp4r/dataforms.rb +5 -0
  76. data/lib/xmpp4r/dataforms/x/data.rb +297 -0
  77. data/lib/xmpp4r/debuglog.rb +63 -0
  78. data/lib/xmpp4r/delay.rb +5 -0
  79. data/lib/xmpp4r/delay/x/delay.rb +99 -0
  80. data/lib/xmpp4r/discovery.rb +8 -0
  81. data/lib/xmpp4r/discovery/helper/helper.rb +58 -0
  82. data/lib/xmpp4r/discovery/helper/responder.rb +165 -0
  83. data/lib/xmpp4r/discovery/iq/discoinfo.rb +211 -0
  84. data/lib/xmpp4r/discovery/iq/discoitems.rb +147 -0
  85. data/lib/xmpp4r/entity_time.rb +6 -0
  86. data/lib/xmpp4r/entity_time/iq.rb +45 -0
  87. data/lib/xmpp4r/entity_time/responder.rb +57 -0
  88. data/lib/xmpp4r/errors.rb +284 -0
  89. data/lib/xmpp4r/feature_negotiation.rb +5 -0
  90. data/lib/xmpp4r/feature_negotiation/iq/feature.rb +28 -0
  91. data/lib/xmpp4r/framework/base.rb +55 -0
  92. data/lib/xmpp4r/framework/bot.rb +148 -0
  93. data/lib/xmpp4r/httpbinding.rb +5 -0
  94. data/lib/xmpp4r/httpbinding/client.rb +275 -0
  95. data/lib/xmpp4r/idgenerator.rb +37 -0
  96. data/lib/xmpp4r/iq.rb +221 -0
  97. data/lib/xmpp4r/jid.rb +167 -0
  98. data/lib/xmpp4r/last.rb +2 -0
  99. data/lib/xmpp4r/last/helper/helper.rb +37 -0
  100. data/lib/xmpp4r/last/iq/last.rb +67 -0
  101. data/lib/xmpp4r/location.rb +2 -0
  102. data/lib/xmpp4r/location/helper/helper.rb +56 -0
  103. data/lib/xmpp4r/location/location.rb +179 -0
  104. data/lib/xmpp4r/message.rb +226 -0
  105. data/lib/xmpp4r/muc.rb +14 -0
  106. data/lib/xmpp4r/muc/helper/mucbrowser.rb +92 -0
  107. data/lib/xmpp4r/muc/helper/mucclient.rb +469 -0
  108. data/lib/xmpp4r/muc/helper/simplemucclient.rb +332 -0
  109. data/lib/xmpp4r/muc/iq/mucadmin.rb +23 -0
  110. data/lib/xmpp4r/muc/iq/mucadminitem.rb +20 -0
  111. data/lib/xmpp4r/muc/iq/mucowner.rb +15 -0
  112. data/lib/xmpp4r/muc/item.rb +143 -0
  113. data/lib/xmpp4r/muc/x/muc.rb +70 -0
  114. data/lib/xmpp4r/muc/x/mucuserinvite.rb +60 -0
  115. data/lib/xmpp4r/muc/x/mucuseritem.rb +36 -0
  116. data/lib/xmpp4r/presence.rb +232 -0
  117. data/lib/xmpp4r/pubsub.rb +8 -0
  118. data/lib/xmpp4r/pubsub/children/configuration.rb +86 -0
  119. data/lib/xmpp4r/pubsub/children/event.rb +49 -0
  120. data/lib/xmpp4r/pubsub/children/item.rb +35 -0
  121. data/lib/xmpp4r/pubsub/children/items.rb +53 -0
  122. data/lib/xmpp4r/pubsub/children/node_config.rb +48 -0
  123. data/lib/xmpp4r/pubsub/children/publish.rb +38 -0
  124. data/lib/xmpp4r/pubsub/children/retract.rb +41 -0
  125. data/lib/xmpp4r/pubsub/children/subscription.rb +62 -0
  126. data/lib/xmpp4r/pubsub/children/subscription_config.rb +67 -0
  127. data/lib/xmpp4r/pubsub/children/unsubscribe.rb +63 -0
  128. data/lib/xmpp4r/pubsub/helper/nodebrowser.rb +129 -0
  129. data/lib/xmpp4r/pubsub/helper/nodehelper.rb +156 -0
  130. data/lib/xmpp4r/pubsub/helper/oauth_service_helper.rb +90 -0
  131. data/lib/xmpp4r/pubsub/helper/servicehelper.rb +490 -0
  132. data/lib/xmpp4r/pubsub/iq/pubsub.rb +19 -0
  133. data/lib/xmpp4r/query.rb +15 -0
  134. data/lib/xmpp4r/reliable.rb +168 -0
  135. data/lib/xmpp4r/rexmladdons.rb +197 -0
  136. data/lib/xmpp4r/roster.rb +7 -0
  137. data/lib/xmpp4r/roster/helper/roster.rb +532 -0
  138. data/lib/xmpp4r/roster/iq/roster.rb +215 -0
  139. data/lib/xmpp4r/roster/x/roster.rb +138 -0
  140. data/lib/xmpp4r/rpc.rb +2 -0
  141. data/lib/xmpp4r/rpc/helper/client.rb +123 -0
  142. data/lib/xmpp4r/rpc/helper/server.rb +74 -0
  143. data/lib/xmpp4r/rpc/helper/xmlrpcaddons.rb +67 -0
  144. data/lib/xmpp4r/rpc/iq/rpc.rb +23 -0
  145. data/lib/xmpp4r/sasl.rb +259 -0
  146. data/lib/xmpp4r/semaphore.rb +38 -0
  147. data/lib/xmpp4r/stream.rb +611 -0
  148. data/lib/xmpp4r/streamparser.rb +66 -0
  149. data/lib/xmpp4r/test/listener_mocker.rb +118 -0
  150. data/lib/xmpp4r/tune.rb +2 -0
  151. data/lib/xmpp4r/tune/helper/helper.rb +58 -0
  152. data/lib/xmpp4r/tune/tune.rb +113 -0
  153. data/lib/xmpp4r/vcard.rb +6 -0
  154. data/lib/xmpp4r/vcard/helper/vcard.rb +84 -0
  155. data/lib/xmpp4r/vcard/iq/vcard.rb +109 -0
  156. data/lib/xmpp4r/version.rb +7 -0
  157. data/lib/xmpp4r/version/helper/responder.rb +72 -0
  158. data/lib/xmpp4r/version/helper/simpleresponder.rb +44 -0
  159. data/lib/xmpp4r/version/iq/version.rb +105 -0
  160. data/lib/xmpp4r/x.rb +37 -0
  161. data/lib/xmpp4r/xhtml.rb +1 -0
  162. data/lib/xmpp4r/xhtml/html.rb +115 -0
  163. data/lib/xmpp4r/xmpp4r.rb +20 -0
  164. data/lib/xmpp4r/xmppelement.rb +168 -0
  165. data/lib/xmpp4r/xmppstanza.rb +162 -0
  166. data/setup.rb +1586 -0
  167. data/test/bytestreams/tc_ibb.rb +188 -0
  168. data/test/bytestreams/tc_socks5bytestreams.rb +114 -0
  169. data/test/caps/tc_helper.rb +158 -0
  170. data/test/dataforms/tc_data.rb +81 -0
  171. data/test/delay/tc_xdelay.rb +51 -0
  172. data/test/discovery/tc_responder.rb +91 -0
  173. data/test/entity_time/tc_responder.rb +65 -0
  174. data/test/last/tc_helper.rb +75 -0
  175. data/test/lib/assert_equal_xml.rb +14 -0
  176. data/test/lib/clienttester.rb +149 -0
  177. data/test/muc/tc_muc_mucclient.rb +834 -0
  178. data/test/muc/tc_muc_simplemucclient.rb +114 -0
  179. data/test/muc/tc_mucowner.rb +50 -0
  180. data/test/pubsub/tc_helper.rb +785 -0
  181. data/test/pubsub/tc_nodeconfig.rb +61 -0
  182. data/test/pubsub/tc_subscriptionconfig.rb +41 -0
  183. data/test/roster/tc_helper.rb +523 -0
  184. data/test/roster/tc_iqqueryroster.rb +173 -0
  185. data/test/roster/tc_xroster.rb +73 -0
  186. data/test/rpc/tc_helper.rb +96 -0
  187. data/test/tc_callbacks.rb +129 -0
  188. data/test/tc_class_names.rb +146 -0
  189. data/test/tc_client.rb +30 -0
  190. data/test/tc_errors.rb +146 -0
  191. data/test/tc_idgenerator.rb +30 -0
  192. data/test/tc_iq.rb +113 -0
  193. data/test/tc_iqquery.rb +31 -0
  194. data/test/tc_jid.rb +204 -0
  195. data/test/tc_presence.rb +150 -0
  196. data/test/tc_rexml.rb +139 -0
  197. data/test/tc_stream.rb +193 -0
  198. data/test/tc_streamComponent.rb +105 -0
  199. data/test/tc_streamError.rb +129 -0
  200. data/test/tc_streamSend.rb +59 -0
  201. data/test/tc_streamparser.rb +137 -0
  202. data/test/tc_xmppstanza.rb +135 -0
  203. data/test/ts_xmpp4r.rb +44 -0
  204. data/test/tune/tc_helper_recv.rb +82 -0
  205. data/test/tune/tc_helper_send.rb +74 -0
  206. data/test/tune/tc_tune.rb +79 -0
  207. data/test/vcard/tc_helper.rb +49 -0
  208. data/test/vcard/tc_iqvcard.rb +62 -0
  209. data/test/version/tc_helper.rb +60 -0
  210. data/test/version/tc_iqqueryversion.rb +97 -0
  211. data/test/xhtml/tc_html.rb +41 -0
  212. data/tools/gen_requires.bash +31 -0
  213. data/tools/xmpp4r-gemspec-test.rb +11 -0
  214. data/xmpp4r.gemspec +249 -0
  215. metadata +299 -0
@@ -0,0 +1,221 @@
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/xmppstanza'
6
+ require 'xmpp4r/jid'
7
+ require 'digest/sha1'
8
+
9
+ require 'xmpp4r/query'
10
+ require 'xmpp4r/vcard/iq/vcard'
11
+
12
+ module Jabber
13
+ ##
14
+ # IQ: Information/Query
15
+ # (see RFC3920 - 9.2.3
16
+ #
17
+ # A class used to build/parse IQ requests/responses
18
+ class Iq < XMPPStanza
19
+ name_xmlns 'iq', 'jabber:client'
20
+ force_xmlns true
21
+
22
+ @@element_classes = {}
23
+
24
+ ##
25
+ # Build a new <iq/> stanza
26
+ # type:: [Symbol] or nil, see Iq#type
27
+ # to:: [JID] Recipient
28
+ def initialize(type = nil, to = nil)
29
+ super()
30
+
31
+ if not to.nil?
32
+ set_to(to)
33
+ end
34
+ if not type.nil?
35
+ set_type(type)
36
+ end
37
+ end
38
+
39
+ ##
40
+ # Get the type of the Iq stanza
41
+ #
42
+ # The following values are allowed:
43
+ # * :get
44
+ # * :set
45
+ # * :result
46
+ # * :error
47
+ # result:: [Symbol] or nil
48
+ def type
49
+ case super
50
+ when 'get' then :get
51
+ when 'set' then :set
52
+ when 'result' then :result
53
+ when 'error' then :error
54
+ else nil
55
+ end
56
+ end
57
+
58
+ ##
59
+ # Set the type of the Iq stanza (see Iq#type)
60
+ # v:: [Symbol] or nil
61
+ def type=(v)
62
+ case v
63
+ when :get then super('get')
64
+ when :set then super('set')
65
+ when :result then super('result')
66
+ when :error then super('error')
67
+ else super(nil)
68
+ end
69
+ end
70
+
71
+ ##
72
+ # Set the type of the Iq stanza (chaining-friendly)
73
+ # v:: [Symbol] or nil
74
+ def set_type(v)
75
+ self.type = v
76
+ self
77
+ end
78
+
79
+ ##
80
+ # Returns the iq's query child, or nil
81
+ # result:: [IqQuery]
82
+ def query
83
+ first_element('query')
84
+ end
85
+
86
+ ##
87
+ # Delete old elements named newquery.name
88
+ #
89
+ # newquery:: [REXML::Element] will be added
90
+ def query=(newquery)
91
+ delete_elements(newquery.name)
92
+ add(newquery)
93
+ end
94
+
95
+ ##
96
+ # Returns the iq's query's namespace, or nil
97
+ # result:: [String]
98
+ def queryns
99
+ e = first_element('query')
100
+ if e
101
+ return e.namespace
102
+ else
103
+ return nil
104
+ end
105
+ end
106
+
107
+ ##
108
+ # Returns the iq's <vCard/> child, or nil
109
+ # result:: [IqVcard]
110
+ def vcard
111
+ first_element('vCard')
112
+ end
113
+
114
+ ##
115
+ # Returns the iq's <pubsub/> child, or nil
116
+ # result:: [IqVcard]
117
+ def pubsub
118
+ first_element('pubsub')
119
+ end
120
+
121
+ ##
122
+ # Returns the iq's <command/> child, or nil
123
+ # resulte:: [IqCommand]
124
+ def command
125
+ first_element("command")
126
+ end
127
+
128
+ ##
129
+ # Create a new Iq stanza with an unspecified query child
130
+ # (<query/> has no namespace)
131
+ def Iq.new_query(type = nil, to = nil)
132
+ iq = Iq.new(type, to)
133
+ query = IqQuery.new
134
+ iq.add(query)
135
+ iq
136
+ end
137
+
138
+ ##
139
+ # Create a new jabber:iq:auth set Stanza.
140
+ def Iq.new_authset(jid, password)
141
+ iq = Iq.new(:set)
142
+ query = IqQuery.new
143
+ query.add_namespace('jabber:iq:auth')
144
+ query.add(REXML::Element.new('username').add_text(jid.node))
145
+ query.add(REXML::Element.new('password').add_text(password))
146
+ query.add(REXML::Element.new('resource').add_text(jid.resource)) if not jid.resource.nil?
147
+ iq.add(query)
148
+ iq
149
+ end
150
+
151
+ ##
152
+ # Create a new jabber:iq:auth set Stanza for Digest authentication
153
+ def Iq.new_authset_digest(jid, session_id, password)
154
+ iq = Iq.new(:set)
155
+ query = IqQuery.new
156
+ query.add_namespace('jabber:iq:auth')
157
+ query.add(REXML::Element.new('username').add_text(jid.node))
158
+ query.add(REXML::Element.new('digest').add_text(Digest::SHA1.hexdigest(session_id + password)))
159
+ query.add(REXML::Element.new('resource').add_text(jid.resource)) if not jid.resource.nil?
160
+ iq.add(query)
161
+ iq
162
+ end
163
+
164
+ ##
165
+ # Create a new jabber:iq:register set stanza for service/server registration
166
+ # username:: [String] (Element will be ommited if unset)
167
+ # password:: [String] (Element will be ommited if unset)
168
+ def Iq.new_register(username=nil, password=nil)
169
+ iq = Iq.new(:set)
170
+ query = IqQuery.new
171
+ query.add_namespace('jabber:iq:register')
172
+ query.add(REXML::Element.new('username').add_text(username)) if username
173
+ query.add(REXML::Element.new('password').add_text(password)) if password
174
+ iq.add(query)
175
+ iq
176
+ end
177
+
178
+ ##
179
+ # Create a new jabber:iq:register get stanza for retrieval
180
+ # of accepted registration information
181
+ def Iq.new_registerget
182
+ iq = Iq.new(:get)
183
+ query = IqQuery.new
184
+ query.add_namespace('jabber:iq:register')
185
+ iq.add(query)
186
+ iq
187
+ end
188
+
189
+ ##
190
+ # Create a new jabber:iq:roster get Stanza.
191
+ #
192
+ # IqQueryRoster is unused here because possibly not require'd
193
+ def Iq.new_rosterget
194
+ iq = Iq.new(:get)
195
+ query = IqQuery.new
196
+ query.add_namespace('jabber:iq:roster')
197
+ iq.add(query)
198
+ iq
199
+ end
200
+
201
+ ##
202
+ # Create a new jabber:iq:roster get Stanza.
203
+ def Iq.new_browseget
204
+ iq = Iq.new(:get)
205
+ query = IqQuery.new
206
+ query.add_namespace('jabber:iq:browse')
207
+ iq.add(query)
208
+ iq
209
+ end
210
+
211
+ ##
212
+ # Create a new jabber:iq:roster set Stanza.
213
+ def Iq.new_rosterset
214
+ iq = Iq.new(:set)
215
+ query = IqQuery.new
216
+ query.add_namespace('jabber:iq:roster')
217
+ iq.add(query)
218
+ iq
219
+ end
220
+ end
221
+ end
@@ -0,0 +1,167 @@
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
+ module Jabber
6
+ ##
7
+ # The JID class represents a Jabber Identifier as described by
8
+ # RFC3920 section 3.1.
9
+ #
10
+ # Note that you can use JIDs also for Sorting, Hash keys, ...
11
+ class JID
12
+ include Comparable
13
+
14
+ PATTERN = /^(?:([^@]*)@)??([^@\/]*)(?:\/(.*?))?$/
15
+
16
+ begin
17
+ require 'idn'
18
+ USE_STRINGPREP = true
19
+ rescue LoadError
20
+ USE_STRINGPREP = false
21
+ end
22
+
23
+ ##
24
+ # Create a new JID. If called as new('a@b/c'), parse the string and
25
+ # split (node, domain, resource)
26
+ def initialize(node = "", domain = nil, resource = nil)
27
+ @resource = resource
28
+ @domain = domain
29
+ @node = node
30
+ if @domain.nil? and @resource.nil? and @node
31
+ @node, @domain, @resource = @node.to_s.scan(PATTERN).first
32
+ end
33
+
34
+ if USE_STRINGPREP
35
+ @node = IDN::Stringprep.nodeprep(@node) if @node
36
+ @domain = IDN::Stringprep.nameprep(@domain) if @domain
37
+ @resource = IDN::Stringprep.resourceprep(@resource) if @resource
38
+ else
39
+ @node.downcase! if @node
40
+ @domain.downcase! if @domain
41
+ end
42
+
43
+ raise ArgumentError, 'Node too long' if (@node || '').length > 1023
44
+ raise ArgumentError, 'Domain too long' if (@domain || '').length > 1023
45
+ raise ArgumentError, 'Resource too long' if (@resource || '').length > 1023
46
+ end
47
+
48
+ ##
49
+ # Returns a string representation of the JID
50
+ # * ""
51
+ # * "domain"
52
+ # * "node@domain"
53
+ # * "domain/resource"
54
+ # * "node@domain/resource"
55
+ def to_s
56
+ s = @domain
57
+ s = "#{@node}@#{s}" if @node
58
+ s += "/#{@resource}" if @resource
59
+ return s
60
+ end
61
+
62
+ ##
63
+ # Returns a new JID with resource removed.
64
+ # return:: [JID]
65
+ def strip
66
+ JID.new(@node, @domain)
67
+ end
68
+ alias_method :bare, :strip
69
+
70
+ ##
71
+ # Removes the resource (sets it to nil)
72
+ # return:: [JID] self
73
+ def strip!
74
+ @resource = nil
75
+ self
76
+ end
77
+ alias_method :bare!, :strip!
78
+
79
+ ##
80
+ # Returns a hash value of the String representation
81
+ # (see JID#to_s)
82
+ def hash
83
+ return to_s.hash
84
+ end
85
+
86
+ ##
87
+ # Ccompare to another JID
88
+ #
89
+ # String representations are compared, see JID#to_s
90
+ def eql?(o)
91
+ to_s.eql?(o.to_s)
92
+ end
93
+
94
+ ##
95
+ # Ccompare to another JID
96
+ #
97
+ # String representations are compared, see JID#to_s
98
+ def ==(o)
99
+ to_s == o.to_s
100
+ end
101
+
102
+ ##
103
+ # Compare two JIDs,
104
+ # helpful for sorting etc.
105
+ #
106
+ # String representations are compared, see JID#to_s
107
+ def <=>(o)
108
+ to_s <=> o.to_s
109
+ end
110
+
111
+ # Get the JID's node
112
+ def node
113
+ @node
114
+ end
115
+
116
+ # Set the JID's node
117
+ def node=(v)
118
+ @node = v.to_s
119
+ if USE_STRINGPREP
120
+ @node = IDN::Stringprep.nodeprep(@node) if @node
121
+ end
122
+ end
123
+
124
+ # Get the JID's domain
125
+ def domain
126
+ return nil if @domain.empty?
127
+ @domain
128
+ end
129
+
130
+ # Set the JID's domain
131
+ def domain=(v)
132
+ @domain = v.to_s
133
+ if USE_STRINGPREP
134
+ @domain = IDN::Stringprep.nodeprep(@domain)
135
+ end
136
+ end
137
+
138
+ # Get the JID's resource
139
+ def resource
140
+ @resource
141
+ end
142
+
143
+ # Set the JID's resource
144
+ def resource=(v)
145
+ @resource = v.to_s
146
+ if USE_STRINGPREP
147
+ @resource = IDN::Stringprep.nodeprep(@resource)
148
+ end
149
+ end
150
+
151
+ # Escape JID
152
+ def JID::escape(jid)
153
+ return jid.to_s.gsub('@', '%')
154
+ end
155
+
156
+ # Test if jid is empty
157
+ def empty?
158
+ to_s.empty?
159
+ end
160
+
161
+ # Test id jid is strepped
162
+ def stripped?
163
+ @resource.nil?
164
+ end
165
+ alias_method :bared?, :stripped?
166
+ end
167
+ end
@@ -0,0 +1,2 @@
1
+ require 'xmpp4r/last/iq/last'
2
+ require 'xmpp4r/last/helper/helper'
@@ -0,0 +1,37 @@
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/last'
7
+
8
+ module Jabber
9
+ module LastActivity
10
+ ##
11
+ # A Helper to manage discovery of Last Activity.
12
+ class Helper
13
+ def initialize(client)
14
+ @stream = client
15
+ end
16
+
17
+ ##
18
+ # Gets the last activity from a JID.
19
+ # jid:: [JID]
20
+ # return:: [Jabber::LastActivity::IqQueryLastActivity]
21
+ def get_last_activity_from(jid)
22
+ iq = Jabber::Iq.new(:get, jid)
23
+ iq.from = @stream.jid
24
+ iq.add(Jabber::LastActivity::IqQueryLastActivity.new)
25
+
26
+ reply = @stream.send_with_id(iq)
27
+
28
+ if reply.query && reply.query.kind_of?(IqQueryLastActivity)
29
+ reply.query
30
+ else
31
+ nil
32
+ end
33
+ end
34
+
35
+ end
36
+ end
37
+ end
@@ -0,0 +1,67 @@
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/query'
6
+
7
+ module Jabber
8
+ module LastActivity
9
+ NS_LAST_ACTIVITY = 'jabber:iq:last'
10
+
11
+ ##
12
+ # Class for handling Last Activity queries
13
+ # (XEP-0012)
14
+ class IqQueryLastActivity < IqQuery
15
+ name_xmlns 'query', NS_LAST_ACTIVITY
16
+
17
+ ##
18
+ # Get the number of seconds since last activity.
19
+ #
20
+ # With a bare jid, this will return the number of seconds since the
21
+ # client was last seen (offline user query).
22
+ #
23
+ # With a full jid, this will return the number of seconds that the
24
+ # client has been idle (online user query).
25
+ #
26
+ # With a server, this will return the server or component's uptime in
27
+ # seconds (server / component query).
28
+ def seconds
29
+ attributes['seconds'] ? attributes['seconds'].to_i : nil
30
+ end
31
+
32
+ ##
33
+ # Set the number of seconds since last activity
34
+ def seconds=(val)
35
+ attributes['seconds'] = val.to_s
36
+ end
37
+
38
+ ##
39
+ # Set the number of seconds since last activity
40
+ # (chaining-friendly)
41
+ def set_second(val)
42
+ self.seconds = val
43
+ self
44
+ end
45
+
46
+ ##
47
+ # For an offline user query, get the last status.
48
+ def status
49
+ self.text
50
+ end
51
+
52
+ ##
53
+ # For an offline user query, set the last status.
54
+ def status=(val)
55
+ self.text = val
56
+ end
57
+
58
+ ##
59
+ # For an offline user query, set the last status.
60
+ # (chaining-friendly)
61
+ def set_status(val)
62
+ self.status = val
63
+ self
64
+ end
65
+ end
66
+ end
67
+ end