i LUdZddlmZddlZddlZ ddlmZddl m Z ddl m Z ddl mZmZmZmZmZmZmZmZmZdd lmZdd lmZmZdd lmZmZmZer dd l m!Z!dd l"m#Z#gdZ$ejJe&Z'Gdde(Z)Gdde(Z*hdZ+de,d<ddhZ-de,d<Gdde.Z/Gdde/Z0Gdde)Z1e)d Z2erdd!l3m4Z4d"Z5Gd#d$Z6gd%Z7e7d&gzZ8e7gd'zZ9gd(Z:d^d)Z;e8f d_d*Z< d`d+Z=dad,Z>dbd-Z?dd.l@mAZAdd/lBmCZCdd0lDmEZEdd1lFmGZGdd2lHmIZIdd3lJmKZKdd4lLmMZMdd5lNmOZOdd6lPmQZQdd7lRmSZSdd8lTmUZUdd9lVmWZWdd:lXmYZYdd;lZm[Z[ddl`maZadd?lbmcZcdd@ldmeZeddAlfmgZgddBlhmiZiddCljmkZkddDllmmZmddElnmoZoddFlpmqZqddGlrmsZsddHltmuZuddIlvmwZweYeaecewe2dJZxidKeAdLeCdMeEdNeIdOeKdPeMdQeGdReOdSeQdTeSdUeUdVeWdWe[dXe]dYe_dZeed[egeiekemeoeqeseud\Zyy#e$r ddlmZn#e$rd]dZYnwxYwY wxYw)ca =================== 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') ) annotationsN)get_annotationsc|jSN)__annotations__)things HC:\Projects\mas-dev\.venv\Lib\site-packages\rdflib/namespace/__init__.pyrrYs(( () lru_cache)Path) TYPE_CHECKINGAnyDictIterableListOptionalSetTupleUnion)category) urldefragurljoin)URIRefVariable _is_valid_uri)Graph)Store)" is_ncname split_uri NamespaceClosedNamespaceDefinedNamespaceNamespaceManagerBRICKCSVWDCDCAMDCATDCMITYPEDCTERMSDOAPFOAFGEOODRL2ORGOWLPROFPROVQBRDFRDFSSDOSHSKOSSOSASSNTIMEVANNVOIDWGSXSDc^eZdZdZd dZed dZd dZd dZd dZ d fd Z ddZ xZ S)r a 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 c tj||}|S#t$rtj||d}Y|SwxYwNzutf-8)str__new__UnicodeDecodeErrorclsvaluerts r rDzNamespace.__new__sF 2S%(B " 2S%1B  2s  >>ct|dzS)Ntitle)rselfs r rKzNamespace.titlesdWn%%r cNt|t|tr|zSdzS)N)r isinstancerCrMnames r termzNamespace.terms&djs&;dDEEDEEr c$|j|SrrSrMkeys r __getitem__zNamespace.__getitem__yy~r cR|jdrt|j|SN__) startswithAttributeErrorrSrQs r __getattr__zNamespace.__getattr__s" ??4  yyr c(dt|dS)N Namespace()super__repr__rM __class__s r rezNamespace.__repr__sEG,./q11r c$|j|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 r]rMrefs r __contains__zNamespace.__contains__s~~d##r )rHUnion[str, bytes]returnr rnrrRrCrnrrWrCrnrrnrCrkrCrnbool) __name__ __module__ __qualname____doc__rDpropertyrKrSrXr_rerl __classcell__rgs@r r r s; &&F 2$r r cDeZdZdZddZdfd Zdfd Zdfd ZxZS) 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') c tj||}|S#t$r3trt |t sJtj||d}Y|SwxYwrB)rCrDrEr rPbytesrFs r rDzURIPattern.__new__sY 2S%(B  " 2!%///S%1B  2s8AAc4tt||i|Sr)rrd__mod__rMargskwargsrgs r rzURIPattern.__mod__segot6v677r c4tt||i|Sr)rrdformatrs r rzURIPattern.formatsegnd5f566r c(dt|dS)Nz URIPattern(rbrcrfs r rezURIPattern.__repr__sUW-/022r )rHrmrnr}rorr) rurvrwrxrDrrrerzr{s@r r}r}s! 8733r r}>_NS_fail_warn_extras __slots___underscore_numzSet[str]_DFNS_RESERVED_ATTRS_pytestfixturefunction_partialmethod_IGNORED_ATTR_LOOKUPceZdZUdZeZded<ded<dZded<d Zded <gZ d ed <d Z ded <e ddddZ dfd Z ddZddZddZddZddZddZxZS) DefinedNamespaceMetaz>Utility metaclass for generating URIRefs with a common prefix.Tuple[str, ...]rr rTrtrFr List[str]rrN)maxsizec\t|}|tvrtd||tvr t|js |j rS||vrO|j rt d|d|jdtjd|d|jd|j|S) Nz6DefinedNamespace like object has no access item named term '' not in namespace ''zCode: z is not defined in namespace ) stacklevel) rCrKeyErrorrrrr^rwarningswarnru)rGrRdefaults r rXz DefinedNamespaceMeta.__getitem__s4y ' 'HQ ) )*  IICyy$vdV3GyPQ%RSS TF"? ~N wwt}r c|tvr t|tvrtd||jdrtt ||S|j|S)Nz.DefinedNamespace like object has no attribute r\)rr^rr]rdr__getattribute__rX)rGrRrgs r r_z DefinedNamespaceMeta.__getattr__$se ' ' " " ) ) @I __T "-sDTJ Jt$$r c\ t|j}d|dS#t$rd}YwxYw)Nrarb)reprrr^)rGns_reprs r rezDefinedNamespaceMeta.__repr__/s; +377mGG9A&& +*G +s  ++cL t|jS#t$rYywxYw)Nr)rCrr^)rGs r __str__zDefinedNamespaceMeta.__str__6s' (sww<  (' (s  ##c$|j|Sr)rX)rGothers r __add__zDefinedNamespaceMeta.__add__<su%%r c j}t|jt|rt t|dt fdj DS#t$rYywxYw)zGDetermine whether a URI or an individual item belongs to this namespaceFNc3K|]^}t|trLt|vxs;|jvxs+jxrddk(xrddj `yw)r_N) issubclassr"rrrisdigit).0crGitem_strs r z4DefinedNamespaceMeta.__contains__..Hs{ !-. * * W199$ W##U s(:Ux|?S?S?U WsA$A')rr^rCr]lenanymro)rGitemthis_nsrs` @r rlz!DefinedNamespaceMeta.__contains__?sz ggGt9   s7| ,CL 1 34H WWY      s A// A;:A;ct|Dchc] }t|}}|jt|Dchc]}|t|}}|Scc}wcc}wr)rrCdifference_updater)rGxattrsvaluess r __dir__zDefinedNamespaceMeta.__dir__Ps[!0!56!5AQ!56  45',-u!#c!f+u- 7.s AAc|t|ji}t|jD] \}}t |t s|d|||<"d|iS)z;Returns this DefinedNamespace as a JSON-LD 'context' object:z@context)rCrritemsrr)rMpfxtermsrWrSs r as_jsonld_contextz&DefinedNamespaceMeta.as_jsonld_contextWsZc$((m$(.446IC$' #uAcU^c 7E""r rrp)rRrCrr)rrCrnr)rrCrnrt)rnz Iterable[str])rrCrndict)rurvrwrxtuplerrrrrrr rXr_rerrrlrrrzr{s@r rrsyH!&I( NE4E4GY!OT!t& %'( & "#r rc0eZdZUdZeZded<dZy)r"z A Namespace with an enumerated list of members. Warnings are emitted if unknown members are referenced if _warn is True rrctd)Nz!namespace may not be instantiated) TypeErrorrLs r __init__zDefinedNamespace.__init__is;<Acf|jd|jjdt|dS)N.(rb)rvrgrurCrLs r rezClosedNamespace.__repr__s///"!DNN$;$;# 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 >>> c||_i|_i|_d|_i|_i|_|dk(ry|dk(r]t jD]\}}|j||tjD]\}}|j||y|dk(r td|dk(r/tjD]\}}|j||ytd|)NnonerdflibcczHaven't got to this option yetcorezunsupported namespace set ) graph_NamespaceManager__cache_NamespaceManager__cache_strict_NamespaceManager__log_NamespaceManager__strie_NamespaceManager__trie_NAMESPACE_PREFIXES_RDFLIBrbind_NAMESPACE_PREFIXES_CORENotImplementedError ValueError)rMrbind_namespacesprefixnss r rzNamespaceManager.__init__s ;= BD ') &(  f $   (8>>@  &"%A7<<>  &"%?  $ &&FG G  &6<<>  &"%?9/9JKL Lr cHtfd|jDS)Nc3FK|]\}}j|ywrri)rrrrks r rz0NamespaceManager.__contains__..s!J8I*&"3>>"%8Is!)r namespacesrjs `r rlzNamespaceManager.__contains__s J8IJJJr ci|_i|_i|_|jD]$\}}t |jt |&yr)rrrr insert_trierC)rMpns r resetzNamespaceManager.resets>   OO%DAq  SV ,&r c.|jjSr)rstorerLs r rzNamespaceManager.store szzr c`|j|\}}}|dk(r|Sdj||fSNrOr compute_qnamejoinrMrr namespacerRs r qnamezNamespaceManager.qnames8"&"4"4S"9 4 R<K88VTN+ +r cV|j||\}}}dj||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. )generaterr)rMrr rrrRs r curiezNamespaceManager.curies34#'"4"4S8"4"L 4xx''r c`|j|\}}}|dk(r|Sdj||fSr)compute_qname_strictrrs r qname_strictzNamespaceManager.qname_strict5s8"&";";C"@ 4 R<K88VTN+ +r c t|\}}||jvr*t|j|jt |t t |}|jj|}|t|trd|zS|d|zS|j|}dj|d|dgS#t $rt|trd|zcYSd|zcYSwxYw)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>rr) rr insert_strierrCr ExceptionrPrrrrr)rMrdfTermrrRr qNamePartss r normalizeUrizNamespaceManager.normalizeUri<s ('0OIt ,T\\4;;IGs9~.I ""9- >j(;7? " ^G# #++G4J88Z]JrN;< < ('8,w&''  (sAB??C'C'&C'c"||jvr/t|stdj| t |\}}||jvr!t|j|j||j|r+t|j||}||}|t|d}t |}|j j|}|X|stdj|d} d|z}|j j|sn|dz }'|j|||||f|j|<|j|S#t$r7}t |}|j j|}d}|s|Yd}~Ed}~wwxYw)NzY"{}" does not look like a valid URI, cannot serialize this. Did you want to urlencode it?rO)No known prefix for {} and generate=Falserns%s)rrrrrrrrrrrget_longest_namespacerrrr) rMrr rrRrr pl_namespacenums r rzNamespaceManager.compute_qnameUs dll " % ovv  "+C. 4 ,T\\4;; B||I&4T\\)5LcR + ,Is9~/0Dy)IZZ&&y1F~"CJJ9U#c\F:://71HC   &),!'D 9DLL ||C  ? "3K **95G  sE F,F  Fc|j||\}}}tt|r|||fS||jvr t |t \}}||jvr!t|j|j|t|}|jj|}|X|stdj|d} d|z}|jj|sn|dz }'|j!|||||f|j|<|j|S#t $rdj|}t |wxYw)Nz^This graph cannot be serialized to a strict format because there is no valid way to shorten {}rrr)rrrCrrNAME_START_CATEGORIESrrrrrrrrrrr)rMrr rrrRmessagers r rz%NamespaceManager.compute_qname_strictsh#'"4"4S("C 4 SY 9d* *$---.&/5J&KOItDLL0 t{{IF#9- **>#&GNN ) C!'##zz33F;!q  IIfi0,2It+D##C(&&s+ +W".FFLfSk%W-- .s D""&Ecvt|tur"tdt|jd|j dd}t |dk7r t d|jj|d}|tt||dSt d|j 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”.rzPrefix "z" not bound to any namespace.) typerCrrusplitrrrrr)rMr partsrs r expand_curiezNamespaceManager.expand_curiesE{c!=d5k>R>R=SSTUV V C# u:?R ZZ ! !%( + >SWIeAhZ01 1EKK,Q/00NO r cbts|jj||S |jj|||S#t$rc}dt |vrLt j dt|jd|jj||cYd}~SYd}~yd}~wwxYw)Noverrider(z}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")rMrrr(errors r _store_bindzNamespaceManager._store_binds&::??695 5 :::??69x?H H :SZ' U$! zzvy99( :sA B. AB)B.)B.ctt|}|d}nd|vr td|jj |}|r t|}|r||k7r|r4|j |||t |jt|y|sd}d} ||}|jj |}|r|t|k(ry|jj |sn|dz }T|j |||n_|jj|} | |j |||n-| |k(rn'|s| jdr|j |||t |jt|y) 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 NrO z Prefixes may not contain spaces.r'rrr) rrCrrrr.rrrr]) rMrrr(replacebound_namespacer new_prefix tnamespace bound_prefixs r rzNamespaceManager.bindsx 3y>* >F F]=> >**..v6 $_5O );  X FDKKY8 "C'-s3 !ZZ11*= )vj/A"Azz++J7q   ZX  F::,,Y7L#  X F'|66s;$$VY$JDKKY0r c#rK|jjD]\}}t|}||fywr)rrr)rMrrs r rzNamespaceManager.namespaces-s7!%!6!6!8 FIy)I)# #"9s57ctjj}td|z|| }|rt |d}|s|r|ddk(r |ddk7rd|z}t |S)Nz%s/)allow_fragmentsrr#z%s#)r cwdas_urirrr)rMrdefragbaseresults r absolutizezNamespaceManager.absolutize2sjxxz  "sJG v&q)Fs2w#~&**;f~r N)r)rrrrrs)rnNone)rnr)rrCrnrC)T)rrCr rtrnrC)rrCrnrC)rrCr rtrnzTuple[str, URIRef, str])rrCr rtrnzTuple[str, str, str])r rCrnr)rrCrrr(rtrnr@)TF) r Optional[str]rrr(rtr1rtrnr@)rnzIterable[Tuple[str, URIRef]])r)rrCr<intrnr)rurvrwrxrrlrryrr r rrrrr%r.rrr?rr r r#r#s/b#MJK-  ,(:,=2+!\*.:,:,"&:, :,x8:( A1A1A1 A1  A1  A1F$ r r#)LlLuLoLtNlNd)McMeMnLmrH)·u·-rr%rrbc|rW|d}|dk(st|tvr   C 'S 59C{   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?)owlrdfrdfsxsdxmlbrickcsvwdcdcatdcmitypedctermsdcamdoapfoafgeoodrlorgprofprovqbschemash)skossosassntimevannvoidwgs)rrrnr)rRrCrnrB)rrCrXrrnzTuple[str, str])r_Dict[str, Any]rHrCrnr)rcrr_rrHrCrnr@)r_rrHrCrnrA)zrx __future__rloggingr annotationlibr ImportErrorinspect functoolsr pathlibr typingr rrrrrrrr unicodedatar urllib.parserr rdflib.termrrr rdflib.graphr rdflib.storer__all__ getLoggerrur+rCr r}rrrr"rr"r!rWrdflib._type_checkingrr*r#rSPLIT_START_CATEGORIESrRrSrrrrrrdflib.namespace._BRICKr$rdflib.namespace._CSVWr%rdflib.namespace._DCr&rdflib.namespace._DCAMr'rdflib.namespace._DCATr(rdflib.namespace._DCMITYPEr)rdflib.namespace._DCTERMSr*rdflib.namespace._DOAPr+rdflib.namespace._FOAFr,rdflib.namespace._GEOr-rdflib.namespace._ODRL2r.rdflib.namespace._ORGr/rdflib.namespace._OWLr0rdflib.namespace._PROFr1rdflib.namespace._PROVr2rdflib.namespace._QBr3rdflib.namespace._RDFr4rdflib.namespace._RDFSr5rdflib.namespace._SDOr6rdflib.namespace._SHr7rdflib.namespace._SKOSr8rdflib.namespace._SOSAr9rdflib.namespace._SSNr:rdflib.namespace._TIMEr;rdflib.namespace._VANNr<rdflib.namespace._VOIDr=rdflib.namespace._WGSr>rdflib.namespace._XSDr?rrrr r rsFP# ) XXX +77""# J   8 $<$<$~33F"h"h Y#4Y#x =!5 =0i0f 899RRn 7.$7'*HHG ((>5 5$55. !$20 *'#''/-''%)%%''#%'%#''%'''%%       U D " D    w  D D D 3 E 3 D D "  c!" "#$       1k))+ ) )) )s5HH# HH# HH#HH#"H#