postal 0.1.4

data/lib/postal/mailing.rb

@@ -0,0 +1,171 @@
+module Postal
+  class Mailing < Postal::Base
+    
+    class << self
+      
+    end
+    
+    
+    DEFAULT_ATTRIBUTES = {:additional_headers => nil, 
+                          :attachments => nil, 
+                          :bypass_moderation => nil, 
+                          :campaign => nil, 
+                          :char_set_id => nil, 
+                          :detect_html => nil, 
+                          :dont_attempt_after_date => nil, 
+                          :enable_recovery => nil, 
+                          :from => nil, 
+                          :html_message => nil, 
+                          :html_section_encoding => nil, 
+                          :is_html_section_encoded => nil, 
+                          :is_text_section_encoded => nil,
+                          :list_name => nil,
+                          :recency_number_of_mailings => nil,
+                          :recency_which => nil,
+                          :reply_to => nil,
+                          :resend_after_days => nil,
+                          :sample_size => nil,
+                          :scheduled_mailing_date => nil,
+                          :subject => nil,
+                          :text_message => nil,
+                          :text_section_encoding => nil,
+                          :title => nil,
+                          :to => nil,
+                          :track_opens => nil,
+                          :rewrite_date_when_sent => nil }
+    
+    attr_accessor :additional_headers, 
+                  :attachments, 
+                  :bypass_moderation, 
+                  :campaign, 
+                  :char_set_id, 
+                  :detect_html, 
+                  :dont_attempt_after_date, 
+                  :enable_recovery, 
+                  :from, 
+                  :html_message, 
+                  :html_section_encoding, 
+                  :is_html_section_encoded, 
+                  :is_text_section_encoded,
+                  :list_name,
+                  :recency_number_of_mailings,
+                  :recency_which,
+                  :reply_to,
+                  :resend_after_days,
+                  :sample_size,
+                  :scheduled_mailing_date,
+                  :subject,
+                  :text_message,
+                  :text_section_encoding,
+                  :title,
+                  :to,
+                  :track_opens,
+                  :rewrite_date_when_sent
+    
+    # Create a new mailing ready to send
+    def initialize(args={})
+      args = DEFAULT_ATTRIBUTES.merge(args)
+      @to = args[:to] 
+      @additional_headers = args[:additional_headers] 
+      @attachments = args[:attachments] 
+      @bypass_moderation = args[:bypass_moderation] 
+      @campaign = args[:campaign] 
+      @char_set_id = args[:char_set_id] 
+      @detect_html = args[:detect_html] 
+      @dont_attempt_after_date = args[:dont_attempt_after_date] 
+      @enable_recovery = args[:enable_recovery] 
+      @from = args[:from] 
+      @html_message = args[:html_message] 
+      @html_section_encoding = args[:html_section_encoding] 
+      @is_html_section_encoded = args[:is_html_section_encoded] 
+      @is_text_section_encoded = args[:is_text_section_encoded]
+      @list_name = args[:list_name] || Postal.options[:list_name]
+      @recency_number_of_mailings = args[:recency_number_of_mailings]
+      @recency_which = args[:recency_which]
+      @reply_to = args[:reply_to]
+      @resend_after_days = args[:resend_after_days]
+      @sample_size = args[:sample_size]
+      @scheduled_mailing_date = args[:scheduled_mailing_date]
+      @subject = args[:subject]
+      @text_message = args[:text_message]
+      @text_section_encoding = args[:text_section_encoding]
+      @title = args[:title]
+      @to = args[:to]
+      @track_opens = args[:track_opens]
+      @rewrite_date_when_sent = args[:rewrite_date_when_sent]
+    end
+    
+    
+    # Send the mailing
+    def send
+      if valid?
+        mail = Postal::Lmapi::MailingStruct.new(:additionalHeaders => @additional_headers, 
+                                                :attachments => @attachments, 
+                                                :bypassModeration => @bypass_moderation, 
+                                                :campaign => @campaign, 
+                                                :charSetID => @char_set_id, 
+                                                :detectHtml => @detect_html, 
+                                                :dontAttemptAfterDate => @dont_attempt_after_date, 
+                                                :enableRecovery => @enable_recovery, 
+                                                :from => @from, 
+                                                :htmlMessage => @html_message, 
+                                                :htmlSectionEncoding => @html_section_encoding, 
+                                                :isHtmlSectionEncoded => @is_html_section_encoded, 
+                                                :isTextSectionEncoded => @is_text_section_encoded,
+                                                :listName => @list_name,
+                                                :recencyNumberOfMailings => @recency_number_of_mailings,
+                                                :recencyWhich => @recency_which,
+                                                :replyTo => @reply_to,
+                                                :resendAfterDays => @resend_after_days,
+                                                :sampleSize => @sample_size,
+                                                :scheduledMailingDate => @scheduled_mailing_date,
+                                                :subject => @subject,
+                                                :textMessage => @text_message,
+                                                :textSectionEncoding => @text_section_encoding,
+                                                :title => @title,
+                                                :trackOpens => @track_opens,
+                                                :rewriteDateWhenSent => @rewrite_date_when_sent )
+        
+        # are we sending to a list of email addresses or member ids
+        case @to.to_a.first
+        when ::String
+          emails = @to.to_a
+          member_ids = []
+        when ::Fixnum
+          emails = []
+          member_ids = @to.to_a
+        end
+
+        return Postal.driver.sendMailingDirect(emails,member_ids,mail)
+      else
+        return false
+      end
+    end
+    
+    
+    # same as send() but throws an error instead of just returning false
+    def send!
+      if id = send
+        return id
+      else
+        raise Postal::CouldNotSendMailing, 'Your mail was invalid and could not be sent.'
+      end
+    end
+    
+    alias_method :save, :send
+    alias_method :save!, :send!
+    
+    
+    # Determines whether the email is valid to send
+    def valid?
+      return validate
+    end
+    
+    
+    # Determines whether we have everything we need to send an email
+    def validate
+      return (@list_name && @to && @subject) ? true : false
+    end
+    
+  end
+end

data/lib/postal/member.rb

@@ -0,0 +1,141 @@
+module Postal
+  class Member < Postal::Base
+    
+    class << self
+      
+      def find_by_filter(*args)
+        unless args.find { |arg| arg.match(/ListName/) }
+          args << "ListName=#{Postal.options[:list_name]}"
+        end
+        if soap_members = Postal.driver.selectMembers(args)
+          members = soap_members.collect do |member|
+            demographics = {}
+            member.demographics.each { |demo| demographics.merge!({ demo.name.to_sym => demo.value }) }
+            Member.new(:email => member.emailAddress, :name => member.fullName, :id => member.memberID, :list_name => member.listName, :demographics => demographics)
+          end
+          if members.size == 1
+            return members.first
+          else
+            return members
+          end
+        else
+          return nil
+        end
+      end
+      
+      
+      # Will NOT let you delete the entire list's members (only pass a ListName) Returns the number of members that were deleted, or nil if none were
+      def destroy(*args)
+        unless args.find { |arg| arg.match(/ListName/) }
+          args << "ListName=#{Postal.options[:list_name]}"
+        end
+        # raise Postal::WouldDeleteAllMembers, 'Not passing any parameters (other than ListName) to this method will delete ALL members of a list. If you really want to delete all members of this list, use destroy! instead.' if args.to_a.size == 1 && args.to_a.first.match(/ListName/)
+        return Postal.driver.deleteMembers(args)
+      end
+      
+      
+      # WILL let you delete an entire list's members (only pass a ListName). Returns the number of members that were deleted, or nil if none were
+      # def destroy!(*args)
+      #   return Postal.driver.deleteMembers(args)
+      # end
+      
+      
+      protected
+      
+        def find_by_email(args,options)
+          if args.size == 1
+            list_name = Postal.options[:list_name]
+          else
+            list_name = args.last
+          end
+          email = args.first
+          member_id = 0
+
+          begin
+            return Postal.driver.getMemberID(Postal::Lmapi::SimpleMemberStruct.new(list_name,member_id,email))
+          rescue SOAP::FaultError
+            return nil
+          end
+        end
+      
+      
+        def find_by_id(args,options)
+          member_id = args.first
+          return Postal.driver.getEmailFromMemberID(member_id)
+        end
+        
+      
+        # Find one or more members by name
+        def find_some(args,options={})
+          case args.first
+          when ::String
+            find_by_email(args,options)
+          when ::Fixnum
+            find_by_id(args,options)
+          when nil
+            find_by_struct(options)
+          end
+        end
+      
+    end
+    
+    DEFAULT_ATTRIBUTES = { :id => nil, :email => nil, :name => nil, :list_name => nil, :demographics => {} }
+    
+    attr_accessor :id, :email, :name, :list_name, :demographics
+    
+    
+    # Create a new member instance
+    def initialize(attributes={})
+      attributes = DEFAULT_ATTRIBUTES.merge(attributes)
+      @id = attributes[:id]
+      @email = attributes[:email]
+      @name = attributes[:name]
+      @list_name = attributes[:list_name] || Postal.options[:list_name]
+      @demographics = attributes[:demographics]
+    end
+    
+    
+    # Save the member to Lyris and returns the member ID that was created. Returns `false` if the save fails.
+    def save
+      # if @list is a list Object then get the name out (all Lyris wants is the name)
+      list_name = @list_name
+      begin
+        @id = Postal.driver.createSingleMember(@email, @name, list_name)
+        update_attributes(@demographics) unless @demographics.empty?
+        return @id
+      rescue SOAP::FaultError
+        return false
+      end
+    end
+    
+    
+    # Saves the member to Lyris and returns the member ID that was created. Throws an error if the save fails.
+    def save!
+      if id = save
+        return id
+      else
+        raise Postal::CouldNotCreateMember, 'Could not create a new member. The most likely cause is that the specified list already contains this email address.'
+      end
+    end
+    
+    
+    # Update the demographics for a user
+    def update_attributes(attributes={})
+      list_name = @list_name
+      demos = attributes.collect { |key,value| Postal::Lmapi::KeyValueType.new(value,key.to_s) }
+      member = Postal::Lmapi::SimpleMemberStruct.new(list_name, @id, @email)
+      return Postal.driver.updateMemberDemographics(member,demos)
+    end
+    
+    
+    # Throw an error if demographics couldn't be saved
+    def update_attributes!(attributes={})
+      if update_attributes(attributes)
+        return true
+      else
+        raise Postal::CouldNotUpdateMember, 'Could not update the member. The most likely cause is that your demographics are invalid.'
+      end
+    end
+    
+  end
+end

data/postal.gemspec

@@ -0,0 +1,66 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{postal}
+  s.version = "0.1.4"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Rob Cameron"]
+  s.date = %q{2009-08-31}
+  s.description = %q{Lyris is an enterprise email service. Postal makes it easy for Ruby to talk to Lyris's API.}
+  s.email = %q{cannikinn@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/postal.rb",
+     "lib/postal/base.rb",
+     "lib/postal/list.rb",
+     "lib/postal/lmapi/lmapi.rb",
+     "lib/postal/lmapi/lmapi_driver.rb",
+     "lib/postal/lmapi/lmapi_mapping_registry.rb",
+     "lib/postal/mailing.rb",
+     "lib/postal/member.rb",
+     "postal.gemspec",
+     "test/list_test.rb",
+     "test/lmapiClient.rb",
+     "test/lyris_sample.yml",
+     "test/mailing_test.rb",
+     "test/member_test.rb",
+     "test/postal_suite.rb",
+     "test/test_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/cannikin/postal}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Gem for talking to the Lyris API}
+  s.test_files = [
+    "test/list_test.rb",
+     "test/lmapiClient.rb",
+     "test/mailing_test.rb",
+     "test/member_test.rb",
+     "test/postal_suite.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<soap4r>, [">= 1.5.8"])
+    else
+      s.add_dependency(%q<soap4r>, [">= 1.5.8"])
+    end
+  else
+    s.add_dependency(%q<soap4r>, [">= 1.5.8"])
+  end
+end

data/test/list_test.rb

@@ -0,0 +1,20 @@
+require 'test_helper'
+
+class ListTest < Test::Unit::TestCase
+  
+  @config = nil
+
+  def setup
+    load_config
+  end
+  
+  # lists
+  def test_can_find_list_that_exists
+    assert Postal::List.find(@config['list_name'])
+  end
+  
+  def test_returns_nil_if_list_not_found
+    assert_nil Postal::List.find('foo')
+  end
+  
+end

data/test/lmapiClient.rb

@@ -0,0 +1,854 @@
+#!/usr/bin/env ruby
+
+# Sample client generated by wsdl2ruby
+
+# require 'lmapiDriver.rb'
+
+endpoint_url = ARGV.shift
+obj = LmapiSoap.new(endpoint_url)
+
+# run ruby with -d to see SOAP wiredumps.
+obj.wiredump_dev = STDERR if $DEBUG
+
+# SYNOPSIS
+#   ApiVersion
+#
+# ARGS
+#   N/A
+#
+# RETURNS
+#   v_return        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+
+puts obj.apiVersion
+
+# SYNOPSIS
+#   CurrentUserEmailAddress
+#
+# ARGS
+#   N/A
+#
+# RETURNS
+#   v_return        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+
+puts obj.currentUserEmailAddress
+
+# SYNOPSIS
+#   DeleteMembers(filterCriteriaArray)
+#
+# ARGS
+#   filterCriteriaArray ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+filterCriteriaArray = nil
+puts obj.deleteMembers(filterCriteriaArray)
+
+# SYNOPSIS
+#   GetMemberID(simpleMemberStructIn)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+simpleMemberStructIn = nil
+puts obj.getMemberID(simpleMemberStructIn)
+
+# SYNOPSIS
+#   CreateSingleMember(emailAddress, fullName, listName)
+#
+# ARGS
+#   emailAddress    C_String - {http://www.w3.org/2001/XMLSchema}string
+#   fullName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#   listName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+emailAddress = fullName = listName = nil
+puts obj.createSingleMember(emailAddress, fullName, listName)
+
+# SYNOPSIS
+#   CreateManyMembers(arrayOfTinyMemberStructIn, listName, skipBadRecords)
+#
+# ARGS
+#   arrayOfTinyMemberStructIn ArrayOfTinyMemberStruct - {http://www.lyris.com/lmapi}ArrayOfTinyMemberStruct
+#   listName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#   skipBadRecords  Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+arrayOfTinyMemberStructIn = listName = skipBadRecords = nil
+puts obj.createManyMembers(arrayOfTinyMemberStructIn, listName, skipBadRecords)
+
+# SYNOPSIS
+#   SqlSelect(sqlStatement)
+#
+# ARGS
+#   sqlStatement    C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        ArrayOfArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfArrayOfstring
+#
+sqlStatement = nil
+puts obj.sqlSelect(sqlStatement)
+
+# SYNOPSIS
+#   SqlInsert(sqlStatement, dataArray, returnID)
+#
+# ARGS
+#   sqlStatement    C_String - {http://www.w3.org/2001/XMLSchema}string
+#   dataArray       ArrayOfKeyValueType - {http://www.lyris.com/lmapi}ArrayOfKeyValueType
+#   returnID        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+sqlStatement = dataArray = returnID = nil
+puts obj.sqlInsert(sqlStatement, dataArray, returnID)
+
+# SYNOPSIS
+#   SqlUpdate(sqlStatement, dataArray, sqlWhere)
+#
+# ARGS
+#   sqlStatement    C_String - {http://www.w3.org/2001/XMLSchema}string
+#   dataArray       ArrayOfKeyValueType - {http://www.lyris.com/lmapi}ArrayOfKeyValueType
+#   sqlWhere        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+sqlStatement = dataArray = sqlWhere = nil
+puts obj.sqlUpdate(sqlStatement, dataArray, sqlWhere)
+
+# SYNOPSIS
+#   SqlDelete(tableName, sqlWhere)
+#
+# ARGS
+#   tableName       C_String - {http://www.w3.org/2001/XMLSchema}string
+#   sqlWhere        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+tableName = sqlWhere = nil
+puts obj.sqlDelete(tableName, sqlWhere)
+
+# SYNOPSIS
+#   UpdateMemberPassword(simpleMemberStructIn, password)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#   password        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+simpleMemberStructIn = password = nil
+puts obj.updateMemberPassword(simpleMemberStructIn, password)
+
+# SYNOPSIS
+#   CheckMemberPassword(simpleMemberStructIn, password)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#   password        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+simpleMemberStructIn = password = nil
+puts obj.checkMemberPassword(simpleMemberStructIn, password)
+
+# SYNOPSIS
+#   CopyMember(simpleMemberStructIn, emailAddress, fullName, listName)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#   emailAddress    C_String - {http://www.w3.org/2001/XMLSchema}string
+#   fullName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#   listName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+simpleMemberStructIn = emailAddress = fullName = listName = nil
+puts obj.copyMember(simpleMemberStructIn, emailAddress, fullName, listName)
+
+# SYNOPSIS
+#   CreateList(listTypeEnumIn, listName, shortDescription, adminName, adminEmail, adminPassword, topic)
+#
+# ARGS
+#   listTypeEnumIn  ListTypeEnum - {http://tempuri.org/ns1.xsd}ListTypeEnum
+#   listName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#   shortDescription C_String - {http://www.w3.org/2001/XMLSchema}string
+#   adminName       C_String - {http://www.w3.org/2001/XMLSchema}string
+#   adminEmail      C_String - {http://www.w3.org/2001/XMLSchema}string
+#   adminPassword   C_String - {http://www.w3.org/2001/XMLSchema}string
+#   topic           C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+listTypeEnumIn = listName = shortDescription = adminName = adminEmail = adminPassword = topic = nil
+puts obj.createList(listTypeEnumIn, listName, shortDescription, adminName, adminEmail, adminPassword, topic)
+
+# SYNOPSIS
+#   DeleteList(listName)
+#
+# ARGS
+#   listName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+listName = nil
+puts obj.deleteList(listName)
+
+# SYNOPSIS
+#   EmailOnWhatLists(emailAddress)
+#
+# ARGS
+#   emailAddress    C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#
+emailAddress = nil
+puts obj.emailOnWhatLists(emailAddress)
+
+# SYNOPSIS
+#   EmailPasswordOnWhatLists(emailAddress, password)
+#
+# ARGS
+#   emailAddress    C_String - {http://www.w3.org/2001/XMLSchema}string
+#   password        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#
+emailAddress = password = nil
+puts obj.emailPasswordOnWhatLists(emailAddress, password)
+
+# SYNOPSIS
+#   CreateListAdmin(adminEmail, adminPassword, adminListName, adminFullName, receiveListAdminMail, receiveModerationNotification, bypassListModeration)
+#
+# ARGS
+#   adminEmail      C_String - {http://www.w3.org/2001/XMLSchema}string
+#   adminPassword   C_String - {http://www.w3.org/2001/XMLSchema}string
+#   adminListName   C_String - {http://www.w3.org/2001/XMLSchema}string
+#   adminFullName   C_String - {http://www.w3.org/2001/XMLSchema}string
+#   receiveListAdminMail Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#   receiveModerationNotification Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#   bypassListModeration Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+adminEmail = adminPassword = adminListName = adminFullName = receiveListAdminMail = receiveModerationNotification = bypassListModeration = nil
+puts obj.createListAdmin(adminEmail, adminPassword, adminListName, adminFullName, receiveListAdminMail, receiveModerationNotification, bypassListModeration)
+
+# SYNOPSIS
+#   CreateMemberBan(memberBanStructIn)
+#
+# ARGS
+#   memberBanStructIn MemberBanStruct - {http://tempuri.org/ns1.xsd}MemberBanStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+memberBanStructIn = nil
+puts obj.createMemberBan(memberBanStructIn)
+
+# SYNOPSIS
+#   GetEmailFromMemberID(memberID)
+#
+# ARGS
+#   memberID        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+# RETURNS
+#   v_return        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+memberID = nil
+puts obj.getEmailFromMemberID(memberID)
+
+# SYNOPSIS
+#   GetListID(listName)
+#
+# ARGS
+#   listName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+listName = nil
+puts obj.getListID(listName)
+
+# SYNOPSIS
+#   GetListnameFromMemberID(memberID)
+#
+# ARGS
+#   memberID        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+# RETURNS
+#   v_return        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+memberID = nil
+puts obj.getListnameFromMemberID(memberID)
+
+# SYNOPSIS
+#   ImportContent(contentID)
+#
+# ARGS
+#   contentID       Int - {http://www.w3.org/2001/XMLSchema}int
+#
+# RETURNS
+#   v_return        SimpleMailingStruct - {http://tempuri.org/ns1.xsd}SimpleMailingStruct
+#
+contentID = nil
+puts obj.importContent(contentID)
+
+# SYNOPSIS
+#   SelectMembers(filterCriteriaArray)
+#
+# ARGS
+#   filterCriteriaArray ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#
+# RETURNS
+#   v_return        ArrayOfMemberStruct - {http://www.lyris.com/lmapi}ArrayOfMemberStruct
+#
+filterCriteriaArray = nil
+puts obj.selectMembers(filterCriteriaArray)
+
+# SYNOPSIS
+#   SelectSimpleMembers(filterCriteriaArray)
+#
+# ARGS
+#   filterCriteriaArray ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#
+# RETURNS
+#   v_return        ArrayOfSimpleMemberStruct - {http://www.lyris.com/lmapi}ArrayOfSimpleMemberStruct
+#
+filterCriteriaArray = nil
+puts obj.selectSimpleMembers(filterCriteriaArray)
+
+# SYNOPSIS
+#   SendMailing(segmentID, mailingStructIn)
+#
+# ARGS
+#   segmentID       Int - {http://www.w3.org/2001/XMLSchema}int
+#   mailingStructIn MailingStruct - {http://tempuri.org/ns1.xsd}MailingStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+segmentID = mailingStructIn = nil
+puts obj.sendMailing(segmentID, mailingStructIn)
+
+# SYNOPSIS
+#   MailingStatus(mailingID)
+#
+# ARGS
+#   mailingID       Int - {http://www.w3.org/2001/XMLSchema}int
+#
+# RETURNS
+#   v_return        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+mailingID = nil
+puts obj.mailingStatus(mailingID)
+
+# SYNOPSIS
+#   ScheduleMailing(segmentID, sendDate, mailingStructIn)
+#
+# ARGS
+#   segmentID       Int - {http://www.w3.org/2001/XMLSchema}int
+#   sendDate        DateTime - {http://www.w3.org/2001/XMLSchema}dateTime
+#   mailingStructIn MailingStruct - {http://tempuri.org/ns1.xsd}MailingStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+segmentID = sendDate = mailingStructIn = nil
+puts obj.scheduleMailing(segmentID, sendDate, mailingStructIn)
+
+# SYNOPSIS
+#   ModerateMailing(moderateID, accept, sendRejectMessage)
+#
+# ARGS
+#   moderateID      Int - {http://www.w3.org/2001/XMLSchema}int
+#   accept          Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#   sendRejectMessage Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+moderateID = accept = sendRejectMessage = nil
+puts obj.moderateMailing(moderateID, accept, sendRejectMessage)
+
+# SYNOPSIS
+#   SelectContent(filterCriteriaArray)
+#
+# ARGS
+#   filterCriteriaArray ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#
+# RETURNS
+#   v_return        ArrayOfContentStruct - {http://www.lyris.com/lmapi}ArrayOfContentStruct
+#
+filterCriteriaArray = nil
+puts obj.selectContent(filterCriteriaArray)
+
+# SYNOPSIS
+#   SelectLists(listName, siteName)
+#
+# ARGS
+#   listName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#   siteName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        ArrayOfListStruct - {http://www.lyris.com/lmapi}ArrayOfListStruct
+#
+listName = siteName = nil
+puts obj.selectLists(listName, siteName)
+
+# SYNOPSIS
+#   SelectSegments(filterCriteriaArray)
+#
+# ARGS
+#   filterCriteriaArray ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#
+# RETURNS
+#   v_return        ArrayOfSegmentStruct - {http://www.lyris.com/lmapi}ArrayOfSegmentStruct
+#
+filterCriteriaArray = nil
+puts obj.selectSegments(filterCriteriaArray)
+
+# SYNOPSIS
+#   SendMailingDirect(emailAddressArray, memberIDArray, mailingStructIn)
+#
+# ARGS
+#   emailAddressArray ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#   memberIDArray   ArrayOfint - {http://www.lyris.com/lmapi}ArrayOfint
+#   mailingStructIn MailingStruct - {http://tempuri.org/ns1.xsd}MailingStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+emailAddressArray = memberIDArray = mailingStructIn = nil
+puts obj.sendMailingDirect(emailAddressArray, memberIDArray, mailingStructIn)
+
+# SYNOPSIS
+#   SendMemberDoc(simpleMemberStructIn, docTypeIn)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#   docTypeIn       MessageTypeEnum - {http://tempuri.org/ns1.xsd}MessageTypeEnum
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+simpleMemberStructIn = docTypeIn = nil
+puts obj.sendMemberDoc(simpleMemberStructIn, docTypeIn)
+
+# SYNOPSIS
+#   TrackingSummary(outMailID)
+#
+# ARGS
+#   outMailID       Int - {http://www.w3.org/2001/XMLSchema}int
+#
+# RETURNS
+#   v_return        TrackingSummaryStruct - {http://tempuri.org/ns1.xsd}TrackingSummaryStruct
+#
+outMailID = nil
+puts obj.trackingSummary(outMailID)
+
+# SYNOPSIS
+#   Unsubscribe(simpleMemberStructArrayIn)
+#
+# ARGS
+#   simpleMemberStructArrayIn ArrayOfSimpleMemberStruct - {http://www.lyris.com/lmapi}ArrayOfSimpleMemberStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+simpleMemberStructArrayIn = nil
+puts obj.unsubscribe(simpleMemberStructArrayIn)
+
+# SYNOPSIS
+#   UpdateMemberEmail(simpleMemberStructIn, emailAddress)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#   emailAddress    C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+simpleMemberStructIn = emailAddress = nil
+puts obj.updateMemberEmail(simpleMemberStructIn, emailAddress)
+
+# SYNOPSIS
+#   UpdateMemberKind(simpleMemberStructIn, memberKind)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#   memberKind      MemberKindEnum - {http://tempuri.org/ns1.xsd}MemberKindEnum
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+simpleMemberStructIn = memberKind = nil
+puts obj.updateMemberKind(simpleMemberStructIn, memberKind)
+
+# SYNOPSIS
+#   UpdateMemberStatus(simpleMemberStructIn, memberStatus)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#   memberStatus    MemberStatusEnum - {http://tempuri.org/ns1.xsd}MemberStatusEnum
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+simpleMemberStructIn = memberStatus = nil
+puts obj.updateMemberStatus(simpleMemberStructIn, memberStatus)
+
+# SYNOPSIS
+#   UpdateList(listStructIn)
+#
+# ARGS
+#   listStructIn    ListStruct - {http://tempuri.org/ns1.xsd}ListStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+listStructIn = nil
+puts obj.updateList(listStructIn)
+
+# SYNOPSIS
+#   UpdateListAdmin(simpleMemberStructIn, isListAdmin, receiveListAdminMail, receiveModerationNotification, bypassListModeration)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#   isListAdmin     Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#   receiveListAdminMail Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#   receiveModerationNotification Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#   bypassListModeration Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+simpleMemberStructIn = isListAdmin = receiveListAdminMail = receiveModerationNotification = bypassListModeration = nil
+puts obj.updateListAdmin(simpleMemberStructIn, isListAdmin, receiveListAdminMail, receiveModerationNotification, bypassListModeration)
+
+# SYNOPSIS
+#   UpdateMemberDemographics(simpleMemberStructIn, demographicsArray)
+#
+# ARGS
+#   simpleMemberStructIn SimpleMemberStruct - {http://tempuri.org/ns1.xsd}SimpleMemberStruct
+#   demographicsArray ArrayOfKeyValueType - {http://www.lyris.com/lmapi}ArrayOfKeyValueType
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+simpleMemberStructIn = demographicsArray = nil
+puts obj.updateMemberDemographics(simpleMemberStructIn, demographicsArray)
+
+# SYNOPSIS
+#   CreateMemberColumn(fieldName, fieldType)
+#
+# ARGS
+#   fieldName       C_String - {http://www.w3.org/2001/XMLSchema}string
+#   fieldType       FieldTypeEnum - {http://tempuri.org/ns1.xsd}FieldTypeEnum
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+fieldName = fieldType = nil
+puts obj.createMemberColumn(fieldName, fieldType)
+
+# SYNOPSIS
+#   DeleteMemberColumn(fieldName)
+#
+# ARGS
+#   fieldName       C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+fieldName = nil
+puts obj.deleteMemberColumn(fieldName)
+
+# SYNOPSIS
+#   CreateSegment(segmentStructIn)
+#
+# ARGS
+#   segmentStructIn SegmentStruct - {http://tempuri.org/ns1.xsd}SegmentStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+segmentStructIn = nil
+puts obj.createSegment(segmentStructIn)
+
+# SYNOPSIS
+#   UpdateSegment(segmentStructIn)
+#
+# ARGS
+#   segmentStructIn SegmentStruct - {http://tempuri.org/ns1.xsd}SegmentStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+segmentStructIn = nil
+puts obj.updateSegment(segmentStructIn)
+
+# SYNOPSIS
+#   DeleteSegment(segmentID)
+#
+# ARGS
+#   segmentID       Int - {http://www.w3.org/2001/XMLSchema}int
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+segmentID = nil
+puts obj.deleteSegment(segmentID)
+
+# SYNOPSIS
+#   SendMessage(messageStructIn)
+#
+# ARGS
+#   messageStructIn MessageStruct - {http://tempuri.org/ns1.xsd}MessageStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+messageStructIn = nil
+puts obj.sendMessage(messageStructIn)
+
+# SYNOPSIS
+#   CreateSite(siteStructIn)
+#
+# ARGS
+#   siteStructIn    SiteStruct - {http://tempuri.org/ns1.xsd}SiteStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+siteStructIn = nil
+puts obj.createSite(siteStructIn)
+
+# SYNOPSIS
+#   UpdateSite(siteStructIn)
+#
+# ARGS
+#   siteStructIn    SiteStruct - {http://tempuri.org/ns1.xsd}SiteStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+siteStructIn = nil
+puts obj.updateSite(siteStructIn)
+
+# SYNOPSIS
+#   DeleteSite(siteID)
+#
+# ARGS
+#   siteID          Int - {http://www.w3.org/2001/XMLSchema}int
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+siteID = nil
+puts obj.deleteSite(siteID)
+
+# SYNOPSIS
+#   CreateTopic(topicStructIn)
+#
+# ARGS
+#   topicStructIn   TopicStruct - {http://tempuri.org/ns1.xsd}TopicStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+topicStructIn = nil
+puts obj.createTopic(topicStructIn)
+
+# SYNOPSIS
+#   UpdateTopic(topicStructIn)
+#
+# ARGS
+#   topicStructIn   TopicStruct - {http://tempuri.org/ns1.xsd}TopicStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+topicStructIn = nil
+puts obj.updateTopic(topicStructIn)
+
+# SYNOPSIS
+#   DeleteTopic(topicTitle)
+#
+# ARGS
+#   topicTitle      C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+topicTitle = nil
+puts obj.deleteTopic(topicTitle)
+
+# SYNOPSIS
+#   GetPreviewMailing(previewStructIn)
+#
+# ARGS
+#   previewStructIn PreviewStruct - {http://tempuri.org/ns1.xsd}PreviewStruct
+#
+# RETURNS
+#   v_return        C_String - {http://www.w3.org/2001/XMLSchema}string
+#
+previewStructIn = nil
+puts obj.getPreviewMailing(previewStructIn)
+
+# SYNOPSIS
+#   CreateServerAdmin(serverAdminStructIn)
+#
+# ARGS
+#   serverAdminStructIn ServerAdminStruct - {http://tempuri.org/ns1.xsd}ServerAdminStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+serverAdminStructIn = nil
+puts obj.createServerAdmin(serverAdminStructIn)
+
+# SYNOPSIS
+#   UpdateServerAdmin(serverAdminStructIn)
+#
+# ARGS
+#   serverAdminStructIn ServerAdminStruct - {http://tempuri.org/ns1.xsd}ServerAdminStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+serverAdminStructIn = nil
+puts obj.updateServerAdmin(serverAdminStructIn)
+
+# SYNOPSIS
+#   DeleteServerAdmin(serverAdminStructIn)
+#
+# ARGS
+#   serverAdminStructIn ServerAdminStruct - {http://tempuri.org/ns1.xsd}ServerAdminStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+serverAdminStructIn = nil
+puts obj.deleteServerAdmin(serverAdminStructIn)
+
+# SYNOPSIS
+#   CreateSiteAdmin(siteAdminStructIn)
+#
+# ARGS
+#   siteAdminStructIn SiteAdminStruct - {http://tempuri.org/ns1.xsd}SiteAdminStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+siteAdminStructIn = nil
+puts obj.createSiteAdmin(siteAdminStructIn)
+
+# SYNOPSIS
+#   UpdateSiteAdmin(siteAdminStructIn)
+#
+# ARGS
+#   siteAdminStructIn SiteAdminStruct - {http://tempuri.org/ns1.xsd}SiteAdminStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+siteAdminStructIn = nil
+puts obj.updateSiteAdmin(siteAdminStructIn)
+
+# SYNOPSIS
+#   DeleteSiteAdmin(siteAdminStructIn)
+#
+# ARGS
+#   siteAdminStructIn SiteAdminStruct - {http://tempuri.org/ns1.xsd}SiteAdminStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+siteAdminStructIn = nil
+puts obj.deleteSiteAdmin(siteAdminStructIn)
+
+# SYNOPSIS
+#   CreateContent(contentStructIn)
+#
+# ARGS
+#   contentStructIn ContentStruct - {http://tempuri.org/ns1.xsd}ContentStruct
+#
+# RETURNS
+#   v_return        Int - {http://www.w3.org/2001/XMLSchema}int
+#
+contentStructIn = nil
+puts obj.createContent(contentStructIn)
+
+# SYNOPSIS
+#   UpdateContent(contentStructIn)
+#
+# ARGS
+#   contentStructIn ContentStruct - {http://tempuri.org/ns1.xsd}ContentStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+contentStructIn = nil
+puts obj.updateContent(contentStructIn)
+
+# SYNOPSIS
+#   DeleteContent(contentStructIn)
+#
+# ARGS
+#   contentStructIn ContentStruct - {http://tempuri.org/ns1.xsd}ContentStruct
+#
+# RETURNS
+#   v_return        Boolean - {http://www.w3.org/2001/XMLSchema}boolean
+#
+contentStructIn = nil
+puts obj.deleteContent(contentStructIn)
+
+# SYNOPSIS
+#   SelectListsEx(listName, siteName, fieldsToFetch, whereClause)
+#
+# ARGS
+#   listName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#   siteName        C_String - {http://www.w3.org/2001/XMLSchema}string
+#   fieldsToFetch   ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#   whereClause     ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#
+# RETURNS
+#   v_return        ArrayOfArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfArrayOfstring
+#
+listName = siteName = fieldsToFetch = whereClause = nil
+puts obj.selectListsEx(listName, siteName, fieldsToFetch, whereClause)
+
+# SYNOPSIS
+#   SelectMembersEx(fieldsToFetch, filterCriteriaArray)
+#
+# ARGS
+#   fieldsToFetch   ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#   filterCriteriaArray ArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfstring
+#
+# RETURNS
+#   v_return        ArrayOfArrayOfstring - {http://www.lyris.com/lmapi}ArrayOfArrayOfstring
+#
+fieldsToFetch = filterCriteriaArray = nil
+puts obj.selectMembersEx(fieldsToFetch, filterCriteriaArray)
+
+