ecircle 0.0.7 → 0.0.8

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ecircle (0.0.7)
+    ecircle (0.0.8)
       activesupport
       i18n
       rake

data/README.md

@@ -1,3 +1,6 @@
+Travis Build Status
+-------------
+
 [![Build Status](https://secure.travis-ci.org/troessner/ecircle.png)](http://travis-ci.org/troessner/ecircle)
 
 Synopsis
@@ -5,30 +8,40 @@ Synopsis
 
 This gem aims to be a full-fledged solution for the ecircle API, the [synchronous one](http://webservices.ecircle-ag.com/soap/javadoc/com/ecircleag/webservices/EcMApi.html) and the [asynchronous one](http://developer.ecircle-ag.com/apiwiki/wiki/AsynchronousAPI).
 
-The API coverage is far from complete.
+The API coverage is far from complete, however as far as I can see the most useful / frequent methods are covered.
 
-However, the existing API coverage can be considered stable and is used in production.
+The existing API methods can be considered stable and are used in production.
 
 Features
 -------------
 
-So far just a couple of methods:
+###Synchronous API
+
+The following methods are implemented:
+
+* createMember
+* createOrUpdateUserByEmail
+* deleteGroup
+* deleteMember
+* logon (only for debugging purposes)
+* logout
+* sendParametrizedSingleMessageToUser
+
+See the [online API documentation](http://rubydoc.info/github/troessner/ecircle/master/frames) for details on arguments and return values
 
-* create_member
-* create_or_update_user_by_email
-* delete_member
-* send_parametrized_single_message_to_user
+###Asnchronous API
 
-See the rdoc for details on arguments and return values: [TODO Add link]
+Since the asynchronous API is neither documented by ecircle nor intuitive at all, you're on your own. Jump to the examples section and good luck.
 
 To do
 -------------
 
-* Rethink current structure
-* Implement missing API methods
-* Specs
-* RDoc
-* Remove JobPackage from gem since this is highly specific
+* Implement missing API methods:
+ * createOrUpdateGroup
+ * deleteUser
+ * deleteUserByEmail
+ * lookupGroups
+* Write specs
 
 Configuration
 -------------
@@ -53,6 +66,8 @@ Session tokens will be re-used to keep the number of session related traffic to
 Examples
 -------------
 
+### Synchronous API
+
 ```Ruby
 # Given you have called Ecircle.configure appropriatly...
 
@@ -73,4 +88,39 @@ Ecircle.send_parametrized_single_message_to_user uid,
                                                 [ :name, :message ],
                                                 [ 'Tom', 'welcome!' ]
 
-```
+# 5.) Delete the group
+Ecircle.delete_group your_group_id
+
+# 6.) Log out
+Ecircle.logout
+
+```
+### Asynchronous API
+
+```Ruby
+Ecircle.configure do |config|
+  config.user        = 'your@user.com'
+  config.async_realm = 'http://your.async.realm.com' # IMPORTANT - different realm.
+  config.password    = 'your_password'
+end
+
+@options = {
+  :endpoint                     => 'http://your.domain/eC-MessageService',
+  :request_id                   => '1234',
+  :group_id                     => '5678',
+  :send_out_date                => 70.minutes.from_now, # Must be at least one hour in the future!
+  :send_date_for_report         => 140.minutes.from_now,  # Must be at least one hour in the future *after* dispatching!
+  :report_email                 => 'your@report.de',
+  :report_email_name            => 'Your name',
+  :subject                      => 'Newsletter',
+  :text                         => 'Newsletter text content',
+  :html                         => 'Newsletter html content'
+}
+
+Ecircle::JobPackage.send_async_message_to_group @options
+```
+
+Documentation
+-------------
+
+* [Online API Documentation](http://rubydoc.info/github/troessner/ecircle/master/frames)

data/lib/ecircle.rb

@@ -10,7 +10,7 @@ require 'savon'
 
 dir = File.dirname(__FILE__)
 
-%w!version configuration client helper job_package!.each do |file|
+%w!api version configuration helper job_package wrapped_response!.each do |file|
   require File.join(dir, 'ecircle', file)
 end
 
@@ -23,8 +23,8 @@ module Ecircle
     end
 
     #@private
-    def client
-      @client ||= Client.new
+    def api
+      @api ||= Api.new
     end
 
     #@private
@@ -33,9 +33,9 @@ module Ecircle
     end
   end
 
-  (Ecircle::Client.instance_methods(false) - [:client]).each do |meth|
+  (Ecircle::Api.instance_methods(false) - [:client]).each do |meth|
     define_singleton_method meth do |*args|
-      client.send meth, *args
+      api.send meth, *args
     end
   end
 end

data/lib/ecircle/api.rb

@@ -0,0 +1,209 @@
+module Ecircle
+  class Api
+    #@private
+    attr_accessor :auth_token
+    @@help = <<-doc
+    !!!
+    Got an authentication exception, chances are good that you're credentials are wrong, so better double check that.
+    You can explicitly check for it by calling something like:
+    Ecircle.configure do..
+    Ecircle.logon
+    !!!
+    doc
+
+
+    #@private
+    def ensuring_logon &block
+      begin
+        @auth_token ||= logon
+      rescue Savon::SOAP::Fault => e
+        # If we are here this probably means that our login credentials are wrong.
+        wrapped_response = WrappedResponse.new(e)
+        if wrapped_response.permission_problem?
+          puts @@help
+          raise
+        end
+      end
+
+      first_try = true
+      begin
+        block.call
+      rescue Savon::SOAP::Fault => e
+        # If we are here that probably means that our session token has expired.
+        wrapped_response = WrappedResponse.new(e)
+        if wrapped_response.permission_problem?
+          if first_try
+            first_try = false
+            @auth_token = logon
+            retry
+          else
+            puts "!!! Could not re-authenticate after session expired: #{wrapped_response.inspect} !!!"
+            raise
+          end
+        else
+          raise  # Re-raise cause something else went wrong.
+        end
+      end
+    end
+
+    # @private
+    def client
+      @client ||= Savon::Client.new do
+        wsdl.document =  Ecircle.configuration.wsdl
+        wsdl.endpoint =  Ecircle.configuration.endpoint
+        wsdl.namespace = Ecircle.configuration.namespace
+      end
+    end
+
+    # Creates a member, which basically is just an association between a user and a group.
+    #
+    # @param [Integer] user_id ecircle user_id
+    # @param [Integer] group_id ecircle group_id
+    # @param [Boolean] invite send an invite by ecircle
+    # @param [Boolean] send_message send a message by ecircle
+    # @return [WrappedResponse]
+    def create_member user_id, group_id, invite = false, send_message = false
+      ensuring_logon do
+        begin
+          @response = client.request :createMember do
+            soap.body = {
+              :session     => auth_token,
+              :userId      => user_id,
+              :groupId     => group_id,
+              :invite      => invite.to_s,
+              :sendMessage => send_message.to_s
+            }
+          end
+        rescue Savon::SOAP::Fault => e
+          wrapped_response = WrappedResponse.new(e)
+          if wrapped_response.no_such_user? || wrapped_response.no_such_group_when_a_user_was_given
+            return wrapped_response
+          else
+            raise # Re-raise cause something else went wrong.
+          end
+        end
+        WrappedResponse.new(:success => true, :ecircle_id => @response.body[:create_member_response][:create_member_return].to_s)
+      end
+    end
+
+    # Create or update user by email
+    # see http://developer.ecircle-ag.com/apiwiki/wiki/SynchronousSoapAPI#section-SynchronousSoapAPI-UserObjectExample
+    # for an example of the user xml
+    # @param [Hash] user_xml, in it's most simple form a { :email => 'test@test.com' } is sufficient
+    # @return [Integer] the user id
+    # TODO Error handling is missing.
+    def create_or_update_user_by_email user_attributes
+      ensuring_logon do
+        @response = client.request :createOrUpdateUserByEmail do
+          soap.body = {
+            :session     => auth_token, # TODO We can't use @auth_token here cause then the session_id is nil. Why?
+            :userXml     => Helper.build_user_xml(user_attributes),
+            :sendMessage => 0
+          }
+        end
+        @response.body[:create_or_update_user_by_email_response][:create_or_update_user_by_email_return].to_i
+      end
+    end
+
+    # Delete a member.
+    #
+    # @param [Integer] group_id ecircle group id
+    # @return [WrappedResponse]
+    def delete_group group_id
+      ensuring_logon do
+        begin
+          @response = client.request :deleteGroup do
+            soap.body = {
+              :session  => auth_token,
+              :memberId => group_id
+            }
+          end
+        rescue Savon::SOAP::Fault => e
+          wrapped_response = WrappedResponse.new(e)
+          if wrapped_response.group_does_not_exist?
+            return wrapped_response
+          else
+            raise # Re-raise cause something else went wrong.
+          end
+        end
+      end
+      WrappedResponse.new(:success => true)
+    end
+
+    # Delete a member.
+    #
+    # @param [Integer] member_id ecircle member id
+    # @return [WrappedResponse]
+    def delete_member member_id
+      ensuring_logon do
+        begin
+          @response = client.request :deleteMember do
+            soap.body = {
+              :session  => auth_token,
+              :memberId => member_id
+            }
+          end
+        rescue Savon::SOAP::Fault => e
+          wrapped_response = WrappedResponse.new(e)
+          if wrapped_response.member_does_not_exist?
+            return wrapped_response
+          else
+            raise # Re-raise cause something else went wrong.
+          end
+        end
+      end
+      WrappedResponse.new(:success => true)
+    end
+
+    # Logon. You don't need to call this explicitly but it's useful for debugging.
+    #
+    # @return [String] the session id
+    def logon
+      @response = client.request :logon do
+        soap.body = {
+          :user   => Ecircle.configuration.user,
+          :realm  => Ecircle.configuration.sync_realm,
+          :passwd => Ecircle.configuration.password
+        }
+      end
+      @response.body[:logon_response][:logon_return].to_s
+    end
+
+    # Log out. Uses the last session token.
+    #
+    # @return nil
+    def logout
+      client.request :logout do
+        soap.body = {
+          :session  => auth_token,
+        }
+      end
+    end
+
+    # Send a parametrized single message to user - you need an existing ecircle template ID for this.
+    #
+    # @param [Integer] user_id ecircle user_id
+    # @param [Integer] message_id the ecircle template ID
+    # @param [Array] the names of the variables you want to interpolate in the template
+    # @param [Array] the values of the variables you want to interpolate in the template
+    # @return [WrappedResponse]
+    def send_parametrized_single_message_to_user user_id, message_id, names = [], values = []
+      ensuring_logon do
+        begin
+          @response = client.request :sendParametrizedSingleMessageToUser do
+            soap.body = {
+              :session           => auth_token,
+              :singleMessageId   => message_id,
+              :userId            => user_id,
+              :names             => names,
+              :values            => values
+            }
+          end
+        rescue Savon::SOAP::Fault => e
+          return WrappedResponse.new(e)
+        end
+      end
+      WrappedResponse.new(:success => true)
+    end
+  end
+end

data/lib/ecircle/helper.rb

@@ -8,5 +8,12 @@ module Ecircle
       matcher = /(.*)(00)/.match(tz) # We need to do that because ecircle won't accept +0200, just +02:00.
       "#{date.strftime('%Y-%m-%dT%H:%M:%S')}#{matcher[1]}:#{matcher[2]}"
     end
+
+    def build_user_xml attributes
+      '<user>' + attributes.each_with_object('') do |slice, xml|
+        name, value = slice.first, slice.last;
+        xml << "<#{name}>#{value}</#{name}>"
+      end+'</user>'
+    end
   end
 end

data/lib/ecircle/job_package.rb

@@ -9,7 +9,7 @@ module Ecircle
         wsdl.namespace = "http://webservices.ecircleag.com/ws"
       end
 
-      response = client.request :postGroupRequest,  'xmlns' => 'http://webservices.ecircle-ag.com/ws' do
+      client.request :postGroupRequest,  'xmlns' => 'http://webservices.ecircle-ag.com/ws' do
         soap.header =  { :authenticate => { :realm    => Ecircle.configuration.async_realm,
                                             :email    => Ecircle.configuration.user,
                                             :password => Ecircle.configuration.password },
@@ -33,14 +33,14 @@ module Ecircle
           xml.tag! 'send-report-address' do
             xml.tag! 'email-address' do
               xml.email options[:report_email]
-              xml.name "Send report for newsletter for location #{options[:location_name]} sent out on #{options[:send_out_date]}"
+              xml.name options[:report_email_name]
             end
           end
           xml.tag! 'status-report', 'report-id' => 'new', 'delete' => 'false', 'user-tracking-details' => 'false',  'link-tracking-details' => 'false', 'bouncing-details' => 'false' do
             xml.tag! 'report-address' do
               xml.tag! 'email-address' do
                 xml.email options[:report_email]
-                xml.name "Status report for newsletter for location #{options[:location_name]} sent out on #{options[:send_out_date]}"
+                xml.name options[:report_email_name]
               end
             end
             xml.tag! 'send-date' do
@@ -56,13 +56,13 @@ module Ecircle
         xml.tag! 'success-report-address' do
           xml.tag! 'email-address' do
             xml.email options[:report_email]
-            xml.name "Success report for newsletter for location #{options[:location_name]} sent out on #{options[:send_out_date]}"
+            xml.name options[:report_email_name]
           end
         end
         xml.tag! 'failure-report-address' do
           xml.tag! 'email-address' do
             xml.email options[:report_email]
-            xml.name "Failure report for newsletter for location #{options[:location_name]} sent out on #{options[:send_out_date]}"
+            xml.name options[:report_email_name]
           end
         end
       end

data/lib/ecircle/version.rb

@@ -1,3 +1,3 @@
 module Ecircle
-  VERSION = "0.0.7"
+  VERSION = '0.0.8'
 end

data/lib/ecircle/wrapped_response.rb

@@ -0,0 +1,50 @@
+module Ecircle
+  class WrappedResponse
+    #@private
+    attr_accessor :success, :error_message, :fault_code, :ecircle_id
+
+    # We create a wrapped response in 2 cases:
+    #   1.) We get a Savon::SOAP::Fault exception, so something went wrong. In this we get passed an exception.
+    #   2.) We get back a "regular" response. In this we get passed an hash.
+    def initialize options_or_exception
+      if options_or_exception.kind_of? Exception
+        attributes = options_or_exception.to_hash
+        @success       = false
+        @error_message = attributes[:fault][:detail][:fault][:error_message]
+        @fault_code    = attributes[:fault][:detail][:fault][:code].to_i
+      elsif options_or_exception.kind_of? Hash
+        @success       = options_or_exception[:success]
+        @error_message = options_or_exception[:error_message]
+        @fault_code    = options_or_exception[:fault_code] ? options_or_exception[:fault_code].to_i : nil
+        @ecircle_id    = options_or_exception[:ecircle_id]
+      else
+        raise ArgumentError, "!!! Was either expecting a hash or an exception but got: #{options_or_exception.class} !!!"
+      end
+    end
+
+    def member_does_not_exist?
+      @fault_code == 100
+    end
+
+    def group_does_not_exist?
+      @fault_code == 500
+    end
+
+    def no_such_user?
+      @fault_code == 500
+    end
+
+    def permission_problem?
+      @fault_code == 502 && @error_message = 'Permission Problem'
+    end
+
+    def no_such_group_when_a_user_was_given?
+      # YES, this IS horrible. Thanks ecircle. "Group does not exist" error codes vary depending on context.
+      @fault_code == 502 && @error_message = 'Permission Problem'
+    end
+
+    def success?
+      @success
+    end
+  end
+end

metadata

@@ -1,100 +1,105 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: ecircle
-version: !ruby/object:Gem::Version
-  version: 0.0.7
+version: !ruby/object:Gem::Version 
   prerelease: 
+  version: 0.0.8
 platform: ruby
-authors:
-- Timo Rößner
+authors: 
+- "Timo R\xC3\xB6\xC3\x9Fner"
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-02 00:00:00.000000000Z
-dependencies:
-- !ruby/object:Gem::Dependency
+
+date: 2011-11-09 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
   name: activesupport
-  requirement: &69598750 !ruby/object:Gem::Requirement
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
   type: :runtime
   prerelease: false
-  version_requirements: *69598750
-- !ruby/object:Gem::Dependency
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
   name: i18n
-  requirement: &69598090 !ruby/object:Gem::Requirement
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
   type: :runtime
   prerelease: false
-  version_requirements: *69598090
-- !ruby/object:Gem::Dependency
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
   name: rake
-  requirement: &69597470 !ruby/object:Gem::Requirement
+  requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
   type: :runtime
   prerelease: false
-  version_requirements: *69597470
-- !ruby/object:Gem::Dependency
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
   name: savon
-  requirement: &69596650 !ruby/object:Gem::Requirement
+  requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
         version: 0.9.7
   type: :runtime
   prerelease: false
-  version_requirements: *69596650
-- !ruby/object:Gem::Dependency
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
   name: rspec
-  requirement: &69595940 !ruby/object:Gem::Requirement
+  requirement: &id005 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - =
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
         version: 2.6.0
   type: :development
   prerelease: false
-  version_requirements: *69595940
-- !ruby/object:Gem::Dependency
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
   name: yard
-  requirement: &69595540 !ruby/object:Gem::Requirement
+  requirement: &id006 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
   type: :development
   prerelease: false
-  version_requirements: *69595540
-- !ruby/object:Gem::Dependency
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
   name: ruby-debug19
-  requirement: &69594720 !ruby/object:Gem::Requirement
+  requirement: &id007 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
   type: :development
   prerelease: false
-  version_requirements: *69594720
+  version_requirements: *id007
 description: The ecircle gem aims to be a full-fledged client for all ecircle services.
-email:
+email: 
 - timo.roessner@googlemail.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - .gitignore
 - .rvmrc
 - .travis.yml
@@ -104,42 +109,47 @@ files:
 - Rakefile
 - ecircle.gemspec
 - lib/ecircle.rb
-- lib/ecircle/client.rb
+- lib/ecircle/api.rb
 - lib/ecircle/configuration.rb
 - lib/ecircle/helper.rb
 - lib/ecircle/job_package.rb
 - lib/ecircle/version.rb
+- lib/ecircle/wrapped_response.rb
 - spec/client_spec.rb
 - spec/spec_helper.rb
-homepage: ''
+has_rdoc: true
+homepage: ""
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-      segments:
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: -743074899
+      segments: 
       - 0
-      hash: -98517107
-required_rubygems_version: !ruby/object:Gem::Requirement
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-      segments:
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: -743074899
+      segments: 
       - 0
-      hash: -98517107
+      version: "0"
 requirements: []
+
 rubyforge_project: ecircle
-rubygems_version: 1.8.10
+rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: Ecircle gem
 test_files: []
-has_rdoc: 
+

data/lib/ecircle/client.rb

@@ -1,164 +0,0 @@
-module Ecircle
-  class Client
-    #@private
-    attr_accessor :auth_token
-
-    #@private
-    def ensuring_logon &block
-      begin
-        @auth_token ||= logon
-      rescue Savon::SOAP::Fault => e
-        # If we are here this probably means that our login credentials are wrong.
-        response = e.to_hash
-        if response[:fault][:detail][:fault][:code] == '502'
-          help = <<-doc
-          !!!
-          Got an authentication exception, chances are good that you're credentials are wrong, so better double check that.
-          You can explicitly check for it by calling something like:
-          Ecircle.configure do..
-          Ecircle.logon
-          !!!
-          doc
-          puts help
-        else
-          puts "!!! Got an unexpected fault code from Savon: #{response.inspect} !!!"
-        end
-        raise
-      rescue => e
-        puts  "!!! Got unexpected non-Savon exception: #{e.class} !!!"
-        raise
-      end
-
-      first_try = true
-      begin
-        block.call
-      rescue Savon::SOAP::Fault => e
-        # If we are here that probably means that our session token has expired.
-        if first_try
-          first_try = false
-          @auth_token = logon
-          retry
-        else
-          puts "!!! Could not re-authenticate after session expired: #{e.to_hash.inspect} !!!"
-          raise
-        end
-      end
-    end
-
-    # @private
-    def client
-      @client ||= Savon::Client.new do
-        wsdl.document =  Ecircle.configuration.wsdl
-        wsdl.endpoint =  Ecircle.configuration.endpoint
-        wsdl.namespace = Ecircle.configuration.namespace
-      end
-    end
-
-    # Creates a member, which basically is just an association between a user and a group.
-    #
-    # @param [Integer] user_id ecircle user_id
-    # @param [Integer] group_id ecircle group_id
-    # @param [Boolean] invite send an invite by ecircle
-    # @param [Boolean] send_message send a message by ecircle
-    # @return [String] the member id
-    def create_member user_id, group_id, invite = false, send_message = false
-      ensuring_logon do
-        @response = client.request :createMember do
-          soap.body = {
-            :session     => auth_token,
-            :userId      => user_id,
-            :groupId     => group_id,
-            :invite      => invite.to_s,
-            :sendMessage => send_message.to_s
-          }
-        end
-        @response.body[:create_member_response][:create_member_return].to_s
-      end
-    end
-
-    # Create or update user by email
-    # see http://developer.ecircle-ag.com/apiwiki/wiki/SynchronousSoapAPI#section-SynchronousSoapAPI-UserObjectExample
-    # for an example of the user xml
-    # @param [Hash] user_xml, in it's most simple form a { :email => 'test@test.com' } is sufficient
-    # @return [Integer] the user id
-    def create_or_update_user_by_email attributes
-      user_xml = '<user>' + attributes.each_with_object('') do |slice, xml|
-        name, value = slice.first, slice.last;
-        xml << "<#{name}>#{value}</#{name}>"
-      end+'</user>'
-
-      ensuring_logon do
-        @response = client.request :createOrUpdateUserByEmail do
-          soap.body = {
-            :session     => auth_token, # TODO We can't use @auth_token here cause then the session_id is nil. Why?
-            :userXml     => user_xml,
-            :sendMessage => 0
-          }
-        end
-        @response.body[:create_or_update_user_by_email_response][:create_or_update_user_by_email_return].to_i
-      end
-    end
-
-    # Delete a member.
-    #
-    # @param [Integer] member_id ecircle member id
-    # @return [Boolean]
-    def delete_member member_id
-      ensuring_logon do
-        # In case we pass in a non existing member id we'll get a corresponding exception, so we need to catch this here as well.
-        begin
-          @response = client.request :deleteMember do
-            soap.body = {
-              :session  => auth_token,
-              :memberId => member_id
-            }
-          end
-        rescue Savon::SOAP::Fault => e
-          if e.to_hash[:fault][:detail][:fault][:code] == '100'
-            # "100" means member ID didn't exist so just return false.
-            return false
-          else
-            # Re-raise cause something else went wrong.
-            raise
-          end
-        end
-      end
-      true
-    end
-
-    # Logon. You don't need to call this explicitly but it's useful for debugging.
-    #
-    # @return [String] the session id
-    def logon
-      @response = client.request :logon do
-        soap.body = {
-          :user   => Ecircle.configuration.user,
-          :realm  => Ecircle.configuration.sync_realm,
-          :passwd => Ecircle.configuration.password
-        }
-      end
-      @response.body[:logon_response][:logon_return].to_s
-    end
-
-    # Send a parametrized single message to user - you need an existing ecircle template ID for this.
-    #
-    # @param [Integer] user_id ecircle user_id
-    # @param [Integer] message_id the ecircle template ID
-    # @param [Array] the names of the variables you want to interpolate in the template
-    # @param [Array] the values of the variables you want to interpolate in the template
-    # @return nil
-    def send_parametrized_single_message_to_user user_id, message_id, names = [], values = []
-      ensuring_logon do
-        @response = client.request :sendParametrizedSingleMessageToUser do
-          soap.body = {
-            :session           => auth_token,
-            :singleMessageId   => message_id,
-            :userId            => user_id,
-            :names             => names,
-            :values            => values
-          }
-        end
-      end
-    end
-  end
-end