postini 0.0.1

data/lib/postini/api/endpointresolver/EndpointResolverDriver.rb

@@ -0,0 +1,51 @@
+require File.dirname(__FILE__) + '/EndpointResolver.rb'
+require File.dirname(__FILE__) + '/EndpointResolverMappingRegistry.rb'
+require 'soap/rpc/driver'
+
+module Postini::API::EndpointResolver #:nodoc: all
+
+class EndpointResolverPort < ::SOAP::RPC::Driver
+  DefaultEndpointUrl = "https://api-meta.postini.com/api2/endpointresolver"
+
+  Methods = [
+    [ "",
+      "getServiceEndpoint",
+      [ ["in", "parameters", ["::SOAP::SOAPElement", "http://postini.com/PSTN/SOAPAPI/v2/endpointresolver", "GetServiceEndpoint"]],
+        ["out", "parameters", ["::SOAP::SOAPElement", "http://postini.com/PSTN/SOAPAPI/v2/endpointresolver", "GetServiceEndpointResponse"]] ],
+      { :request_style =>  :document, :request_use =>  :literal,
+        :response_style => :document, :response_use => :literal,
+        :faults => {"Postini::API::EndpointResolver::UnknownInternalException"=>{:use=>"literal", :namespace=>nil, :name=>"UnknownInternalException", :encodingstyle=>"document", :ns=>"http://postini.com/PSTN/SOAPAPI/v2/endpointresolver"}, "Postini::API::EndpointResolver::AdminBlockException"=>{:use=>"literal", :namespace=>nil, :name=>"AdminBlockException", :encodingstyle=>"document", :ns=>"http://postini.com/PSTN/SOAPAPI/v2/endpointresolver"}, "Postini::API::EndpointResolver::MissingElementException"=>{:use=>"literal", :namespace=>nil, :name=>"MissingElementException", :encodingstyle=>"document", :ns=>"http://postini.com/PSTN/SOAPAPI/v2/endpointresolver"}, "Postini::API::EndpointResolver::InvalidValueException"=>{:use=>"literal", :namespace=>nil, :name=>"InvalidValueException", :encodingstyle=>"document", :ns=>"http://postini.com/PSTN/SOAPAPI/v2/endpointresolver"}, "Postini::API::EndpointResolver::UnknownEmailException"=>{:use=>"literal", :namespace=>nil, :name=>"UnknownEmailException", :encodingstyle=>"document", :ns=>"http://postini.com/PSTN/SOAPAPI/v2/endpointresolver"}, "Postini::API::EndpointResolver::MalformedKeyException"=>{:use=>"literal", :namespace=>nil, :name=>"MalformedKeyException", :encodingstyle=>"document", :ns=>"http://postini.com/PSTN/SOAPAPI/v2/endpointresolver"}, "Postini::API::EndpointResolver::InternalException"=>{:use=>"literal", :namespace=>nil, :name=>"InternalException", :encodingstyle=>"document", :ns=>"http://postini.com/PSTN/SOAPAPI/v2/endpointresolver"}, "Postini::API::EndpointResolver::NoSuchKeyException"=>{:use=>"literal", :namespace=>nil, :name=>"NoSuchKeyException", :encodingstyle=>"document", :ns=>"http://postini.com/PSTN/SOAPAPI/v2/endpointresolver"}} }
+    ]
+  ]
+
+  def initialize(endpoint_url = nil)
+    endpoint_url ||= DefaultEndpointUrl
+    super(endpoint_url, nil)
+    self.mapping_registry = EndpointResolverMappingRegistry::EncodedRegistry
+    self.literal_mapping_registry = EndpointResolverMappingRegistry::LiteralRegistry
+    init_methods
+  end
+
+private
+
+  def init_methods
+    Methods.each do |definitions|
+      opt = definitions.last
+      if opt[:request_style] == :document
+        add_document_operation(*definitions)
+      else
+        add_rpc_operation(*definitions)
+        qname = definitions[0]
+        name = definitions[2]
+        if qname.name != name and qname.name.capitalize == name.capitalize
+          ::SOAP::Mapping.define_singleton_method(self, qname.name) do |*arg|
+            __send__(name, *arg)
+          end
+        end
+      end
+    end
+  end
+end
+
+
+end

data/lib/postini/api/endpointresolver/EndpointResolverMappingRegistry.rb

@@ -0,0 +1,268 @@
+require File.dirname(__FILE__) + '/EndpointResolver.rb'
+require 'soap/mapping'
+
+module Postini; module API; module EndpointResolver
+
+module EndpointResolverMappingRegistry
+  EncodedRegistry = ::SOAP::Mapping::EncodedRegistry.new
+  LiteralRegistry = ::SOAP::Mapping::LiteralRegistry.new
+  NsEndpointresolver = "http://postini.com/PSTN/SOAPAPI/v2/endpointresolver"
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::AdminBlockException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "AdminBlockException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::GetServiceEndpoint,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "GetServiceEndpoint"),
+    :schema_element => [
+      ["apiKey", ["SOAP::SOAPString", XSD::QName.new(nil, "apiKey")]],
+      ["email", ["SOAP::SOAPString", XSD::QName.new(nil, "email")]],
+      ["service", ["Postini::API::EndpointResolver::Service", XSD::QName.new(nil, "service")]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::GetServiceEndpointResponse,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "GetServiceEndpointResponse"),
+    :schema_element => [
+      ["endpointURI", ["SOAP::SOAPString", XSD::QName.new(nil, "EndpointURI")], [0, 1]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::InternalException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "InternalException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::InvalidValueException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "InvalidValueException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::MalformedKeyException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "MalformedKeyException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::MissingElementException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "MissingElementException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::NoSuchKeyException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "NoSuchKeyException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::UnknownEmailException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "UnknownEmailException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::UnknownInternalException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "UnknownInternalException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  EncodedRegistry.register(
+    :class => Postini::API::EndpointResolver::Service,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "service")
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::AdminBlockException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "AdminBlockException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::GetServiceEndpoint,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "GetServiceEndpoint"),
+    :schema_element => [
+      ["apiKey", ["SOAP::SOAPString", XSD::QName.new(nil, "apiKey")]],
+      ["email", ["SOAP::SOAPString", XSD::QName.new(nil, "email")]],
+      ["service", ["Postini::API::EndpointResolver::Service", XSD::QName.new(nil, "service")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::GetServiceEndpointResponse,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "GetServiceEndpointResponse"),
+    :schema_element => [
+      ["endpointURI", ["SOAP::SOAPString", XSD::QName.new(nil, "EndpointURI")], [0, 1]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::InternalException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "InternalException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::InvalidValueException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "InvalidValueException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::MalformedKeyException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "MalformedKeyException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::MissingElementException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "MissingElementException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::NoSuchKeyException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "NoSuchKeyException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::UnknownEmailException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "UnknownEmailException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::UnknownInternalException,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "UnknownInternalException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::Service,
+    :schema_type => XSD::QName.new(NsEndpointresolver, "service")
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::AdminBlockException,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "AdminBlockException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::GetServiceEndpoint,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "GetServiceEndpoint"),
+    :schema_element => [
+      ["apiKey", ["SOAP::SOAPString", XSD::QName.new(nil, "apiKey")]],
+      ["email", ["SOAP::SOAPString", XSD::QName.new(nil, "email")]],
+      ["service", ["Postini::API::EndpointResolver::Service", XSD::QName.new(nil, "service")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::GetServiceEndpointResponse,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "GetServiceEndpointResponse"),
+    :schema_element => [
+      ["endpointURI", ["SOAP::SOAPString", XSD::QName.new(nil, "EndpointURI")], [0, 1]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::InternalException,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "InternalException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::InvalidValueException,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "InvalidValueException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::MalformedKeyException,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "MalformedKeyException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::MissingElementException,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "MissingElementException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::NoSuchKeyException,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "NoSuchKeyException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::UnknownEmailException,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "UnknownEmailException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+
+  LiteralRegistry.register(
+    :class => Postini::API::EndpointResolver::UnknownInternalException,
+    :schema_name => XSD::QName.new(NsEndpointresolver, "UnknownInternalException"),
+    :schema_element => [
+      ["message", ["SOAP::SOAPString", XSD::QName.new(nil, "message")]]
+    ]
+  )
+end
+
+end; end; end

data/lib/postini/api/endpointresolver/EndpointResolverServiceClient.rb

@@ -0,0 +1,38 @@
+#!/usr/bin/env ruby
+require File.dirname(__FILE__) + '/EndpointResolverDriver.rb'
+
+
+module Postini::API::EndpointResolver
+
+endpoint_url = ARGV.shift
+obj = EndpointResolverPort.new(endpoint_url)
+
+# run ruby with -d to see SOAP wiredumps.
+obj.wiredump_dev = STDERR if $DEBUG
+
+# SYNOPSIS
+#   GetServiceEndpoint(parameters)
+#
+# ARGS
+#   parameters      GetServiceEndpoint - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}GetServiceEndpoint
+#
+# RETURNS
+#   parameters      GetServiceEndpointResponse - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}GetServiceEndpointResponse
+#
+# RAISES
+#   fault           AdminBlockException - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}AdminBlockException
+#   fault           InternalException - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}InternalException
+#   fault           InvalidValueException - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}InvalidValueException
+#   fault           MalformedKeyException - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}MalformedKeyException
+#   fault           MissingElementException - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}MissingElementException
+#   fault           NoSuchKeyException - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}NoSuchKeyException
+#   fault           UnknownEmailException - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}UnknownEmailException
+#   fault           UnknownInternalException - {http://postini.com/PSTN/SOAPAPI/v2/endpointresolver}UnknownInternalException
+#
+parameters = nil
+puts obj.getServiceEndpoint(parameters)
+
+
+
+
+end

data/lib/postini/api.rb

@@ -0,0 +1,8 @@
+module Postini
+  
+  # This module contains all the wsdl2ruby uglies and is not documented, since
+  # this gem is supposed to abstract it away
+  module API #:nodoc: all
+      
+  end
+end

data/lib/postini/domain.rb

@@ -0,0 +1,65 @@
+require 'postini/api/automatedbatch/AutomatedBatchDriver'
+
+module Postini
+  
+  # Represents the functions to perform on a domain
+  #
+  # TODO: Definitely improve this documentation
+  class Domain
+    
+    attr_accessor :id, :name, :org, :substrip
+    
+    class << self
+      
+      # Return an instance of #Domain with all the attributes populated
+      def find( domain )
+        remote = Postini::API::AutomatedBatch::AutomatedBatchPort.new( Postini.endpoint_uri )
+        request = Postini::API::AutomatedBatch::Displaydomain.new( Postini.auth, domain )
+        response = remote.displaydomain( request )
+        domain_record = response.domainRecord
+        
+        # Don't give back false positives
+        if domain_record.domainid == ""
+          return nil
+        end
+        
+        new(
+          :name => domain_record.domainname,
+          :id => domain_record.domainid,
+          :org => domain_record.org,
+          :substrip => domain_record.substrip
+        )
+      end
+      
+    end
+    
+    # Setup a new instance with the combination of attributes set
+    def initialize( attributes = {} )
+      attributes.each_pair do |k,v|
+        instance_variable_set "@#{k.to_s}", v
+      end
+    end
+    
+    def new?
+      @id.nil?
+    end
+    
+    # Create a new domain in the system. Requires +name+ and +org+ to be set.
+    # This method will through a SOAP exception if the domain could not be
+    # added.
+    def create
+      return false unless new?
+      
+      # TODO: Add missing validations here
+      
+      remote = Postini::API::AutomatedBatch::AutomatedBatchPort.new( Postini.endpoint_uri )
+      args = Postini::API::AutomatedBatch::Adddomainargs.new( @name )
+      request = Postini::API::AutomatedBatch::Adddomain.new(
+        Postini.auth, @org, args
+      )
+      remote.adddomain( request )
+    end
+    
+  end
+  
+end

data/lib/postini/user.rb

@@ -0,0 +1,125 @@
+require 'postini/api/automatedbatch/AutomatedBatchDriver'
+
+module Postini
+  
+  # This class represents a user in the Postini systems.
+  #
+  # TODO: Expand documentation
+  class User
+    
+    attr_accessor :id, :active, :address, :approved_recipients, 
+      :approved_senders, :blocked_senders, :create_method, :created_date,
+      :filter_adult, :filter_bulk, :filter_getrich, :filter_offers, 
+      :filter_racial, :initial_password, :junkmail_filter, :lang_locale,
+      :lastmod_date, :message_encryption, :message_limit, :message_limited,
+      :message_count, :notice_address, :orgid, :password, :timezone, 
+      :virus_notify, :virus_state, :weblocked, :welcome_count, :wireless_state
+    
+    class << self
+      
+      # Return a new instance of the user
+      # TODO: Make this take various options just like ActiveRecord
+      def find( user )
+        remote = Postini::API::AutomatedBatch::AutomatedBatchPort.new( Postini.endpoint_uri( user ) )
+        request = Postini::API::AutomatedBatch::Displayuser.new( Postini.auth, user )
+        response = remote.displayuser( request )
+        user_record = response.userRecord
+        
+        attributes = {}
+        user_record.instance_variables.each do |var|
+          attributes[ var.sub('@','').to_sym ] = user_record.instance_variable_get(var)
+        end
+        
+        # fix id
+        attributes[:id] = attributes.delete(:user_id)
+        
+        new( attributes )
+      end
+      
+      # Permanently remove the user from Postini
+      def destroy( address )
+        remote = Postini::API::AutomatedBatch::AutomatedBatchPort.new( Potini.endpoint_uri( address ) )
+        request = Postini::API::AutmatedBatch::Deleteuser.new( Postini.auth, address )
+        remote.deleteuser( request )
+      end
+      
+    end
+    
+    # Setup a new instance with the combination of attributes set
+    def initialize( attributes = {} )
+      attributes.each_pair do |k,v|
+        instance_variable_set "@#{k.to_s}", v
+      end
+    end
+    
+    def new?
+      @id.nil?
+    end
+    
+    # Create the new user.
+    # TODO: Add support for sending a welcome message and assigning to an org
+    def create
+      return false unless new?
+      
+      # TODO: Add missing validations here
+      
+      remote = Postini::API::AutomatedBatch::AutomatedBatchPort.new( Postini.endpoint_uri )
+      request = Postini::API::AutomatedBatch::Adduser.new( Postini.auth, @address )
+      remote.adduser( request )
+    end
+    
+    # Remove the user from Postini
+    def destroy
+      return false if new?
+      
+      self.class.destroy( @address )
+    end
+    
+    # Return the list of aliases for the mailbox
+    def aliases
+      if @aliases.nil?
+        remote = Postini::API::AutomatedBatch::AutomatedBatchPort.new( Postini.endpoint_uri( @address ) )
+        query = Postini::API::AutomatedBatch::ListusersqueryParams.new
+        query.aliases = 1
+        query.childorgs = 1
+        query.primaryqs = @address
+        query.targetOrg = @orgid
+        request = Postini::API::AutomatedBatch::Listusers.new(
+          Postini.auth,
+          "ALL",
+          query
+        )
+        
+        response = remote.listusers( request )
+        
+        @aliases = []
+        response.each { |user_record| @aliases << user_record.address }
+      end
+      
+      @aliases
+    end
+    
+    # Add an alias to this user
+    def add_alias( address )
+      @aliases = nil # clear our cache
+      remote = Postini::API::AutomatedBatch::AutomatedBatchPort.new( Postini.endpoint_uri( @address ) )
+      request = Postini::API::AutomatedBatch::Addalias.new( Postini.auth, @address, address )
+      remote.addalias( request )
+    end
+    
+    # Removes the specified alias
+    def remove_alias( address )
+      @aliases = nil # clear our cache
+      remote = Postini::API::AutomatedBatch::AutomatedBatchPort.new( Postini.endpoint_uri( @address ) )
+      request = Postini::API::AutomatedBatch::Deletealias.new( Postini.auth, address )
+      remote.deletealias( request )
+    end
+    
+    # Removes all aliases from the user
+    def clear_aliases
+      aliases.each do |address|
+        remove_alias( address )
+      end
+    end
+  end
+end

data/lib/postini/version.rb

@@ -0,0 +1,9 @@
+module Postini
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/postini.rb

@@ -0,0 +1,100 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+# requirements
+gem 'soap4r'
+require 'postini/user'
+require 'postini/domain'
+
+require 'postini/api/endpointresolver/EndpointResolverDriver'
+
+# This module just provides access to configuration details used by the rest of
+# the gem.
+# 
+# Current configuration values are:
+# * api_key
+# * system_number
+# * username
+# * password
+# * xauth
+# 
+# The +api_key+ is your unique API keys obtained from Postini via their Early
+# Access program.
+# 
+#   Postini.api_key = "your48characterkey"
+# 
+# The +system_number+ can be any known system number (known to your account).
+# The gem uses the Postini Endpoint Resolver service, but in some cases needs a 
+# known system to work from. Refer to the "Locating Your System" section of the 
+# Early Access documentation for more information.
+# 
+#   Postini.system_number = 8
+# 
+# The +username+ parameter is required if:
+# 1. Your org is using POP authentication, and thus needs the admin user's
+# authentication details, not the end-user's.
+# 2. You omit the optional username and password/xauth string for the request
+# 
+#   Postini.username = 'administrat@jumboinc.com'
+# 
+# The +password+ and +xauth+ parameters are mutually exclusive, and cannot be
+# used together. This library will use the +password+ if present, ignoring the
+# +xauth+ string alltogether.
+# 
+#   Postini.password = 'secret'
+#   Postini.xauth = 'format_unknown_to_author'
+#
+module Postini
+  
+  # On the fly class variable, getter and setter generation...
+  %w{ api_key system_number username password xauth }.each do |config|
+    class_eval <<-EOF
+      @@#{config} = nil
+      def self.#{config}=( val )
+        @@#{config} = val
+      end
+      def self.#{config}
+        @@#{config}
+      end
+    EOF
+  end
+  
+  # Return the appropriate endpoint URI for the service calls. If +user+ is
+  # provided, the endpoint is determined using the Endpoint Resolver Service,
+  # otherwise it is contructed from the +system_number+ configuration value.
+  def self.endpoint_uri( user = nil, service = :automated_batch )
+    raise "System Number not known" if user.nil? && system_number.nil?
+    
+    # Translate the service
+    service = case service
+    when :automated_batch
+      [ Postini::API::EndpointResolver::Service::V2AutomatedBatch, "automatedbatch" ]
+    end
+    
+    if user.nil?
+      "https://api-s#{system_number}.postini.com/api2/#{service[1]}"
+    else
+      remote = Postini::API::EndpointResolver::EndpointResolverPort.new
+      request = Postini::API::EndpointResolver::GetServiceEndpoint.new(
+        Postini.api_key, user, service[0]
+      )
+      response = remote.getServiceEndpoint( request )
+      response.endpointURI
+    end
+  end
+  
+  def self.auth( service = :automated_batch, username = nil, password = nil, xauth = nil )
+    username ||= self.username
+    password ||= self.password
+    if password.nil?
+      xauth ||= self.xauth
+    end
+    
+    case service
+    when :automated_batch
+      API::AutomatedBatch::AuthElem.new(
+        api_key, username, password, xauth
+      )
+    end
+  end
+end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/postini.rb'}"
+puts "Loading postini gem"
+exec "#{irb} #{libs} --simple-prompt"