File: README

package info (click to toggle)
python-soappy 0.11.3-1.7
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 908 kB
  • ctags: 1,617
  • sloc: python: 12,660; makefile: 9
file content (185 lines) | stat: -rw-r--r-- 4,808 bytes parent folder | download | duplicates (2)
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
==============================================
SOAPpy - Simple to use SOAP library for Python 
==============================================

Current Maintainers: 	

	Gregory R. Warnes <greg@warnes.net>
	Christopher Blunck <blunck2@gst.com>

Original Authors: 

	Cayce Ullman <c_ullman@yahoo.com>
        Brian Matthews <blm@blmatthews.com>

Contributions by:

	Brad Knotwell <b.knotwell@f5.com>
	Mark Bucciarelli <mark@hubcapconsulting.com> (ported WSDL
             client from ZSI)
	Ivan R. Judson 	<judson@mcs.anl.gov> (Globus support)
	Kirk Strauser <kirk@daycos.com>
	Antonio Beamud Montero <antonio.beamud@linkend.com> (patches
  	     for integrating SOAPpy into Zope)

Copyright (c) 2002-2003, Pfizer, Inc.
Copyright (c) 2001, Cayce Ullman.
Copyright (c) 2001, Brian Matthews.
All rights reserved, see the file LICENSE for conditions of use.

Introduction
------------

The goal of the SOAPpy team is to provide a full-featured SOAP library
for Python that is very simple to use and that fully supports dynamic
interaction between clients and servers.

INCLUDED:
- General SOAP Parser based on sax.xml
- General SOAP Builder
- SOAP Proxy for RPC client code
- SOAP Server framework for RPC server code

FEATURES:
- Handles all SOAP 1.0 types
- Handles faults 
- Allows namespace specification
- Allows SOAPAction specification
- Homogeneous typed arrays
- Supports multiple schemas
- Header support (mustUnderstand and actor)
- XML attribute support
- Multi-referencing support (Parser/Builder)
- Understands SOAP-ENC:root attribute
- Good interop, passes all client tests for Frontier, SOAP::LITE, SOAPRMI
- Encodings
- SSL clients (with Python compiled with OpenSSL support)
- SSL servers (with Python compiled with OpenSSL support and M2Crypto
  installed)
- Encodes XML tags per SOAP 1.2 name mangling specification (Gregory Warnes)
- Automatic stateful SOAP server support (Apache v2.x) (blunck2)
- WSDL client support
- Early WSDL server support

TODO: (See RELEASE_INFO and CHANGELOG for recent changes)
- Timeout on method calls
- Advanced arrays (sparse, multidimensional and partial)
- Attachments
- mod_python example
- medusa example
- Improved documentation

MANIFEST:

    Files
    -----

    README	        This file
    RELEASE_NOTES       General information about each release
    CHANGELOG           Detailed list of changes
    TODO		List of tasks that need to be done

    setup.py            Python installation control files
    MANIFEST
    MANIFEST.in
    
    SOAPpy.spec*        RPM package control file

    Directories
    -----------

    SOAPpy/*            Source code for the package
    SOAPpy/wstools/*    Source code for WSDL tools
    tests/*             unit tests and examples
    validate/*          interop client and servers
    bid/*		N+I interop client and server
    doc/*		Documentation
    contrib/		Contributed examples (also see test/)
    docs/		Documentation
    tools/              Misc tools useful for the SOAPpy developers
    zope/               Patches to Zope allowing it to provide SOAP services


INSTALLATION 

Required Packages
-----------------

These packages should be installed before SOAPpy.

- fpconst 0.6.0 or later,
  <http://www.analytics.washington.edu/Zope/projects/fpconst>

- pyXML 0.8.3 or later, <http://pyxml.sourceforge.net>

Optional
--------

These packages provide support for optional SOAPpy features.

- pyGlobus, optional support for Globus,
  <http://www-itg.lbl.gov/gtg/projects/pyGlobus/>

- M2Crypto.SSL, optional support for server-side SSL
  <http://sandbox.rulemaker.net/ngps/m2/>

- If Python is compiled with SSL support (Python 2.3 does so by
  default), client-side use of SSL is supported

Installation
------------

As of version 0.9.8 SOAPpy can be installed using the standard python
package installation tools.  

To install:

  1) Unpack the distribution package:

     On Windows, use your favorite zip file uncompression tool.

     On Unix: 

     $ tar -xvzf SOAPpy-$VERSION$.tar.gz

     if you have gnu tar, otherwise

     $ gzcat SOAPpy-$VERSION$.tar.gz | tar -xvf -

  2) Change into the source directory

     $ cd SOAPpy-$VERSION$

  3) Compile the package 

     $ python setup.py build

  4) Install the package as root

     $ su 
     Password: XXXXXX
     $ python setup.py install


QUICK START

A simple "Hello World" http SOAP server:

      import SOAPpy
      def hello():
	  return "Hello World"

      server = SOAP.SOAPServer(("localhost", 8080))
      server.registerFunction(hello)
      server.serve_forever()

And the corresponding client:

      import SOAPpy
      server = SOAPpy.SOAPProxy("http://localhost:8080/")
      print server.hello()
      
For further information see the files in the doc/ directory.


$Id: README,v 1.12 2003/12/19 22:19:35 warnes Exp $