This has been done pretty much blindly, as I'm running into authentication errors. Address validation -might- work, but I need someone whose account isn't acting strange to test this.

Also more comment fixes on ship_service.py.

Author: Greg Taylor

examples/__init__.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python
+"""
+This example shows how to validate addresses. Note that the validation
+class can handle up to 100 addresses for validation.
+"""
+import logging
+import binascii
+from example_config import CONFIG_OBJ
+from fedex.services.address_validation_service import FedexAddressValidationRequest
+
+# Set this to the INFO level to see the response from Fedex printed in stdout.
+logging.basicConfig(level=logging.INFO)
+
+# This is the object that will be handling our tracking request.
+# We're using the FedexConfig object from example_config.py in this dir.
+address = FedexAddressValidationRequest(CONFIG_OBJ)
+
+address1 = address.create_wsdl_object_of_type('AddressToValidate')
+address1.CompanyName = 'International Paper'
+address1.Address.StreetLines = ['155 Old Greenville Hwy', 'Suite 103']
+address1.Address.City = 'Clemson'
+address1.Address.StateOrProvinceCode = 'SC'
+address1.Address.PostalCode = 29631
+address1.Address.CountryCode = 'US'
+address1.Address.Residential = False
+
+address.add_address(address1)
+address.send_request()
+print address.response

examples/address_validation.py

@@ -81,7 +81,7 @@ def __init__(self, config_obj, wsdl_name, *args, **kwargs):
 
         self.client = Client('file://%s' % self.wsdl_path)
 
-        print self.client
+        #print self.client
 
         self.VersionId = None
         """@ivar: Holds details on the version numbers of the WSDL."""

fedex/base_service.py

@@ -0,0 +1,84 @@
+"""
+Address Validation Service Module
+=================================
+This package contains the shipping methods defined by Fedex's 
+AddressValidationService WSDL file. Each is encapsulated in a class for 
+easy access. For more details on each, refer to the respective class's 
+documentation.
+"""
+from datetime import datetime
+from .. base_service import FedexBaseService
+
+class FedexAddressValidationRequest(FedexBaseService):
+    """
+    This class allows you validate anywhere from one to a hundred addresses
+    in one go. Create AddressToValidate WSDL objects and add them to each
+    instance of this request using add_address().
+    """
+    def __init__(self, config_obj, *args, **kwargs):
+        """
+        @type config_obj: L{FedexConfig}
+        @param config_obj: A valid FedexConfig object.        
+        """
+        self._config_obj = config_obj
+        
+        # Holds version info for the VersionId SOAP object.
+        self._version_info = {'service_id': 'ship', 'major': '2', 
+                             'intermediate': '0', 'minor': '0'}
+        
+        self.AddressValidationOptions = None
+        """@ivar: Holds the AddressValidationOptions WSDL object."""
+        self.addresses_to_validate = []
+        """@ivar: Holds the AddressToValidate WSDL object."""
+        # Call the parent FedexBaseService class for basic setup work.
+        super(FedexAddressValidationRequest, self).__init__(self._config_obj, 
+                                                         'AddressValidationService_v2.wsdl',
+                                                         *args, **kwargs)
+        
+    def _prepare_wsdl_objects(self):
+        """
+        Create the data structure and get it ready for the WSDL request.
+        """
+        # This holds some optional options for the request..
+        self.AddressValidationOptions = self.client.factory.create('AddressValidationOptions')
+                               
+        # This is good to review if you'd like to see what the data structure
+        # looks like.
+        self.logger.debug(self.AddressValidationOptions)
+    
+    def _assemble_and_send_request(self):
+        """
+        Fires off the Fedex request.
+        
+        @warning: NEVER CALL THIS METHOD DIRECTLY. CALL send_request(), 
+            WHICH RESIDES ON FedexBaseService AND IS INHERITED.
+        """
+        # We get an exception like this when specifying an IntegratorId:
+        # suds.TypeNotFound: Type not found: 'IntegratorId'
+        # Setting it to None does not seem to appease it.
+        del self.ClientDetail.IntegratorId
+        self.logger.debug(self.WebAuthenticationDetail)
+        self.logger.debug(self.ClientDetail)
+        self.logger.debug(self.TransactionDetail)
+        self.logger.debug(self.VersionId)
+        # Fire off the query.
+        response = self.client.service.addressValidation(WebAuthenticationDetail=self.WebAuthenticationDetail,
+                                        ClientDetail=self.ClientDetail,
+                                        TransactionDetail=self.TransactionDetail,
+                                        Version=self.VersionId,
+                                        RequestTimestamp=datetime.now(),
+                                        Options=self.AddressValidationOptions,
+                                        AddressToValidate=self.addresses_to_validate)
+        return response
+
+    def add_address(self, address_item):
+        """
+        Adds an address to self.addresses_to_validate.
+        
+        @type address_item: WSDL object, type of AddressToValidate WSDL object.
+        @keyword address_item: A AddressToValidate, created by
+            calling create_wsdl_object_of_type('AddressToValidate') on
+            this FedexAddressValidationRequest object. 
+            See examples/create_shipment.py for more details.
+        """
+        self.addresses_to_validate.append(address_item)

fedex/services/address_validation_service.py

@@ -10,17 +10,15 @@
 
 class FedexProcessShipmentRequest(FedexBaseService):
     """
-    This class allows you to track shipments by providing a tracking
-    number or other identifying features. By default, you
-    can simply pass a tracking number to the constructor. If you would like
-    to query shipments based on something other than tracking number, you will
-    want to read the documentation for the L{__init__} method. 
-    Particularly, the tracking_value and package_identifier arguments.
+    This class allows you to process (create) a new FedEx shipment. You will
+    need to populate the data structures in self.RequestedShipment, then
+    send the request. Label printing is supported and very configurable,
+    returning an ASCII representation with the response as well.
     """
     def __init__(self, config_obj, *args, **kwargs):
         """
-        Sends a shipment tracking request. The optional keyword args
-        detailed on L{FedexBaseService} apply here as well.
+        The optional keyword args detailed on L{FedexBaseService} 
+        apply here as well.
 
         @type config_obj: L{FedexConfig}
         @param config_obj: A valid FedexConfig object.