PiFG 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+dzd5Z,d{d8Z-d|d}d>Z.d~dAZ/ dddFZ0 dddLZ1ddNZ2ddPZ3dddTZ4dddXZ5 ddd`Z6dadddbfddlZ7eddnZ8edodpddqZ8ddpddrZ8dsZ9 dte9zduzZ: e:dvzZ; e9dtzZ< e:dwzZ= ddyZ>dS)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=csvtsvseqIterable[_HashableT]returnList[_HashableT]c<tfd|DS)zX Return a new list without duplicates. Preserves the order, unlike set(seq) cFg|]}|v||S)add).0xseens _/home/jaya/work/projects/VOICE-AGENT/VIET/agent-env/lib/python3.11/site-packages/rdflib/util.py zlist2set..}s, @ @ @!atmmDHHQKKmAmmmset)rBrLs @rMrrvs( 55D @ @ @ @s @ @ @@rOIterable[_AnyT]Optional[_AnyT]c|D]}|cSdS)z_ return the first element in a python sequence for graphs, use graph.value instead NrH)rBresults rMrrs!  4rOsequence Iterable[str]stripintSet[str]cV|rtd|DSt|S)z,removes duplicate strings from the sequence.c3>K|]}|VdSN)rX)rJss rM zuniq..s*//17799//////rOrP)rVrXs rMr r s3 //h//////8}}rO Iterable[Any]numberc0d}|D]}|dz }||krdSdS)z>Returns 1 if sequence has more items than number and 0 if not.rrH)rVraiitems rMr!r!s9 A Q v::11  1rOr^ Optional[str]default Optional[rdflib.term.Identifier]c|s|S|dr<|dr'tj|ddS|dr<|dr'tj|ddS|drtj|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) <>rc"_zUnrecognised term syntax: '%s') startswithendswithrdflibtermURIRefLiteralBNode Exception)r^rgmsgs rMr"r"s  c  qzz#{!!!AbD'*** c  qzz#{""1QrT7+++ c  {  ###.2nnrOstrbackendnsm+Optional[rdflib.namespace.NamespaceManager]&Optional[Union[rdflib.term.Node, str]]c0 |s|S|drMtj|ddddS|dr|drd}nd}||d\}}|t|d}d}d}|d } | d krt|| d zd|||}n|d r |dd}| d d}| dd}|dd}tj |||S|dks|dkr#tj |dkS| ddd ddd ddd rd| vr5tj |tjjjSd|vrBtj t#|tjjjStj t'|tjjjS|dr7t|dd} tj|| S|dr7t|dd} tj|| S|dr'tj|d dSd|vr|;tjtj}|dd\} } t7|| } tj| | Stj|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 ``` rjrcrlzraw-unicode-escapezunicode-escapermz"""Nz^^r@z\"z\xz\\xtruefalse.-e)datatype{[z_::)rorqrrrsencodedecodersplitlenrfindr#replacertlower isnumeric namespaceXSDdoublefloatdecimalrYintegergraph QuotedGraphrruNamespaceManagersplitdict namespaces Namespace)r^rgryrzquotesvaluerestrlanguagedtoffset identifierprefix last_partnss rMr#r#sF ||CH${!! adGNN/ 0 0 7 78H I I    c  B$ <<   FFFhhvq)) tc&kkmm$::d## q== tHqLNN3WgsKKHHs## $8 eS)) eV,, 12299:JKK{""5(H=== fW {""1;///  b!   b!   b!    !$ !''))  ;&&q63C3G3N&OO O !88;&&uQxx&:J:N:V&WW W{""3q66F4D4H4P"QQQ c  $QqtW%% |''<<< c  $QqtW%% |!!':666 d   ${  122'''  ;"33FL4F4F4H4HIICGGCOO #.."" # #F +))"--i88{  ###rOFc |t}|r:t|}|dr tdz}n tdz}d|dz|dzfz}nt |}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' ``` N<z -%02d:%02dZz!%0004d-%02d-%02dT%02d:%02d:%02d%s)r rrr r)tlocal_time_zone time_tupletz_minstzdyearmonthdayhhmmsswdyzr^s rMr$r$)s& y FF q\\ a= %mGG"nGgmWr\::AYY -7*D%b"b"a+tUCRS.QQA HrOvalc ld|vr|dz }|d\}}|dd|dd}}|r|dkr |dd}d}nLt|dd}t|d d }t||z|d zzd z}| }|d \} } } |d \} } }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:00ZrrNrrlrrr)rrYrr)rymdr hmstz_str tz_offset signed_hrsminssecsrrrhourminutesecondrs rMr%r%Os=, #~~ | #ICqs)T!""XC Vs]]CRCy __ 6!A#;Z  4'*r/9R?E yy~~D%99S>>D&& TCJJC#d))S[[#f++qRSUVW  A I A HrOfpathfmapOptional[Dict[str, str]]c|pt}|t|p&||S)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)rrs rMr&r&~sAJ  $$D 88HUOO $ $ ?(?(??rOTrboolct|d}|dkr|dr|}|r|}|dr |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' ``` rlrrrcN)rror)rrexts rMrrso$ 5//" C byyU%%c**y iikk ~~c!""g JrOrrproprdflib.term.URIRefrootsOptional[Set[rdflib.term.Node]]Set[rdflib.term.Node]ct}|t}||D]L\}}||||vr||||vr||M|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` )rQsubject_objectsrIremove)rrr non_rootsrKrs rMr'r's(+uuI }%%d++1 a :: LLOOO I   IIaLLL LrOc|Sr]rH)rKs rMrsqrOdownrootrdflib.term.Nodemapper.Callable[[rdflib.term.Node], rdflib.term.Node]sortkeyOptional[Callable[[Any], Any]]donedir,Optional[Tuple[rdflib.term.Node, List[Any]]]c \|t}||vrdS||g}|dkr|||}n|||}|D].} t || |||||} | r|| /||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)rQrIsubjectsobjectsr(appendsorted) rrrrrrrtreebranchesbranchrs rMr(r(s< |uu t||HHTNNN D f}}>>$--==t,, UFD&'4 E E   KKNNN F4LL&7333 44rOargscdSr]rHrgrs rMr)r)s@CrO.)rgcdSr]rHrs rMr)r)s crOc|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`. rH)rgrargs rMr)r)s+* ?JJJ  NrOz !$&'()*+,;=%z:@z/?/irict|}|\}}}}}|dvr|St|t}t|t}t|t}|jr.|jdd}nd}d|vrd|d}|jr |d|j}|jrKt|jt}|j r"t|j t}|d|}|d |}t|||||f} | d r| d 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)safeidnaasciirrr]r#) rr_PATH_SAFE_CHARS_QUERY_SAFE_CHARShostnamerrportusername_USERNAME_SAFE_CHARSpasswordrrp) rpartsschemenetlocpathqueryfragmentauth pass_quoteduris rMr*r*as SMME.3+VVT5(&&& , - - -D %/ 0 0 0EX$5666H ~&&v..55g>> f}}V z*))UZ)) ~$U^*>??? > +5IJJJK**[**D##6## ffdE8< = =C ||Cc!2!2 s  JrO)rBrCrDrE)rBrRrDrS)r)rVrWrXrYrDrZ)rVr`rarYrDrYr])r^rfrgrhrDrh)NNN) r^rxrgrfryrfrzr{rDr|)NF)rrxrDrY)rrxrrrDrf)T)rrxrrrDrx)rrrrrrrDr)rrrrrrrrrrrrrrxrDr)rrSrgr-rDr-)rrSrgrSrDrS)rrxrDrx)?__doc__ __future__rcalendarros.pathrr rrrr typingr r r rrrrrrrrrrr urllib.parserrr rdflib.graphrqrdflib.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*rHrOrMr"s,#"""""<;;;;;;;;;;;;; 5444444444#""""""    W\ 2 2 2  5 5 5 $   8   $  F V F 6 ( h F I i y!* " " +o " #  1 2$%  %&   - - . / < ' ( &&"AAAA    CG>"!7; m$m$m$m$m$`# # # # L, , , , ^&@&@&@&@&@R>.2<>I[.2,01515151515h CCC C 7:  8<6# ,,t3&,*C/ %s*222222rO