o iW @sUddlZddlZddlmZddlmZddlmZmZm Z m Z m Z m Z m Z mZmZddlmZddlmZmZddlmZmZmZerQddlmZdd lmZd Zgd Zee Z!Gd d d e"Z#Gddde"Z$hdZ%e e"e&d<Gddde'Z(Gddde(dZ)Gddde#Z*e#dZ+erddl,m-Z-dZ.GdddZ/gdZ0e0dgZ1e0gd Z2gd!Z3d"e"d#e4fd$d%Z5e1fd&e"d'e e"d#ee"e"ffd(d)Z6d*e e"efd+e"d#e e"effd,d-Z7d.e e"efd*e e"efd+e"d#dfd/d0Z8d*e e"efd+e"d#e e"fd1d2Z9dd3l:m;Z;dd4lm?Z?dd6l@mAZAdd7lBmCZCdd8lDmEZEdd9lFmGZGdd:lHmIZIdd;lJmKZKddlPmQZQdd?lRmSZSdd@lTmUZUddAlVmWZWddBlXmYZYddClZm[Z[ddDl\m]Z]ddEl^m_Z_ddFl`maZaddGlbmcZcddHldmeZeddIlfmgZgddJlhmiZiddKljmkZkddLllmmZmddMlnmoZoddNlpmqZqeSe[e]eqe+dOZridPe;dQe=dRe?dSeCdTeEdUeGdVeAdWeIdXeKdYeMdZeOd[eQd\eUd]eWd^eYd_e_d`eaeceeegeiekemeodaZsdS)bN) lru_cache)Path) TYPE_CHECKINGAnyDictIterableListOptionalSetTupleUnion)category) urldefragurljoin)URIRefVariable _is_valid_uri)Graph)Storea =================== 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 >>> RDFS = Namespace("http://www.w3.org/1999/02/22-rdf-syntax-ns#") Fully qualified URIs in the namespace can be constructed either by attribute or by dictionary access on Namespace instances: .. code-block:: pycon >>> RDFS.seeAlso rdflib.term.URIRef('http://www.w3.org/1999/02/22-rdf-syntax-ns#seeAlso') >>> RDFS['seeAlso'] rdflib.term.URIRef('http://www.w3.org/1999/02/22-rdf-syntax-ns#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: * BRICK * CSVW * DC * DCAT * DCMITYPE * DCTERMS * DCAM * DOAP * FOAF * ODRL2 * ORG * OWL * PROF * PROV * QB * RDF * RDFS * SDO * SH * SKOS * SOSA * SSN * TIME * VANN * VOID * WGS * XSD .. code-block:: pycon >>> from rdflib.namespace import RDFS >>> RDFS.seeAlso rdflib.term.URIRef('http://www.w3.org/2000/01/rdf-schema#seeAlso') )" is_ncname split_uri NamespaceClosedNamespaceDefinedNamespaceNamespaceManagerBRICKCSVWDCDCAMDCATDCMITYPEDCTERMSDOAPFOAFGEOODRL2ORGOWLPROFPROVQBRDFRDFSSDOSHSKOSSOSASSNTIMEVANNVOIDWGSXSDcseZdZdZdeeefddfddZede fddZ dede fd d Z d ede fd d Z dede fddZ deffdd ZdedefddZZS)ra Utility class for quickly generating URIRefs with a common prefix >>> from rdflib.namespace import Namespace >>> n = Namespace("http://example.org/") >>> n.Person # as attribute rdflib.term.URIRef('http://example.org/Person') >>> n['first-name'] # as item - for things that are not valid python identifiers rdflib.term.URIRef('http://example.org/first-name') >>> n.Person in n True >>> n2 = Namespace("http://example2.org/") >>> n.Person in n2 False valuereturncCs6z t||}W|Styt||d}Y|SwNzutf-8)str__new__UnicodeDecodeErrorclsr7rtr@T/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/rdflib/namespace/__init__.pyr;s zNamespace.__new__cCs t|dS)Ntitlerselfr@r@rArBs zNamespace.titlenamecCst|t|tr |SdS)N)r isinstancer:rErFr@r@rAtermszNamespace.termkeycC ||SNrJrErKr@r@rA __getitem__ zNamespace.__getitem__cCs|drt||SN__) startswithAttributeErrorrJrIr@r@rA __getattr__s  zNamespace.__getattr__cdtdSNz Namespace()super__repr__rD __class__r@rAr\zNamespace.__repr__refcCs ||S)aAllows to check if a URI is within (starts with) this Namespace. >>> from rdflib import URIRef >>> namespace = Namespace('http://example.org/') >>> uri = URIRef('http://example.org/foo') >>> uri in namespace True >>> person_class = namespace['Person'] >>> person_class in namespace True >>> obj = URIRef('http://not.example.org/bar') >>> obj in namespace False rTrEr`r@r@rA __contains__s zNamespace.__contains__)__name__ __module__ __qualname____doc__r r:bytesr;propertyrrBrJrPrVr\boolrc __classcell__r@r@r]rArsrcsdeZdZdZdeeefddfddZdeffdd Z deffdd Z deffd d Z Z S) URIPatterna8 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('http://example.org/books/12345/resource') r7r8cCsHz t||}W|Sty#trt|tsJt||d}Y|Swr9)r:r;r<rrHrhr=r@r@rAr;s zURIPattern.__new__cttj|i|SrM)rr[__mod__rEargskwargsr]r@rArnzURIPattern.__mod__crmrM)rr[formatror]r@rArsrrzURIPattern.formatcrW)Nz URIPattern(rYrZrDr]r@rAr\r_zURIPattern.__repr__) rdrerfrgr r:rhr;rrnrsr\rkr@r@r]rArls   rl>_NS_fail_warn_extras_underscore_num_DFNS_RESERVED_ATTRScseZdZUdZeed<dZeed<dZeed<gZ e e ed<dZ eed<e d d d d e d effd d Zd e fddZd e fddZd e fddZde d efddZde d effdd Zd ee fddZde d efddZZS)!DefinedNamespaceMetaz>Utility metaclass for generating URIRefs with a common prefix.rtTrvFrurwrxN)maxsizerFr8cst|}|tvrtd|t|drt||S|js#|jrD||vrD|jr6td|d|jdt j d|d|j dd |j|S) Nz.DefinedNamespace like object has no attribute rSterm '' not in namespace ''zCode: z is not defined in namespace ) stacklevel) r:ryrUrTr[rPrvrurtwarningswarnrd)r>rFdefaultr]r@rArPs z DefinedNamespaceMeta.__getitem__cCrLrMrP)r>rFr@r@rArVrQz DefinedNamespaceMeta.__getattr__cCsdt|jdSrXr:rtr>r@r@rAr\ r_zDefinedNamespaceMeta.__repr__cC t|jSrMrrr@r@rA__str__rQzDefinedNamespaceMeta.__str__othercCrLrMr)r>rr@r@rA__add__rQzDefinedNamespaceMeta.__add__itemcs`t|drt|Stjr"ttjdtfddDS)zGDetermine whether a URI or an individual item belongs to this namespacerSNc3sP|]#}t|tr|jvp#|jvp#jo#ddko#ddVqdS)r_N) issubclassr__annotations__rwrxisdigit).0cr>item_strr@rA s   z4DefinedNamespaceMeta.__contains__..)r:rTr[rcrtlenanymro)r>rr]rrArcs  z!DefinedNamespaceMeta.__contains__cs0ddjD}|tfdd|D}|S)NcSsh|]}t|qSr@r:rxr@r@rA &sz/DefinedNamespaceMeta.__dir__..csh|]}t|qSr@rrrr@rAr)s)rdifference_updatery)r>attrsvaluesr@rrA__dir__%s zDefinedNamespaceMeta.__dir__pfxcCsF|t|ji}|jD]\}}t|tr|d|||<q d|iS)z=Returns this DefinedNamespace as a a JSON-LD 'context' object:z@context)r:rtritemsrr)rErtermsrKrJr@r@rAas_jsonld_context,s  z&DefinedNamespaceMeta.as_jsonld_contextrM)rdrerfrgrrrvrjrurwrr:rxrrrPrVr\rrrcrrdictrrkr@r@r]rArzs    rzc@seZdZdZddZdS)rz A Namespace with an enumerated list of members. Warnings are emitted if unknown members are referenced if _warn is True cCstd)Nz!namespace may not be instantiated) TypeErrorrDr@r@rA__init__<zDefinedNamespace.__init__N)rdrerfrgrr@r@r@rAr6s r) metaclasscseZdZUdZeeefed<dedeeffdd Z e defdd Z d edefd d Z d edefddZ d edefddZdefddZdeefddZdedefddZdeefddZZS)rzf A namespace with a closed list of members Trying to create terms not listed is an error _ClosedNamespace__urisurircs&t||fdd|D_S)Ncsi|] }|t|qSr@rC)rtr?r@rA Ksz+ClosedNamespace.__new__..)r[r;r)r>rrr]rrAr;IszClosedNamespace.__new__r8cCt|SrMrrDr@r@rArNzClosedNamespace.urirFcCs.|j|}|durtd|d|d|S)Nr|r}r~)rgetKeyError)rErFrr@r@rArJRs zClosedNamespace.termrKcCrLrMrNrOr@r@rArPXrQzClosedNamespace.__getitem__c Cs<|drtz||WSty}zt|d}~wwrR)rTrUrJr)rErFer@r@rArV[s  zClosedNamespace.__getattr__cCs |jd|jjdt|dS)N.(rY)rer^rdr:rDr@r@rAr\ds zClosedNamespace.__repr__cCrrM)listrrDr@r@rArgrQzClosedNamespace.__dir__r`cCs||jvSrM)rrrbr@r@rArcjs zClosedNamespace.__contains__cCrrM)dirrDr@r@rA_ipython_key_completions_orz)ClosedNamespace._ipython_key_completions_)rdrerfrgrr:rrrr;rirrJrPrVr\rrjrcrrkr@r@r]rAr@s  rz$http://www.w3.org/XML/1998/namespace)_NamespaceSetStringTc @sheZdZdZ d5   d6ddZd ed efd d Zd7ddZe d8ddZ ded efddZ d9deded efddZ ded efddZ ded efddZd9deded eeeeffdd Z d9deded eeeeffd!d"Zd#ed efd$d%Zd&ed'ed(ed d fd)d*Z  +d:d&eed'ed(ed,ed d f d-d.Zd eeeeffd/d0Zd;ded2ed efd3d4Zd S) namespace mappings This class requires an RDFlib Graph as an input parameter and may optionally have the parameter bind_namespaces set. This second parameter selects a strategy which is one of the following: * core: * binds several core RDF prefixes only * owl, rdf, rdfs, xsd, xml from the NAMESPACE_PREFIXES_CORE object * rdflib: * binds all the namespaces shipped with RDFLib as DefinedNamespace instances * all the core namespaces and all the following: brick, csvw, dc, dcat * dcmitype, dcterms, dcam, doap, foaf, geo, odrl, org, prof, prov, qb, schema * sh, skos, sosa, ssn, time, vann, void * see the NAMESPACE_PREFIXES_RDFLIB object for the up-to-date list * this is default * none: * binds no namespaces to prefixes * note this is NOT default behaviour * cc: * using prefix bindings from prefix.cc which is a online prefixes database * not implemented yet - this is aspirational .. attention:: The namespaces bound for specific values of ``bind_namespaces`` constitute part of RDFLib's public interface, so changes to them should only be additive within the same minor version. Removing values, or removing namespaces that are bound by default, constitutes a breaking change. See the Sample usage .. code-block:: pycon >>> import rdflib >>> from rdflib import Graph >>> from rdflib.namespace import Namespace, NamespaceManager >>> EX = Namespace('http://example.com/') >>> namespace_manager = NamespaceManager(Graph()) >>> namespace_manager.bind('ex', EX, 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 >>> rdflibgraphrbind_namespacesrcCs||_i|_i|_d|_i|_i|_|dkrdS|dkr.)r namespacesrbr@rrArcszNamespaceManager.__contains__NcCs8i|_i|_i|_|D] \}}t|jt|q dSrM)rrrr insert_trier:)rEpnr@r@rAresets zNamespaceManager.resetrcCs|jjSrM)rstorerDr@r@rArrzNamespaceManager.storercC*||\}}}|dkr|Sd||fSNrGr compute_qnamejoinrErr namespacerFr@r@rAqnamezNamespaceManager.qnameTgeneratecCs"|j||d\}}}d||fS)a From a URI, generate a valid CURIE. Result is guaranteed to contain a colon separating the prefix from the name, even if the prefix is an empty string. .. warning:: When ``generate`` is `True` (which is the default) and there is no matching namespace for the URI in the namespace manager then a new namespace will be added with prefix ``ns{index}``. Thus, when ``generate`` is `True`, this function is not a pure function because of this side-effect. This default behaviour is chosen so that this function operates similarly to `NamespaceManager.qname`. :param uri: URI to generate CURIE for. :param generate: Whether to add a prefix for the namespace if one doesn't already exist. Default: `True`. :return: CURIE for the URI. :raises KeyError: If generate is `False` and the namespace doesn't already have a prefix. )rrr)rErrrrrFr@r@rAcurieszNamespaceManager.curiecCrr)compute_qname_strictrrr@r@rA qname_strict rzNamespaceManager.qname_strictrdfTermcCszt|\}}||jvrt|j|jt|tt|}Wnty5t|tr/d|YSd|YSw|j |}|durIt|trId|S|durQd|S| |}d |d|dgS)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>Nrr) rr insert_strierr:r ExceptionrHrrrrr)rErrrFr qNamePartsr@r@rA normalizeUris"        zNamespaceManager.normalizeUric Cs@||jvrt|std|zt|\}}Wn"ty:}zt|}|j|}d}|s0|WYd}~nd}~ww||jvrHt |j|j ||j|rct |j||}|durc|}|t |d}t|}|j|}|dur|szt d|d} d|}|j|sn|d7}q}||||||f|j|<|j|S)NzY"{}" does not look like a valid URI, cannot serialize this. Did you want to urlencode it?rG)No known prefix for {} and generate=Falserns%s)rrrrsrrrrrrrget_longest_namespacerrrr) rErrrrFrr pl_namespacenumr@r@rAr*sT         zNamespaceManager.compute_qnamecCs|||\}}}tt|r|||fS||jvrxz t|t\}}Wnty2d|}t|w||jvr@t |j|j |t |}|j |}|durp|sWtd|d} d|}|j |sen|d7}qZ||||||f|j|<|j|S)Nz^This graph cannot be serialized to a strict format because there is no valid way to shorten {}rrr)rrr:rrNAME_START_CATEGORIESrrsrrrrrrrrr)rErrrrrFmessagerr@r@rArWsF         z%NamespaceManager.compute_qname_strictrcCst|turtdt|jd|dd}t|dkr!td|j|d}|dur9t t||dStd |ddd ) aw Expand a CURIE of the form , e.g. "rdf:type" into its full expression: >>> import rdflib >>> g = rdflib.Graph() >>> g.namespace_manager.expand_curie("rdf:type") rdflib.term.URIRef('http://www.w3.org/1999/02/22-rdf-syntax-ns#type') Raises exception if a namespace is not bound to the prefix. zArgument must be a string, not rrru@Malformed curie argument, format should be e.g. “foaf:name”.rNzPrefix "z" not bound to any namespace.) typer:rrdsplitrrrrr)rErpartsrr@r@rA expand_curies   zNamespaceManager.expand_curierroverridec Csts |j||Sz |jj|||dWStyD}z%dt|vr9tjdt|jdd|j||WYd}~SWYd}~dSd}~ww)Nrrz}caught a TypeError, retrying call to %s.bind without override, see https://github.com/RDFLib/rdflib/issues/1880 for more infoT)exc_info)_with_bind_override_fixrrrr:loggerwarningr)rErrrerrorr@r@rA _store_binds zNamespaceManager._store_bindFreplacec Cs<tt|}|dur d}nd|vrtd|j|}|r!t|}|rm||krm|r;|j|||dt|jt|dS|s?d}d} d||f}|j|}|rX|t|krXdS|j|s_n|d7}qB|j|||dn'|j|} | dur|j|||dn| |krn|s| d r|j|||dt|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 NrG z Prefixes may not contain spaces.rrrz%s%sr) rr:rrrrrrrrT) rErrrrbound_namespacer new_prefix tnamespace bound_prefixr@r@rArsD       zNamespaceManager.bindccs,|jD] \}}t|}||fVqdSrM)rrr)rErrr@r@rArs  zNamespaceManager.namespacesrdefragcCs`t}td||| d}|rt|d}|s,|r,|ddkr,|ddkr,d|}t|S)Nz%s/)allow_fragmentsrr#z%s#)rcwdas_urirrr)rErrbaseresultr@r@rA absolutizes  zNamespaceManager.absolutize)r)rrrr)r8N)r8r)T)TF)r)rdrerfrgrr:rjrcrrirrrrrr rrrrrr rrrrintrr@r@r@rAr{sT2 '  ".  < Cr)LlLuLoLtNlNd)McMeMnLmr)·u·-rr%rrYrFr8cCs`|r.|d}|dkst|tvr.tdt|D]}||}t|tvr+|tvr(qdSqdSdS)Nrrr)r rrangerNAME_CATEGORIESALLOWED_NAME_CHARS)rFfirstirr@r@rArAs rr split_startcCs|trt|tdfSt|}td|D]F}|| d}t|tvr]|tvr+qtd||D](}t|||vsB||dkrZ|d|}|sLn||d}||fSq2nqtd |)NrrrrzCan't split '{}') rTXMLNSrrrr rrrrs)rrlengthrrjrlnr@r@rArTs&     rtrier7cCs||vr||Sd}t|D]0}t|t|kr(||r(t|||S||r@|s5i||<d}||}||||<q||vrIi||<||S)zInsert 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)tuplekeysrrTrpop)r!r7 multi_checkrKdict_r@r@rArks$  rstriecCs||vr t||||<dSdSrM)r)r'r!r7r@r@rArsrcCs>|D]}||rt|||}|dur|S|SqdSrM)rTr)r!r7rKoutr@r@rArs r)r)r)r)r)r)r )r!)r")r#)r$)r%)r&)r')r()r))r*)r+)r,)r-)r.)r/)r0)r1)r2)r3)r4)r5)r6)owlrdfrdfsxsdxmlbrickcsvwdcdcatdcmitypedctermsdcamdoapfoafgeoodrlorgprofprovqbschemash)skossosassntimevannvoidwgs)tloggingr functoolsrpathlibrtypingrrrrrr r r r unicodedatar urllib.parserr rdflib.termrrr rdflib.graphr rdflib.storerrg__all__ getLoggerrdrr:rrlryrrrzrrrrdflib._type_checkingrrrrSPLIT_START_CATEGORIESrrr rrrrrrdflib.namespace._BRICKrrdflib.namespace._CSVWrrdflib.namespace._DCrrdflib.namespace._DCAMrrdflib.namespace._DCATrrdflib.namespace._DCMITYPEr rdflib.namespace._DCTERMSr!rdflib.namespace._DOAPr"rdflib.namespace._FOAFr#rdflib.namespace._GEOr$rdflib.namespace._ODRL2r%rdflib.namespace._ORGr&rdflib.namespace._OWLr'rdflib.namespace._PROFr(rdflib.namespace._PROVr)rdflib.namespace._QBr*rdflib.namespace._RDFr+rdflib.namespace._RDFSr,rdflib.namespace._SDOr-rdflib.namespace._SHr.rdflib.namespace._SKOSr/rdflib.namespace._SOSAr0rdflib.namespace._SSNr1rdflib.namespace._TIMEr2rdflib.namespace._VANNr3rdflib.namespace._VOIDr4rdflib.namespace._WGSr5rdflib.namespace._XSDr6rrr@r@r@rAs   ,   H %?# L 3 <        *"