#HJjFG dZddlmZddlmZddlmZddlmZm Z m Z mZm Z ddl m Z mZmZmZmZmZmZmZmZmZmZmZmZmZddlmZmZmZddlZ ddl!Z ddl"Z dd l#m$Z$e rdd lm%Z%gd Z&ed e Z'edZ(iddddddddddddddddddddddddddddd dddZ)d!gd"gd#gd$gd%gd&d'gd(gd)gd*gd+ Z*d,gd-gd.gd/gd0Z+dJd1Z,dKd2Z-dLdMd3Z.dNd4Z/ dO dPd5Z0 dQ dRd6Z1dSd7Z2dTd8Z3dOdUd9Z4dVdWd:Z5 dO dXd;Z6d<ddd=f dYd>Z7edZd?Z8ed@dA d[dBZ8ddA d[dCZ8dDZ9 dEe9zdFzZ: e:dGzZ; e9dEzZ< e:dHzZ= d\dIZ>y)]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=csvtsvcnt}|Dcgc]}||vs|j|r|c}Scc}w)zX Return a new list without duplicates. Preserves the order, unlike set(seq) )setadd)seqseenxs U/Users/ahmed/devFolder/claude-voice/.venv/lib/python3.12/site-packages/rdflib/util.pyrrvs3 5D @s!atmDHHQKAs @@ @s 222c|D]}|cSy)z_ return the first element in a python sequence for graphs, use graph.value instead N)rEresults rHrrs   c@|rtd|DSt|S)z,removes duplicate strings from the sequence.c3<K|]}|jywN)strip).0ss rH zuniq..s/h1779hs)rC)sequencerPs rHr r s  /h///8}rLc.d}|D]}|dz }||kDsyy)z>Returns 1 if sequence has more items than number and 0 if not.rrJ)rTnumberiitems rHr!r!s) A Q v: rLc|s|S|jdr3|jdr"tjj |ddS|jdr3|jdr"tjj |ddS|jdrtjj |Sd|z}t|)ay 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) <>rV"_zUnrecognised term syntax: '%s') startswithendswithrdflibtermURIRefLiteralBNode Exception)rRdefaultmsgs rHr"r"s  c qzz#{{!!!Ab'** c qzz#{{""1Qr7++ c {{  ##.2nrLc8|s|S|jdr@tjj|ddj dj dS|jdr|jdrd}nd}|j |d\}}|t|d}d}d}|jd } | d k\rt|| d zd|||}n|jd r|dd}|jd d}|jdd}|j dj d}tjj|||S|dk(s|dk(r"tjj|dk(S|jjdddjdddjdddjrd|jvrCtjj|tjjj Sd|vrLtjjt#|tjjj$Stjjt'|tjjj(S|jdr.t|dd} tj*j-|| S|jdr.t|dd} tj*j/|| S|jdr"tjj1|d dSd|vr|;tjj3tj*j/}|j5dd\} } t7|j9| } tjj;| | Stjj1|S)aCreates 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[rVr]zraw-unicode-escapezunicode-escaper^z"""Nz^^r@z\"z\xz\\xtruefalse.-e)datatype{[z_::)r`rbrcrdencodedecodersplitlenrfindr#replacerelower isnumeric namespaceXSDdoublefloatdecimalintintegergraph QuotedGraphrrfNamespaceManagersplitdict namespaces Namespace)rRrhbackendnsmquotesvaluerestrslanguagedtoffset identifierprefix last_partnss rHr#r#siF ||C{{!! aGNN/ 0 7 78H I   c  << FFhhvq) tc&km$::d# q= tHqLN3WgsKHs#8 eS) eV, 1299:JK{{""5(H== 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 | t}|r1t|}|dr tdz}n tdz}d|dz|dzfz}n t |}d}|\ }}}}} } } } } d||||| | |fz}|S)ahttp://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%b"b"a+tUCRS.QQA HrLc d|vr|dz }|jd\}}|dd|dd}}|r|dk(r|dd}d}n6t|dd}t|d d }t||z|d zzd z}| }|jd \} } } |jd \} } }tt| t| t| t| t| t|dddf }||z}|S)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]rrqrv)rrrr)valymdr hmstz_str tz_offset signed_hrsminssecsrrrhourminutesecondrs rHr%r%Os , #~ | #ICq)T!"XC Vs]CRy _ 6!A;Z 4'*r/9R?E yy~D%99S>D&& TCJC#d)S[#f+qRSUVW A I A HrLc|xst}|jt|xs|j|jS)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 $ ?(??rLct|d}|dk(r|jdr|}|r|j}|jdr|dd}|S)aK 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]rprorVN)rr`r})rr}exts rHrrsU$ 5/" C byU%%c* iik ~~c!"g JrLct}| t}|j|D]A\}}|j|||vr|j|||vs1|j|C|S)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'sh(+uI }%%d+1 a : LLO I  IIaL , LrLc|SrOrJ)rGs rHrsqrLdownc  | t}||vry|j|g}|dk(r|j||}n|j||}|D]'} t || |||||} | s|j | )||t ||fS)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 t|HHTN D f}>>$-==t, UFD&'4 E KKN 4L&73 44rLcyrOrJrhargss rHr)r)s@CrL.)rhcyrOrJrs rHr)r)srLc |D]}||cS|S)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)rhrargs rHr)r)s* ?J NrLz !$&'()*+,;=%z:@z/?/ct|}|\}}}}}|dvr|St|t}t|t}t|t}|jr+|jj dj d}nd}d|vrd|d}|jr|d|j}|jrPt|jt}|jr"t|jt}|d|}|d |}t|||||f} |jd r| jd s| d z } | S) 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)safeidnaasciirprvru]rl#) rr_PATH_SAFE_CHARS_QUERY_SAFE_CHARShostnamerwrxportusername_USERNAME_SAFE_CHARSpasswordrra) iripartsschemenetlocpathqueryfragmentauth pass_quoteduris rHr*r*as8 SME.3+VVT5(&& , -D %/ 0EX$56H ~~&&v.55g> f}VHA zz81UZZL) ~~U^^*>? >>5IJKV1[M*D66(# ffdE8< =C ||Cc!2 s  JrL)rEzIterable[_HashableT]returnzList[_HashableT])rEzIterable[_AnyT]rOptional[_AnyT])r)rTz Iterable[str]rPrrzSet[str])rTz Iterable[Any]rWrrrrO)rR Optional[str]rh Optional[rdflib.term.Identifier]rr)NNN) rRstrrhrrrrz+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]]])rrrhr-rr-)rrrhrrr)rrrr)?__doc__ __future__rcalendarros.pathrr rrrr typingr r r rrrrrrrrrrr urllib.parserrr rdflib.graphrbrdflib.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