01iFG 2SrSSKJr SSKJr SSKJr SSKJrJ r J r JrJ r SSK J r JrJrJrJrJrJrJrJrJrJrJrJrJr SSKJrJrJr SSKr SSK!r SSK"r SS K#J$r$ \ (aSS KJ%r% /S Qr&\"S \S 9r'\"S5r(0SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_S S_SS_r)S!/S"/S#/S$/S%/S&S'/S(/S)/S*/S+. r*S,/S-/S./S//S0.r+SJS1jr,SKS2jr-SLSMS3jjr.SNS4jr/SOSPS5jjr0SQSRS6jjr1SSS7jr2STS8jr3SOSUS9jjr4SVSWS:jjr5SOSXS;jjr6S<SSS=4SYS>jjr7\SZS?j5r8\S@SA.S[SBjj5r8SSA.S[SCjjr8SDr9SE\9-SF-r:\:SG-r;\9SE-r<\:SH-r=S\SIjr>g)]z Some utility functions. Miscellaneous utilities * list2set * first * uniq * more_than Term characterisation and generation * to_term * from_n3 Date/time utilities * date_time * parse_date_time ) annotations)timegm)splitext)altzonegmtime localtimetimetimezone) TYPE_CHECKINGAnyCallableDictHashableIterableIteratorListOptionalSetTupleTypeVarUnionoverload)quoteurlsplit urlunsplitN)sign)Graph) list2setfirstuniq more_thanto_termfrom_n3 date_timeparse_date_time guess_format find_rootsget_tree _coalesce_iri2uri _HashableT)bound_AnyTxmlrdfowln3ttlturtlenttrixxhtmlrdfahtmlsvgnqnquadstrigjsonjson-ldjsonldzapplication/rdf+xmlztext/n3z text/turtlezapplication/n-tripleszapplication/trixz text/htmlzapplication/xhtml+xmlzapplication/n-quadszapplication/trigzapplication/ld+json) r.r1r3r4r5r7r;r<r>zapplication/sparql-results+xmlzapplication/sparql-results+jsonztext/csvztext/tab-separated-values)r.r=csvtsvc[5nUVs/sH$o"U;dM URU5(aM"UPM& sn$s snf)zL Return a new list without duplicates. Preserves the order, unlike set(seq) )setadd)seqseenxs E/home/james-whalen/.local/lib/python3.13/site-packages/rdflib/util.pyrrvs3 5D @s!tmADHHQKAs @@ @s ===cUHnUs $ g)zS return the first element in a python sequence for graphs, use graph.value instead N)rEresults rHrrs   cJU(a[SU55$[U5$)z,removes duplicate strings from the sequence.c3@# UHoR5v M g7fN)strip).0ss rH uniq..s/h7799hs)rC)sequencerPs rHr r s  /h///8}rLc2SnUHnUS- nX!:dM g g)z>Returns 1 if sequence has more items than number and 0 if not.rrJ)rUnumberiitems rHr!r!s' A Q : rLcU(dU$URS5(a8URS5(a"[RR USS5$URS5(a8URS5(a"[RR USS5$URS5(a[RR U5$SU-n[U5e)a] Creates and returns an Identifier of type corresponding to the pattern of the given positional argument string `s`: '' returns the `default` keyword argument value or `None` '' returns `URIRef(s)` (i.e. without angle brackets) '"s"' returns `Literal(s)` (i.e. without doublequotes) '_s' returns `BNode(s)` (i.e. without leading underscore) <>rW"_zUnrecognised term syntax: '%s') startswithendswithrdflibtermURIRefLiteralBNode Exception)rRdefaultmsgs rHr"r"s  c  qzz#{{!!!Ab'** c  qzz#{{""1Qr7++ c  {{  ##.2nrLcU(dU$URS5(a@[RRUSSR S5R S55$URS5(aURS5(aSnOSnUR US5upVU[U5SnSnSnURS 5n U S :a[XiS -SXU5nOURS 5(aUSSnURS S5nURSS5nUR S5R S5n[RRXXU5$US:XdUS:Xa"[RRUS:H5$UR5RSSS5RSSS5RSSS5R5(aSUR5;a@[RRU[RRR S9$SU;aI[RR[#U5[RRR$S9$[RR['U5[RRR(S9$URS5(a-[USS5n [R*R-X*5$URS5(a-[USS5n [R*R/X*5$URS5(a"[RR1US S5$SU;aUc;[RR3[R*R/55nUR5SS5up[7UR955U n [RR;U 5U $[RR1U5$)aECreates the Identifier corresponding to the given n3 string. ```python >>> from rdflib.term import URIRef, Literal >>> from rdflib.namespace import NamespaceManager >>> from_n3('') == URIRef('http://ex.com/foo') True >>> from_n3('"foo"@de') == Literal('foo', lang='de') True >>> from_n3('"""multi\nline\nstring"""@en') == Literal( ... 'multi\nline\nstring', lang='en') True >>> from_n3('42') == Literal(42) True >>> from_n3(Literal(42).n3()) == Literal(42) True >>> from_n3('"42"^^xsd:integer') == Literal(42) True >>> from rdflib import RDFS >>> from_n3('rdfs:label') == RDFS['label'] True >>> nsm = NamespaceManager(rdflib.graph.Graph()) >>> nsm.bind('dbpedia', 'http://dbpedia.org/resource/') >>> berlin = URIRef('http://dbpedia.org/resource/Berlin') >>> from_n3('dbpedia:Berlin', nsm=nsm) == berlin True ``` r\rWr^zraw-unicode-escapezunicode-escaper_z"""Nz^^r@z\"z\xz\\xtruefalse.-e)datatype{[z_::)rarcrdreencodedecodersplitlenrfindr#replacerflower isnumeric namespaceXSDdoublefloatdecimalintintegergraph QuotedGraphrrgNamespaceManagersplitdict namespaces Namespace)rRribackendnsmquotesvaluerestrtlanguagedtoffset identifierprefix last_partnss rHr#r#spF ||C{{!! aGNN/ 0 7 78H I   c   <<  FFhhvq) c&km$::d# q= tqLN3WsKHs##8 eS) eV, 1299:JK{{""5H== fW {{""1;//  b!  b!  b!     !'') ;;&&q63C3C3G3G3N3N&O O !8;;&&uQx&:J:J:N:N:V:V&W W{{""3q6F4D4D4H4H4P4P"QQ c  QqW% ||''<< c  QqW% ||!!'66 d  {{  12''  ;""33FLL4F4F4HICGGCO #.." #F +))"-i88{{  ##rLc Uc [5nU(a6[U5nUS(a [S-nO [S-nSUS-US-4-nO [ U5nSnUu pVpxppn SXVXxXU4-nU$)aOhttp://www.w3.org/TR/NOTE-datetime ex: 1997-07-16T19:20:30Z ```python >>> date_time(1126482850) '2005-09-11T23:54:10Z' @@ this will change depending on where it is run #>>> date_time(1126482850, local_time_zone=True) #'2005-09-11T19:54:10-04:00' >>> date_time(1) '1970-01-01T00:00:01Z' >>> date_time(0) '1970-01-01T00:00:00Z' ``` <z -%02d:%02dZz!%0004d-%02d-%02dT%02d:%02d:%02d%s)r rrr r)tlocal_time_zone time_tupletz_minstzdyearmonthdayhhmmsswdyzrRs rHr$r$)s& y Fq\ a=mG"nGgmWr\::AY -7*D""+tCRS.QQA HrLc SU;aUS- nURS5upUSSUSSpCU(aUS:XaUSSnSnO6[USS5n[US S 5n[U5U-US --S -nU*nURS 5upn URS 5upn[[U 5[U 5[U 5[U 5[U 5[U5SSS4 5nX-nU$)aalways returns seconds in UTC ```python # tests are written like this to make any errors easier to understand >>> parse_date_time('2005-09-11T23:54:10Z') - 1126482850.0 0.0 >>> parse_date_time('2005-09-11T16:54:10-07:00') - 1126482850.0 0.0 >>> parse_date_time('1970-01-01T00:00:01Z') - 1.0 0.0 >>> parse_date_time('1970-01-01T00:00:00Z') - 0.0 0.0 >>> parse_date_time("2005-09-05T10:42:00") - 1125916920.0 0.0 ``` Tz T00:00:00ZrrNrr^rrrrw)rrrr)valymdr hmstz_str tz_offset signed_hrsminssecsrrrhourminutesecondrs rHr%r%Os, #~ | #ICq)T!"X Vs]CRy _ 6!A;Z 4'*r/9R?E yy~D99S>D& TCJC#d)S[#f+qRSUVW A A HrLcU=(d [nUR[U55=(d URUR55$)a Guess RDF serialization based on file suffix. Uses `SUFFIX_FORMAT_MAP` unless `fmap` is provided. Example: ```python >>> guess_format('path/to/file.rdf') 'xml' >>> guess_format('path/to/file.owl') 'xml' >>> guess_format('path/to/file.ttl') 'turtle' >>> guess_format('path/to/file.json') 'json-ld' >>> guess_format('path/to/file.xhtml') 'rdfa' >>> guess_format('path/to/file.svg') 'rdfa' >>> guess_format('path/to/file.xhtml', {'xhtml': 'grddl'}) 'grddl' ``` This also works with just the suffixes, with or without leading dot, and regardless of letter case: ```python >>> guess_format('.rdf') 'xml' >>> guess_format('rdf') 'xml' >>> guess_format('RDF') 'xml' ``` )SUFFIX_FORMAT_MAPget_get_extr~)fpathfmaps rHr&r&~s7J  $$D 88HUO $ ?(??rLc[U5SnUS:XaURS5(aUnU(aUR5nURS5(aUSSnU$)a Gets the file extension from a file(path); stripped of leading '.' and in lower case. Example: ```python >>> _get_ext("path/to/file.txt") 'txt' >>> _get_ext("OTHER.PDF") 'pdf' >>> _get_ext("noext") '' >>> _get_ext(".rdf") 'rdf' ``` r^rqrprWN)rrar~)rr~exts rHrrs[$ 5/" C byU%%c** iik ~~c!"g JrLc[5nUc [5nURU5HDupEURU5 XB;aURU5 XS;dM3URU5 MF U$)aFind the roots in some sort of transitive hierarchy. find_roots(graph, rdflib.RDFS.subClassOf) will return a set of all roots of the sub-class hierarchy Assumes triple of the form (child, prop, parent), i.e. the direction of `RDFS.subClassOf` or `SKOS.broader` )rCsubject_objectsrDremove)rproproots non_rootsrGrs rHr'r'sb(+uI }%%d+ a : LLO  IIaL , LrLcU$rOrJ)rGs rHrsqrLdownc $Uc [5nX;agURU5 /nUS:XaURX!5nOURX5nUH+n [ X X#XEU5n U (dMUR U 5 M- U"U5[ XtS94$)a Return a nested list/tuple structure representing the tree built by the transitive property given, starting from the root given i.e. ```python get_tree( graph, rdflib.URIRef("http://xmlns.com/foaf/0.1/Person"), rdflib.RDFS.subClassOf, ) ``` will return the structure for the subClassTree below person. dir='down' assumes triple of the form (child, prop, parent), i.e. the direction of RDFS.subClassOf or SKOS.broader Any other dir traverses in the other direction Nr)key)rCrDsubjectsobjectsr(appendsorted) rrootrmappersortkeydonedirtreebranchesbranchrs rHr(r(s< |u |HHTN D f}>>$-==, UD' E 1 KKN 4L&3 44rLcgrOrJriargss rHr)r)s@CrL.)ricgrOrJrs rHr)r)srLc&UH nUcMUs $ U$)a This is a null coalescing function, it will return the first non-`None` argument passed to it, otherwise it will return `default` which is `None` by default. For more info regarding the rationale of this function see deferred [PEP 505](https://peps.python.org/pep-0505/). Args: *args: Values to consider as candidates to return, the first arg that is not `None` will be returned. If no argument is passed this function will return None. default: The default value to return if none of the args are not `None`. Returns: The first `args` that is not `None`, otherwise the value of `default` if there are no `args` or if all `args` are `None`. rJ)rirargs rHr)r)s* ?J NrLz !$&'()*+,;=%z:@z/?/c[U5nUup#pEnUS;aU$[U[S9n[U[S9n[U[S9nUR(a+URR S5R S5nOSnSU;aSUS3nUR(aUSUR3nUR(aO[UR[S9nUR(a[UR[S9nUSU3nUS U3n[X#XEU45n URS 5(aU RS 5(dU S - n U $) u Prior art: - [iri_to_uri from Werkzeug](https://github.com/pallets/werkzeug/blob/92c6380248c7272ee668e1f8bbd80447027ccce2/src/werkzeug/urls.py#L926-L931) ```python >>> _iri2uri("https://dbpedia.org/resource/Almería") 'https://dbpedia.org/resource/Almer%C3%ADa' ``` )httphttps)safeidnaasciirqrwrv]rm#) rr_PATH_SAFE_CHARS_QUERY_SAFE_CHARShostnamerxryportusername_USERNAME_SAFE_CHARSpasswordrrb) iripartsschemenetlocpathqueryfragmentauth pass_quoteduris rHr*r*as6 SME.3+VT(&& , -D %/ 0EX$56H ~~&&v.55g> f}VHA zz81UZZL) ~~U^^*>? >>5IJKV1[M*D66(# fd8< =C ||Cc!2!2 s  JrL)rEzIterable[_HashableT]returnzList[_HashableT])rEzIterable[_AnyT]rOptional[_AnyT])r)rUz Iterable[str]rPrrzSet[str])rUz Iterable[Any]rXrrrrO)rR Optional[str]ri Optional[rdflib.term.Identifier]rr)NNN) rRstrrirrrrz+Optional[rdflib.namespace.NamespaceManager]rz&Optional[Union[rdflib.term.Node, str]])NF)rrrr)rrrzOptional[Dict[str, str]]rr)T)rrr~boolrr)rrrrdflib.term.URIRefrOptional[Set[rdflib.term.Node]]rzSet[rdflib.term.Node])rrrzrdflib.term.Noderrrz.Callable[[rdflib.term.Node], rdflib.term.Node]rzOptional[Callable[[Any], Any]]rrrrrz,Optional[Tuple[rdflib.term.Node, List[Any]]])rrrir-rr-)rrrirrr)rrrr)?__doc__ __future__rcalendarros.pathrr rrrr typingr r r rrrrrrrrrrr urllib.parserrr rdflib.graphrcrdflib.namespace rdflib.term rdflib.compatrr__all__r+r-rFORMAT_MIMETYPE_MAP"RESPONSE_TABLE_FORMAT_MIMETYPE_MAPrrr r!r"r#r$r%r&rr'r(r)_RFC3986_SUBDELIMS_RFC3986_PCHAR_NUrrrr*rJrLrHrsv,#<; 54"  \ 2  5 5 5 $   8   $  F V F 6 ( h F I i y!* " " +o " #  1 2$%  %&  - - . / < ' ( &"A CG?%>"!7; m$ m$ m$m$ 5 m$ , m$`# L, ^&@R>.2   + <>I.2,015 15 15 15 ; 15 , 15 * 15 15215h C C 7: %4  8< %46# ,,t3&,*C/ %s*2rL