\d dZddlmZddlmZmZmZddl m Z d de ddDZd ZGd d Zd S) z( L{URLPath}, a representation of a URL. )cast)quoteunquote urlunsplit)URLcRg|]$}t|d%S)ascii)chrencode).0xs 6lib/python3.11/site-packages/twisted/python/urlpath.py rs*DDDc!ffmmG,,DDDrc:d|ztfdfdS)a Attriute declaration to preserve mutability on L{URLPath}. @param name: a public attribute name @type name: native L{str} @return: a descriptor which retrieves the private version of the attribute on get and calls rerealize on set. _c$t|SN)getattr)self privateNames rz"_rereconstituter..sWT;//rct|t|tr|n|dp|S)Ncharmap)setattr isinstancebytesr _reconstitute)rvaluers rrz"_rereconstituter..sS #E511Nu||I7N7N   $ !!## r)property)namers @r_rereconstituterr$s@*K ////       rc4eZdZdZ ddZdZedZedZedZ ed Z ed Z e d Z ddZe dZe dZe dZdZddZddZddZddZdZdefdZdefdZdS)URLPatha A representation of a URL. @ivar scheme: The scheme of the URL (e.g. 'http'). @type scheme: L{bytes} @ivar netloc: The network location ("host"). @type netloc: L{bytes} @ivar path: The path on the network location. @type path: L{bytes} @ivar query: The query argument (the portion after ? in the URL). @type query: L{bytes} @ivar fragment: The page fragment (the portion after # in the URL). @type fragment: L{bytes} r localhostc||pd|_||_|pd|_||_||_|dS)Nshttp/)_scheme_netloc_path_query _fragmentr )rschemenetlocpathqueryfragments r__init__zURLPath.__init__=sH(  \T  ! rc tt|j|j|j|j|jft}tj | d d|_ dS)zM Reconstitute this L{URLPath} from all its given attributes. safer N) urlquoterr*r+r,r-r. _allascii_URLfromTextr decode_url)rurltexts rr zURLPath._reconstituteGss t|TZdnU       M'.."9"9"@"@"I"IJJ rr/r0r1r2r3c||}||jpdg|_|jjd|_|jd|_t|jjd d|_ t|jj  ddd|_|jjd|_|S) a Reconstruct all the public instance variables of this L{URLPath} from its underlying L{_URL}. @param urlInstance: the object to base this L{URLPath} on. @type urlInstance: L{_URL} @return: a new L{URLPath} )r1r T)r1rooted)r2rN)__new__replacer1r=r/r r* authorityr+r:asURIasTextr,r2r-r3r.)cls urlInstancers r_fromURLzURLPath._fromURLYs{{3''[-=-E"'FF y'..w77 y**,,33G<< dinT 2 2 2 8 8 : : A A C C J J7 S S $)/22288::AACCJJ7SSUVUWUWX +227;; rFTcT|jj}d|rfddgfd|DzS)a Split this URL's path into its components. @param unquote: whether to remove %-encoding from the returned strings. @param copy: (ignored, do not use) @return: The components of C{self.path} @rtype: L{list} of L{bytes} c,|dS)Nr )r )rs rrz"URLPath.pathList..{s188G,,rc2|t|Sr) urlunquote)rms rrz"URLPath.pathList..}s:a==)9)9rrc&g|] }|SrP)r segmentmappers rrz$URLPath.pathList..~s!@@@Gw@@@r)r=r1)rrcopysegmentsrRs @rpathListzURLPath.pathListosN9>,,  :!'999Fu@@@@x@@@@@rct|tstd|t j|S)z Make a L{URLPath} from a L{str} or L{unicode}. @param url: A L{str} representation of a URL. @type url: L{str} or L{unicode}. @return: a new L{URLPath} derived from the given string. @rtype: L{URLPath} z'url' must be a str)rstr ValueErrorrIr:r;)klassurls r fromStringzURLPath.fromStringsA#s## 4233 3~~dmC00111rct|tstdt|t}||S)z Make a L{URLPath} from a L{bytes}. @param url: A L{bytes} representation of a URL. @type url: L{bytes} @return: a new L{URLPath} derived from the given L{bytes}. @rtype: L{URLPath} @since: 15.4 z'url' must be bytesr6)rrrXr8r9r[)rYrZquoteds r fromByteszURLPath.fromBytessK#u%% 4233 3#I...'''rcP||S)a Make a L{URLPath} from a L{twisted.web.http.Request}. @param request: A L{twisted.web.http.Request} to make the L{URLPath} from. @return: a new L{URLPath} derived from the given request. @rtype: L{URLPath} )r^ prePathURL)rYrequests r fromRequestzURLPath.fromRequests"w1133444rcr||d|r |jjndS)a Return a modified copy of C{self} using C{newURL}, keeping the query string if C{keepQuery} is C{True}. @param newURL: a L{URL} to derive a new L{URLPath} from @type newURL: L{URL} @param keepQuery: if C{True}, preserve the query parameters from C{self} on the new L{URLPath}; if C{False}, give the new L{URLPath} no query parameters. @type keepQuery: L{bool} @return: a new L{URLPath} r@rP)r3r2)rIrCr=r2)rnewURL keepQuerys r_modz URLPath._mods;}} NNB.RdiooPRN S S   rc||j|d|S)a Get the sibling of the current L{URLPath}. A sibling is a file which is in the same directory as the current file. @param path: The path of the sibling. @type path: L{bytes} @param keepQuery: Whether to keep the query parameters on the returned L{URLPath}. @type keepQuery: L{bool} @return: a new L{URLPath} r )rfr=siblingr<rr1res rrhzURLPath.siblings4yy**4;;w+?+?@@)LLLrc||j|d|S)a) Get the child of this L{URLPath}. @param path: The path of the child. @type path: L{bytes} @param keepQuery: Whether to keep the query parameters on the returned L{URLPath}. @type keepQuery: L{bool} @return: a new L{URLPath} r )rfr=childr<ris rrkz URLPath.childs2yyW)=)=>> JJJrc^||jd|S)z Get the parent directory of this L{URLPath}. @param keepQuery: Whether to keep the query parameters on the returned L{URLPath}. @type keepQuery: L{bool} @return: a new L{URLPath} z..rfr=clickrres rparentzURLPath.parents&yy.. :::rc^||jd|S)z Get the current directory of this L{URLPath}. @param keepQuery: Whether to keep the query parameters on the returned L{URLPath}. @type keepQuery: L{bool} @return: a new L{URLPath} .rmros rherez URLPath.heres&yy--y999rc||j|dS)a7 Return a path which is the URL where a browser would presumably take you if you clicked on a link with an HREF as given. @param st: A relative URL, to be interpreted relative to C{self} as the base URL. @type st: L{bytes} @return: a new L{URLPath} r )rIr=rnr<)rsts rrnz URLPath.clicks0}}TY__RYYw-?-?@@AAArreturnc~tt|jS)z= The L{str} of a L{URLPath} is its URL text. )rrWr=rErFrs r__str__zURLPath.__str__s,C**1133444rcfd|j|j|j|j|jS)z{ The L{repr} of a L{URLPath} is an eval-able expression which will construct a similar L{URLPath}. zGURLPath(scheme={!r}, netloc={!r}, path={!r}, query={!r}, fragment={!r}))formatr/r0r1r2r3rxs r__repr__zURLPath.__repr__ s6 Y__ K K I J M    rN)rr'rrr)FT)F)__name__ __module__ __qualname____doc__r4r r$r/r0r1r2r3 classmethodrIrUr[r^rbrfrhrkrprsrnrWryr|rPrrr&r&)s(NQ K K K h ' 'F  h ' 'F  F # #D  W % %E ++H[*AAAA" 2 2[ 2(([(" 5 5[ 5   &MMMM K K K K ; ; ; ; : : : : B B B55555  #       rr&N)rtypingr urllib.parserr8rrMr hyperlinkrr:joinranger9r$r&rPrrrs MMMMMMMMMM!!!!!! HHDDeeAsmmDDD E E 0m m m m m m m m m m r