jabber4r-revive 0.9.0

data/.gitignore

@@ -0,0 +1,4 @@
+.rvmrc
+
+tmp/
+pkg/

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format progress
+--order random

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3
+branches:
+  only:
+    - master
+script: bundle exec rspec

data/CHANGELOG

@@ -0,0 +1,45 @@
+
+v0.9.0
+  - 2013/06/26: feature(changelog) added changelog file (Strech (aka Sergey Fedorov))
+  - 2013/06/26: Jabber::BoshSession : Modified to_json method (Strech (aka Sergey Fedorov))
+  - 2013/06/25: Jabber::BoshSession : XMPP over BOSH (XEP-0206) (Strech (aka Sergey Fedorov))
+  - 2013/06/20: Jabber::Connection : Change method parse_failure (Strech (aka Sergey Fedorov))
+  - 2013/06/20: Jabber::Connection : Refactoring (Strech (aka Sergey Fedorov))
+  - 2013/06/20: Rspec : Socket mock changed. Jabber::Connection : Specs for #send (Strech (aka Sergey Fedorov))
+  - 2013/06/20: Rspec : Change rspec dummy text (Strech (aka Sergey Fedorov))
+  - 2013/06/20: Jabber::Debugger : Added (Strech (aka Sergey Fedorov))
+  - 2013/06/20: Jabber : Moved up on one level (Strech (aka Sergey Fedorov))
+  - 2013/06/20: Jabber::Connection : add_filter and remove_filter refactoring (Strech (aka Sergey Fedorov))
+  - 2013/06/20: F (Strech (aka Sergey Fedorov))
+  - 2013/06/20: F (Strech (aka Sergey Fedorov))
+  - 2013/06/19: Jabber::Connection : New method force_close! added (Strech (aka Sergey Fedorov))
+  - 2013/06/19: Jabber::Connection : Added :end_document listener (Strech (aka Sergey Fedorov))
+  - 2013/06/07: Jabber::Protocol::Connection : Fix misstype (Strech (aka Sergey Fedorov))
+  - 2013/06/07: Jabber : Added missing requires (Strech (aka Sergey Fedorov))
+  - 2013/06/07: Jabber::JID : Specs for same?, ::to_jid methods (Strech (aka Sergey Fedorov))
+  - 2013/06/07: Jabber::JID : Specs for hash, ==, strip! methods (Strech (aka Sergey Fedorov))
+  - 2013/06/07: Jabber::JID : Specs for to_s method. Jid regexp (Strech (aka Sergey Fedorov))
+  - 2013/06/07: CI : TravisCI config updated (Strech (aka Sergey Fedorov))
+  - 2013/06/07: CI : TravisCI config updated (Strech (aka Sergey Fedorov))
+  - 2013/06/07: CI : TravisCI config updated (Strech (aka Sergey Fedorov))
+  - 2013/06/07: CI : TravisCI config added (Strech (aka Sergey Fedorov))
+  - 2013/06/07: Update README.md (Sergey Fedorov)
+  - 2013/06/07: Jabber::Protocol : Methods send and receive sync by mutex. Some part of refactoring (Strech (aka Sergey Fedorov))
+  - 2013/06/07: Jabber::Protocol : Class methods refactoring. Split subclasses (Strech (aka Sergey Fedorov))
+  - 2013/06/06: Jabber::Protocol : Class refactoring (Strech (aka Sergey Fedorov))
+  - 2013/06/04: Jabber::JID : Strip method added (Strech (aka Sergey Fedorov))
+  - 2013/06/04: Jabber::Protocol::Iq : Class method from_element refactoring (Strech (aka Sergey Fedorov))
+  - 2013/06/04: Jabber::Protocol::Iq : Replace class name to self (Strech (aka Sergey Fedorov))
+  - 2013/06/04: Update README.md (Sergey Fedorov)
+  - 2013/06/04: Update README.md (Sergey Fedorov)
+  - 2013/06/04: Jabber::Protocol::Iq : Send method refactoring (Strech (aka Sergey Fedorov))
+  - 2013/06/04: Jabber::JID : Tomdoc (Strech (aka Sergey Fedorov))
+  - 2013/06/04: Jabber::JID : Rspec specs added. Refactoring (Strech (aka Sergey Fedorov))
+  - 2013/06/04: Gem: Rspec gem dependency added (Strech (aka Sergey Fedorov))
+  - 2013/06/03: Update .gitignore (Strech (aka Sergey Fedorov))
+  - 2013/06/03: Jabber::Protocol::Iq : Misstype fixed. Trailing spaces removed (Strech (aka Sergey Fedorov))
+  - 2013/06/03: Rename LICENSE.txt to LICENSE (Sergey Fedorov)
+  - 2013/06/03: Update README.md (Sergey Fedorov)
+
+v0.8.0
+  - 2013/06/03: Initial commit (Strech (aka Sergey Fedorov))

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,45 @@
+PATH
+  remote: .
+  specs:
+    jabber4r-revive (0.9.0)
+      ox
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.4)
+    changelogger (0.0.3)
+      grit (~> 2.5.0)
+      thor (~> 0.16.0)
+    crack (0.4.0)
+      safe_yaml (~> 0.9.0)
+    diff-lcs (1.2.4)
+    grit (2.5.0)
+      diff-lcs (~> 1.1)
+      mime-types (~> 1.15)
+      posix-spawn (~> 0.3.6)
+    mime-types (1.23)
+    ox (2.0.4)
+    posix-spawn (0.3.6)
+    rspec (2.13.0)
+      rspec-core (~> 2.13.0)
+      rspec-expectations (~> 2.13.0)
+      rspec-mocks (~> 2.13.0)
+    rspec-core (2.13.1)
+    rspec-expectations (2.13.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.13.1)
+    safe_yaml (0.9.3)
+    thor (0.16.0)
+    webmock (1.11.0)
+      addressable (>= 2.2.7)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  changelogger
+  jabber4r-revive!
+  rspec
+  webmock

data/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2002, Rich Kilmer (rich@infoether.com)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+ 
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 
+
+The name Rich Kilmer may not be used to endorse or promote products derived from this software without specific prior written permission. 
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,29 @@
+# Jabber4r (revive)
+
+Original [README](http://rubydoc.info/gems/jabber4r/file/README) and original [jabber4r web-site](http://jabber4r.rubyforge.org/)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'jabber4r-revive'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install jabber4r-revive
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,71 @@
+# coding: utf-8
+
+require "bundler/gem_tasks"
+require "pty"
+
+# ============================== Support =======================================
+
+ROOT_PATH = File.expand_path("..", __FILE__)
+VERSION_PATH = File.join(ROOT_PATH, "lib", "jabber4r", "version.rb")
+CHANGELOG_PATH = File.join(ROOT_PATH, "CHANGELOG")
+
+# get current version from version.rb file
+def current_version
+  version = File.read(VERSION_PATH).gsub(/[^\d\.]+/, "").strip.chomp
+end
+
+# get released version from git
+def released_version
+  /\Av([\d\.]+)\z/ === `git describe --tags --abbrev=0 2>/dev/null || echo 'v0.0.0'`.chomp.strip
+
+  $1
+end
+
+# run +cmd+ in subprocess, redirect its stdout to parent's stdout
+def spawn(cmd, stdout = STDOUT)
+  puts ">> #{cmd}"
+
+  cmd += ' 2>&1'
+  PTY.spawn cmd do |r, w, pid|
+    begin
+      r.sync
+      r.each_char { |chr| stdout.write(chr) }
+    rescue Errno::EIO => e
+      # simply ignoring this
+    ensure
+      ::Process.wait pid
+    end
+  end
+  abort "#{cmd} failed" unless $? && $?.exitstatus == 0
+end
+
+# =============================== Tasks ========================================
+
+namespace :version do
+  task :current do
+    puts current_version
+  end
+
+  desc "Release new version"
+  task release: [:changelog, :commit, :tag]
+
+  desc "Add new version to git repo"
+  task :commit do
+    spawn "git add '#{VERSION_PATH}'"
+    spawn "git diff --cached --exit-code > /dev/null || git commit -m \"Release #{current_version}\" || echo -n"
+  end
+
+  desc "Add git tag for new version"
+  task :tag do
+    spawn "git tag v#{current_version}"
+  end
+
+  desc "Generate file CHANGELOG"
+  task :changelog do
+    spawn "changelogger changelog '#{ROOT_PATH}' --top_version='v#{current_version}' > '#{CHANGELOG_PATH}'"
+    spawn "git add '#{CHANGELOG_PATH}'"
+  end
+end
+
+desc "Show current version"
+task version: "version:current"

data/jabber4r-revive.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "jabber4r/version"
+
+Gem::Specification.new do |gem|
+  gem.name          = "jabber4r-revive"
+  gem.version       = Jabber::VERSION
+  gem.authors       = ["Richard Kilmer", "Sergey Fedorov"]
+  gem.email         = ["rich@infoether.com", "strech_ftf@mail.ru"]
+  gem.description   = "The purpose of this library is to allow Ruby applications to  talk to a Jabber IM system. Jabber is an open-source instant  messaging service, which can be learned about at http://www.jabber.org"
+  gem.summary       = "Read more http://jabber4r.rubyforge.org"
+  gem.homepage      = "https://github.com/Strech/jabber4r-revive"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "ox"
+
+  gem.add_development_dependency "rspec"
+  gem.add_development_dependency "webmock"
+  gem.add_development_dependency "changelogger"
+end

data/lib/jabber4r/bosh_session.rb

@@ -0,0 +1,224 @@
+# coding: utf-8
+
+# License: see LICENSE
+# Jabber4R - Jabber Instant Messaging Library for Ruby
+# Copyright (C) 2002  Rich Kilmer <rich@infoether.com>
+# Copyright (C) 2013  Sergey Fedorov <strech_ftf@mail.ru>
+
+require "ox"
+require "json"
+require "net/http"
+require "digest/sha1"
+
+module Jabber
+  # XMPP Over BOSH class
+  # NOTE: http://xmpp.org/extensions/xep-0206.html
+  class BoshSession
+    # Public: Default connection options
+    DEFAULTS = {
+      host: "localhost",
+      port: 5280,
+      bind_uri: "/http-bind"
+    }.freeze
+
+    attr_reader :stream_id
+    attr_reader :jid, :rid, :sid
+    attr_reader :host, :port, :bind_uri
+
+    # Public: Create new BOSH-session and bind it to jabber http-bind service
+    #
+    # username - String the login of jabber server user
+    # password - String the password of jabber server user
+    # options  - Hash the options for jabber http-bind service (default: Empty hash)
+    #            :host     - String the jabber server host
+    #            :port     - [String|Fixnum] the port of http-bind endpoint of jabber server
+    #            :bind_uri - String the http-bind uri
+    #
+    #
+    # Examples
+    #
+    # Jabber::BoshSession.bind("strech@localhost/res-1", "secret-pass")
+    # Jabber::BoshSession.bind("strech@localhost/res-1", "secret-pass", )
+    #
+    # Raises Jabber::AuthenticationError
+    # Returns Jabber::BoshSession
+    def self.bind(username, password, options = {})
+      host, port, bind_uri = DEFAULTS.dup.merge!(options).values
+
+      session = new(host, port, bind_uri)
+      raise AuthenticationError, "Failed to login" unless session.authenticate(username, password)
+
+      session
+    end
+
+    # Public: Create new BOSH-session (not binded to http-bind service)
+    #
+    # host     - String the jabber server host
+    # port     - [String|Fixnum] the port of http-bind endpoint of jabber server
+    # bind_uri - String the http-bind uri
+    #
+    # Examples
+    #
+    # Jabber::BoshSession.new("localhost", 5280, "/http-bind")
+    #
+    # Returns Jabber::BoshSession
+    def initialize(host, port, bind_uri)
+      @host, @port, @bind_uri = host, port, bind_uri
+      @alive = false
+    end
+
+    # Public: Authenticate user in jabber server by his username and password
+    # NOTE: This authentication is Non-SASL http://xmpp.org/extensions/xep-0078.html
+    #
+    # Examples
+    #
+    # bosh = Jabber::BoshSession.new ...
+    # bosh.authenticate("strech@localhost/my-resource", "super-secret-password") # => true
+    # bosh.alive? # => true
+    #
+    # Returns boolean
+    def authenticate(username, password)
+      open_new_stream
+
+      @jid = username.is_a?(JID) ? username : JID.new(username)
+      @alive = login(jid, password)
+    end
+
+    # Public: Is BOSH-session active? (no polling consider)
+    #
+    # Returns boolean
+    def alive?
+      @alive
+    end
+
+    # Public: Represent BOSH-session as json object
+    #
+    # Returns String
+    def to_json
+      {jid: jid.to_s, rid: rid, sid: sid}.to_json
+    end
+
+    private
+   # Internal: Send open stream command to jabber server
+    #
+    # Raises XMLMalformedError
+    # Returns boolean
+    def open_new_stream
+      Jabber.debug("Open stream for bosh session")
+
+      body = Ox::Element.new("body").tap do |element|
+        element[:xmlns]   = "http://jabber.org/protocol/httpbind"
+        element[:content] = "text/xml; charset=utf-8"
+        element[:rid]     = generate_next_rid
+        element[:to]      = host
+        element[:secure]  = true
+        element[:wait]    = 60
+        element[:hold]    = 1
+      end
+
+      response = post(Ox.dump body)
+      xml = Ox.parse(response.body.tr("'", '"'))
+
+      [:sid, :authid].each do |m|
+        raise XMLMalformedError,
+          "Couldn't find <body /> attribute [#{m}]" if xml[m].nil?
+      end
+
+      @sid, @stream_id = xml.sid, xml.authid
+
+      true
+    end
+
+    # Internal: Send login request to jabber server
+    #
+    # jid - Jabber::JID the jid of jabber user
+    # password - String the password of jabber user
+    #
+    # Raises ArgumentError
+    # Raises XMLMalformedError
+    # Returns boolean
+    def login(jid, password)
+      raise ArgumentError,
+        "Jabber::JID expected, but #{jid.class} was given" unless jid.is_a?(JID)
+
+      query = Ox::Element.new("query").tap do |element|
+        element[:xmlns] = "jabber:iq:auth"
+
+        element << (Ox::Element.new("username") << jid.node)
+        element << (Ox::Element.new("digest")   << generate_digest_for(stream_id, password))
+        element << (Ox::Element.new("resource") << jid.resource)
+      end
+
+      iq = Ox::Element.new("iq").tap do |element|
+        element[:xmlns] = "jabber:client"
+        element[:type]  = "set"
+        element[:id]    = Jabber.gen_random_id
+
+        element << query
+      end
+
+      body = Ox::Element.new("body").tap do |element|
+        element[:xmlns]   = 'http://jabber.org/protocol/httpbind'
+        element[:content] = "text/xml; charset=utf-8"
+        element[:rid]     = generate_next_rid
+        element[:sid]     = sid
+
+        element << iq
+      end
+
+      response = post(Ox.dump body)
+      xml = Ox.parse(response.body.tr("'", '"'))
+
+      raise XMLMalformedError, "Couldn't find xml tag <iq/>" if xml.locate("iq").empty?
+      return false unless xml.iq[:type] == "result"
+
+      @rid = body.rid
+
+      true
+    end
+
+    # Internal: Send HTTP-post request on HTTP-bind uri
+    #
+    # body - String data, which will be sended
+    #
+    # Examples
+    #
+    # post(%Q[<body><iq id="1"/></body>]) # => Net::HTTPSuccess
+    #
+    # Raises Net::HTTPBadResponse
+    # Returns Net:HttpResponse
+    def post(body)
+      request = Net::HTTP::Post.new(bind_uri)
+      request.body = body
+      request.content_length = request.body.size
+      request["Content-Type"] = "text/xml; charset=utf-8"
+
+      Jabber.debug("Sending POST request - #{body.strip}")
+
+      response = Net::HTTP.new(host, port).start { |http| http.request(request) }
+
+      Jabber.debug("Receiving - #{response.code}: #{response.body.inspect}")
+
+      unless response.is_a?(Net::HTTPSuccess)
+        raise Net::HTTPBadResponse, "Net::HTTPSuccess expected, but #{response.class} was received"
+      end
+
+      response
+    end
+
+    # Internal: Generate hex string consist of concatination of all arguments
+    #
+    # Returns String
+    def generate_digest_for(*args)
+      Digest::SHA1.hexdigest(args.join)
+    end
+
+    # Internal: Generate next request id for http post request
+    #
+    # Returns Fixnum
+    def generate_next_rid
+      @rid ||= rand(1_000_000_000)
+      @rid += 1
+    end
+  end
+end