forked from ombre42/robotframework-sudslibrary
-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.txt
59 lines (41 loc) · 2.8 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
Suds library for Robot Framework
================================
Introduction
------------
SudsLibrary is a library for functional testing of SOAP-based web services.
SudsLibrary is based on Suds, a dynamic SOAP 1.1 client.
See the `Keyword Documentation`_ for more information about using the library.
Installation
------------
You can install SudsLibrary using pip, with the following command
``pip install robotframework-sudslibrary``
Binary installers are available on `PyPI`_, but they do not include Suds, a required package.
Getting Help
------------
The `user group for Robot Framework`_ is the best place to get help. Consider including in the post:
- Publicly accessible URL to the WSDL or an attachment containing the WSDL
- Log file as attachment or an excerpt of it
Installation Using a Fork of Suds
---------------------------------
Development on the Suds project has appeared to cease. There are more than one forks of Suds that you may want to use. SudsLibrary was only tested with suds-jurko and the official suds package.
Here are three ways to setup for using a fork:
#. If the fork is in PyPI:
Set the environmental variable SUDS_LIBRARY_SUDS_REQUIREMENT to a valid requirement string, such as "suds-somefork > 0.5". When SudsLibrary is installed, the fork will be installed from PyPi to satisfy the requirement.
#. If the fork is not in PyPI or you have already installed it:
Install the fork prior to SudsLibrary. Then set the environmental variable SUDS_LIBRARY_SUDS_REQUIREMENT to a space and install SudsLibrary. This essentially removes the installation dependency on Suds.
#. Uninstall suds after installing SudsLibrary. Then install a fork.
Jython Support
--------------
Suds and SudsLibrary do work under Jython. Suds will not install under Jython, however.
You can extract the contents of the source tarball and put that folder in JYTHONPATH (suds-0.4) or you can use the installation of Suds performed by CPython.
SudsLibrary will install under Jython only if you bypass the requirement on Suds as mentioned in the `Installation Using a Fork of Suds`_.
If you need to test services served over HTTPS in Jython and the certificates are not valid, you will have some extra work to do since Java always validates certificates.
See these posts on getting Java to trust all certificates:
1. http://tech.pedersen-live.com/2010/10/trusting-all-certificates-in-jython/
2. http://jython.xhaus.com/installing-an-all-trusting-security-provider-on-java-and-jython/
IronPython Support
------------------
Support under IronPython is unkown -- it has not been tested.
.. _Keyword Documentation: http://ombre42.github.com/robotframework-sudslibrary/doc/SudsLibrary.html
.. _PyPI: https://pypi.python.org/pypi/robotframework-sudslibrary/
.. _user group for Robot Framework: http://groups.google.com/group/robotframework-users