3 d_R@sddlmZddlmZddlmZddlZddlZddlmZddlm Z ddlm Z ddl m Z dd l mZdd l mZdd lmZmZmZmZd Zd dddddddddddddddgZejeZGddde ZGddde ZGd ddeZGd!d"d"eZeZeed#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2gd3Z ed4Z!eeZ"ed5Z#ed6Z$ed7Z%ed8Z&ed9Z'eed:d;dd?d@dAdBdCdDdEdFdGdHdIdJdKdLdMd1dNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdig0d3Z(edjZ)edkZ*eedldmdnd;dodpdqdrdsdtdudvdwdxdydzddS))absolute_import)division)print_functionN)category) string_types) text_type) pathname2url) urldefrag)urljoin)URIRefVariable_XSD_PFX _is_valid_uria =================== Namespace Utilities =================== RDFLib provides mechanisms for managing Namespaces. In particular, there is a :class:`~rdflib.namespace.Namespace` class that takes as its argument the base URI of the namespace. .. code-block:: pycon >>> from rdflib.namespace import Namespace >>> owl = Namespace('http://www.w3.org/2002/07/owl#') Fully qualified URIs in the namespace can be constructed either by attribute or by dictionary access on Namespace instances: .. code-block:: pycon >>> owl.seeAlso rdflib.term.URIRef(u'http://www.w3.org/2002/07/owl#seeAlso') >>> owl['seeAlso'] rdflib.term.URIRef(u'http://www.w3.org/2002/07/owl#seeAlso') Automatic handling of unknown predicates ----------------------------------------- As a programming convenience, a namespace binding is automatically created when :class:`rdflib.term.URIRef` predicates are added to the graph. Importable namespaces ----------------------- The following namespaces are available by directly importing from rdflib: * RDF * RDFS * OWL * XSD * FOAF * SKOS * DOAP * DC * DCTERMS * VOID .. code-block:: pycon >>> from rdflib import OWL >>> OWL.seeAlso rdflib.term.URIRef(u'http://www.w3.org/2002/07/owl#seeAlso') is_ncname split_uri NamespaceClosedNamespaceNamespaceManagerXMLNSRDFRDFSXSDOWLSKOSDOAPFOAFDCDCTERMSVOIDc@sFeZdZdZddZeddZddZdd d Zd d Z d dZ dS)ra Utility class for quickly generating URIRefs with a common prefix >>> from rdflib import Namespace >>> n = Namespace("http://example.org/") >>> n.Person # as attribute rdflib.term.URIRef(u'http://example.org/Person') >>> n['first-name'] # as item - for things that are not valid python identifiers rdflib.term.URIRef(u'http://example.org/first-name') c Cs8ytj||}Wn"tk r2tj||d}YnX|S)Nzutf-8)r__new__UnicodeDecodeError)clsvaluertr$2/tmp/pip-build-7vycvbft/rdflib/rdflib/namespace.pyrbs zNamespace.__new__cCs t|dS)Ntitle)r )selfr$r$r%r&iszNamespace.titlecCst|t|tr|ndS)N)r isinstancer)r'namer$r$r%termmszNamespace.termNcCs |j|S)N)r+)r'keydefaultr$r$r% __getitem__qszNamespace.__getitem__cCs|jdrtn |j|SdS)N__) startswithAttributeErrorr+)r'r*r$r$r% __getattr__ts zNamespace.__getattr__cCs dt|S)Nz Namespace(%r))r)r'r$r$r%__repr__zszNamespace.__repr__)N) __name__ __module__ __qualname____doc__rpropertyr&r+r.r2r3r$r$r$r%rTs   c@s0eZdZdZddZddZddZdd Zd S) URIPatterna9 Utility class for creating URIs according to some pattern This supports either new style formatting with .format or old-style with % operator >>> u=URIPattern("http://example.org/%s/%d/resource") >>> u%('books', 12345) rdflib.term.URIRef(u'http://example.org/books/12345/resource') c Cs8ytj||}Wn"tk r2tj||d}YnX|S)Nzutf-8)rrr )r!r"r#r$r$r%rs zURIPattern.__new__cOstt|j||S)N)r r__mod__)r'argskwargsr$r$r%r:szURIPattern.__mod__cOsttj|f||S)N)r rformat)r'r;r<r$r$r%r=szURIPattern.formatcCs dt|S)NzURIPattern(%r))r)r'r$r$r%r3szURIPattern.__repr__N)r4r5r6r7rr:r=r3r$r$r$r%r9~s  r9c@sBeZdZdZddZddZdddZd d Zd d Zd dZ dS)rzf A namespace with a closed list of members Trying to create terms not listen is an error cCs2||_i|_x |D]}t|j||j|<qWdS)N)uri_ClosedNamespace__urisr )r'r>termstr$r$r%__init__s zClosedNamespace.__init__cCs0|jj|}|dkr(tdj||jn|SdS)Nzterm '{}' not in namespace '{}')r?getKeyErrorr=r>)r'r*r>r$r$r%r+s  zClosedNamespace.termNcCs |j|S)N)r+)r'r,r-r$r$r%r.szClosedNamespace.__getitem__cCsJ|jdrtn6y |j|Stk rD}zt|WYdd}~XnXdS)Nr/)r0r1r+rD)r'r*er$r$r%r2s   zClosedNamespace.__getattr__cCs t|jS)N)rr>)r'r$r$r%__str__szClosedNamespace.__str__cCsdt|jS)Nz!rdf.namespace.ClosedNamespace(%r))rr>)r'r$r$r%r3szClosedNamespace.__repr__)N) r4r5r6r7rBr+r.r2rFr3r$r$r$r%rs  cs,eZdZdZfddZfddZZS) _RDFNamespacez( Closed namespace for RDF terms c!sZtt|jtddddddddd d d d d ddddddddddddddddddd gd!dS)"Nz+http://www.w3.org/1999/02/22-rdf-syntax-ns#r DescriptionZIDZaboutZ parseTyperesourceliZnodeIDdatatypeZSeqZBagZAltZ StatementZPropertyListZ PlainLiteralsubject predicateobjecttyper"firstrestnilZ XMLLiteralZHTMLZ langStringZJSONZCompoundLiterallanguage direction)r@)superrGrBr )r') __class__r$r%rBs   z_RDFNamespace.__init__c s^|jdrNyt|dd}Wntk r2YnX|dkrNtd|j|fStt|j|S)N_rz%s_%s)r0int ValueErrorr r>rVrGr+)r'r*i)rWr$r%r+s z_RDFNamespace.term)r4r5r6r7rBr+ __classcell__r$r$)rWr%rGs rGz%http://www.w3.org/2000/01/rdf-schema#ResourceZClassZ subClassOfZ subPropertyOfcommentlabeldomainrangeZseeAlsoZ isDefinedByLiteral ContainerZContainerMembershipPropertymemberZDatatype)r>r@zhttp://www.w3.org/2002/07/owl#zhttp://www.w3.org/ns/csvw#z http://purl.org/dc/elements/1.1/zhttp://www.w3.org/ns/dcat#zhttp://purl.org/dc/terms/zhttp://usefulinc.com/ns/doap#zhttp://xmlns.com/foaf/0.1/ZAgentZPersonr*r&imgZ depictionZdepictsZ familyNameZ givenNameZknowsZ based_nearZageZmademakerZ primaryTopicZprimaryTopicOfZProjectZ OrganizationGroupDocumentZImageZnickZmboxhomepageZweblogZopenidZjabberIDZ mbox_sha1sumZinterestZtopic_interestZtopicpageZworkplaceHomepageZworkInfoHomepageZschoolHomepageZ publicationsZcurrentProjectZ pastProjectaccountZ OnlineAccountZ accountNameZaccountServiceHomepageZPersonalProfileDocumentZtipjarsha1Z thumbnailZlogozhttp://www.w3.org/ns/odrl/2/zhttp://www.w3.org/ns/org#zhttp://www.w3.org/ns/prov#EntityZActivityZwasGeneratedByZwasDerivedFromZwasAttributedToZ startedAtTimeusedZ wasInformedByZ endedAtTimeZwasAssociatedWithZactedOnBehalfOf CollectionZEmptyCollectionZBundleZ SoftwareAgentLocationZ alternateOfZspecializationOfZgeneratedAtTimeZhadPrimarySourcer"Z wasQuotedFromZ wasRevisionOfZinvalidatedAtTimeZwasInvalidatedByZ hadMemberZ wasStartedByZ wasEndedByZ invalidatedZ influencedZ atLocation generatedZ InfluenceZEntityInfluenceUsageZStartZEndZ DerivationZ PrimarySourceZ QuotationZRevisionZActivityInfluenceZ GenerationZ CommunicationZ InvalidationZAgentInfluenceZ AttributionZ AssociationZPlanZ DelegationZInstantaneousEventZRoleZwasInfluencedByZqualifiedInfluenceZqualifiedGenerationZqualifiedDerivationZqualifiedPrimarySourceZqualifiedQuotationZqualifiedRevisionZqualifiedAttributionZqualifiedInvalidationZqualifiedStartZqualifiedUsageZqualifiedCommunicationZqualifiedAssociationZ qualifiedEndZqualifiedDelegationZ influencerentityZhadUsageZ hadGenerationZactivityZagentZhadPlanZ hadActivityatTimeZhadRolezhttp://www.w3.org/ns/dx/prof/zhttps://schema.org/zhttp://www.w3.org/ns/shacl#z$http://www.w3.org/2004/02/skos/core#ZConceptZ ConceptSchemeZinSchemeZ hasTopConceptZ topConceptOfZaltLabelZ hiddenLabelZ prefLabelnotationZ changeNoteZ definitionZ editorialNoteZexampleZ historyNoteZnoteZ scopeNoteZbroaderZbroaderTransitiveZnarrowerZnarrowerTransitiverelatedZsemanticRelationZOrderedCollectionZ memberListZ broadMatchZ closeMatchZ exactMatchZmappingRelationZ narrowMatchZ relatedMatchzhttp://www.w3.org/ns/ssn/zhttp://www.w3.org/ns/sosa/zhttp://www.w3.org/2006/time#zhttp://rdfs.org/ns/void#c@sxeZdZdZddZddZddZeeZdd Z d d Z d d Z dddZ dddZ dddZddZdddZdS) rat Class for managing prefix => namespace mappings Sample usage from FuXi ... .. code-block:: python ruleStore = N3RuleStore(additionalBuiltins=additionalBuiltins) nsMgr = NamespaceManager(Graph(ruleStore)) ruleGraph = Graph(ruleStore,namespace_manager=nsMgr) and ... .. code-block:: pycon >>> import rdflib >>> from rdflib import Graph >>> from rdflib.namespace import Namespace, NamespaceManager >>> exNs = Namespace('http://example.com/') >>> namespace_manager = NamespaceManager(Graph()) >>> namespace_manager.bind('ex', exNs, override=False) >>> g = Graph() >>> g.namespace_manager = namespace_manager >>> all_ns = [n for n in g.namespace_manager.namespaces()] >>> assert ('ex', rdflib.term.URIRef('http://example.com/')) in all_ns >>> cCs~||_i|_i|_d|_i|_i|_x$|jD]\}}t|jt|q.W|j dd|j dt |j dt |j dt dS)Nxmlz$http://www.w3.org/XML/1998/namespacerdfZrdfsZxsd) graph_NamespaceManager__cache_NamespaceManager__cache_strictZ_NamespaceManager__log_NamespaceManager__strie_NamespaceManager__trie namespaces insert_triestrbindrrr)r'rzpnr$r$r%rBds   zNamespaceManager.__init__cCs<i|_i|_i|_x$|jD]\}}t|jt|qWdS)N)r{r}r~rrr)r'rrr$r$r%resetrs zNamespaceManager.resetcCs|jjS)N)rzstore)r'r$r$r%Z __get_storeyszNamespaceManager.__get_storecCs.|j|\}}}|dkr|Sdj||fSdS)Nr(:) compute_qnamejoin)r'r>prefix namespacer*r$r$r%qname}szNamespaceManager.qnamecCs.|j|\}}}|dkr|Sdj||fSdS)Nr(r)compute_qname_strictr)r'r>rrr*r$r$r% qname_strictszNamespaceManager.qname_strictc Csy:t|\}}||jkr,t|j|jt|tt|}Wn&t|trTd|Sd|SYnX|j j |}|dkrt|trd|S|dkrd|S|j |}dj |d|dgSdS)z Takes an RDF Term and 'normalizes' it into a QName (using the registered prefix) or (unlike compute_qname) the Notation 3 form for URIs: <...URI...> z?%sz<%s>NrrrY) rr} insert_strier~rr rr)r rrrr)r'ZrdfTermrr*rZ qNamePartsr$r$r% normalizeUris      zNamespaceManager.normalizeUriTc CsBt|stdj|||jkr8yt|\}}Wn>tk rp}z"t|}|jj|}|s`|WYdd}~XnX||jkrt |j|j ||j|rt |j||}|dk r|}|t |d}t|}|jj|}|dkr(|st dj|d}x$d|}|jj|sP|d7}qW|j|||||f|j|<|j|S)NzY"{}" does not look like a valid URI, cannot serialize this. Did you want to urlencode it?z)No known prefix for {} and generate=FalserYzns%s)rr[r=r{rr rrr}rr~get_longest_namespacelenrDrr) r'r>generaterr*rErZ pl_namespacenumr$r$r%rsB          zNamespaceManager.compute_qnamec Cs|j|\}}}tt|r&|||fS||jkryt|t\}}Wn4tk rx}zdj|}t|WYdd}~XnX||jkrt |j|j |t |}|j j |}|dkr|stdj|d}x"d|}|j j|sP|d7}qW|j|||||f|j|<|j|SdS)Nz^This graph cannot be serialized to a strict format because there is no valid way to shorten {}z)No known prefix for {} and generate=FalserYzns%s)rrrr|rNAME_START_CATEGORIESr[r=r}rr~r rrrDrr) r'r>rrrr*rEmessagerr$r$r%rs6          z%NamespaceManager.compute_qname_strictFc Cs(tt|}|dkrd}|jj|}|r0t|}|r||kr|rb|jj||t|jt|dS|sjd}d}xFd||f}|jj|}|r|t|krdS|jj|sP|d7}qpW|jj||nN|jj|} | dkr|jj||n*| |krn |s| j dr|jj||t|jt|dS)zbind a given namespace to the prefix if override, rebind, even if the given namespace is already bound to another prefix. if replace, replace any existing prefix with the new namespace Nr(r-rYz%s%srX) r rrrrrr~rrr0) r'rroverridereplaceZbound_namespacer new_prefixZ tnamespaceZ bound_prefixr$r$r%rs>        zNamespaceManager.bindccs.x(|jjD]\}}t|}||fVq WdS)N)rrr )r'rrr$r$r%r9szNamespaceManager.namespacesrYcCsftdttj}td||| d}|r6t|d}|s^|r^|ddkr^|d dkr^d|}t|S) Nzfile:z%s/)allow_fragmentsrrY#z%s#rr)r rosgetcwdr r )r'r>defragbaseresultr$r$r% absolutize>s zNamespaceManager.absolutizeN)T)T)TF)rY)r4r5r6r7rBrZ_NamespaceManager__get_storer8rrrrrrrrrr$r$r$r%rDs * 2 9ZLlZLuZLoLtZNlZNdZMcZMeZMnZLm·u·-.rXrcCsj|rf|d}|dks t|tkrfx@tdt|D].}||}t|tkr0|dkrZ|tkrZq0dSq0WdSdS)NrrXrYr)rrrbrNAME_CATEGORIESALLOWED_NAME_CHARS)r*rQr\cr$r$r%rws z$http://www.w3.org/XML/1998/namespacecCs|jtrt|jtdfSt|}xtd|D]}|| d}t|tkr0|tkrXq0xXtd||D]F}t|||ks||dkrh|d|}|sP||d}||fSqhWPq0Wtdj |dS)NrYrrXzCan't split '{}'r) r0rsplitrrbrrrr[r=)r>Z split_startlengthr\rjnslnr$r$r%rs"     cCs||kr||Sd}xlt|jD]\}t|t|krN|j|rNt|||S|j|r"|shi||<d}|j|}||||<q"W||kri||<||S)z Insert a value into the trie if it is not already contained in the trie. Return the subtree for the value regardless of whether it is a new value or not. FT)tuplekeysrr0rpop)trier"Z multi_checkr,Zdict_r$r$r%rs  rcCs||krt||||<dS)N)r)Zstrierr"r$r$r%rsrcCs:x4|D],}|j|rt|||}|dkr.|S|SqWdS)N)r0r)rr"r,outr$r$r%rs  r)? __future__rrrloggingr unicodedatarsixrrZsix.moves.urllib.requestrZsix.moves.urllib.parser r Z rdflib.termr r r rr7__all__ getLoggerr4loggerrr9rOrrGrrrrZCSVWrZDCATrrrZODRL2ZORGZPROVZPROFZSDOZSHrZSOSAZSSNZTIMErrrZSPLIT_START_CATEGORIESrrrrrrrrr$r$r$r%s         8  *).                              (