Ñò ÁØqKc@sÅdZddd!Zddd!Zddd!ZddklZd efd „ƒYZd efd „ƒYZd efd„ƒYZdefd„ƒYZ defd„ƒYZ defd„ƒYZ dS(s¯ $RCSfile: interfaces.py,v $ Processor interfaces Author: Philipp von Weitershausen $Id: interfaces.py,v 1.4 2005/09/06 02:08:59 arielpartners Exp $ s $Name: $iiþÿÿÿs$Date: 2005/09/06 02:08:59 $s$Revision: 1.4 $i iÿÿÿÿ(t Interfacet IProcessorcBseZd„ZRS(cCsdS(s‹ Set debug level from 0 to 3. 0 = silent 3 = extra verbose Debug messages go to Zope server log. N((tlevel((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyt setDebugLevels(t__name__t __module__R(((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyRst IDTDValidatorcBs eZdZd„Zd„ZRS(sÓ ZopeXMLMethods DTD Validator public interface This class encapsulates an DTD Validator for use by ZopeXMLMethods. IDTDValidator is the Interface implemented by a processor library. Any library capable of validating XML via a DTD can be used, as long as an adaptor class is written that conforms to this interface. This is the first of many schema validator interfaces. For example: XML-Schema, RelaxNG, Schematron, DTD. cCsdS(sm Validate the passed in XML document against the DTD that it refers to in a DOCTYPE. N((t xmlStringtxmlURL((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pytdtdValidationResultsString,scCsdS(so Return boolean indicating whether passed in document is valid with respect to its DTD N((RR((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyt isValidForDTD2s(RRt__doc__R R (((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyRs  tIXPathProcessorcBseZdZd„ZRS(sU ZopeXMLMethods XSLT Processor public interface This class encapsulates an XSLT Processor for use by ZopeXMLMethods. IXSLTProcessor is the Interface implemented by a processor library. Any library capable of processing XPath can be used, as long as an adaptor class is written that conforms to this interface. cCsdS(sy Return compiled expression as IXPathExpression. If a particular processing library does not provide the capability of compiling an expression, it may choose to implement IXPathExpression directly and have this method return an instance of itself (see SabPythProcessor.py). Throws an exception if there are any errors. N((t expression((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pytcompileCs(RRR R(((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyR 8s tIXPathExpressioncBs#eZdZdd„Zd„ZRS(sî Interface for a compiled xpath expression. This may be implemented either as a separate adaptor class that adapts a processor-native compiled xpath expression type, or directly by the parent adaptor class. icCsdS(s+return result of xpath evaluation as stringN((RRt prettyPrint((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pytevaluateStringWscCsdS(s)return a list of DOM nodes matching xpathN((txmlNodeR((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyt evaluateDOMZs(RRR RR(((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyRMs tIXSLTProcessorcBs eZdZdhdd„ZRS(sT ZopeXMLMethods XSLT Processor public interface This class encapsulates an XSLT Processor for use by ZopeXMLMethods. IXSLTProcessor is the Interface implemented by a processor library. Any library capable of processing XSLT can be used, as long as an adaptor class is written that conforms to this interface. cCsdS(s¨ Transforms the passed in XML into the required output (usually HTML) using the passed in XSLT. Both the XML and XSLT strings should be well-formed. Returns the output as a string. transformObject and REQUEST params may be used to acquire Zope content such as XSLT parameters and URN namespaces, if required. If anything goes wrong, it raises an Exception. N((RRt xsltStringtxsltURLttransformObjectt xsltParamstREQUEST((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyt transformhsN(RRR tNoneR(((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyR]s tIProcessorRegistrycBsAeZdd„Zd„Zd„Zd„Zd„Zd„ZRS(icCsdS(sf For a given processor type, indicate a preference for one processor over another. Set the 'exclusive' flag to indicate that no other choices should be offered, even if available. To change your preference, simply call this method again. Note: if the chosen processor is not available, this advice is simply ignored. Why? Imagine the case where you make a choice, then ZSync the object tree to another Zope instance in which this processor is not available! We must recover gracefully from this (rather likely) scenario. N((t processorTypet processorNamet exclusive((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pytpreferwscCsdS(s6register a processor with the given name and classnameN((RRtprocessorClassName((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pytregister…scCsdS(se Return list of currently available processors of the given type. If an exclusive preference has been expressed, *and* the preferred processor is available, return only that. Call reload() first to ensure we pick up new processor libraries if we just got ZSynced to another Zope instance. N((R((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pytnamesˆscCsdS(s³ Obtain the object encapsulating the named processor of the given type, if it is available. Otherwise, return the defaultItem() N((RR((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pytitem–scCsdS(s“ Obtain the object encapsulating the preferred processor of the given type, if it is available. Otherwise try all other processors in random order. Finally, give up if we don't have a single processor available. Call reload() first to ensure we pick up new processor libraries if we just got ZSynced to another Zope instance. N((R((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyt defaultItem scCsdS(sï Return the name of the default processor of the indicated type. If a preference was indicated and it is available, return it. Otherwise return the first one or None if there aren't any. N((R((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyt defaultName°s(RRR R"R#R$R%R&(((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyRus     N( R t __cvstag__t__date__t __version__tzope.interfaceRRRR RRR(((s:/srv/Zope/Products/ZopeXMLMethods/processors/interfaces.pyt s