What SOAP client libraries exist for Python, and where is the documentation for them? [closed]

Asked 15/10, 2008 at 19:50 Answered 1/6, 2011 at 3:35

346

I've never used SOAP before and I'm sort of new to Python. I'm doing this to get myself acquainted with both technologies. I've installed SOAPlib and I've tried to read their Client documentation, but I don't understand it too well. Is there anything else I can look into which is more suited for being a SOAP Client library for Python?

Edit: Just in case it helps, I'm using Python 2.6.

Inexpressible answered 15/10, 2008 at 19:50 Comment(4)

Does it have to be SOAP, such as using pre-existing web services? Python's xmlrpclib is dead simple to use and I've migrated our SOAP services to XMLRPC with it. – Lashandralashar 16/10, 2008 at 1:3

Sometimes one just want to connect to service that is ONLY provided over SOAP so yes - good python SOAP lib is something that one will sooner or later need. One won't have any chance to convince service provider to replace SOAP with something "cleaner"... – Cyrstalcyrus 23/9, 2009 at 20:24

FYI: I opened a similar post that targets SOAP for Python 3: #7817803 – Caiaphas 19/10, 2011 at 6:21

Look at Python Wiki for uptodate info: wiki.python.org/moin/WebServices – Nutting 22/8, 2016 at 18:50

408

Update (2016):

If you only need SOAP client, there is well maintained library called zeep. It supports both Python 2 and 3 :)

Update:

Additionally to what is mentioned above, I will refer to Python WebServices page which is always up-to-date with all actively maintained and recommended modules to SOAP and all other webservice types.

Unfortunately, at the moment, I don't think there is a "best" Python SOAP library. Each of the mainstream ones available has its own pros and cons.

Older libraries:

SOAPy: Was the "best," but no longer maintained. Does not work on Python 2.5+
ZSI: Very painful to use, and development is slow. Has a module called "SOAPpy", which is different than SOAPy (above).

"Newer" libraries:

SUDS: Very Pythonic, and easy to create WSDL-consuming SOAP clients. Creating SOAP servers is a little bit more difficult. (This package does not work with Python3. For Python3 see SUDS-py3)
SUDS-py3: The Python3 version of SUDS
spyne: Creating servers is easy, creating clients a little bit more challenging. Documentation is somewhat lacking.
ladon: Creating servers is much like in soaplib (using a decorator). Ladon exposes more interfaces than SOAP at the same time without extra user code needed.
pysimplesoap: very lightweight but useful for both client and server - includes a web2py server integration that ships with web2py.
SOAPpy: Distinct from the abandoned SOAPpy that's hosted at the ZSI link above, this version was actually maintained until 2011, now it seems to be abandoned too.
soaplib: Easy to use python library for writing and calling soap web services. Webservices written with soaplib are simple, lightweight, work well with other SOAP implementations, and can be deployed as WSGI applications.
osa: A fast/slim easy to use SOAP python client library.

Of the above, I've only used SUDS personally, and I liked it a lot.

Idolatrous answered 15/10, 2008 at 19:50 Comment(18)

Python 2.5.2, SOAPpy 0.12.0 and my SOAP clients work. – Hymenopterous 16/10, 2008 at 9:45

Looks like you misspelled SOAPpy. Or do soappy and soapy both exist? Either way you might want to edit to clarify – Heliogabalus 15/5, 2009 at 19:15

SOAPy and SOAPpy are actually different. I've edited to clarify, and turned the post into a community wiki. – Idolatrous 21/5, 2009 at 20:16

+1 for SUDS, great library! I ran into problems using SUDS with HTTPS web services behind a proxy. Turns out it is a known Python urllib2 issue. See my answer for more details. – Lxx 6/8, 2009 at 8:35

I've personally, had a lot of success with SOAPpy. Although, I've occasionally had to write some wrappers to fix some things. ( .NET consuming, WSDL serving ) – Dancer 20/10, 2010 at 15:41

suds could be great, but it has problems with ssl ((( – Ahasuerus 23/11, 2010 at 16:34

Suds also doesn't support multipart replies without our patch: fedorahosted.org/suds/ticket/308 – Bluefish 29/11, 2011 at 8:43

I tried SUDs, but it went into an infinite loop when opening a WSDL; then python threw a recursion limit error. I found this open ticket regarding the issue: fedorahosted.org/suds/ticket/239 Apparently this was a library breaking bug 3 years ago, and still hasn't been fixed. – Aliciaalick 27/2, 2012 at 22:5

How can you write a server using SUDS? Never seen any working examples. – Dextro 9/4, 2013 at 20:36

There's a maintained fork of SUDS at bitbucket.org/jurko/suds – Ensure 28/6, 2013 at 12:10

I've started using SUDS today for fetching data only. It handled a basic apikey auth in the soap headers without any problems, and the responses were fairly easy to parse. The documentation was also fairy decent. – Mcallister 6/9, 2013 at 0:15

SOAPpy was revived a bit and received a few updates in 2014. Check it out here: pypi.python.org/pypi/SOAPpy. – Raddle 8/4, 2015 at 20:22

I used a suds-jurko, works with python 3.3. Great library indeed!! – Mehitable 30/4, 2015 at 13:11

Many of these seem outdated, but osa seems to be maintained, documented and easy to use. – Heptahedron 7/12, 2015 at 16:56

Big thanks for coming back in 2016 and updating this! 🎉 – Duckbill 10/3, 2017 at 19:52

SUDS’ fedorahosted page is now not available. Also, there is a new Python3 version of it, available as suds-py3. – Striptease 1/3, 2018 at 9:36

Update from 2018 - Zeep seems to be the way to go - most modern underlying libraries, extensive support. – Harvestman 10/6, 2018 at 18:36

In case there is anyone able to provide info on which of these is supporting Client side TLS certificates via HSM (PKCS11) it would be highly appreciated! – Fidelia 16/4, 2019 at 14:14

I followed the advice of other answers to this question and gave SUDS a try. After using it "in anger" I must agree: SUDS is very nice! Highly recommended!

I did run into trouble calling HTTPS-based web services from behind a proxy. At the time of this writing, this affects all Python web-service clients that use urllib2, so I'll document the solution here.

The urllib2 module shipping with python 2.6.2 and below will not issue a CONNECT to the proxy for HTTPS-over-HTTP-proxy sessions. This results in a long timeout, or if you are lucky, an error that looks like:

abort: error: error:140770FC:SSL routines:SSL23_GET_SERVER_HELLO:unknown protocol

This was issue1424152 on the Python bug tracker. There are patches attached to the bug report that will fix this in Python 2.x and Python 3.x. The issue is already fixed.

Lxx answered 15/10, 2008 at 19:50 Comment(6)

Just installed it and even though I'm totally new to Python it felt very intuitive and I could send SUDS requests i minutes time. The library is great! – Belicia 11/6, 2011 at 12:28

Do you mind updating this one. I ask because I clicked on the link, and the bug is fixed. – Blakely 27/6, 2011 at 15:12

Shame it appears to no longer be maintained – Hbeam 21/10, 2013 at 23:26

Fore us suds also works well.. However its very slow. Retrieving an xml soap file takes 0.5 seconds, and processing it takes 5 seconds on a dual core machine! – Doggish 5/9, 2014 at 9:13

@paulm: try bitbucket.org/jurko/suds – Voltage 25/2, 2016 at 10:34

At 2020 I would recommend SUDS over zeep – Armand 14/7, 2020 at 8:38

I had good experience with SUDS https://fedorahosted.org/suds

Used their TestSuite as documentation.

Herv answered 15/10, 2008 at 19:50 Comment(3)

SUDS is awesome! really easy to use, good docs, great stuff! – Chasse 5/10, 2011 at 15:40

Maintained, python3 supported fork: suds-jurko. pip install suds-jurko – Leiva 19/6, 2015 at 3:0

I am trying to call async soap api with suds, working well but not getting any response, can someone help in that, hr my Q.: #39228219 – Henry 30/8, 2016 at 13:35

SUDS is the way to go, no question about it.

Rockefeller answered 25/7, 2009 at 0:59 Comment(2)

And it also fails on a large number of WSDL files. To back that claim up - the Bing maps API's for example, some of these fail and suds can't parse them. – Machado 10/1, 2011 at 10:17

i found SUDS supports SSL endpoints. – Tycho 6/5, 2011 at 15:27

Just an FYI warning for people looking at SUDS, until this ticket is resolved, SUDS does not support the "choice" tag in WSDL:

https://fedorahosted.org/suds/ticket/342

see: suds and choice tag

Parchment answered 1/6, 2011 at 3:35 Comment(0)

SUDS is easy to use, but is not guaranteed to be re-entrant. If you're keeping the WSDL Client() object around in a threaded app for better performance, there's some risk involved. The solution to this risk, the clone() method, throws the unrecoverable Python 5508 bug, which seems to print but not really throw an exception. Can be confusing, but it works. It is still by far the best Python SOAP client.

Apposite answered 25/2, 2010 at 17:4 Comment(0)

We released a new library: PySimpleSOAP, that provides support for simple and functional client/server. It goals are: ease of use and flexibility (no classes, autogenerated code or xml is required), WSDL introspection and generation, WS-I standard compliance, compatibility (including Java AXIS, .NET and Jboss WS). It is included into Web2Py to enable full-stack solutions (complementing other supported protocols such as XML_RPC, JSON, AMF-RPC, etc.).

If someone is learning SOAP or want to investigate it, I think it is a good choice to start.

Underplot answered 7/8, 2010 at 1:0 Comment(0)

I believe soaplib has deprecated its SOAP client ('sender') in favor of suds. At this point soaplib is focused on being a web framework agnostic SOAP server ('receiver'). Currently soaplib is under active development and is usually discussed in the Python SOAP mailing list:

http://mail.python.org/mailman/listinfo/soap

Rodgers answered 31/8, 2010 at 16:18 Comment(0)

In my conclusion we have this:

Soap client side:

~~use only Suds-jurko (updated 2016) suds is well maintained and updated.~~

UPDATE 06/2017: suds-jurko library is not updated and apparently abandoned,

I tested zeep library but got limitations around tokens, by now just support UsernameToken, i report a bug to create timestamp token and author update the code to fix it.

Zeep start good and has good documentation , so i recently migrated my code from suds to zeep and works fine.

~~Soap server side:~~

We have TGWS, soaplib (pysimplesoap not tested) IMHO use and help soaplib must be the choice.

Best regards,

Gurglet answered 31/8, 2010 at 20:32 Comment(1)

Is there good documentation/samples for Suds-jurko? in the repo there are a few .rst files but not much in a way of documentation of how to use the library. – Bon 16/6, 2017 at 23:12

As I suggested here I recommend you roll your own. It's actually not that difficult and I suspect that's the reason there aren't better Python SOAP libraries out there.

Noontide answered 16/10, 2008 at 1:0 Comment(0)

suds is pretty good. I tried SOAPpy but didn't get it to work in quite the way I needed whereas suds worked pretty much straight away.

Elyn answered 24/3, 2011 at 2:31 Comment(0)

Could this help: http://users.skynet.be/pascalbotte/rcx-ws-doc/python.htm#SOAPPY

I found it by searching for wsdl and python, with the rational being, that you would need a wsdl description of a SOAP server to do any useful client wrappers....

Ecstasy answered 15/10, 2008 at 19:56 Comment(0)

We'd used SOAPpy from Python Web Services, but it seems that ZSI (same source) is replacing it.

Lashandralashar answered 15/10, 2008 at 19:59 Comment(0)

Im using SOAPpy with Python 2.5.3 in a production setting.

I had to manually edit a couple of files in SOAPpy (something about header code being in the wrong place) but other than that it worked and continues to do so very reliably.

Satin answered 18/3, 2010 at 3:29 Comment(1)

We did the same and are using SOAPpy with Python 2.6.3. – Raddle 31/8, 2010 at 13:25

Hot tags

Godot Unity Godot Help Programming Godot 4.X GUI GDScript 3D 2D Physics CSharp Godot 3.X VR XR Projects C++

Recommended topics

Hot tags