Add ability to override the soap endpoint via Client.set_address()

CHANGES

@@ -1,3 +1,8 @@
+0.8.0 (unreleased)
+------------------
+ - Add ability to override the soap endpoint via `Client.set_address()`
+
+
 0.7.1 (2016-06-01)
 ------------------
  - Fix regression with handling wsdl:import statements for messages (#47)

docs/in-depth.rst

@@ -29,6 +29,24 @@ binding is availble via ``client.service``. To use a specific binding you can
 use ``binding = client.bind('MyService', 'MyPort')``. 
 
 
+Overriding the default endpoint address
+---------------------------------------
+There are situations where you need to change the soap address from the one
+which is defined within the WSDL. This can be done by using the
+``Client.set_address()`` method.
+
+.. code-block:: python
+
+    from zeep import Client
+    from zeep import xsd
+
+    client = Client('http://my-endpoint.com/production.svc?wsdl')
+    client.set_address(
+        'EnterpriseService', 'EnterpriseSoap11', 
+        'http://my-endpoint.com/acceptance/')
+    client.service.submit('something')
+
+
 Any objects
 -----------
 

src/zeep/client.py

@@ -73,6 +73,28 @@ def bind(self, service_name=None, port_name=None):
             port = list(service.ports.values())[0]
         return ServiceProxy(self, port)
 
+    def set_address(self, service_name, port_name, address):
+        """Override the default port address for the given `service_name`
+        `port_name` combination.
+
+        :param service_name: Name of the service
+        :type address: string
+        :param port_name: Name of the port within the service
+        :type address: string
+        :param address: URL of the server
+        :type address: string
+
+        """
+        service = self.wsdl.services.get(service_name)
+        if not service:
+            raise ValueError("Service not found")
+
+        port = service.ports.get(port_name)
+        if not port:
+            raise ValueError("Port not found")
+
+        port.binding_options['address'] = address
+
     def get_type(self, name):
         return self.wsdl.schema.get_type(name)
 

tests/test_client.py

@@ -21,6 +21,31 @@ def test_bind_service_port():
     service = client_obj.bind('StockQuoteService', 'StockQuotePort')
     assert service
 
+@pytest.mark.requests
+def test_set_address():
+    client_obj = client.Client('tests/wsdl_files/soap.wsdl')
+    client_obj.set_address(
+        'StockQuoteService', 'StockQuotePort', 'http://test.python-zeep.org/x')
+
+    response = """
+    <?xml version="1.0"?>
+    <soapenv:Envelope
+        xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
+        xmlns:stoc="http://example.com/stockquote.xsd">
+       <soapenv:Header/>
+       <soapenv:Body>
+          <stoc:TradePrice>
+             <price>120.123</price>
+          </stoc:TradePrice>
+       </soapenv:Body>
+    </soapenv:Envelope>
+    """.strip()
+
+    with requests_mock.mock() as m:
+        m.post('http://test.python-zeep.org/x', text=response)
+        result = client_obj.service.GetLastTradePrice('foobar')
+        assert result == 120.123
+
 
 @pytest.mark.requests
 def test_service_proxy():