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
|
============================
XMLRPC Python Library
============================
This kit contains an implementation of the xmlrpc protocol written in C and
wrapped up in python. The spec for the XMLRPC protocol can be found at
"http://www.xmlrpc.com".
AUTHOR
------
Shilad Sen, Sourcelight Technologies Inc.
shilad.sen@sourcelight.com
Sourcelight Technologies, Inc
906 University Place, Suite B-211
Evanston, IL 60201
Thanks to Chris Jensen for the windows compatability and to Pat Szuta for
the DateTime and Base64 objects.
INSTALLATION
------------
See the INSTALL file which should be included with this distribution.
INFO
----
This is version 0.8.4 of the xmlrpc library. There have been some big
changes since the 0.8.2 version. Please see the CHANGELOG for version
information.
xmlrpc.py is pretty well documented. If you want more documentation, at
this point you'll have to go to the source. Some time I should document
everything better, especially the nonblocking aspects of the server and
client.
FEATURES
--------
* Efficiency: This library seems to be 20x-100x faster than other xmlrpc
libraries I've tried. I have benchmarked this library at about 1000 RPC
calls per second between two different celeron 466 machines. Both speed
and memory use seem to be exponentially better (related to the size of
objects being sent across) than the existing Python libraries.
* Non-Blocking IO: This becomes important when you have critical
applications (especially servers) that CANNOT be held up because a client
is trickling a request in or is reading a response at 1 byte per second.
* Event based: This goes hand in hand with non-blocking IO. It lets you
use an event based model for your client/server application, where the
main body is basically the select loop on the file descriptors you are
interested in. The work is done by registering callbacks for different
events you received on file descriptors. This can be very nice. There is
some work to be done here, but all the hooks are in place. See TO DO for
a list of the features that have yet to be incorporated.
* Portable: Source should be compatible on both windows and POSIX
CONTENTS
--------
README - this file
CHANELOG - features / fixes
_xmlrpcmodule.so - a python module written in C for xmlrpc
xmlrpc.py - a python wrapper for the low-level module
example.py - example python code
if you have a source distribution, there will be other files.
LICENSE
-------
A full copy of the LGPL license is included in the file COPYING.
This is an Pyton implementation of the xmlrpc spec from www.xmlrpc.com
Copyright (c) 2001 by Shilad Sen, Sourcelight Technologies, Inc
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
