Skip to main content

A transport and architecture agnostic rpc (de)serialization library that focuses on making small, rpc-oriented messaging work.

Project description

This is a simple, easily extendible rpc library that provides several useful tools for creating and publishing web services in python. This package features on-demand wsdl generation for the published services, a wsgi-compliant web application, support for complex class structures, binary attachments, and a simple framework for creating additional serialization mechanisms.

This project uses lxml as it’s XML API, providing full namespace support.




  • Implemented fanout support for transports and protocols that can handle that.
  • Implemented a helper module that generates a Soap/Wsdl 1.1 application in rpclib.util.simple
  • Some work towards supporting Python3 using 2to3. See issue #113.
  • ctx.descriptor.reset_function implemented. It’s now safe to fiddle with that value in event handlers.
  • Incorporated a cleaned-up version of the Django wrapper:
  • Fix most of the tests that fail due to api changes.
  • Fix Http soap client.
  • Full change log:


  • Made color in logs optional
  • Fixed ByteArray serializer



  • Many issues with ‘soft’ validation was fixed.
  • MethodDescriptor.udp added. Short for “User-Defined Properties”, you can use it to store arbitrary metadata about the decorated method.
  • Fix HttpRpc response serialization.
  • Documentation updates.


  • Fixed import errors in Python<=2.5.
  • A problem with rpclib’s String and unicode objects was fixed.


  • Fixed Fault publishing in Wsdl.
  • Implemented ‘soft’ validation.
  • Documentation improvements. It’s mostly ready!
  • A bug with min/max_occurs logic was fixed. This causes rpclib not to send null values for elements with min_occurs=0 (the default value).
  • Native value for rpclib.model.primitive.String was changed to unicode. To exchange raw data, you should use rpclib.model.binary.ByteArray.
  • Full change log:


  • Added MAX_CONTENT_LENGTH = 2 * 1024 * 1024 and BLOCK_LENGTH = 8 * 1024 constants to rpclib.server.wsgi module.
  • rpclib.model.binary.Attachment is deprecated, and is replaced by ByteArray. The native format of ByteArray is an iterable of strings.
  • Exception handling was formalized. HTTP return codes can be set by exception classes from rpclib.error or custom exceptions.
  • Full change log:


  • Limited support for sqlalchemy.orm.relationship (no string arguments)
  • Added missing event firings.
  • Documented event api and fundamental data structures (rpclib._base)
  • Full change log:



  • Documentation improvements.
  • rpclib.protocol.xml.XmlObject is now working as out_protocol.
  • Many fixes.


  • Documentation improvements.
  • rpclib.client.http.Client -> rpclib.client.http.HttpClient
  • rpclib.client.zeromq.Client -> rpclib.client.zeromq.ZeroMQClient
  • rpclib.server.zeromq.Server -> rpclib.server.zeromq.ZeroMQServer
  • rpclib.model.table.TableSerializer -> rpclib.model.table.TableModel


  • Fixed call to rpclib.application.Application.call_wrapper
  • Fixed HttpRpc server transport instantiation.
  • Documentation improvements.


  • rpclib.application.Application.call_wrapper introduced
  • Documentation improvements.


  • The serialization / deserialization logic was redesigned. Now most of the serialization-related logic is under the responsibility of the ProtocolBase children.
  • Interface generation logic was redesigned. The WSDL logic is separated to XmlSchema and Wsdl11 classes. ‘add_to_schema’ calls were renamed to just ‘add’ and were moved inside rpclib.interface.xml_schema package.
  • Interface and Protocol assignment of an rpclib application is now more explicit. Both are also configurable during instantion. This doesn’t mean there’s much to configure :)
  • WS-I Conformance is back!. See for the latest conformance report.
  • Numeric types now support range restrictions. e.g. Integer(ge=0) will only accept positive integers.
  • Any -> AnyXml, AnyAsDict -> AnyDict. AnyAsDict is not the child of the AnyXml anymore.
  • rpclib.model.exception -> rpclib.model.fault.


  • The method dispatch logic was rewritten: It’s now possible for the protocols to override how method request strings are matched to methods definitions.
  • Unsigned integer primitives were added.
  • ZeroMQ client was fixed.
  • Header confusion in native http soap client was fixed.
  • Grouped transport-specific context information under ctx.transport attribute.
  • Added a self reference mechanism.


  • The inclusion of base xml schemas were made optional.
  • WSDL: Fix out header being the same as in header.
  • Added type checking to outgoing Integer types. it’s not handled as nicely as it should be.
  • Fixed the case where changing the _in_message tag name of the method prevented it from being called.
  • SOAP/WSDL: Added support for multiple {in,out}_header objects.
  • Correct some bugs with the XMLAttribute model


  • Added inheritance support to rpclib.model.table.TableSerializer.


  • The NullServer now also returns context with the return object to have it survive past user-defined method return.


  • More tests are migrated to the new api.
  • Function identifier strings are no more created directly from the function object itself. Function’s key in the class definition is used as default instead.
  • Base xml schemas are no longer imported.


  • Added rpclib.server.null.NullServer, which is a server class with a client interface that attempts to do no (de)serialization at all. It’s intended to be used in tests.


  • Add late mapping support to sqlalchemy table serializer.


  • Add preliminary support for a sqlalchemy-0.7-compatible serializer.


  • Migrate the HttpRpc serializer to the new internal api.


  • SimpleType -> SimpleModel
  • Small bugfixes.


  • EventManager now uses ordered sets instead of normal sets to store event handlers.
  • Implemented sort_wsdl, a small hack to sort wsdl output in order to ease debugging.


  • Implemented EventManager and replaced hook calls with events.
  • The rpc decorator now produces static methods. The methods still get an implicit first argument that holds the service contexts. It’s an instance of the MethodContext class, and not the ServiceBase (formerly DefinitionBase) class.
  • The new srpc decorator doesn’t force the methods to have an implicit first argument.
  • Fixed fault namespace resolution.
  • Moved xml constants to rpclib.const.xml_ns
  • The following changes to soaplib were ported to rpclib’s SOAP/WSDL parts:
    • duration object is now compatible with Python’s native timedelta.
    • WSDL: Support for multiple <service> tags in the wsdl (one for each class in the application)
    • WSDL: Support for multiple <portType> tags and multiple ports.
    • WSDL: Support for enumerating exceptions a method can throw was added.
    • SOAP: Exceptions got some love to be more standards-compliant.
    • SOAP: Xml attribute support
  • Moved all modules with packagename.base to packagename._base.
  • Renamed classes to have module name as a prefix:
    • rpclib.client._base.Base -> rpclib.client._base.ClientBase
    • rpclib.model._base.Base -> rpclib.model._base.ModelBase
    • rpclib.protocol._base.Base -> rpclib.protocol._base.ProtocolBase
    • rpclib.server._base.Base -> rpclib.server._base.ServerBase
    • rpclic.service.DefinitionBase -> rpclib.service.ServiceBase
    • rpclib.server.wsgi.Application -> rpclib.server.wsgi.WsgiApplication
  • Moved some classes and modules around:
    • rpclib.model.clazz -> rpclib.model.complex
    • rpclib.model.complex.ClassSerializer -> rpclib.model.complex.ComplexModel
    • rpclib.Application -> rpclib.application.Application
    • rpclib.service.rpc, srpc -> rpclib.decorator.rpc, srpc

soaplib-3.x -> rpclib-1.1.1-alpha

  • Soaplib is now also protocol agnostic. As it now supports protocols other than soap (like Rest-minus-the-verbs HttpRpc), it’s renamed to rpclib. This also means soaplib can now support multiple versions of soap and wsdl standards.
  • Mention of xml and soap removed from public api where it’s not directly related to soap or xml. (e.g. a hook rename: on_method_exception_xml -> on_method_exception_doc)
  • Protocol serializers now return iterables instead of complete messages. This is a first step towards eliminating the need to have the whole message in memory during processing.


  • This release transformed soaplib from a soap server that exclusively supported http to a soap serialization/deserialization library that is architecture and transport agnostic.
  • Hard dependency on WSGI removed.
  • Sphinx docs with working examples:
  • Serializers renamed to Models.
  • Standalone xsd generation for ClassSerializer objects has been added. This allows soaplib to be used to define generic XML schemas, without SOAP artifacts.
  • Annotation Tags for primitive Models has been added.
  • The soaplib client has been re-written after having been dropped from recent releases. It follows the suds API but is based on lxml for better performance. WARNING: the soaplib client is not well-tested and future support is tentative and dependent on community response.
  • 0mq support added.
  • Twisted supported via WSGI wrappers.
  • Increased test coverage for soaplib and supported servers


  • Standards-compliant Soap Faults
  • Allow multiple return values and return types


  • pritimitive.Array -> clazz.Array
  • Support for SimpleType restrictions (pattern, length, etc.)


  • Soap header support
  • Tried the WS-I Test first time. Many bug fixes.


  • Support for inheritance.


  • Support for publishing multiple service classes.


  • Soap server logic almost completely rewritten.
  • Soap client removed in favor of suds.
  • Object definition api no longer needs a class types: under class definition.
  • XML Schema validation is supported.
  • Support for publishing multiple namespaces. (multiple <schema> tags in the wsdl)
  • Support for enumerations.
  • Application and Service Definition are separated. Application is instantiated on server start, and Service Definition is instantiated for each new request.
  • @soapmethod -> @rpc


  • Switched to lxml for proper xml namespace support.


  • First public stable release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for rpclib, version 2.5.1-beta
Filename, size File type Python version Upload date Hashes
Filename, size rpclib-2.5.1-beta.tar.gz (85.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page