On Thursday 13 May 2010, Jeff Ortel elucidated thus:
All,
Suds currently has (2) ways (hooks) for users to plug in
functionality (not including Transports). First, is the schema
Doctor used to repair broken XSDs at runtime. Second, is the
Binding.replyfilter used to alter the raw reply text. In most cases,
the replyfilter is used to strip out undesirable characters before
sax parsing.
Recently, I needed to add a third hook to provide users with a means
to modify the outgoing soap envelope for certain edge cases. Rather
then add yet another one-off hook, it seems better to add a more
general "plugin" facility. Something more formal and extensible.
And so I did in 0.4 (beta).
Please see:
https://fedorahosted.org/suds/wiki/Documentation#PLUGINS
and provide comments/suggestions including additional hooks.
Initial comments (just clarification, mostly).
- Clarify in the docs exactly when the hooks get called, and what they
contain. "After client is initialized." OK, but what (loosely) has
happend at that point? And before *what*? What is the WSDL object?
The raw file (object)? The response from urllib2.urlopen()?
- Same for "loaded." What does "loading" a WSDL or XSD entail?
Opening? Parsing? It says "contains the document root." But:
loaded: "called before loading"..."contains document root" Sounds
like
it's called after something is loaded...the name is confusing.
"Sending" and "received" seem clear enough.
I'm sure I'll have more comments...those were the ones that struck me
first.
j
--
Joshua Kugler
Part-Time System Admin/Programmer
http://www.eeinternet.com
PGP Key:
http://pgp.mit.edu/ ID 0x73B13B6A