xcapclient 1.2.2 → 1.3.1

data/README.rdoc

@@ -1,4 +1,4 @@
-= XCAPClient (version 1.2.2)
+= XCAPClient (version 1.3.1)
 
 * http://dev.sipdoc.net/projects/ruby-xcapclient/wiki/
 * http://rubyforge.org/projects/xcapclient/
@@ -66,7 +66,7 @@ A developer interested in this library should study the following documents:
     :password => "xxxxxx",
     :ssl_verify_cert => true
   }
-  
+
   xcap_apps = {
     "pres-rules" => {
       :xmlns => "urn:ietf:params:xml:ns:pres-rules",
@@ -75,14 +75,14 @@ A developer interested in this library should study the following documents:
       :document_name => "index"
     }
   }
-  
+
   @xcapclient = Client.new(xcap_conf, xcap_apps)
 
 
 ==== Fetch the "pres-rules" document from the server
 
   @xcapclient.get("pres-rules")
-  
+
 
 ==== Fetch again the "pres-rules" document (now including the stored ETag)
 
@@ -121,7 +121,7 @@ By default, the methods accesing the XCAP server include the ETag if it's availa
   @xcapclient.get_node("pres-rules", nil,
     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
-  
+
 
 ==== Add a new node (a new allowed user in "pres-rules" document)
 

data/lib/xcapclient.rb

@@ -1,30 +1,23 @@
-module XCAPClient
-	
-	VERSION = "1.2.2"
-	
-	RUBY_VERSION_CORE = case RUBY_VERSION
-		when /^1\.9\./
-			:RUBY_1_9
-		when /^1\.8\./
-			:RUBY_1_8
-		end
-	
-end
-
+module XCAPClient ; end
 
 require "httpclient"
+require "timeout"
 begin
-	require "nokogiri"
-	XCAPClient::NOKOGIRI_INSTALLED = true
-	XCAPClient::PARSE_OPTIONS = Nokogiri::XML::ParseOptions::NONET + Nokogiri::XML::ParseOptions::NOERROR
+  require "nokogiri"
+  XCAPClient::NOKOGIRI_INSTALLED = true
+  XCAPClient::PARSE_OPTIONS = \
+    ::Nokogiri::XML::ParseOptions::STRICT + \
+    ::Nokogiri::XML::ParseOptions::NONET + \
+    ::Nokogiri::XML::ParseOptions::NOBLANKS + \
+    ::Nokogiri::XML::ParseOptions::PEDANTIC
 rescue LoadError
-	STDERR.puts "WARNING: Nokogiri XML parser is not installed. Some non vital features are disabled."
-	XCAPClient::NOKOGIRI_INSTALLED = false
+  STDERR.puts "WARNING: Nokogiri XML parser is not installed. Some non vital features are disabled."
+  XCAPClient::NOKOGIRI_INSTALLED = false
 end
 
-
-xcapclient_root = File.join(File.dirname(__FILE__), 'xcapclient')
-require File.join(xcapclient_root, "client")
-require File.join(xcapclient_root, "errors")
-require File.join(xcapclient_root, "application")
-require File.join(xcapclient_root, "document")
+XCAPClient::DIR_LIB = File.join(File.dirname(__FILE__), 'xcapclient')
+require File.join(XCAPClient::DIR_LIB, "version")
+require File.join(XCAPClient::DIR_LIB, "client")
+require File.join(XCAPClient::DIR_LIB, "errors")
+require File.join(XCAPClient::DIR_LIB, "application")
+require File.join(XCAPClient::DIR_LIB, "document")

data/lib/xcapclient/application.rb

@@ -1,62 +1,62 @@
 module XCAPClient
-	
-	class Application
-		
-		attr_reader :auid, :xmlns, :mime_type, :document_name, :scope
-		
-		def initialize(auid, data={})  #:nodoc:
-			
-			@auid = auid
-			
-			# Check application data.
-			raise ConfigError, "Application `data' must be a hash ('#{@auid}')" unless (Hash === data)
-			
-			@xmlns = data[:xmlns].freeze
-			@mime_type = data[:mime_type].freeze
-			@document_name = data[:document_name] || "index"
-			@scope = data[:scope] || :user
-			@scope.freeze
-			
-			# Check auid.
-			raise ConfigError, "Application `auid' must be a non empty string ('#{@auid}')" unless String === @auid && ! @auid.empty?
-				
-			# Check xmlns.
-			raise ConfigError, "Application `xmlns' must be a non empty string ('#{@auid}')" unless String === @xmlns && ! @xmlns.empty?
-			
-			# Check mime-type.
-			raise ConfigError, "Application `mime_type' must be a non empty string ('#{@auid}')" unless String === @mime_type && ! @mime_type.empty?
-			
-			# Check document_name
-			raise ConfigError, "Application `document_name' must be a non empty string ('#{@auid}')" unless String === @document_name && ! @document_name.empty?
-			
-			# Check scope.
-			raise ConfigError, "Application `scope' must be :user or :global ('#{@auid}')" unless [:user, :global].include?(@scope)
-			
-			# Create first document.
-			@documents = {}
-			@documents[@document_name] = Document.new(@document_name)
-			
-		end
-		
-		# Get the XCAPClient::Document with name _document_name_ within this application. If the parameter is not set, the default document is got.
-		#
-		def document(document_name=nil)
-			@documents[document_name || @document_name]
-		end
-		
-		# Get an Array containing all the documents created for this application.
-		def documents
-			@documents
-		end
-		
-		# Creates a new XCAPClient::Document for this application with name _document_name_.
-		def add_document(document_name)
-			raise DocumentError, "document '#{document_name}' already exists" if @documents[document_name]
-			@documents[document_name] = Document.new(document_name)
-			
-			return @documents[document_name]
-		end
-		
-	end
-	
+
+  class Application
+
+    attr_reader :auid, :xmlns, :mime_type, :document_name, :scope
+
+    def initialize(auid, data={})  #:nodoc:
+
+      @auid = auid
+
+      # Check application data.
+      raise ConfigError, "Application `data' must be a hash ('#{@auid}')" unless (Hash === data)
+
+      @xmlns = data[:xmlns].freeze
+      @mime_type = data[:mime_type].freeze
+      @document_name = data[:document_name] || "index"
+      @scope = data[:scope] || :user
+      @scope.freeze
+
+      # Check auid.
+      raise ConfigError, "Application `auid' must be a non empty string ('#{@auid}')" unless String === @auid && ! @auid.empty?
+
+      # Check xmlns.
+      raise ConfigError, "Application `xmlns' must be a non empty string ('#{@auid}')" unless String === @xmlns && ! @xmlns.empty?
+
+      # Check mime-type.
+      raise ConfigError, "Application `mime_type' must be a non empty string ('#{@auid}')" unless String === @mime_type && ! @mime_type.empty?
+
+      # Check document_name
+      raise ConfigError, "Application `document_name' must be a non empty string ('#{@auid}')" unless String === @document_name && ! @document_name.empty?
+
+      # Check scope.
+      raise ConfigError, "Application `scope' must be :user or :global ('#{@auid}')" unless [:user, :global].include?(@scope)
+
+      # Create first document.
+      @documents = {}
+      @documents[@document_name] = Document.new(@document_name)
+
+    end
+
+    # Get the XCAPClient::Document with name _document_name_ within this application. If the parameter is not set, the default document is got.
+    #
+    def document(document_name=nil)
+      @documents[document_name || @document_name]
+    end
+
+    # Get an Array containing all the documents created for this application.
+    def documents
+      @documents
+    end
+
+    # Creates a new XCAPClient::Document for this application with name _document_name_.
+    def add_document(document_name)
+      raise DocumentError, "document '#{document_name}' already exists" if @documents[document_name]
+      @documents[document_name] = Document.new(document_name)
+
+      return @documents[document_name]
+    end
+
+  end
+
 end

data/lib/xcapclient/client.rb

@@ -1,700 +1,721 @@
 module XCAPClient
-	
-	
-	# The base class of the library. A program using this library must instantiate it.
-	#
-	# === Common notes for methods <tt>get*</tt>, <tt>put*</tt> and <tt>delete*</tt>
-	# 
-	# ==== Shared parameters
-	#
-	# *_auid_*: String, the auid of the application. Example:"pres-rules".
-	#
-	# *_document_*: nil by default. It can be:
-	#   * String, so the application must contain a document called as it.
-	#   * XCAPClient::Document object.
-	#   * nil, so the application default document is selected.
-	#
-	# *_check_etag_*: true by default. If true the client adds the header "If-None-Match" or "If-Match" to the HTTP request containing the last ETag received.
-	#
-	# *_selector_*: Document/node selector. The path that identifies the XML document or node within the XCAP root URL. It's automatically converted to ASCII and percent encoded if needed. Example:
-	#
-	#   '/cp:ruleset/cp:rule/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]'
-	#
-	# *_xml_namespaces_*: nil by default. It's a hash containing the prefixes and namespaces used in the query. Example:
-	#
-	#   {"pr"=>"urn:ietf:params:xml:ns:pres-rules", "cp"=>"urn:ietf:params:xml:ns:common-policy"}
-	#
-	# ==== Exceptions
-	#
-	# If these methods receive a non HTTP 2XX response they generate an exception. Check ERRORS.rdoc for detailed info.
-	#
-	# ==== Access to the full response
-	#
-	# In any case, the HTTP response is stored in the document _last_response_ attribute as an HTTP::Message[http://dev.ctor.org/doc/httpclient/] object. To get it:
-	#
-	#   @xcapclient.application("pres-rules").document.last_response
-	#
-	class Client
-		
-		
-		USER_AGENT = "Ruby-XCAPClient"
-		COMMON_HEADERS = {
-			"User-Agent" => "#{USER_AGENT}/#{VERSION}",
-			"Connection" => "close"
-		}
-		GLOBAL_XUI = "global"
-		XCAP_CAPS_XMLNS = "urn:ietf:params:xml:ns:xcap-caps"
-		HTTP_TIMEOUT = 6
-		CONF_PARAMETERS = [:xcap_root, :user, :auth_user, :password, :identity_header, :identity_user, :ssl_verify_cert]
-		
-		
-		attr_reader :xcap_root, :user, :auth_user, :password, :identity_header, :identity_user, :ssl_verify_cert
-		
-		
-		# Create a new XCAP client. It requires two parameters:
-		#
-		# * _conf_: A hash containing settings related to the server:
-		#   * _xcap_root_: The URL where the documents hold.
-		#   * _user_: The client username. Depending on the server it could look like "sip:alice@domain.org", "alice@domain.org", "alice", "tel:+12345678"...
-		#   * _auth_user_: Username, SIP URI or TEL URI for HTTP Digest authentication (if required). If not set it takes the value of _user_ field.
-		#   * _identity_header_: Header required in some XCAP networks containing the user identity (i.e. "X-XCAP-Preferred-Identity").
-		#   * _identity_user_: Value for the _identity_header_. It could be a SIP or TEL URI. If not set it takes teh value of _user_ field.
-		#   * _ssl_verify_cert_: If true and the server uses SSL, the certificate is inspected (expiration time, signature...).
-		#
-		# * _applications_: A hash of hashes containing each XCAP application available for the client. Each application is an entry of the hash containing a key whose value is the "auid" of the application and whose value is a hast with the following fields:
-		#   * _xmlns_: The XML namespace uri of the application.
-		#   * _document_name_: The name of the default document for this application ("index" if not set).
-		#   * _scope_: Can be :user or :global (:user if not set).
-		#     * _:user_: Each user has his own document(s) for this application.
-		#     * _:global_: The document(s) is shared for all the users.
-		#
-		# Example:
-		#   xcap_conf = {
-		#     :xcap_root => "https://xcap.domain.org/xcap-root",
-		#     :user => "sip:alice@domain.org",
-		#     :auth_user => "alice",
-		#     :password => "1234",
-		#     :ssl_verify_cert => false
-		#   }
-		#   xcap_apps = {
-		#     "pres-rules" => {
-		#       :xmlns => "urn:ietf:params:xml:ns:pres-rules",
-		#       :mime_type => "application/auth-policy+xml",
-		#       :document_name => "index",
-		#       :scope => :user
-		#     },
-		#     "rls-services" => {
-		#       :xmlns => "urn:ietf:params:xml:ns:rls-services",
-		#       :mime_type => "application/rls-services+xml",
-		#       :document_name => "index",
-		#       :scope => :user
-		#     }
-		#   }
-		#
-		#   @client = Client.new(xcap_conf, xcap_apps)
-		#
-		# Example:
-		#   xcap_conf = {
-		#     :xcap_root => "https://xcap.domain.net",
-		#     :user => "tel:+12345678",
-		#     :auth_user => "tel:+12345678",
-		#     :password => "1234",
-		#     :identity_header => "X-XCAP-Preferred-Identity",
-		#     :ssl_verify_cert => true
-		#   }
-		#
-		# A XCAP application called "xcap-caps" is automatically added to the list of applications of the new client. This application is defined in the {RFC 4825}[http://tools.ietf.org/html/rfc4825].
-		#
-		def initialize(conf={}, applications={})
-			
-			# Check conf hash.
-			raise ConfigError, "`conf' must be a hash" unless (Hash === conf)
-			
-			# Check non existing parameter names.
-			conf.each_key do |key|
-				raise ConfigError, "Uknown parameter name '#{key}' in `conf' hash" unless CONF_PARAMETERS.include?(key)
-			end
-			
-			# Check xcap_root parameter.
-			@xcap_root = ( conf[:xcap_root] =~ /\/$/ ) ? URI.parse(conf[:xcap_root][0..-2]) : URI.parse(conf[:xcap_root])
-			raise ConfigError, "`xcap_root' must be http or https URI" unless [URI::HTTP, URI::HTTPS].include?(@xcap_root.class)
-			
-			# Check user.
-			@user = conf[:user].freeze
-			raise ConfigError, "`user' must be a non empty string" unless (String === @user && ! @user.empty?)
-			
-			@auth_user = conf[:auth_user].freeze || @user
-			@password = conf[:password].freeze
-			
-			@identity_header = conf[:identity_header].freeze
-			@identity_user = ( conf[:identity_user].freeze || @user )  if @identity_header
-			COMMON_HEADERS[@identity_header] = '"' + @identity_user + '"'  if @identity_header
-			
-			# Initialize the HTTP client.
-			@http_client = HTTPClient.new
-			@http_client.set_auth(@xcap_root, @auth_user, @password)
-			@http_client.protocol_retry_count = 3  ### TODO: Set an appropiate value (min 2 for 401).
-			@http_client.connect_timeout = HTTP_TIMEOUT
-			@http_client.send_timeout = HTTP_TIMEOUT
-			@http_client.receive_timeout = HTTP_TIMEOUT
-			
-			@xcap_root.freeze  # Freeze now as it has been modified in @http_client.set_auth.
-			
-			# Check ssl_verify_cert parameter.
-			if URI::HTTPS === @xcap_root
-				@ssl_verify_cert = conf[:ssl_verify_cert] || false
-				raise ConfigError, "`ssl_verify_cert' must be true or false" unless [TrueClass, FalseClass].include?(@ssl_verify_cert.class)
-				@http_client.ssl_config.verify_mode = ( @ssl_verify_cert ? 3 : 0 )
-			end
-			
-			# Generate applications.
-			@applications = {}
-			
-			# Add the "xcap-caps" application.
-			@applications["xcap-caps"] = Application.new("xcap-caps", {
-				:xmlns => "urn:ietf:params:xml:ns:xcap-caps",
-				:mime_type => "application/xcap-caps+xml",
-				:scope => :global,
-				:document_name => "index"
-			})
-			
-			# Add custom applications.
-			applications.each do |auid, data|
-				@applications[auid] = Application.new(auid, data)
-			end
-			
-			@applications.freeze
-			
-		end  # def initialize
-		
-		
-		# Returns the XCAPClient::Application whose auid mathes the _auid_ parameter.
-		#
-		# Example:
-		#
-		#   @xcapclient.application("pres-rules")
-		#
-		def application(auid)
-			@applications[auid]
-		end
-		
-		
-		# Returns an Array with all the applications configured in the client.
-		def applications
-			@applications
-		end
-		
-		
-		# Fetch a document from the server.
-		#
-		# Example:
-		#
-		#   @xcapclient.get("pres-rules")
-		#
-		# If success:
-		# * The method returns true.
-		# * Received XML plain document is stored in <tt>@xcapclient.application("pres-rules").document.plain</tt> (the default document).
-		# * Received ETag is stored in <tt>@xcapclient.application("pres-rules").document.etag</tt>.
-		#
-		def get(auid, document=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:get, application, document, nil, nil, nil, nil, check_etag)
-			
-			# Check Content-Type.
-			check_content_type(response, application.mime_type)
-			
-			# Store the plain document.
-			document.plain = response.body.content
-			
-			# Update ETag.
-			document.etag = response.header["ETag"].first
-			
-			return true
-			
-		end
-		
-		
-		# Create/replace a document in the server.
-		#
-		# Example:
-		#
-		#   @xcapclient.put("pres-rules")
-		#
-		# If success:
-		# * The method returns true.
-		# * Local plain document in <tt>@xcapclient.application("pres-rules").document.plain</tt> is uploaded to the server.
-		# * Received ETag is stored in <tt>@xcapclient.application("pres-rules").document.etag</tt>.
-		#
-		def put(auid, document=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:put, application, document, nil, nil, nil, application.mime_type, check_etag)
-			
-			# Update ETag.
-			document.etag = response.header["ETag"].first
-			
-			return true
-			
-		end
-		
-		
-		# Delete a document in the server.
-		#
-		# Example:
-		#
-		#   @xcapclient.delete("pres-rules")
-		#
-		# If success:
-		# * The method returns true.
-		# * Local plain document and ETag are deleted.
-		#
-		def delete(auid, document=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:delete, application, document, nil, nil, nil, nil, check_etag)
-			
-			# Reset the local document.
-			document.plain = nil
-			document.etag = nil
-			
-			return true
-			
-		end
-		
-		
-		# Fetch a node from the document stored in the server.
-		#
-		# Example, fetching the node with "id" = "sip:alice@example.org":
-		#
-		#   @xcapclient.get_node("pres-rules", nil,
-		#     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
-		#     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
-		#
-		# If success:
-		# * The method returns the node as a String.
-		#
-		def get_node(auid, document, selector, xml_namespaces=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:get, application, document, selector, nil, xml_namespaces, nil, check_etag)
-			
-			# Check Content-Type.
-			check_content_type(response, "application/xcap-el+xml")
-			
-			return response.body.content
-			
-		end
-		
-		# Create/replace a node in the document stored in the server.
-		#
-		# Example, creating/replacing the node with "id" = "sip:alice@example.org":
-		#
-		#   @xcapclient.put_node("pres-rules", nil,
-		#     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:bob@example.org"]',
-		#     '<cp:one id="sip:bob@example.org"/>',
-		#     {"cp"=>"urn:ietf:params:xml:ns:common-policy"})
-		#
-		# If success:
-		# * The method returns true.
-		# * Local plain document and ETag are deleted (as the document has changed).
-		#
-		def put_node(auid, document, selector, selector_body, xml_namespaces=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:put, application, document, selector, selector_body, xml_namespaces, "application/xcap-el+xml", check_etag)
-			
-			# Reset local plain document and ETag as we have modified it.
-			document.plain = nil
-			document.etag = nil
-			
-			return true
-			
-		end
-		
-		
-		# Delete a node in the document stored in the server.
-		#
-		# Example, deleting the node with "id" = "sip:alice@example.org":
-		#
-		#   @xcapclient.delete_node("pres-rules", nil,
-		#     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
-		#     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
-		#
-		# If success:
-		# * The method returns true.
-		# * Local plain document and ETag are deleted (as the document has changed).
-		#
-		def delete_node(auid, document, selector, xml_namespaces=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:delete, application, document, selector, nil, xml_namespaces, nil, check_etag)
-			
-			# Reset local plain document and ETag as we have modified it
-			document.plain = nil
-			document.etag = nil
-			
-			return true
-			
-		end
-		
-		
-		# Fetch a node attribute from the document stored in the server.
-		#
-		# Example, fetching the "name" attribute of the node with
-		# "id" = "sip:alice@example.org":
-		#
-		#   @xcapclient.get_attribute("pres-rules", nil,
-		#     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
-		#     "name",
-		#     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
-		#
-		# If success:
-		# * The method returns the attribute as a String.
-		#
-		def get_attribute(auid, document, selector, attribute_name, xml_namespaces=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:get, application, document, selector + "/@#{attribute_name}", nil, xml_namespaces, nil, check_etag)
-			
-			# Check Content-Type.
-			check_content_type(response, "application/xcap-att+xml")
-			
-			return response.body.content
-			
-		end
-		
-		
-		# Create/replace a node attribute in the document stored in the server.
-		#
-		# Example, creating/replacing the "name" attribute of the node with
-		# "id" = "sip:alice@example.org" with new value "Alice Yeah":
-		#
-		#   @xcapclient.put_attribute("pres-rules", nil,
-		#     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
-		#     "name",
-		#     "Alice Yeah",
-		#     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
-		#
-		# If success:
-		# * The method returns true.
-		# * Local plain document and ETag are deleted (as the document has changed).
-		#
-		def put_attribute(auid, document, selector, attribute_name, attribute_value, xml_namespaces=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:put, application, document, selector + "/@#{attribute_name}", attribute_value, xml_namespaces, "application/xcap-att+xml", check_etag)
-			
-			# Reset local plain document and ETag as we have modified it.
-			document.plain = nil
-			document.etag = nil
-			
-			return true
-			
-		end
-		
-		
-		# Delete a node attribute in the document stored in the server.
-		#
-		# Example, deleting the "name" attribute of the node with
-		# "id" = "sip:alice@example.org":
-		#
-		#   @xcapclient.delete_attribute("pres-rules", nil,
-		#     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
-		#     "name",
-		#     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
-		#
-		# If success:
-		# * The method returns true.
-		# * Local plain document and ETag are deleted (as the document has changed).
-		#
-		def delete_attribute(auid, document, selector, attribute_name, xml_namespaces=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:delete, application, document, selector + "/@#{attribute_name}", nil, xml_namespaces, nil, check_etag)
-			
-			# Reset local plain document and ETag as we have modified it
-			document.plain = nil
-			document.etag = nil
-			
-			return true
-			
-		end
-		
-		
-		# Fetch the namespace prefixes of a node.
-		#
-		# If the client wants to create/replace a node, the body of the PUT
-		# request must use the same namespaces and prefixes as those used in 
-		# the document stored in the server. This methods allows the client
-		# to fetch these namespaces and prefixes.
-		#
-		# Related documentation: {RFC 4825 section 7.10}[http://tools.ietf.org/html/rfc4825#section-7.10],
-		# {RFC 4825 section 10}[http://tools.ietf.org/html/rfc4825#section-10]
-		#
-		# Example:
-		#
-		#   @xcapclient.get_node_namespaces("pres-rules", nil,
-		#     'ccpp:ruleset/ccpp:rule[@id="pres_whitelist"]',
-		#     { "ccpp" => "urn:ietf:params:xml:ns:common-policy" })
-		#
-		# Assuming the server uses "cp" for that namespace, it would reply:
-		#
-		#   HTTP/1.1 200 OK
-		#   Content-Type: application/xcap-ns+xml
-		#
-		#   <cp:identity xmlns:pr="urn:ietf:params:xml:ns:pres-rules"
-		#     xmlns:cp="urn:ietf:params:xml:ns:common-policy" />
-		#
-		# If Nokogiri[http://wiki.github.com/tenderlove/nokogiri] is available the method returns a hash:
-		#   {"pr"=>"urn:ietf:params:xml:ns:pres-rules", "cp"=>"urn:ietf:params:xml:ns:common-policy"}
-		# If not, the method returns the response body as a String and the application must parse it.
-		#
-		def get_node_namespaces(auid, document, selector, xml_namespaces=nil, check_etag=true)
-			
-			application, document = get_app_doc(auid, document)
-			response = send_request(:get, application, document, selector + "/namespace::*", nil, xml_namespaces, nil, check_etag)
-			
-			# Check Content-Type.
-			check_content_type(response, "application/xcap-ns+xml")
-			
-			return case NOKOGIRI_INSTALLED
-				when true
-					Nokogiri::XML.parse(response.body.content).namespaces
-				when false
-					response.body.content
-				end
-			
-		end
-		
-		
-		# Fetch the XCAP applications (auids) supported by the server.
-		#
-		# Related documentation: {RFC 4825 section 12}[http://tools.ietf.org/html/rfc4825#section-12]
-		#
-		# If Nokogiri[http://wiki.github.com/tenderlove/nokogiri] is available the method returns an 
-		# Array containing the auids. If not, the response body is returned as a String.
-		#
-		def get_xcap_auids
-		
-			body = get_node("xcap-caps", nil, 'xcap-caps/auids')
-			
-			return case NOKOGIRI_INSTALLED
-				when true
-					parse(body).xpath("auids/auid", {"xmlns" => XCAP_CAPS_XMLNS}).map {|auid| auid.content}
-				when false
-					body
-				end
-		
-		end
-		
-		
-		# Fetch the XCAP extensions supported by the server.
-		#
-		# Same as XCAPClient::Client::get_xcap_auids but fetching the supported extensions.
-		#
-		def get_xcap_extensions
-		
-			body = get_node("xcap-caps", nil, 'xcap-caps/extensions')
-			
-			return case NOKOGIRI_INSTALLED
-				when true
-					parse(body).xpath("extensions/extension", {"xmlns" => XCAP_CAPS_XMLNS}).map {|extension| extension.content}
-				when false
-					body
-				end
-		
-		end
-		
-		
-		# Fetch the XCAP namespaces supported by the server.
-		#
-		# Same as XCAPClient::Client::get_xcap_auids but fetching the supported namespaces.
-		#
-		def get_xcap_namespaces
-		
-			body = get_node("xcap-caps", nil, 'xcap-caps/namespaces')
-			
-			return case NOKOGIRI_INSTALLED
-				when true
-					parse(body).xpath("namespaces/namespace", {"xmlns" => XCAP_CAPS_XMLNS}).map {|namespace| namespace.content}
-				when false
-					body
-				end
-		
-		end
-		
-		
-		private
-		
-		
-		def get_app_doc(auid, document=nil)
-			
-			# Get the application.
-			application = @applications[auid]
-			raise WrongAUID, "There is no application with auid '#{auid}'" unless application
-			
-			# Get the document.
-			case document
-			when Document
-			when String
-				document_name = document
-				document = application.document(document_name)
-				raise DocumentError, "document '#{document_name}' doesn't exist in application '#{auid}'" unless document
-			when NilClass
-				document = application.document  # Default document.
-			else
-				raise ArgumentError, "`document' must be Document, String or nil"
-			end
-			
-			return [application, document]
-			
-		end
-		
-		
-		# Converts the hash namespaces hash into a HTTP query.
-		#
-		#   get_xmlns_query( { "a"=>"urn:test:default-namespace", "b"=>"urn:test:namespace1-uri" } )
-		#   => "?xmlns(a=urn:test:default-namespace)xmlns(b=urn:test:namespace1-uri)"
-		#
-		def get_xmlns_query(xml_namespaces)
-			
-			return "" if ( ! xml_namespaces || xml_namespaces.empty? )
-			
-			xmlns_query="?"
-			xml_namespaces.each do |prefix, uri|
-				xmlns_query += "xmlns(#{prefix}=#{uri})"
-			end
-			
-			return xmlns_query
-			
-		end
-		
-		
-		def send_request(method, application, document, selector, selector_body, xml_namespaces, content_type, check_etag)
-			
-			# Set extra headers.
-			extra_headers = {}.merge(COMMON_HEADERS)
-			if check_etag && document.etag
-				case method
-				when :get
-					extra_headers["If-None-Match"] = document.etag
-				when :put
-					extra_headers["If-Match"] = document.etag
-				when :delete
-					extra_headers["If-Match"] = document.etag
-				end
-			end
-			extra_headers["Content-Type"] = content_type if content_type
-			
-			# XUI.
-			xui = case application.scope
-			when :user
-				"users/#{user_encode(@user)}"
-			when :global
-				GLOBAL_XUI
-			end
-			
-			# URI.
-			uri = "#{@xcap_root}/#{application.auid}/#{xui}/#{percent_encode(document.name)}"
-			uri += "/~~/#{percent_encode(selector)}" if selector
-			uri +=  get_xmlns_query(xml_namespaces) if xml_namespaces
-			
-			# Body (just in case of PUT).
-			body = ( selector_body || document.plain || nil ) if method == :put
-			raise ArgumentError, "PUT body must be a String" unless String === body if method == :put
-			
-			begin
-				response = @http_client.request(method, uri, nil, body, extra_headers)
-			rescue => e
-				raise ConnectionError, "Error contacting the server <#{e.class}: #{e.message}>"
-			end
-			
-			document.last_response = response
-			
-			# Process the response.
-			case response.status.to_s
-			
-			when /^2[0-9]{2}$/
-				return response
-				
-			when "304"
-				raise HTTPDocumentNotModified
-				
-			when "400"
-				raise HTTPBadRequest
-				
-			when "403"
-				raise HTTPForbidden
-				
-			when "404"
-				raise HTTPDocumentNotFound
-				
-			when /^(401|407)$/
-				raise HTTPAuthenticationError, "Couldn't authenticate for URI '#{uri}' [#{response.status} #{response.reason}]"
-			
-			when "409"
-				raise HTTPConflictError
-			
-			when "412"
-				raise HTTPNoMatchingETag
-			
-			when /^50[03]$/
-				raise HTTPServerError
-			
-			whe "501"
-				raise HTTPNotImplemented
-				
-			else
-				raise HTTPUnknownError, "Unknown Error [#{response.status} #{response.reason}]"
-				
-			end
-			
-		end  # def send_request
-		
-		
-		# http://tools.ietf.org/html/rfc3986#section-3.3
-		# I add "/" and "@" as they must not be escaped.
-		# I remove "&", "?" so they must be escaped now.
-		ESCAPE_CHARS = "[^a-zA-Z0-9\\-._~!$&'()*+,=:;/@]"
-		
-		def percent_encode(str)
-			### NOTE: I've removed "&", "?" so they must be escaped now.
-			return case RUBY_VERSION_CORE
-			when :RUBY_1_9
-				str.dup.force_encoding('ASCII-8BIT').gsub(/#{ESCAPE_CHARS}/) { '%%%02x' % $&.ord }
-			when :RUBY_1_8
-				str.gsub(/#{ESCAPE_CHARS}/n) {|s| sprintf('%%%02x', s[0]) }
-			end
-		end
-		
-		
-		def user_encode(str)
-			return case RUBY_VERSION_CORE
-			when :RUBY_1_9
-				str.gsub(/[?\/]/) { '%%%02x' % $&.ord }
-			when :RUBY_1_8
-				str.gsub(/[?\/]/) {|s| sprintf('%%%02x', s[0]) }
-			end
-		end
-		
-		
-		def check_content_type(response, valid_content_type)
-			content_type = response.header["Content-Type"].first
-			raise HTTPWrongContentType, "Wrong Content-Type ('#{content_type})" unless content_type =~ /^#{Regexp.escape(valid_content_type)};?/i
-		end
-		
-		
-		def parse(str)
-			begin
-				Nokogiri::XML.parse(str, nil, nil, PARSE_OPTIONS)
-			rescue Nokogiri::SyntaxError => e
-				raise XMLParsingError, "Couldn't parse the XML file <#{e.class}: #{e.message}>"
-			end
-		end
-		
-		
-	end  # class Client
-	
-	
+
+
+  # The base class of the library. A program using this library must instantiate it.
+  #
+  # === Common notes for methods <tt>get*</tt>, <tt>put*</tt> and <tt>delete*</tt>
+  #
+  # ==== Shared parameters
+  #
+  # *_auid_*: String, the auid of the application. Example:"pres-rules".
+  #
+  # *_document_*: nil by default. It can be:
+  #   * String, so the application must contain a document called as it.
+  #   * XCAPClient::Document object.
+  #   * nil, so the application default document is selected.
+  #
+  # *_check_etag_*: true by default. If true the client adds the header "If-None-Match" or "If-Match" to the HTTP request containing the last ETag received.
+  #
+  # *_selector_*: Document/node selector. The path that identifies the XML document or node within the XCAP root URL. It's automatically converted to ASCII and percent encoded if needed. Example:
+  #
+  #   '/cp:ruleset/cp:rule/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]'
+  #
+  # *_xml_namespaces_*: nil by default. It's a hash containing the prefixes and namespaces used in the query. Example:
+  #
+  #   {"pr"=>"urn:ietf:params:xml:ns:pres-rules", "cp"=>"urn:ietf:params:xml:ns:common-policy"}
+  #
+  # ==== Exceptions
+  #
+  # If these methods receive a non HTTP 2XX response they generate an exception. Check ERRORS.rdoc for detailed info.
+  #
+  # ==== Access to the full response
+  #
+  # In any case, the HTTP response is stored in the document _last_response_ attribute as an HTTP::Message[http://dev.ctor.org/doc/httpclient/] object. To get it:
+  #
+  #   @xcapclient.application("pres-rules").document.last_response
+  #
+  class Client
+
+
+    USER_AGENT = "Ruby-XCAPClient"
+    COMMON_HEADERS = {
+      "User-Agent" => "#{USER_AGENT}/#{VERSION}",
+      "Connection" => "close"
+    }
+    GLOBAL_XUI = "global"
+    XCAP_CAPS_XMLNS = "urn:ietf:params:xml:ns:xcap-caps"
+    HTTP_TIMEOUT = 6
+    CONF_PARAMETERS = [:xcap_root, :user, :auth_user, :password, :identity_header, :identity_user, :ssl_verify_cert]
+
+
+    attr_reader :xcap_root, :user, :auth_user, :password, :identity_header, :identity_user, :ssl_verify_cert
+
+
+    # Create a new XCAP client. It requires two parameters:
+    #
+    # * _conf_: A hash containing settings related to the server:
+    #   * _xcap_root_: The URL where the documents hold.
+    #   * _user_: The client username. Depending on the server it could look like "sip:alice@domain.org", "alice@domain.org", "alice", "tel:+12345678"...
+    #   * _auth_user_: Username, SIP URI or TEL URI for HTTP Digest authentication (if required). If not set it takes the value of _user_ field.
+    #   * _identity_header_: Header required in some XCAP networks containing the user identity (i.e. "X-XCAP-Preferred-Identity").
+    #   * _identity_user_: Value for the _identity_header_. It could be a SIP or TEL URI. If not set it takes teh value of _user_ field.
+    #   * _ssl_verify_cert_: If true and the server uses SSL, the certificate is inspected (expiration time, signature...).
+    #
+    # * _applications_: A hash of hashes containing each XCAP application available for the client. Each application is an entry of the hash containing a key whose value is the "auid" of the application and whose value is a hast with the following fields:
+    #   * _xmlns_: The XML namespace uri of the application.
+    #   * _document_name_: The name of the default document for this application ("index" if not set).
+    #   * _scope_: Can be :user or :global (:user if not set).
+    #     * _:user_: Each user has his own document(s) for this application.
+    #     * _:global_: The document(s) is shared for all the users.
+    #
+    # Example:
+    #   xcap_conf = {
+    #     :xcap_root => "https://xcap.domain.org/xcap-root",
+    #     :user => "sip:alice@domain.org",
+    #     :auth_user => "alice",
+    #     :password => "1234",
+    #     :ssl_verify_cert => false
+    #   }
+    #   xcap_apps = {
+    #     "pres-rules" => {
+    #       :xmlns => "urn:ietf:params:xml:ns:pres-rules",
+    #       :mime_type => "application/auth-policy+xml",
+    #       :document_name => "index",
+    #       :scope => :user
+    #     },
+    #     "rls-services" => {
+    #       :xmlns => "urn:ietf:params:xml:ns:rls-services",
+    #       :mime_type => "application/rls-services+xml",
+    #       :document_name => "index",
+    #       :scope => :user
+    #     }
+    #   }
+    #
+    #   @client = Client.new(xcap_conf, xcap_apps)
+    #
+    # Example:
+    #   xcap_conf = {
+    #     :xcap_root => "https://xcap.domain.net",
+    #     :user => "tel:+12345678",
+    #     :auth_user => "tel:+12345678",
+    #     :password => "1234",
+    #     :identity_header => "X-XCAP-Preferred-Identity",
+    #     :ssl_verify_cert => true
+    #   }
+    #
+    # A XCAP application called "xcap-caps" is automatically added to the list of applications of the new client. This application is defined in the {RFC 4825}[http://tools.ietf.org/html/rfc4825].
+    #
+    def initialize(conf={}, applications={})
+
+      # Check conf hash.
+      raise ConfigError, "`conf' must be a hash" unless (Hash === conf)
+
+      # Check non existing parameter names.
+      conf.each_key do |key|
+        raise ConfigError, "Uknown parameter name '#{key}' in `conf' hash" unless CONF_PARAMETERS.include?(key)
+      end
+
+      # Check xcap_root parameter.
+      @xcap_root = ( conf[:xcap_root] =~ /\/$/ ) ? URI.parse(conf[:xcap_root][0..-2]) : URI.parse(conf[:xcap_root])
+      raise ConfigError, "`xcap_root' must be http or https URI" unless [URI::HTTP, URI::HTTPS].include?(@xcap_root.class)
+
+      # Check user.
+      @user = conf[:user].freeze
+      raise ConfigError, "`user' must be a non empty string" unless (String === @user && ! @user.empty?)
+
+      @auth_user = conf[:auth_user].freeze || @user
+      @password = conf[:password].freeze
+
+      @identity_header = conf[:identity_header].freeze
+      @identity_user = ( conf[:identity_user].freeze || @user )  if @identity_header
+      COMMON_HEADERS[@identity_header] = '"' + @identity_user + '"'  if @identity_header
+
+      # Initialize the HTTP client.
+      @http_client = HTTPClient.new
+      @http_client.set_auth(@xcap_root, @auth_user, @password)
+      @http_client.protocol_retry_count = 3  ### TODO: Set an appropiate value (min 2 for 401).
+      @http_client.connect_timeout = HTTP_TIMEOUT
+      @http_client.send_timeout = HTTP_TIMEOUT
+      @http_client.receive_timeout = HTTP_TIMEOUT
+
+      @xcap_root.freeze  # Freeze now as it has been modified in @http_client.set_auth.
+
+      # Check ssl_verify_cert parameter.
+      if URI::HTTPS === @xcap_root
+        @ssl_verify_cert = conf[:ssl_verify_cert] || false
+        raise ConfigError, "`ssl_verify_cert' must be true or false" unless [TrueClass, FalseClass].include?(@ssl_verify_cert.class)
+        @http_client.ssl_config.verify_mode = ( @ssl_verify_cert ? 3 : 0 )
+      end
+
+      # Generate applications.
+      @applications = {}
+
+      # Add the "xcap-caps" application.
+      @applications["xcap-caps"] = Application.new("xcap-caps", {
+        :xmlns => "urn:ietf:params:xml:ns:xcap-caps",
+        :mime_type => "application/xcap-caps+xml",
+        :scope => :global,
+        :document_name => "index"
+      })
+
+      # Add custom applications.
+      applications.each do |auid, data|
+        @applications[auid] = Application.new(auid, data)
+      end
+
+      @applications.freeze
+
+    end  # def initialize
+
+
+    # Checks the TCP connection with the XCAP server.
+    #
+    def check_connection
+      begin
+        Timeout.timeout(HTTP_TIMEOUT) do
+          TCPSocket.open @xcap_root.host, @xcap_root.port
+        end
+      rescue Timeout::Error
+        raise Timeout::Error, "cannot connect the XCAP server within #{HTTP_TIMEOUT} seconds"
+      rescue => e
+        raise e.class, "cannot connect the XCAP server (#{e.message})"
+      end
+    end
+
+
+    # Returns the XCAPClient::Application whose auid mathes the _auid_ parameter.
+    #
+    # Example:
+    #
+    #   @xcapclient.application("pres-rules")
+    #
+    def application(auid)
+      @applications[auid]
+    end
+
+
+    # Returns an Array with all the applications configured in the client.
+    def applications
+      @applications
+    end
+
+
+    # Fetch a document from the server.
+    #
+    # Example:
+    #
+    #   @xcapclient.get("pres-rules")
+    #
+    # If success:
+    # * The method returns true.
+    # * Received XML plain document is stored in <tt>@xcapclient.application("pres-rules").document.plain</tt> (the default document).
+    # * Received ETag is stored in <tt>@xcapclient.application("pres-rules").document.etag</tt>.
+    #
+    def get(auid, document=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:get, application, document, nil, nil, nil, nil, check_etag)
+
+      # Check Content-Type.
+      check_content_type(response, application.mime_type)
+
+      # Store the plain document.
+      document.plain = response.body.content
+
+      # Update ETag.
+      document.etag = response.header["ETag"].first
+
+      return true
+
+    end
+
+
+    # Create/replace a document in the server.
+    #
+    # Example:
+    #
+    #   @xcapclient.put("pres-rules")
+    #
+    # If success:
+    # * The method returns true.
+    # * Local plain document in <tt>@xcapclient.application("pres-rules").document.plain</tt> is uploaded to the server.
+    # * Received ETag is stored in <tt>@xcapclient.application("pres-rules").document.etag</tt>.
+    #
+    def put(auid, document=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:put, application, document, nil, nil, nil, application.mime_type, check_etag)
+
+      # Update ETag.
+      document.etag = response.header["ETag"].first
+
+      return true
+
+    end
+
+
+    # Delete a document in the server.
+    #
+    # Example:
+    #
+    #   @xcapclient.delete("pres-rules")
+    #
+    # If success:
+    # * The method returns true.
+    # * Local plain document and ETag are deleted.
+    #
+    def delete(auid, document=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:delete, application, document, nil, nil, nil, nil, check_etag)
+
+      # Reset the local document.
+      document.plain = nil
+      document.etag = nil
+
+      return true
+
+    end
+
+
+    # Fetch a node from the document stored in the server.
+    #
+    # Example, fetching the node with "id" = "sip:alice@example.org":
+    #
+    #   @xcapclient.get_node("pres-rules", nil,
+    #     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
+    #     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
+    #
+    # If success:
+    # * The method returns the node as a String.
+    #
+    def get_node(auid, document, selector, xml_namespaces=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:get, application, document, selector, nil, xml_namespaces, nil, check_etag)
+
+      # Check Content-Type.
+      check_content_type(response, "application/xcap-el+xml")
+
+      return response.body.content
+
+    end
+
+    # Create/replace a node in the document stored in the server.
+    #
+    # Example, creating/replacing the node with "id" = "sip:alice@example.org":
+    #
+    #   @xcapclient.put_node("pres-rules", nil,
+    #     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:bob@example.org"]',
+    #     '<cp:one id="sip:bob@example.org"/>',
+    #     {"cp"=>"urn:ietf:params:xml:ns:common-policy"})
+    #
+    # If success:
+    # * The method returns true.
+    # * Local plain document is deleted (as the document has changed).
+    # * Received ETag is stored in <tt>@xcapclient.application("pres-rules").document.etag</tt>.
+    #
+    def put_node(auid, document, selector, selector_body, xml_namespaces=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:put, application, document, selector, selector_body, xml_namespaces, "application/xcap-el+xml", check_etag)
+
+      # Reset local plain document as we have modified it.
+      document.plain = nil
+
+      # Update ETag.
+      document.etag = response.header["ETag"].first
+
+      return true
+
+    end
+
+
+    # Delete a node in the document stored in the server.
+    #
+    # Example, deleting the node with "id" = "sip:alice@example.org":
+    #
+    #   @xcapclient.delete_node("pres-rules", nil,
+    #     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
+    #     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
+    #
+    # If success:
+    # * The method returns true.
+    # * Local plain document is deleted (as the document has changed).
+    # * Received ETag is stored in <tt>@xcapclient.application("pres-rules").document.etag</tt>.
+    #
+    def delete_node(auid, document, selector, xml_namespaces=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:delete, application, document, selector, nil, xml_namespaces, nil, check_etag)
+
+      # Reset local plain document as we have modified it.
+      document.plain = nil
+
+       # Update ETag.
+      document.etag = response.header["ETag"].first
+
+      return true
+
+    end
+
+
+    # Fetch a node attribute from the document stored in the server.
+    #
+    # Example, fetching the "name" attribute of the node with
+    # "id" = "sip:alice@example.org":
+    #
+    #   @xcapclient.get_attribute("pres-rules", nil,
+    #     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
+    #     "name",
+    #     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
+    #
+    # If success:
+    # * The method returns the attribute as a String.
+    #
+    def get_attribute(auid, document, selector, attribute_name, xml_namespaces=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:get, application, document, selector + "/@#{attribute_name}", nil, xml_namespaces, nil, check_etag)
+
+      # Check Content-Type.
+      check_content_type(response, "application/xcap-att+xml")
+
+      return response.body.content
+
+    end
+
+
+    # Create/replace a node attribute in the document stored in the server.
+    #
+    # Example, creating/replacing the "name" attribute of the node with
+    # "id" = "sip:alice@example.org" with new value "Alice Yeah":
+    #
+    #   @xcapclient.put_attribute("pres-rules", nil,
+    #     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
+    #     "name",
+    #     "Alice Yeah",
+    #     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
+    #
+    # If success:
+    # * The method returns true.
+    # * Local plain document and ETag are deleted (as the document has changed).
+    #
+    def put_attribute(auid, document, selector, attribute_name, attribute_value, xml_namespaces=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:put, application, document, selector + "/@#{attribute_name}", attribute_value, xml_namespaces, "application/xcap-att+xml", check_etag)
+
+      # Reset local plain document and ETag as we have modified it.
+      document.plain = nil
+      document.etag = nil
+
+      return true
+
+    end
+
+
+    # Delete a node attribute in the document stored in the server.
+    #
+    # Example, deleting the "name" attribute of the node with
+    # "id" = "sip:alice@example.org":
+    #
+    #   @xcapclient.delete_attribute("pres-rules", nil,
+    #     'cp:ruleset/cp:rule[@id="pres_whitelist"]/cp:conditions/cp:identity/cp:one[@id="sip:alice@example.org"]',
+    #     "name",
+    #     {"cp" => "urn:ietf:params:xml:ns:common-policy"})
+    #
+    # If success:
+    # * The method returns true.
+    # * Local plain document and ETag are deleted (as the document has changed).
+    #
+    def delete_attribute(auid, document, selector, attribute_name, xml_namespaces=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:delete, application, document, selector + "/@#{attribute_name}", nil, xml_namespaces, nil, check_etag)
+
+      # Reset local plain document and ETag as we have modified it
+      document.plain = nil
+      document.etag = nil
+
+      return true
+
+    end
+
+
+    # Fetch the namespace prefixes of a node.
+    #
+    # If the client wants to create/replace a node, the body of the PUT
+    # request must use the same namespaces and prefixes as those used in
+    # the document stored in the server. This methods allows the client
+    # to fetch these namespaces and prefixes.
+    #
+    # Related documentation: {RFC 4825 section 7.10}[http://tools.ietf.org/html/rfc4825#section-7.10],
+    # {RFC 4825 section 10}[http://tools.ietf.org/html/rfc4825#section-10]
+    #
+    # Example:
+    #
+    #   @xcapclient.get_node_namespaces("pres-rules", nil,
+    #     'ccpp:ruleset/ccpp:rule[@id="pres_whitelist"]',
+    #     { "ccpp" => "urn:ietf:params:xml:ns:common-policy" })
+    #
+    # Assuming the server uses "cp" for that namespace, it would reply:
+    #
+    #   HTTP/1.1 200 OK
+    #   Content-Type: application/xcap-ns+xml
+    #
+    #   <cp:identity xmlns:pr="urn:ietf:params:xml:ns:pres-rules"
+    #     xmlns:cp="urn:ietf:params:xml:ns:common-policy" />
+    #
+    # If Nokogiri[http://wiki.github.com/tenderlove/nokogiri] is available the method returns a hash:
+    #   {"pr"=>"urn:ietf:params:xml:ns:pres-rules", "cp"=>"urn:ietf:params:xml:ns:common-policy"}
+    # If not, the method returns the response body as a String and the application must parse it.
+    #
+    def get_node_namespaces(auid, document, selector, xml_namespaces=nil, check_etag=true)
+
+      application, document = get_app_doc(auid, document)
+      response = send_request(:get, application, document, selector + "/namespace::*", nil, xml_namespaces, nil, check_etag)
+
+      # Check Content-Type.
+      check_content_type(response, "application/xcap-ns+xml")
+
+      return case NOKOGIRI_INSTALLED
+        when true
+          Nokogiri::XML.parse(response.body.content).namespaces
+        when false
+          response.body.content
+        end
+
+    end
+
+
+    # Fetch the XCAP applications (auids) supported by the server.
+    #
+    # Related documentation: {RFC 4825 section 12}[http://tools.ietf.org/html/rfc4825#section-12]
+    #
+    # If Nokogiri[http://wiki.github.com/tenderlove/nokogiri] is available the method returns an
+    # Array containing the auids. If not, the response body is returned as a String.
+    #
+    def get_xcap_auids
+
+      body = get_node("xcap-caps", nil, 'xcap-caps/auids')
+
+      return case NOKOGIRI_INSTALLED
+        when true
+          parse(body).xpath("auids/auid", {"xmlns" => XCAP_CAPS_XMLNS}).map {|auid| auid.content}
+        when false
+          body
+        end
+
+    end
+
+
+    # Fetch the XCAP extensions supported by the server.
+    #
+    # Same as XCAPClient::Client::get_xcap_auids but fetching the supported extensions.
+    #
+    def get_xcap_extensions
+
+      body = get_node("xcap-caps", nil, 'xcap-caps/extensions')
+
+      return case NOKOGIRI_INSTALLED
+        when true
+          parse(body).xpath("extensions/extension", {"xmlns" => XCAP_CAPS_XMLNS}).map {|extension| extension.content}
+        when false
+          body
+        end
+
+    end
+
+
+    # Fetch the XCAP namespaces supported by the server.
+    #
+    # Same as XCAPClient::Client::get_xcap_auids but fetching the supported namespaces.
+    #
+    def get_xcap_namespaces
+
+      body = get_node("xcap-caps", nil, 'xcap-caps/namespaces')
+
+      return case NOKOGIRI_INSTALLED
+        when true
+          parse(body).xpath("namespaces/namespace", {"xmlns" => XCAP_CAPS_XMLNS}).map {|namespace| namespace.content}
+        when false
+          body
+        end
+
+    end
+
+
+    private
+
+
+    def get_app_doc(auid, document=nil)
+
+      # Get the application.
+      application = @applications[auid]
+      raise WrongAUID, "There is no application with auid '#{auid}'" unless application
+
+      # Get the document.
+      case document
+      when Document
+      when String
+        document_name = document
+        document = application.document(document_name)
+        raise DocumentError, "document '#{document_name}' doesn't exist in application '#{auid}'" unless document
+      when NilClass
+        document = application.document  # Default document.
+      else
+        raise ArgumentError, "`document' must be Document, String or nil"
+      end
+
+      return [application, document]
+
+    end
+
+
+    # Converts the hash namespaces hash into a HTTP query.
+    #
+    #   get_xmlns_query( { "a"=>"urn:test:default-namespace", "b"=>"urn:test:namespace1-uri" } )
+    #   => "?xmlns(a=urn:test:default-namespace)xmlns(b=urn:test:namespace1-uri)"
+    #
+    def get_xmlns_query(xml_namespaces)
+
+      return "" if ( ! xml_namespaces || xml_namespaces.empty? )
+
+      xmlns_query="?"
+      xml_namespaces.each do |prefix, uri|
+        xmlns_query += "xmlns(#{prefix}=#{uri})"
+      end
+
+      return xmlns_query
+
+    end
+
+
+    def send_request(method, application, document, selector, selector_body, xml_namespaces, content_type, check_etag)
+
+      # Set extra headers.
+      extra_headers = {}.merge(COMMON_HEADERS)
+      if check_etag && document.etag
+        case method
+        when :get
+          extra_headers["If-None-Match"] = document.etag
+        when :put
+          extra_headers["If-Match"] = document.etag
+        when :delete
+          extra_headers["If-Match"] = document.etag
+        end
+      end
+      extra_headers["Content-Type"] = content_type if content_type
+
+      # XUI.
+      xui = case application.scope
+      when :user
+        "users/#{user_encode(@user)}"
+      when :global
+        GLOBAL_XUI
+      end
+
+      # URI.
+      uri = "#{@xcap_root}/#{application.auid}/#{xui}/#{percent_encode(document.name)}"
+      uri += "/~~/#{percent_encode(selector)}" if selector
+      uri +=  get_xmlns_query(xml_namespaces) if xml_namespaces
+
+      # Body (just in case of PUT).
+      body = ( selector_body || document.plain || nil ) if method == :put
+      raise ArgumentError, "PUT body must be a String" unless String === body if method == :put
+
+      begin
+        response = @http_client.request(method, uri, nil, body, extra_headers)
+      rescue => e
+        raise ConnectionError, "Error contacting the server <#{e.class}: #{e.message}>"
+      end
+
+      document.last_response = response
+
+      # Process the response.
+      case response.status.to_s
+
+      when /^2[0-9]{2}$/
+        return response
+
+      when "304"
+        raise HTTPDocumentNotModified
+
+      when "400"
+        raise HTTPBadRequest
+
+      when "403"
+        raise HTTPForbidden
+
+      when "404"
+        raise HTTPDocumentNotFound
+
+      when /^(401|407)$/
+        raise HTTPAuthenticationError, "Couldn't authenticate for URI '#{uri}' [#{response.status} #{response.reason}]"
+
+      when "409"
+        raise HTTPConflictError
+
+      when "412"
+        raise HTTPNoMatchingETag
+
+      when /^50[03]$/
+        raise HTTPServerError
+
+      when "501"
+        raise HTTPNotImplemented
+
+      else
+        raise HTTPUnknownError, "Unknown Error [#{response.status} #{response.reason}]"
+
+      end
+
+    end  # def send_request
+
+
+    # http://tools.ietf.org/html/rfc3986#section-3.3
+    # My changes:
+    # - Not escaped: "/", "@"
+    # - Escaped:     ";", "?"
+    ESCAPE_CHARS = "[^a-zA-Z0-9\\-._~!$&'()*+,=:/@]"
+
+    if RUBY_VERSION >= "1.9"
+      def percent_encode(str)
+        str.dup.force_encoding('ASCII-8BIT').gsub(/#{ESCAPE_CHARS}/) { '%%%02x' % $&.ord }
+      end
+
+      def user_encode(str)
+        str.gsub(/[?\/]/) { '%%%02x' % $&.ord }
+      end
+
+    else
+      def percent_encode(str)
+        str.gsub(/#{ESCAPE_CHARS}/n) {|s| sprintf('%%%02x', s[0]) }
+      end
+
+      def user_encode(str)
+        str.gsub(/[?\/]/) {|s| sprintf('%%%02x', s[0]) }
+      end
+    end
+
+
+    def check_content_type(response, valid_content_type)
+      content_type = response.header["Content-Type"].first
+      raise HTTPWrongContentType, "Wrong Content-Type ('#{content_type})" unless content_type =~ /^#{Regexp.escape(valid_content_type)};?/i
+    end
+
+
+    def parse(str)
+      begin
+        ::Nokogiri::XML.parse(str, nil, "UTF-8", PARSE_OPTIONS)
+      rescue ::Nokogiri::SyntaxError => e
+        raise XMLParsingError, "Couldn't parse the XML file (#{e.class}: #{e.message})"
+      end
+    end
+
+
+  end  # class Client
+
+
 end