f#]c@sdZddlZddlmZejeZdefdYZdZ dZ dZ dd l Tddl Zd efd YZd Zd ZdZeaied6ed6ed6ZegejeD]\ZZeef^qZdZddZeeZyeste ZWnnXe Z!defdYZ"e"Z#e a$ddZ%e a&ddZ'ea(ddZ)dZ*dZ+dZ,dS(sPyXB stands for Python U{W3C XML Schema} Bindings, and is pronounced "pixbee". It enables translation between XML instance documents and Python objects following rules specified by an XML Schema document. This is the top-level entrypoint to the PyXB system. Importing this gets you all the L{exceptions}, and L{pyxb.namespace}. For more functionality, delve into these submodules: - L{pyxb.xmlschema} Module holding the L{structures} that convert XMLSchema from a DOM model to a Python class model based on the XMLSchema components. Use this when you need to operate on the component model. - L{pyxb.binding} Module used to generate the bindings and at runtime to support the generated bindings. Use this if you need to use the binding model or content model. - L{pyxb.utils} Common utilities used in parsing, generating, and executing. The submodules must be imported separately. iN(tsixtcscRootcBseZdZdZRS(s@This little bundle of joy exists because in Python 2.6 it became an error to invoke C{object.__init__} with parameters (unless you also override C{__new__}, in which case it's only a warning. Whatever.). Since I'm bloody not going to check in every class whether C{super(Myclass,self)} refers to C{object} (even if I could figure out how to do that, 'cuz the obvious solutions don't work), we'll just make this thing the root of all U{cooperative super calling} hierarchies. The standard syntax in PyXB for this pattern is:: def method_csc (self, *args, **kw): self_fn = lambda *_args, **_kw: self super_fn = getattr(super(ThisClass, self), 'method_csc', self_fn) return super_fn(*args, **kw) cOs?t|jjdttfr;tt|j|ndS(Ni(t issubclasst __class__tmrotlisttdicttsuperRt__init__(tselftargstkw((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyR3s "(t__name__t __module__t__doc__R(((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyR!ss1.2.6shttp://pyxb.sourceforge.netsApache License 2.0(t*tBINDcBs,eZdZdZdZdZdZRS(sBundle data for automated binding generation. Instances of this class capture positional and keyword arguments that are used to create binding instances based on context. For example, if C{w} is an instance of a complex type whose C{option} element is declared to be an anonymous class with simple content of type integer and an attribute of C{units}, a correct assignment to that element could be achieved with:: w.option = BIND(54, units="m") cOs||_||_dS(ssCache parameters for subsequent binding creation. Invoke just as you would the factory for a binding class.N(t _BIND__argst _BIND__kw(R R R ((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyR]s cKs |j|j||j|S(sInvoke the given factory method. Position arguments to the factory are those cached in this instance. Keyword arguments are the ones on the command line, updated from the ones in this instance.(tupdateRR(R tfactoryR ((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pytcreateInstancecsN(R R RtNoneRRRR(((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyRNs   iiitminidomtsaxdomtsaxertPYXB_XML_STYLEcCs|dkrvddl}|jjt}|dkr?d}ntj|}|dkrvtd|tfqvntj|dkrtd|fn|adS(sSet the interface used to parse XML content. This can be invoked within code. The system default of L{XMLStyle_saxer} can also be overridden at runtime by setting the environment variable C{PYXB_XML_STYLE} to one of C{minidom}, C{saxdom}, or C{saxer}. @param style: One of L{XMLStyle_minidom}, L{XMLStyle_saxdom}, L{XMLStyle_saxer}. If not provided, the system default is used. iNRsBad value "%s" for %ssBad value %s for _SetXMLStyle( Rtostenvirontgett_XMLStyle_envvart _XMLStyleMapt PyXBExceptiont_XMLStyleMapReverset _XMLStyle(tstyleRt style_name((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt _SetXMLStyles     tValidationConfigcBseZdZeZdZdZeeZeZ dZ dZ ee Z dZ dZdZdZd Zd ZeZd Zd ZeeZeZd ZdZeeZeZdZdZeeZdZRS(sClass holding configuration related to validation. L{pyxb.GlobalValidationConfig} is available to influence validation in all contexts. Each binding class has a reference to an instance of this class, which can be inspected using L{pyxb.binding.basis._TypeBinding_mixin._GetValidationConfig} and changed using L{pyxb.binding.basis._TypeBinding_mixin._SetValidationConfig}. Each binding instance has a reference inherited from its class which can be inspected using L{pyxb.binding.basis._TypeBinding_mixin._validationConfig} and changed using L{pyxb.binding.basis._TypeBinding_mixin._setValidationConfig}. This allows fine control on a per class and per-instance basis. L{forBinding} replaces L{RequireValidWhenParsing}. L{forDocument} replaces L{RequireValidWhenGenerating}. L{contentInfluencesGeneration}, L{orphanElementInContent}, and L{invalidElementInContent} control how L{pyxb.binding.basis.complexTypeDefinition.orderedContent} affects generated documents. cCs|jS(sC{True} iff validation should be performed when manipulating a binding instance. This includes parsing a document or DOM tree, using a binding instance class constructor, or assigning to an element or attribute field of a binding instance.(t_ValidationConfig__forBinding(R ((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt_getForBindingscCs+t|tst|n||_|S(s^Configure whether validation should be performed when manipulating a binding instance.(t isinstancetboolt TypeErrorR'(R tvalue((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt_setForBindings cCs|jS(s C{True} iff validation should be performed when creating a document from a binding instance. This applies at invocation of L{toDOM()}. L{toxml()} invokes C{toDOM()}.(t_ValidationConfig__forDocument(R ((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt_getForDocumentscCs+t|tst|n||_|S(slConfigure whether validation should be performed when generating a document from a binding instance.(R)R*R+R.(R R,((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt_setForDocuments iiiiiicCs|jS(sDetermine whether complex type content influences element order in document generation. The value is one of L{ALWAYS}, L{NEVER}, L{MIXED_ONLY} (default).(t._ValidationConfig__contentInfluencesGeneration(R ((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt __getContentInfluencesGenerationscCs:||j|j|jfkr-t|n||_dS(s0Set the value of L{contentInfluencesGeneration}.N(tALWAYStNEVERt MIXED_ONLYt ValueErrorR1(R R,((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt_setContentInfluencesGeneration scCs|jS(s)How to handle unrecognized elements in content lists. This is used when consulting a complex type instance content list to influence the generation of documents from a binding instance. The value is one of L{IGNORE_ONCE} (default), L{GIVE_UP}, L{RAISE_EXCEPTION}.(t)_ValidationConfig__orphanElementInContent(R ((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt__getOrphanElementInContentscCs:||j|j|jfkr-t|n||_dS(s+Set the value of L{orphanElementInContent}.N(t IGNORE_ONCEtGIVE_UPtRAISE_EXCEPTIONR6R8(R R,((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt_setOrphanElementInContentscCs|jS(sHow to handle invalid elements in content lists. The value is one of L{IGNORE_ONCE} (default), L{GIVE_UP}, L{RAISE_EXCEPTION}.(t*_ValidationConfig__invalidElementInContent(R ((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt__getInvalidElementInContent$scCs:||j|j|jfkr-t|n||_dS(s,Set the value of L{invalidElementInContent}.N(R:R;R<R6R>(R R,((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyt_setInvalidElementInContent*scCsddl}|j|S(sMake a copy of this instance. Use this to get a starting point when you need to customize validation on a per-instance/per-class basis.iN(tcopy(R RA((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyRA1s ( R R RtTrueR'R(R-tpropertyt forBindingR.R/R0t forDocumentR3R4R:R;R<R5R1t1_ValidationConfig__getContentInfluencesGenerationR7tcontentInfluencesGenerationR8t,_ValidationConfig__getOrphanElementInContentR=torphanElementInContentR>t-_ValidationConfig__getInvalidElementInContentR@tinvalidElementInContentRA(((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyR&s8              cCs&|dkrtjStj|a|S(sQuery or set a flag that controls validation checking in XML generation. Normally any attempts to convert a binding instance to a DOM or XML representation requires that the binding validate against the content model, since only in this way can the content be generated in the correct order. In some cases it may be necessary or useful to generate a document from a binding that is incomplete. If validation is not required, the generated documents may not validate even if the content validates, because ordering constraints will be ignored. @keyword value: If absent or C{None}, no change is made; otherwise, this enables (C{True}) or disables (C{False}) the requirement that instances validate before being converted to XML. @type value: C{bool} @return: C{True} iff attempts to generate XML for a binding that does not validate should raise an exception. N(RtGlobalValidationConfigRER0t_GenerationRequiresValid(R,((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pytRequireValidWhenGenerating>s cCs&|dkrtjStj|atS(s9Query or set a flag that controls validation checking in XML parsing. Normally any attempts to convert XML to a binding instance to a binding instance requires that the document validate against the content model. In some cases it may be necessary or useful to process a document that is incomplete. If validation is not required, the generated documents may not validate even if the content validates, because ordering constraints will be ignored. @keyword value: If absent or C{None}, no change is made; otherwise, this enables (C{True}) or disables (C{False}) the requirement that documents validate when being converted to bindings. @type value: C{bool} @return: C{True} iff attempts to generate bindings for a document that does not validate should raise an exception.N(RRLRDR-t_ParsingRequiresValid(R,((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pytRequireValidWhenParsingXs cCs8|dkrtSt|ts.t|n|atS(sControl whether time values are converted to UTC during input. The U{specification } makes clear that timezoned times are in UTC and that times in other timezones are to be translated to UTC when converted from literal to value form. Provide an option to bypass this step, so the input timezone is preserved. @note: Naive processing of unnormalized times--i.e., ignoring the C{tzinfo} field--may result in errors.N(Rt_PreserveInputTimeZoneR)R*R+(R,((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pytPreserveInputTimeZoneps sutf-8cCs(ddl}|jjjj|jS(srReturn an iterator producing the non-element content of the provided instance. The catenated text of the non-element content of an instance can be obtained with:: text = six.u('').join(pyxb.NonElementContent(instance)) @param instance: An instance of L{pyxb.binding.basis.complexTypeDefinition}. @return: an iterator producing text values iN(tpyxb.binding.basistbindingtbasistNonElementContenttContentIteratortorderedContent(tinstancetpyxb((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pyRVs (-Rtloggingt pyxb.utilsRt getLoggerR t_logtobjectRt __version__t__url__t __license__tpyxb.exceptions_tpyxb.namespaceRZRtXMLStyle_minidomtXMLStyle_saxdomtXMLStyle_saxerR"RRt iteritemst_kt_vR!RRR%tFalset_OptimizationActivetAssertionErrorRBt_CorruptionDetectionEnabledR&RLRMRNRORPRQRRt_OutputEncodingt_InputEncodingRV(((sB/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/__init__.pytsN     4