cerberus 0.6 → 0.7

data/lib/vendor/xmpp4r/lib/xmpp4r/bytestreams/iq/bytestreams.rb

@@ -0,0 +1,170 @@
+# =XMPP4R - XMPP Library for Ruby
+# License:: Ruby's license (see the LICENSE file) or GNU GPL, at your option.
+# Website::http://home.gna.org/xmpp4r/
+
+module Jabber
+  module Bytestreams
+    NS_BYTESTREAMS = 'http://jabber.org/protocol/bytestreams'
+
+    ##
+    # Class for accessing <query/> elements with
+    # xmlns='http://jabber.org/protocol/bytestreams'
+    # in <iq/> stanzas.
+    class IqQueryBytestreams < IqQuery
+      name_xmlns 'query', NS_BYTESTREAMS
+
+      ##
+      # Initialize such a <query/>
+      # sid:: [String] Session-ID
+      # mode:: [Symbol] :tcp or :udp
+      def initialize(sid=nil, mode=nil)
+        super()
+        self.sid = sid
+        self.mode = mode
+      end
+
+      ##
+      # Session-ID
+      def sid
+        attributes['sid']
+      end
+
+      ##
+      # Set Session-ID
+      def sid=(s)
+        attributes['sid'] = s
+      end
+
+      ##
+      # Transfer mode
+      # result:: :tcp or :udp
+      def mode
+        case attributes['mode']
+          when 'udp' then :udp
+          else :tcp
+        end
+      end
+
+      ##
+      # Set the transfer mode
+      # m:: :tcp or :udp
+      def mode=(m)
+        case m
+          when :udp then attributes['mode'] = 'udp'
+          else attributes['mode'] = 'tcp'
+        end
+      end
+
+      ##
+      # Get the <streamhost-used/> child
+      # result:: [StreamHostUsed]
+      def streamhost_used
+        first_element('streamhost-used')
+      end
+
+      ##
+      # Get the text of the <activate/> child
+      # result:: [JID] or [nil]
+      def activate
+        j = first_element_text('activate')
+        j ? JID.new(j) : nil
+      end
+
+      ##
+      # Set the text of the <activate/> child
+      # s:: [JID]
+      def activate=(s)
+        replace_element_text('activate', s ? s.to_s : nil)
+      end
+    end
+
+
+    ##
+    # <streamhost/> element, normally appear
+    # as children of IqQueryBytestreams
+    class StreamHost < XMPPElement
+      name_xmlns 'streamhost', NS_BYTESTREAMS
+
+      ##
+      # Initialize a <streamhost/> element
+      # jid:: [JID]
+      # host:: [String] Hostname or IP address
+      # port:: [Fixnum] Port number
+      def initialize(jid=nil, host=nil, port=nil)
+        super()
+        self.jid = jid
+        self.host = host
+        self.port = port
+      end
+
+      ##
+      # Get the JID of the streamhost
+      def jid
+        (a = attributes['jid']) ? JID.new(a) : nil
+      end
+
+      ##
+      # Set the JID of the streamhost
+      def jid=(j)
+        attributes['jid'] = (j ? j.to_s : nil)
+      end
+
+      ##
+      # Get the host address of the streamhost
+      def host
+        attributes['host']
+      end
+
+      ##
+      # Set the host address of the streamhost
+      def host=(h)
+        attributes['host'] = h
+      end
+
+      ##
+      # Get the zeroconf attribute of the streamhost
+      def zeroconf
+        attributes['zeroconf']
+      end
+
+      ##
+      # Set the zeroconf attribute of the streamhost
+      def zeroconf=(s)
+        attributes['zeroconf'] = s
+      end
+
+      ##
+      # Get the port number of the streamhost
+      def port
+        p = attributes['port'].to_i
+        (p == 0 ? nil : p)
+      end
+
+      ##
+      # Set the port number of the streamhost
+      def port=(p)
+        attributes['port'] = p.to_s
+      end
+    end
+
+    ##
+    # <streamhost-used/> element, normally appears
+    # as child of IqQueryBytestreams
+    class StreamHostUsed < XMPPElement
+      name_xmlns 'streamhost-used', NS_BYTESTREAMS
+
+      def initialize(jid=nil)
+        super()
+        self.jid = jid
+      end
+
+      def jid
+        (a = attributes['jid']) ? JID.new(a) : nil
+      end
+
+      def jid=(j)
+        attributes['jid'] = (j ? j.to_s : nil)
+      end
+    end
+  end
+end

data/lib/vendor/xmpp4r/lib/xmpp4r/bytestreams/iq/si.rb

@@ -0,0 +1,206 @@
+# =XMPP4R - XMPP Library for Ruby
+# License:: Ruby's license (see the LICENSE file) or GNU GPL, at your option.
+# Website::http://home.gna.org/xmpp4r/
+
+require 'time'  # For Time#xmlschema
+
+require 'xmpp4r/feature_negotiation/iq/feature'
+
+module Jabber
+  module Bytestreams
+    PROFILE_FILETRANSFER = 'http://jabber.org/protocol/si/profile/file-transfer'
+
+    ##
+    # Iq child 'si' for Stream-Initiation
+    class IqSi < XMPPElement
+      name_xmlns 'si', 'http://jabber.org/protocol/si'
+      force_xmlns true
+
+      def initialize(id=nil, profile=nil, mime_type=nil)
+        super()
+
+        self.id = id
+        self.profile = profile
+        self.mime_type = mime_type
+      end
+
+      ##
+      # Session ID of this stream
+      def id
+        attributes['id']
+      end
+
+      ##
+      # Set Session ID of this stream
+      def id=(s)
+        attributes['id'] = s
+      end
+
+      ##
+      # MIME type of this stream
+      def mime_type
+        attributes['mime-type']
+      end
+
+      ##
+      # Set MIME type of this stream
+      def mime_type=(s)
+        attributes['mime-type'] = s
+      end
+
+      ##
+      # Stream profile, can indicate file-transfer
+      def profile
+        attributes['profile']
+      end
+
+      ##
+      # Set stream profile
+      def profile=(s)
+        attributes['profile'] = s
+      end
+
+      ##
+      # <file/> child
+      # result:: [IqSiFile]
+      def file
+        first_element('file')
+      end
+
+      ##
+      # <feature/> child
+      # result:: [IqFeature]
+      def feature
+        first_element('feature')
+      end
+    end
+
+
+    ##
+    # File-transfer meta-information,
+    # may appear as <file/> in IqSi
+    class IqSiFile < XMPPElement
+      name_xmlns 'file', PROFILE_FILETRANSFER
+
+      def initialize(fname=nil, size=nil)
+        super()
+        self.fname = fname
+        self.size = size
+      end
+
+      ##
+      # Get filename (attribute 'name')
+      def fname
+        attributes['name']
+      end
+
+      ##
+      # Set filename (attribute 'name')
+      def fname=(s)
+        attributes['name'] = s
+      end
+
+      ##
+      # Get MD5 hash
+      def hash
+        attributes['hash']
+      end
+
+      ##
+      # Set MD5 hash
+      def hash=(s)
+        attributes['hash'] = s
+      end
+
+      ##
+      # Get file date
+      # result:: [Time] or nil
+      def date
+        begin
+          Time.xmlschema(attributes['date'])
+        rescue ArgumentError
+          nil
+        end
+      end
+
+      ##
+      # Set file date
+      # d:: [Time] or nil
+      def date=(d)
+        attributes['date'] = (d ? d.xmlschema : nil)
+      end
+
+      ##
+      # File size in bytes
+      # result:: [Fixnum]
+      def size
+        (attributes['size'] =~ /^\d+$/) ? attributes['size'].to_i : nil
+      end
+
+      ##
+      # Set file size
+      def size=(s)
+        attributes['size'] = s ? s.to_s : nil
+      end
+
+      ##
+      # File description
+      def description
+        first_element_text('desc')
+      end
+
+      ##
+      # Set file description
+      def description=(s)
+        replace_element_text('desc', s)
+      end
+
+      ##
+      # <range/> child
+      #
+      # A file-transfer offer may contain this with
+      # no attributes set, indicating the ability to
+      # do ranged transfers.
+      # result:: [IqSiFileRange]
+      def range
+        first_element('range')
+      end
+    end
+
+    ##
+    # Information for ranged transfers
+    class IqSiFileRange < XMPPElement
+      name_xmlns 'range', PROFILE_FILETRANSFER
+      def initialize(offset=nil, length=nil)
+        super()
+
+        self.offset = offset
+        self.length = length
+      end
+
+      ##
+      # File offset (for continuing an interrupted transfer)
+      def offset
+        (attributes['offset'] =~ /^\d+$/) ? attributes['offset'].to_i : nil
+      end
+
+      ##
+      # Set file offset
+      def offset=(o)
+        attributes['offset'] = (o ? o.to_s : nil)
+      end
+
+      ##
+      # File length (if not to transfer whole file)
+      def length
+        (attributes['length'] =~ /^\d+$/) ? attributes['length'].to_i : nil
+      end
+
+      ##
+      # Set file length
+      def length=(o)
+        attributes['length'] = (o ? o.to_s : nil)
+      end
+    end
+  end
+end

data/lib/vendor/xmpp4r/lib/xmpp4r/callbacks.rb

@@ -0,0 +1,124 @@
+# =XMPP4R - XMPP Library for Ruby
+# License:: Ruby's license (see the LICENSE file) or GNU GPL, at your option.
+# Website::http://home.gna.org/xmpp4r/
+
+module Jabber
+  ##
+  # This class manages a list of callbacks.
+  #
+  # ==Callbacks management and priority
+  #
+  # Callbacks are managed by the class CallbackList. When they are added, a
+  # priority (just a number or anything Comparable with other priorities) is
+  # specified. The biggest the priority is, the earliest the callback will be
+  # considered.
+  #
+  # Callbacks are processed for a given set of objects as long as they return
+  # false. If you want to stop processing, you must return true. Example :
+  #  cbl = CallbackList.new
+  #  c1 = false
+  #  c2 = false
+  #  c3 = false
+  #  cbl.add(10) { c1 = true; 1 }
+  #  cbl.add(5) { c2 = true; true }
+  #  cbl.add(0) { c3 = true }
+  #  cbl.process('aa')
+  #  puts "#{c1} #{c2} #{c3}"
+  # This example would display "true true false" as callbacks processing was
+  # stopped after the second callback returned true.
+  #
+  # In XMPP4R, callbacks' priorities are quite normalized since we want to be
+  # able to "cascade" callbacks in a clean way. Here are values your code should
+  # take into account :
+  #
+  # >= 200::  logging & debugging callbacks. Those callbacks should not consume
+  #           elements.
+  # 100-199:: Where Helpers register their callbacks. The normal value is 100,
+  #           and Helpers shouldn't register something else unless there's a
+  #           very good reason to.
+  # < 100::   all those numbers are normally available for your application.
+  #           That's enough, don't you think ?
+  class CallbackList
+
+    # Create a new list of callbacks
+    def initialize
+      @list = []
+    end
+
+    ##
+    # Add a callback to the list
+    #
+    # List will be sorted afterwards
+    #
+    # prio:: [Integer] the callback's priority, the higher, the sooner.
+    # ref:: [String] the callback's reference
+    # block:: [Block] a block to execute
+    # return:: [Jabber::CallbackList] The list, for chaining
+    def add(prio = 0, ref = nil, proc = nil, &block)
+      block = proc if proc
+      @list.push(Callback.new(prio, ref, block))
+      @list.sort! { |a, b| b.priority <=> a.priority }
+      self
+    end
+
+    ##
+    # Delete a callback by reference
+    # ref:: [String] the reference of the callback to delete
+    # return:: [CallBackList] The list, for chaining
+    def delete(ref)
+      @list.delete_if { |item| item.ref == ref }
+      self
+    end
+
+    ##
+    # Number of elements in the list
+    # return:: [Integer] The number of elements
+    def length
+      @list.length
+    end
+
+    ##
+    # Process an element through all my callbacks. returns e.consumed?
+    # e:: [Object] The elements to pass to the callback. You can pass
+    # several, but of course, you block must know how to handle them.
+    # return:: [Boolean] true if the element has been consumed
+    def process(*e)
+      # If somebody adds a new callback the list will get modified
+      # and sorted(!) while still iterating through it. So we use a
+      # local copy of @list. Any freshly added callback will receive
+      # the next stanzas, not the current.
+      list = @list.dup
+
+      # process through callbacks
+      list.each do |item|
+        return true if item.block.call(*e) == true
+      end
+      false
+    end
+  end
+
+  # This class is used to store callbacks inside CallbackList. See the
+  # CallbackList class for more detailed explanations.
+  class Callback
+
+    # The Callback's priority
+    attr_reader :priority
+
+    # The Callback's reference, using for deleting purposes
+    attr_reader :ref
+
+    # The Callback's block to execute
+    attr_reader :block
+
+    ##
+    # Create a new callback
+    # priority:: [Integer] the callback's priority. The higher, the sooner it
+    # will be executed
+    # ref:: [String] The callback's reference
+    def initialize(priority = 0, ref = nil, block = Proc.new {})
+      @priority = priority
+      @ref = ref
+      @block = block
+    end
+  end
+end