e#]c@sdZddlZddlZddlmZddlZddlZeje Z ej j j dejfdYZdefdYZdejfd YZd ej j jejfd YZd ejfd YZddlmZddlmZddlmZddlmZddlmZddlmZejZdeejeej fdYZ!ddl"m#Z#ddl"m$Z$ddl"m%Z%ddl"m&Z&ddl"m'Z'ddl"m(Z(ddl"m)Z)ejj*e%j+deddS(sClasses and global objects related to U{XML Namespaces}. Since namespaces hold all referenceable objects, this module also defines the infrastructure for resolving named object references, such as schema components. iN(tsixt ExpandedNamecBseZdZdZdZdZdZdZdZ dZ dZ dZ dZ dZdZd Zd Zd Zd Zd ZdZdZdZRS(sRepresent an U{expanded name }, which pairs a namespace with a local name. Because a large number of local elements, and most attributes, have no namespace associated with them, this is optimized for representing names with an absent namespace. The hash and equality test methods are set so that a plain string is equivalent to a tuple of C{None} and that string. Note that absent namespaces can be represented in two ways: with a namespace of C{None} (the name "has no namespace"), and with a namespace that is an L{absent namespace } (the name "has an absent namespace"). Hash code calculations are done so that the two alternatives produce the same hash; however, comparison is done so that the two are distinguished. The latter is the intended behavior; the former should not be counted upon. This class allows direct lookup of the named object within a category by using the category name as an accessor function. That is, if the namespace of the expanded name C{en} has a category 'typeDefinition', then the following two expressions are equivalent:: en.typeDefinition() en.namespace().categoryMap('typeDefinition').get(en.localName()) This class descends from C{tuple} so that its values can be used as dictionary keys without concern for pointer equivalence. cCs|jS(s+The L{Namespace} part of the expanded name.(t_ExpandedName__namespace(tself((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt namespace>scCs|jS(sGReturn the URI of the namespace, or C{None} if the namespace is absent.(t_ExpandedName__namespaceURI(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt namespaceURICscCs|jS(s$The local part of the expanded name.(t_ExpandedName__localName(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt localNameHscCs|jjS(s0Pass model validation through to namespace part.(RtvalidateComponentModel(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR PscCs|j|jfS(sReturn a tuple consisting of the namespace URI and the local name. This presents the expanded name as base Python types for persistent storage. Be aware, though, that it will lose the association of the name with an absent namespace, if that matters to you.(RR(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyturiTupleTscsy|jdr%tt|j|S|j}|dkrDdS|j|j|j|j fdS(Nt__cSsdS(N(tNone(((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pytcscsS(N(((tcategory_value(sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR is( t startswithtsuperRt __getattr__RR R t categoryMaptgetR(Rtnametns((RsL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR]s   cCst|j|S(sReturn a new expanded name in the namespace of this name. @param local_name: The local name portion of an expanded name. @return: An instance of L{ExpandedName}. (RR(Rt local_name((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt createNamekscCsLt|tst|}n|jdkrH|j|j}n|S(sReturn the input name, except if the input name has no namespace, return a name that uses the namespace from this name with the local name from the input name. Use this when the XML document has an unqualified name and we're processing using an absent default namespace. @warning: Be careful when using a global name to adopt a name from a local element: if the local element (with no namespace) has the same localName as but is different from the global element (with a namespace), this will improperly provide a namespace when one should not be present. See the comments in L{pyxb.binding.basis.element.elementForName}. N(t isinstanceRRR RR(RR((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt adoptNamess cOs|jd}dt|kr3tjdndt|krWtjdndt|krx|\}}n dt|kst|d}d }t|tjrnt|t rdt|kr|\}}nt|t r|j }|j }nt|t jjr||jt jjjt jjjfkrgtjd|jfn|j}|j }ntjdt|f|d kr|d k r|jr|}qnt|tjrt|d t}nt|t r |j }n|d k r;t|t r;tjd n||_|jd k rh|jj|_n||_|jd k st|j|jf|_|j|jf|_tt |j ||d S( s Create an expanded name. Expected argument patterns are: - ( C{str} ) : the local name in an absent namespace - ( L{ExpandedName} ) : a copy of the given expanded name - ( C{xml.dom.Node} ) : The name extracted from node.namespaceURI and node.localName - ( C{str}, C{str} ) : the namespace URI and the local name - ( L{Namespace}, C{str} ) : the namespace and the local name - ( L{ExpandedName}, C{str}) : the namespace from the expanded name, and the local name Wherever C{str} occurs C{unicode} is also permitted. @keyword fallback_namespace: Optional Namespace instance to use if the namespace would otherwise be None. This is only used if it is an absent namespace. tfallback_namespaceis-Too few arguments to ExpandedName constructoris.Too many arguments to ExpandedName constructoris8Cannot create expanded name from non-element DOM node %ssUnrecognized argument type %stcreate_if_missingsFExpandedName must include a valid (perhaps absent) namespace, or None.N(!Rtlentpyxbt LogicErrortAssertionErrorR RRt string_typesttupleRRRtxmltdomtNodetnodeTypet ELEMENT_NODEtATTRIBUTE_NODERttypetisAbsentNamespacetNamespaceForURItTruet NamespaceRturiRRt_ExpandedName__expandedNamet_ExpandedName__uriTupleRt__init__(RtargstkwRRtln((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR0sP ! '      cCsB|jdk st|jdk r8d|j|jfS|jS(Ns{%s}%s(RR RRR(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt__str__scCs8|jdkr(t|jj|jStj|jS(N(RR R(Rt__hash__R!R.(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR5scCspt|tjr!d|f}nt|ts<|j}nt|dtrl|dj|df}n|S(Nii(RRR R R!R/R,R-(Rtother((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt__otherForCompares cCs8|dkrtSdtjjj|j|j|kS(Ni(R tFalseRtutilstutilitytIteratedCompareMixedR/t_ExpandedName__otherForCompare(RR6((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt__eq__s cCs8|dkrtSdtjjj|j|j|kS(Ni(R R8RR9R:R;R/R<(RR6((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt__lt__s cCs2|j|j|jr.|j|j|jSdS(sReturn the value of the attribute identified by this name in the given node. @return: An instance of C{xml.dom.Attr}, or C{None} if the node does not have an attribute with this name. N(thasAttributeNSRRtgetAttributeNSR (Rtdom_node((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt getAttributescCs"|j|jko!|j|jkS(sIReturn C{True} iff the dom node expanded name matches this expanded name.(RRRR(RRA((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt nodeMatchessN(t__name__t __module__t__doc__RR RRRRRR.R R RRRR0R4R5R<R=R>RBRC(((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyRs*        @     tNamedObjectMapcBs5eZdZdZdZdZdZdZRS(sAn extended dictionary intended to assist with QName resolution. These dictionaries have an attribute that identifies a category of named objects within a Namespace; the specifications for various documents require that certain groups of objects must be unique, while uniqueness is not required between groups. The dictionary also retains a pointer to the Namespace instance for which it holds objects.cCs|jS(s.The namespace to which the object map belongs.(t_NamedObjectMap__namespace(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyRscCs|jS(sCThe category of objects (e.g., typeDefinition, elementDeclaration).(t_NamedObjectMap__category(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pytcategoryscOs/||_||_tt|j||dS(N(RIRHRRGR0(RRJRR1R2((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR0s  N( RDRERFRR RHRJRIR0(((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyRGs   t_NamespaceCategory_mixincBseZdZdZdZdZdZdZdZ dZ dZ dZ d Z d Zd Zd Zd ZdZRS(sMix-in that aggregates those aspects of XMLNamespaces that hold references to categories of named objects. Arbitrary groups of named objects, each requiring unique names within themselves, can be saved. Unless configured otherwise, the Namespace instance is extended with accessors that provide direct access to individual category maps. The name of the method is the category name with a suffix of "s"; e.g., if a category "typeDefinition" exists, it can be accessed from the namespace using the syntax C{ns.typeDefinitions()}. Note that the returned value from the accessor is a live reference to the category map; changes made to the map are reflected in the namespace. cCs,ttt|ddi|_dS(s^CSC extension to reset fields of a Namespace. This one handles category-related data.t_resetc_sdS(N(R (R1R2((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR %sN(tgetattrRRKt%_NamespaceCategory_mixin__categoryMap(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyRL!scCst|jjS(s9The list of individual categories held in this namespace.(tlistRNtkeys(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt categories(scCs|jS(s6Return the whole map from categories to named objects.(RN(R((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt _categoryMap,scCsCy|j|SWn-tk r>tj|d||fnXdS(sHMap from local names to NamedObjectMap instances for the given category.s%s has no category %sN(RNtKeyErrorRtNamespaceError(RRJ((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR0s cCsDx=|jD]/}|d}t|||j|dq WdS(sDefine public methods on the Namespace which provide access to individual NamedObjectMaps based on their category. tscSs|S(N((t_map((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR >sN(RQtsetattrR(RRJt accessor_name((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt__defineCategoryAccessors7s cCsl|j|jdkr%i|_nx6|D].}||jkr,t|||j|} a namespace. Existing maps are not affected.N(t _activateRNR RGt1_NamespaceCategory_mixin__defineCategoryAccessors(RRQRJ((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pytconfigureCategories@s    cCsf|j|}|j|}|dk rX||krXtj|d|||fn|||<|S(sAllow access to the named_object by looking up the local_name in the given category. Raises pyxb.NamespaceUniquenessError if an object with the same name already exists in the category.s*%s: name %s used for multiple values in %sN(RRR RtNamespaceUniquenessError(RRJRt named_objecttname_mapt old_object((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pytaddCategoryObjectQs " cCs9|j|}||j|kr1|||} from names to objects, in separate categories. The default categories are configured externally; for example, the L{Schema} component defines a category for each named component in XMLSchema, and the customizing subclass for WSDL definitions adds categories for the service bindings, messages, etc. Namespaces can be written to and loaded from pickled files. See L{NamespaceArchive} for information. icCs.|dkrtjdn|jj|S(sIf a Namespace instance for the given URI exists, return it; otherwise return None. Note: Absent namespaces are not stored in the registry. If you use one (e.g., for a schema with no target namespace), don't lose hold of it.s!Absent namespaces are unlocatableN(R Rt UsageErrort_Namespace__RegistryR(tclsR-((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyt_NamespaceForURIs tabsentcCs|jdkru|jdkr\tjdtjjj|_||j |jj RDRERFR RRRRRRoRRR8RRRt_Namespace__namespaceArchiveRRt _Namespace__bindingConfigurationRRRt classmethodRRRRRRRR0RLR-RRR)RRRRRRRRRRRRRRRRRRR R R RRRR4(((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyR,As~     '                    (tXMLSchema_instance(t XMLNamespaces(t XMLSchema(tXHTML(tXML(t XMLSchema_hfp(RRR(,RFRtpyxb.utils.utilityt pyxb.utilsRtxml.domR"tloggingt getLoggerRDRR9R:tBackfillComparisonstcscRootRRmRGRKtPrivateTransient_mixinRRRRtpyxb.namespace.utilityRR*RRRRt_NamespaceResolution_mixint_NamespaceArchivable_mixinR,tpyxb.namespace.builtinRRRRRRRt_AddTargetNamespaceAttributeR(((sL/data/av2000/b2b/venv/lib/python2.7/site-packages/pyxb/namespace/__init__.pyts:    %1O %