o miG @sUdZddlmZddlZddlZzddlmZWn ey9zddlmZWney6dtd d ZYnwYnwdd l m Z dd l m Z dd l mZmZmZmZmZmZmZmZmZddlmZddlmZmZddlmZmZmZerddl m!Z!ddl"m#Z#gdZ$e%e&Z'Gddde(Z)Gddde(Z*hdZ+de,d<ddhZ-de,d<Gddde.Z/Gd d!d!e/d"Z0Gd#d$d$e)Z1e)d%Z2erdd&l3m4Z4d'Z5Gd(d)d)Z6gd*Z7e7d+gZ8e7gd,Z9gd-Z:dud1d2Z;e8fdvd7d8ZdydCdDZ?ddEl@mAZAddFlBmCZCddGlDmEZEddHlFmGZGddIlHmIZIddJlJmKZKddKlLmMZMddLlNmOZOddMlPmQZQddNlRmSZSddOlTmUZUddPlVmWZWddQlXmYZYddRlZm[Z[ddSl\m]Z]ddTl^m_Z_ddUl`maZaddVlbmcZcddWldmeZeddXlfmgZgddYlhmiZiddZljmkZkdd[llmmZmdd\lnmoZodd]lpmqZqdd^lrmsZsdd_ltmuZudd`lvmwZweYeaecewe2daZxidbeAdceCddeEdeeIdfeKdgeMdheGdieOdjeQdkeSdleUdmeWdne[doe]dpe_dqeedregeiekemeoeqeseudsZydS)za # Namespace Utilities RDFLib provides mechanisms for managing Namespaces. In particular, there is a [`Namespace`][rdflib.namespace.Namespace] class that takes as its argument the base URI of the namespace. ```python >>> 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: ```python >>> 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 [`URIRef`][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 ```python >>> from rdflib.namespace import RDFS >>> RDFS.seeAlso rdflib.term.URIRef('http://www.w3.org/2000/01/rdf-schema#seeAlso') ``` ) annotationsN)get_annotationsthingAnyreturndictcCs|jSN)__annotations__)rr S/home/kim/smarthome/.venv/lib/python3.10/site-packages/rdflib/namespace/__init__.pyrWsr) lru_cache)Path) TYPE_CHECKINGrDictIterableListOptionalSetTupleUnion)category) urldefragurljoin)URIRefVariable _is_valid_uri)Graph)Store)" is_ncname split_uri NamespaceClosedNamespaceDefinedNamespaceNamespaceManagerBRICKCSVWDCDCAMDCATDCMITYPEDCTERMSDOAPFOAFGEOODRL2ORGOWLPROFPROVQBRDFRDFSSDOSHSKOSSOSASSNTIMEVANNVOIDWGSXSDcsbeZdZdZdddZeddd Zdd d ZdddZdddZ dfdd Z dddZ Z S)r a Utility class for quickly generating URIRefs with a common prefix. ```python >>> 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 ``` valueUnion[str, bytes]rcCs6z t||}W|Styt||d}Y|SwNzutf-8)str__new__UnicodeDecodeErrorclsr@rtr r r rDs zNamespace.__new__rcCs t|dS)Ntitlerselfr r r rIs zNamespace.titlenamerCcCst|t|tr |SdS)N)r isinstancerCrLrMr r r termszNamespace.termkeycC ||SrrQrLrRr r r __getitem__ zNamespace.__getitem__cCs|drt||SN__) startswithAttributeErrorrQrPr r r __getattr__s  zNamespace.__getattr__cdtdS)N Namespace()super__repr__rK __class__r r rbzNamespace.__repr__refboolcCs ||S)aAllows to check if a URI is within (starts with) this Namespace. ```python >>> 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 ``` rZrLrfr r r __contains__s zNamespace.__contains__)r@rArr rrrMrCrrrRrCrrrrCrfrCrrg) __name__ __module__ __qualname____doc__rDpropertyrIrQrVr\rbrj __classcell__r r rcr r s     r csHeZdZdZdddZdfdd Zdfd d Zdfd d ZZS) URIPatternaLUtility class for creating URIs according to some pattern. This supports either new style formatting with .format or old-style with % operator. ```python >>> u=URIPattern("http://example.org/%s/%d/resource") >>> u%('books', 12345) rdflib.term.URIRef('http://example.org/books/12345/resource') ``` r@rArcCsHz t||}W|Sty#trt|tsJt||d}Y|SwrB)rCrDrErrObytesrFr r r rDs zURIPattern.__new__rcttj|i|Sr)rra__mod__rLargskwargsrcr r ryzURIPattern.__mod__crxr)rraformatrzrcr r r~r}zURIPattern.formatrCcr])Nz URIPattern(r_r`rKrcr r rbrezURIPattern.__repr__)r@rArrvrkrn) rprqrrrsrDryr~rbrur r rcr rvs   rv> __slots___extras_fail_underscore_num_warn_NSzSet[str]_DFNS_RESERVED_ATTRSZ_pytestfixturefunction_partialmethod_IGNORED_ATTR_LOOKUPcseZdZUdZeZded<ded<dZded<d Zded <gZ d ed <d Z ded <e ddd)d*ddZ d+fdd Z d,ddZd,ddZd-ddZd.d d!Zd/d#d$Zd0d'd(ZZS)1DefinedNamespaceMetaz>Utility metaclass for generating URIRefs with a common prefix.Tuple[str, ...]rr rTrgrFr List[str]rrN)maxsizerMrCrrcCst|}|tvrtd||tvrt|js|jr=||vr=|jr/td|d|jdtj d|d|j dd|j|S) Nz6DefinedNamespace like object has no access item named term '' not in namespace ''zCode: z is not defined in namespace ) stacklevel) rCrKeyErrorrrrr[rwarningswarnrp)rGrMdefaultr r r rVs z DefinedNamespaceMeta.__getitem__csH|tvrt|tvrtd||drtt||S||S)Nz.DefinedNamespace like object has no attribute rY)rr[rrZrar__getattribute__rV)rGrMrcr r r\)s  z DefinedNamespaceMeta.__getattr__cCs2zt|j}Wn tyd}Ynwd|dS)Nr^r_)reprrr[)rGZns_reprr r r rb4s   zDefinedNamespaceMeta.__repr__cCs"zt|jWStyYdSw)Nr)rCrr[rGr r r __str__;s   zDefinedNamespaceMeta.__str__othercCrSr)rV)rGrr r r __add__ArWzDefinedNamespaceMeta.__add__itemcsfzj}Wn tyYdSwt|t|r%tt|dtfddDS)zGDetermine whether a URI or an individual item belongs to this namespaceFNc3sR|]$}t|trt|vp$|jvp$jo$ddko$ddVqdS)r_N) issubclassr"rrrisdigit).0crGZitem_strr r Ms   z4DefinedNamespaceMeta.__contains__..)rr[rCrZlenanymro)rGrZthis_nsr rr rjDs  z!DefinedNamespaceMeta.__contains__ Iterable[str]cs2ddtD}|tfdd|D}|S)NcSsh|]}t|qSr rCrxr r r Vsz/DefinedNamespaceMeta.__dir__..csh|]}t|qSr rrrr r rYs)rdifference_updater)rGattrsvaluesr rr __dir__Us zDefinedNamespaceMeta.__dir__pfxrcCsH|t|ji}t|D]\}}t|tr|d|||<q d|iS)z;Returns this DefinedNamespace as a JSON-LD 'context' object:z@context)rCrritemsrr)rLrtermsrRrQr r r as_jsonld_context\s  z&DefinedNamespaceMeta.as_jsonld_contextrrl)rMrCrn)rrCrr)rrCrrg)rr)rrCrr)rprqrrrstuplerr rrrrr rVr\rbrrrjrrrur r rcr r s"         rc@s(eZdZUdZeZded<ddZdS)r"zA Namespace with an enumerated list of members. Warnings are emitted if unknown members are referenced if _warn is True. rrcCstd)Nz!namespace may not be instantiated) TypeErrorrKr r r __init__nzDefinedNamespace.__init__N)rprqrrrsrrr rr r r r r"fs  r") metaclasscseZdZUdZded<d fdd Zed!d d Zd"ddZd#ddZ d"ddZ d!ddZ d$ddZ d%ddZ d$ddZZS)&r!zf A namespace with a closed list of members Trying to create terms not listed is an error zDict[str, URIRef]_ClosedNamespace__urisurirCrrcs&t||fdd|D_S)Ncsi|] }|t|qSr rJ)rtrHr r }sz+ClosedNamespace.__new__..)rarDr)rGrrrcrr rD{szClosedNamespace.__new__rcCt|SrrrKr r r rzClosedNamespace.urirMrcCs.|j|}|durtd|d|d|S)Nrrr)rgetr)rLrMrr r r rQs zClosedNamespace.termrRcCrSrrTrUr r r rVrWzClosedNamespace.__getitem__c Cs<|drtz||WSty}zt|d}~wwrX)rZr[rQr)rLrMer r r r\s  zClosedNamespace.__getattr__cCs |jd|jjdt|dS)N.(r_)rqrdrprCrKr r r rbs zClosedNamespace.__repr__cCs t|jSr)listrrKr r r rrWzClosedNamespace.__dir__rfrgcCs||jvSr)rrrir r r rjs zClosedNamespace.__contains__cCrr)dirrKr r r _ipython_key_completions_rz)ClosedNamespace._ipython_key_completions_)rrCrrrnrlrm)rrro)rprqrrrsr rDrtrrQrVr\rbrrjrrur r rcr r!rs       r!z$http://www.w3.org/XML/1998/namespace)_NamespaceSetStringTc@seZdZdZd?d@ddZdAd dZdBddZedCddZdDddZ dEdFddZ dDddZ dGdd Z dEdHd"d#Z dEdId%d&ZdJd)d*ZdKd.d/Z  0dLdMd4d5ZdNd7d8ZdOdPdS)Qr#aClass for managing prefix => 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 !!! warning "Breaking changes" 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 ```python >>> 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 namespacesrir rr rjszNamespaceManager.__contains__NonecCs8i|_i|_i|_|D] \}}t|jt|q dSr)rrrr insert_trierC)rLpnr r r reset s zNamespaceManager.resetrcCs|jjSr)rstorerKr r r rrzNamespaceManager.storercC*||\}}}|dkr|Sd||fSNrNr compute_qnamejoinrLrr namespacerMr r r qnamezNamespaceManager.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 "Side-effect" 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`. Args: uri: URI to generate CURIE for. generate: Whether to add a prefix for the namespace if one doesn't already exist. Default: `True`. Returns: CURIE for the URI Raises: KeyError: If generate is `False` and the namespace doesn't already have a prefix. )rrr)rLrrrrrMr r r curieszNamespaceManager.curiecCrr)compute_qname_strictrrr r r 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_strierrCr ExceptionrOrrrrr)rLrrrMrZ qNamePartsr r r normalizeUriDs"        zNamespaceManager.normalizeUriTuple[str, URIRef, str]c 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?rN)No known prefix for {} and generate=Falserns%s)rrrr~rrrrrrrget_longest_namespacerrrr) rLrrrrMrrZ pl_namespacenumr r r r]sT         zNamespaceManager.compute_qnameTuple[str, str, str]cCs|||\}}}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)rrrCrrNAME_START_CATEGORIESrr~rrrrrrrrr)rLrrrrrMmessagerr r r rsF         z%NamespaceManager.compute_qname_strictrrcCst|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.) typerCrrpsplitrrrrr)rLrpartsrr r r 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_fixrrrrCloggerdebugr)rLrrrerrorr r r _store_binds zNamespaceManager._store_bindF Optional[str]rreplacec 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 NrN z Prefixes may not contain spaces.rrrz%s%sr) rrCrrrr rrrrZ) rLrrrr Zbound_namespacer new_prefixZ tnamespaceZ bound_prefixr r r rsD       zNamespaceManager.bindIterable[Tuple[str, URIRef]]ccs,|jD] \}}t|}||fVqdSr)rrr)rLrrr r r r4s  zNamespaceManager.namespacesrdefragintcCs`t}td||| d}|rt|d}|s,|r,|ddkr,|ddkr,d|}t|S)Nz%s/)allow_fragmentsrr#z%s#)r cwdas_urirrr)rLrrbaseresultr r r absolutize9s  zNamespaceManager.absolutizeN)r)rrrrro)rr)rr)rrCrrC)T)rrCrrgrrC)rrCrrC)rrCrrgrr)rrCrrgrr)rrCrr)rrCrrrrgrr)TF) rr rrrrgr rgrr)rr)r)rrCrrrr)rprqrrrsrrjrrtrrrrrrrrr rrrr r r r r#s* 0 %     !  . <  Br#)ZLlZLuZLoLtZNlNd)ZMcZMeZMnZLmr)·u·-rr%rr_rMrCrcCs`|r.|d}|dkst|tvr.tdt|D]}||}t|tvr+|tvr(qdSqdSdS)Nrrr)rrrangerNAME_CATEGORIESALLOWED_NAME_CHARS)rMfirstirr r r rss rr split_startrTuple[str, str]cCs|trt|tdfSt|}td|D]F}|| d}t|tvr]|tvr+qtd||D](}t|||vsB||dkrZ|d|}|sLn||d}||fSq2nqtd |)NrrrrzCan't split '{}') rZXMLNSrrrrrrrr~)rr"lengthr!rjrlnr r r rs&     rtrieDict[str, Any]r@cCs||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)rkeysrrZrpop)r(r@Z multi_checkrRZdict_r r r rs$  rstriercCs||vr t||||<dSdSr)r)r,r(r@r r r rsrr cCs>|D]}||rt|||}|dur|S|SqdSr)rZr)r(r@rRoutr r r rs r)r$)r%)r&)r')r()r))r*)r+)r,)r-)r.)r/)r0)r1)r2)r3)r4)r5)r6)r7)r8)r9)r:)r;)r<)r=)r>)r?)owlZrdfZrdfsZxsdxmlbrickZcsvwZdcZdcatZdcmitypeZdctermsZdcamZdoapZfoafZgeoZodrlorgZprofZprovZqbZschemash)ZskosZsosaZssntimeZvannvoidZwgs)rrrr)rMrCrr)rrCr"rrr#)r(r)r@rCrr))r,r)r(r)r@rCrr)r(r)r@rCrr )zrs __future__rloggingrZ annotationlibr ImportErrorinspect functoolsr pathlibr typingrrrrrrrrr unicodedatar urllib.parserrZ rdflib.termrrrZ rdflib.graphrZ rdflib.storer__all__ getLoggerrprrCr rvrr rrrr"r!r$Zrdflib._type_checkingrrr#rZSPLIT_START_CATEGORIESrrrrrrrZrdflib.namespace._BRICKr$Zrdflib.namespace._CSVWr%Zrdflib.namespace._DCr&Zrdflib.namespace._DCAMr'Zrdflib.namespace._DCATr(Zrdflib.namespace._DCMITYPEr)Zrdflib.namespace._DCTERMSr*Zrdflib.namespace._DOAPr+Zrdflib.namespace._FOAFr,Zrdflib.namespace._GEOr-Zrdflib.namespace._ODRL2r.Zrdflib.namespace._ORGr/Zrdflib.namespace._OWLr0Zrdflib.namespace._PROFr1Zrdflib.namespace._PROVr2Zrdflib.namespace._QBr3Zrdflib.namespace._RDFr4Zrdflib.namespace._RDFSr5Zrdflib.namespace._SDOr6Zrdflib.namespace._SHr7Zrdflib.namespace._SKOSr8Zrdflib.namespace._SOSAr9Zrdflib.namespace._SSNr:Zrdflib.namespace._TIMEr;Zrdflib.namespace._VANNr<Zrdflib.namespace._VOIDr=Zrdflib.namespace._WGSr>Zrdflib.namespace._XSDr?rrr r r r s F   ,    %D%  \ 3 <