i dZddlmZddlmZmZddlZddlmZddl m Z m Z m Z ddl Z ddlZddlZddlmZmZmZmZmZmZddlZddlZddlmZddlZddlZdd lmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)m*Z+m,Z,m-Z-m.Z.ddl/Z/ddl0Z0dd l1m2Z2m3Z3dd l4m5Z5dd l6m7Z7ddl8m9Z9m:Z:m;Z;mZ>e?e.e,ze-zZ@e@jdejdZCe%de2ZDerddlEmFZFddl1mGZGmHZHmIZImJZJmKZKmLZLddlMmNZNe jGddZPe jGdde#e!ZQdJdZRe'dKdZSe'dLdZSdMdZSdNdZTe' dO dPd!ZUe' dO dQd"ZU dR dSd$ZUdTd%ZVdUd&ZW dV dWd'ZXdXd(ZYd)d)d)d)d*d+d,d-d.d/ ZZe?eZjZ\ dYd0Z] dZd1Z^d[d2Z_e'd d d d d d3 d\d4Z`e'd d d d d d d5 d]d6Z`e'd d d d d d d5 d^d7Z`ddd#d8ddd5 d_d9Z`Gd:d;eeZaGd<d=eaZbGd>d?eaZcGd@dAZdGdBdCZe d`dDZfdadEZgdbdFZhejdcdGZj dd dedHZk dfdIZly)gzCommon I/O API utilities) annotations)ABCabstractmethodN) defaultdict)HashableMappingSequence)BufferedIOBaseBytesIO RawIOBaseStringIO TextIOBase TextIOWrapper)Path) IO TYPE_CHECKINGAnyAnyStr DefaultDictGenericLiteralTypeVarcastoverload)urljoinurlparse uses_netloc uses_params uses_relative) BaseBuffer ReadCsvBuffer)import_optional_dependency)find_stack_level)is_bool is_file_like is_integer is_list_like) ABCMultiIndexz3^[A-Za-z][A-Za-z0-9+\-+.]*(::[A-Za-z0-9+\-+.]+)*:// BaseBufferT)bound) TracebackType)CompressionDictCompressionOptionsFilePath ReadBufferStorageOptions WriteBuffer) MultiIndexcHeZdZUdZded<ded<ded<ded<d Zd ed <y ) IOArgsz? Return value of io/common.py:_get_filepath_or_buffer. str | BaseBufferfilepath_or_bufferstrencodingmoder- compressionFbool should_closeN)__name__ __module__ __qualname____doc____annotations__r=e/Volumes/fast/ai/experiments/voice-extract-mac/.venv/lib/python3.12/site-packages/pandas/io/common.pyr5r5[s))(M I  L$rDr5ceZdZUdZded<ded<ej eZded<d Z d ed <dd Z dd Z ddZ y) IOHandlesau Return value of io/common.py:get_handle Can be used as a context manager. This is used to easily close created buffers and to handle corner cases when TextIOWrapper is inserted. handle: The file handle to be used. created_handles: All file handles that are created by get_handle is_wrapped: Whether a TextIOWrapper needs to be detached. z IO[AnyStr]handler-r;)default_factoryzlist[IO[bytes] | IO[str]]created_handlesFr< is_wrappedcd|jrut|jtsJ|jj |jj |j j|j|j D]}|jg|_d|_y)z Close all created buffers. Note: If a TextIOWrapper was inserted, it is flushed and detached to avoid closing the potentially user-created buffer. FN) rK isinstancerHrflushdetachrJremoveclose)selfrHs rErQzIOHandles.close}s ??dkk=9 99 KK    KK    ' ' 4**F LLN+!rDc|SNrCrRs rE __enter__zIOHandles.__enter__s rDc$|jyrT)rQ)rRexc_type exc_value tracebacks rE__exit__zIOHandles.__exit__s rDNreturnNone)r]zIOHandles[AnyStr])rXztype[BaseException] | NonerYzBaseException | NonerZzTracebackType | Noner]r^) r>r?r@rArB dataclassesfieldlistrJrKrQrVr[rCrDrErGrGhsm    1B1B1BSW1XO.XJ ",((   rDrGcZt|tsyt|jtvS)z Check to see if a URL has a valid protocol. Parameters ---------- url : str or unicode Returns ------- isurl : bool If `url` has a valid protocol return True otherwise False. F)rMr8 parse_urlscheme _VALID_URLSurls rEis_urlrhs& c3  S> K //rDcyrTrCr7s rE _expand_userrks25rDcyrTrCrjs rErkrksBErDcdt|trtjj |S|S)a] Return the argument with an initial component of ~ or ~user replaced by that user's home directory. Parameters ---------- filepath_or_buffer : object to be converted if possible Returns ------- expanded_filepath_or_buffer : an expanded filepath or the input if not expandable )rMr8ospath expanduserrjs rErkrks+$c*ww!!"455 rDc`|yt|r!tt|}|dkr tdyt |drRtt |}t tt|s tdtd|Dr tdyt|r tdtd) NrzUPassing negative integer to header is invalid. For no header, use header=None insteadF) allow_setsz*header must be integer or list of integersc3&K|] }|dk yw)rNrC).0is rE z&validate_header_arg..s%fq1ufsz8cannot specify multi-index header with negative integerszPassing a bool to header is invalid. Use header=None for no header or header=int or list-like of ints to specify the row(s) making up the column names) r&rint ValueErrorr'r allmapanyr$ TypeError)headers rEvalidate_header_argr~s ~&c6" A:9  Fu-h'3z6*+IJ J %f% %WX Xv 4  A BBrD.cyrTrCr7convert_file_likes rEstringify_pathrs rDcyrTrCrs rErrsrDFc|st|rtt|St|tj r|j }t|S)a Attempt to convert a path-like object to a string. Parameters ---------- filepath_or_buffer : object to be converted Returns ------- str_filepath_or_buffer : maybe a string version of the object Notes ----- Objects supporting the fspath protocol are coerced according to its __fspath__ method. Any other object is passed through unchanged, which includes bytes, strings, buffers, or anything else that's not even path-like. )r%rr*rMrnPathLike __fspath__rkrs rErrsI. .@!AK!344$bkk2/::< * ++rDcBddl}|jj|i|S)z` Lazy-import wrapper for stdlib urlopen, as that imports a big chunk of the stdlib. rN)urllib.requestrequesturlopen)argskwargsurllibs rErrs#  !6>> ! !4 26 22rDct|txr2ttj |xr|j d S)zR Returns true if the given URL looks like something fsspec can handle )zhttp://zhttps://)rMr8r<_FSSPEC_URL_PATTERNmatch startswithrfs rE is_fsspec_urlrsA 3 8 $**3/ 0 867 7rDc~t|}t|\}}t||}|r6t|dr*d|vr&t j dt td}t||}d|vr1|dvr-|d vr)t j |d |ttd |vr(|d vr$t j d t t|}d|vr d|vr|dz }t|trt|r|xsi}ddl }|jj||}t!|5} | j"j%dd} | dk(rddi}t'| j)} dddt+ ||d|St-|rt|tsJ|j/dr|j1dd}|j/dr|j1dd}t3d} g} t3dddlm}m}||t:g} | j>|fd|i|xsij?}t+|||d|S|r tCdt|ttDtFjFfrt+tI|||d|St|d s%t|dsd!tK|}tC|t+|||d|S#1swYkxYw#t<$rYwxYw#tA| $rB|ddi}nt|}d|d<| j>|fd|i|xsij?}YwxYw)"a If the filepath_or_buffer is a url, translate and return the buffer. Otherwise passthrough. Parameters ---------- filepath_or_buffer : a url, filepath (str or pathlib.Path), or buffer compression : str or dict, default 'infer' For on-the-fly compression of the output data. If 'infer' and 'filepath_or_buffer' is path-like, then detect compression from the following extensions: '.gz', '.bz2', '.zip', '.xz', '.zst', '.tar', '.tar.gz', '.tar.xz' or '.tar.bz2' (otherwise no compression). Set to ``None`` for no compression. Can also be a dict with key ``'method'`` set to one of {``'zip'``, ``'gzip'``, ``'bz2'``, ``'zstd'``, ``'xz'``, ``'tar'``} and other key-value pairs are forwarded to ``zipfile.ZipFile``, ``gzip.GzipFile``, ``bz2.BZ2File``, ``zstandard.ZstdCompressor``, ``lzma.LZMAFile`` or ``tarfile.TarFile``, respectively. As an example, the following could be passed for faster compression and to create a reproducible gzip archive: ``compression={'method': 'gzip', 'compresslevel': 1, 'mtime': 1}``. encoding : the encoding to use to decode bytes, default is 'utf-8' mode : str, optional storage_options : dict, optional Extra options that make sense for a particular storage connection, e.g. host, port, username, password, etc. For HTTP(S) URLs the key-value pairs are forwarded to ``urllib.request.Request`` as header options. For other URLs (e.g. starting with "s3://", and "gcs://") the key-value pairs are forwarded to ``fsspec.open``. Please see ``fsspec`` and ``urllib`` for more details, and for more examples on storage options refer `here `_. Returns the dataclass IOArgs. writebzDcompression has no effect when passing a non-binary object as input.) stacklevelN)methodw)bz2xz)zutf-16zutf-32z( will not write the byte order mark for a)ziptarzzip and tar do not support mode 'a' properly. This combination will result in multiple files with same name being added to the archive.tr)headerszContent-EncodinggziprT)r7r9r;r=r:zs3a://zs3://zs3n://fsspecbotocore) ClientErrorNoCredentialsErrorr:anonz?storage_options passed with file object or non-fsspec file pathFreadz)Invalid file path or buffer object type: )&rget_compression_methodinfer_compressionhasattrwarningswarnRuntimeWarningr#dictUnicodeWarningrMr8rhrrRequestrrgetr rr5rrreplacer"botocore.exceptionsrrPermissionError ImportErroropentuplerxbytesmmaprktype)r7r9r;r:storage_optionscompression_method fsspec_moderreq_inforeqcontent_encodingreaderrerr_types_to_retry_with_anonrrfile_objmsgs rE_get_filepath_or_bufferr(sb((:;'=[&I# *+=?QRg&8'BsRV R ') "{+=>K t - / , , mCH: N ')  d{)^;  * ')  K +#["8s $c*v6H/I*/R >>))*+,>?#    "F+w7I7/S9$?Q:R9STo -   u T   12 &#)4.#'"7*.'"v{{")49H9NBdf  s1(?K0K 'K,K K)(K),A L<;L<c2ddlm}td||S)z converts an absolute native path to a FILE URL. Parameters ---------- path : a path in native format Returns ------- a valid FILE URL r) pathname2urlzfile:)rrr)rors rEfile_path_to_urlrs, 7L. //rDrrrrrzstd) .tar.tar.gz.tar.bz2.tar.xz.gz.bz2.zip.xzz.zstct|tr!t|} |jd}||fSi}|}||fS#t$r}t d|d}~wwxYw)a Simplifies a compression argument to a compression method string and a mapping containing additional arguments. Parameters ---------- compression : str or mapping If string, specifies the compression method. If mapping, value at key 'method' specifies compression method. Returns ------- tuple of ({compression method}, Optional[str] {compression arguments}, Dict[str, Any]) Raises ------ ValueError on mapping missing 'method' key rz.If mapping, compression must have key 'method'N)rMrrpopKeyErrorrx)r;compression_argsrerrs rErrs{.+w' , X!1!5!5h!?  / //( / //  XMNTW W Xs: A AAc~|y|dk(rt|trd|vr|jdd}t|d}t|tsytj D](\}}|j j|s&|cSy|tvr|Sddgtt}d|d|}t|) a Get the compression method for filepath_or_buffer. If compression='infer', the inferred compression method is returned. Otherwise, the input compression method is returned unchanged, unless it's invalid, in which case an error is raised. Parameters ---------- filepath_or_buffer : str or file handle File path or object. compression : str or dict, default 'infer' For on-the-fly compression of the output data. If 'infer' and 'filepath_or_buffer' is path-like, then detect compression from the following extensions: '.gz', '.bz2', '.zip', '.xz', '.zst', '.tar', '.tar.gz', '.tar.xz' or '.tar.bz2' (otherwise no compression). Set to ``None`` for no compression. Can also be a dict with key ``'method'`` set to one of {``'zip'``, ``'gzip'``, ``'bz2'``, ``'zstd'``, ``'xz'``, ``'tar'``} and other key-value pairs are forwarded to ``zipfile.ZipFile``, ``gzip.GzipFile``, ``bz2.BZ2File``, ``zstandard.ZstdCompressor``, ``lzma.LZMAFile`` or ``tarfile.TarFile``, respectively. As an example, the following could be passed for faster compression and to create a reproducible gzip archive: ``compression={'method': 'gzip', 'compresslevel': 1, 'mtime': 1}``. Returns ------- string or None Raises ------ ValueError on invalid compression specified. Ninferz::rT)rUnrecognized compression type: z Valid compression types are ) rMr8splitrextension_to_compressionitemslowerendswith_supported_compressionssortedrx)r7r; extensionvalidrs rErr:sNg (# .4;M3M!3!9!9$!?!B +,>RVW,c2'?&D&D&F "I{!'')229=""'G-- d =V$;< =E )+7'',g / S/rDclt|j}|jstd|dy)z Check if parent directory of a file exists, raise OSError if it does not Parameters ---------- path: Path or str Path to check parent directory of z1Cannot save file into a non-existent directory: ''N)rparentis_dirOSError)rors rEcheck_parent_directoryrs7$Z  F ==?J6(RSTUU rD)r9r; memory_maperrorsrcyrTrC path_or_bufr:r9r;ris_textrrs rE get_handlersrD)r9r;rrrrcyrTrCrs rErrsrDcyrTrCrs rErrs),rDTc, |xsd}|xsd}t||r d|vr|dz }tj|t|trtj |t |||||}|j} t| |\} }} t| t} t|j} | jd}d|vr| rtt | |rD|dk7r"|jjdd |_ n(|dk(r#d|jvr|xjdz c_ |d k(rXt| tr$tj d*| |jd | } ntj d*| |jd | } nt|d k(r%ddl} | j$| fd|ji| } nJ|dk(rt'| |jfi| } | j(jdk(r| j+| | j(j-}t/|dk(r+| j(j1|j} n|st3d|t3d||dk(r| j5d|jt| trt7d*d| i| } n t7d*d| i| } t| t6sJd| j(jvr| j+| | j(j9}t/|dk(r%| j(j;|d}|J|} n|st3d|t3d||dk(r#ddl}|j>| |jfi| } nw|dk(rbtAd}d|jvrd|jBd*i| i}nd|jDd*i| i}|j0| fd|ji|} nd|}t3|t| trJ| j+| nvt| trf|jFr3d|jvr%t1| |j|jF|d } nt1| |j} | j+| d }|s7|jd!k(r(t| tHrtK| |jF"} n|r|s|st| |jrtM| d#rtM| d$r tM| d%s tO| } tQ| |jF|d } | j+| t|jtxs |jR }d|jvr.tM| d&s"tUd'tW|jd(| jY|jRr7t|jtrJ| j+|jt[| | ||j)S)+a| Get file handle for given path/buffer and mode. Parameters ---------- path_or_buf : str or file handle File path or object. mode : str Mode to open path_or_buf with. encoding : str or None Encoding to use. compression : str or dict, default 'infer' For on-the-fly compression of the output data. If 'infer' and 'path_or_buf' is path-like, then detect compression from the following extensions: '.gz', '.bz2', '.zip', '.xz', '.zst', '.tar', '.tar.gz', '.tar.xz' or '.tar.bz2' (otherwise no compression). Set to ``None`` for no compression. Can also be a dict with key ``'method'`` set to one of {``'zip'``, ``'gzip'``, ``'bz2'``, ``'zstd'``, ``'xz'``, ``'tar'``} and other key-value pairs are forwarded to ``zipfile.ZipFile``, ``gzip.GzipFile``, ``bz2.BZ2File``, ``zstandard.ZstdCompressor``, ``lzma.LZMAFile`` or ``tarfile.TarFile``, respectively. As an example, the following could be passed for faster compression and to create a reproducible gzip archive: ``compression={'method': 'gzip', 'compresslevel': 1, 'mtime': 1}``. May be a dict with key 'method' as compression mode and other keys as compression options if compression mode is 'zip'. Passing compression options as keys in dict is supported for compression modes 'gzip', 'bz2', 'zstd' and 'zip'. memory_map : bool, default False See parsers._parser_params for more information. Only used by read_csv. is_text : bool, default True Whether the type of the content passed to the file/buffer is string or bytes. This is not the same as `"b" not in mode`. If a string content is passed to a binary file/buffer, a wrapper is inserted. errors : str, default 'strict' Specifies how encoding and decoding errors are to be handled. See the errors argument for :func:`open` for a full list of options. storage_options: StorageOptions = None Passed to _get_filepath_or_buffer Returns the dataclass IOHandles utf-8strictr)r9r;r:rrrrrr)r)filenamer:)fileobjr:rrNr:rzZero files found in ZIP file z9Multiple files found in ZIP file. Only one file per ZIP: rnamerz Zero files found in TAR archive zDMultiple files found in TAR archive. Only one file per TAR archive: r zstandarddctxcctxr)r9rnewlineFrb)r9readablewritableseekablerz1Expected file path name or file-like object, got z type)rHrJrKr;rC)._is_binary_modecodecslookuprMr8 lookup_errorrr7_maybe_memory_maprr;rrr:rrGzipFilerBZ2File _BytesZipFilebufferappendnamelistlenrrx setdefault _BytesTarFilegetnames extractfilelzmaLZMAFiler"ZstdDecompressorZstdCompressorr9r_BytesIOWrapperr _IOWrapperrr=r|rreverserG)rr:r9r;rrrrioargsrHhandlesis_pathrr zip_namesfilesfilerr open_argsrrKs rErrsz"7H  xF{D)co   MM(&#F#% ' F & &F #4FJ"GFJ%GF../"&&x0K $7s6{+ &  ++--c26FK F "s&++'= KK3 K & &#&#' #  ' E ! !S[[[[#FE !# #F }}!!S(v&"MM224 y>Q&#]]// @F"$'D[M%RSS$22;> E !  ' ' <&#&&GFG6FG '"&fm4 44fmm(((v& ..0u:?!==44U1X>D+++!F$'G }%UVV$::?B D  "T]] #FF "-k:Dfkk!#%:T%:%:%N=M%NO #%8T%8%8%L;K%LM TYY[[F4K=ACS/ !fc***v FC  ??s&++5  F&&++.FvJ v{{d*z&*/M __  z_VV[[%I +6:.6:.'F __   v v00# 6 M&:M:M  fkk'&&"9 11235 :   OO f77===v001  &&  rDcDeZdZdZeZeddZdfd ZxZ S)_BufferedWriterz Some objects do not support multiple .write() calls (TarFile and ZipFile). This wrapper writes to the underlying buffer on close. cyrTrCrUs rEwrite_to_bufferz_BufferedWriter.write_to_buffers'*rDc*|jry|jjr7|jd|j5|j dddn|jj t|y#1swYxYw)Nr)closed getbuffernbytesseekr r"rQsuper)rR __class__s rErQz_BufferedWriter.closese ;;  >>  " " IIaL$$& KK      s B  Br\) r>r?r@rAr r rr"rQ __classcell__r)s@rEr r s) YF**  rDr cXeZdZ d dfd ZddZddZd dZxZS) rc t|||_||_t j j d||j||d||_y)N)rr:rrC) r(__init__ archive_namertarfileTarFiler extend_moder )rRrr:rr/rr)s rEr.z_BytesTarFile.__init__sZ ( (/';';( !!$'(  (  rDc|jdd}|dk7r|S|j-t|jj}|dvr |d|dd}|S)Nrr)r)rrr:r)rrrsuffix)rRr:r5s rEr2z_BytesTarFile.extend_modes_||C$ 3;K 99 $))_++F//q - rDc"|jyt|j}|jdk(r|jdjS|jdvr*|jdjdjS|jS)z If an explicit archive_name is not given, we still want the file inside the zip file not to be named something.tar, because that causes confusion (GH39465). Nrr))rrr)rrr5 with_suffixrRrs rEinfer_filenamez_BytesTarFile.infer_filenamesz 99  ? ??f $''+00 0 __ B B''+77;@@ @}}rDc|jxs|jxsd}tj|}t |j |_|jj||y)Nr)r) r/r9r0TarInfor getvaluesizer addfile)rRr/tarinfos rEr"z_BytesTarFile.write_to_buffer+sT((JD,?,?,AJU //|44==?+  GT*rD)NrNN) r str | Noner:zLiteral['r', 'a', 'w', 'x']rz-ReadBuffer[bytes] | WriteBuffer[bytes] | Noner/r@rrr]r^)r:r8r]r8r]r@r\)r>r?r@r.r2r9r"r*r+s@rErrs_ ,/AE#'   * ?  !      . +rDrcFeZdZ d dfd ZddZddZxZS)rc t||jdd}||_|j dt j t j||fi||_y)Nrr)r;) r(r.rr/r zipfile ZIP_DEFLATEDZipFiler )rRrr:r/rr)s rEr.z_BytesZipFile.__init__4s] ||C$(-)=)=> (/ $(  (  rDct|jjtjt frUt |jj}|jdk(r|jdjS|jSy)z If an explicit archive_name is not given, we still want the file inside the zip file not to be named something.zip, because that causes confusion (GH39465). rr)N) rMr rrnrr8rr5r7rr8s rEr9z_BytesZipFile.infer_filenameIse dkk**R[[#,> ?DKK001H&(++B/444== rDc|jxs|jxsd}|jj||j y)Nr)r/r9r writestrr<)rRr/s rEr"z_BytesZipFile.write_to_bufferUs:((JD,?,?,AJU  \4==?;rDrT) rz1FilePath | ReadBuffer[bytes] | WriteBuffer[bytes]r:r8r/r@rrr]r^rAr\)r>r?r@r.r9r"r*r+s@rErr3sG $(  ?  !      * r?r@r.rOrrrrCrDrErr[s*  rDrc(eZdZdddZddZdd dZy) rc.||_||_d|_y)NrD)r r9overflow)rRr r9s rEr.z_BytesIOWrapper.__init__{s    rDc.t|j|SrTrM)rRattrs rErOz_BytesIOWrapper.__getattr__rPrDc|jJ|jj|j|j}|j|z}||dks|t |k\r d|_|S|d|}||d|_|S)NrrD)r rencoder9rWr )rRn bytestringcombined_bytestring to_returns rErz_BytesIOWrapper.reads{{&&&[[%%a(// > "mmj8 9Ac*=&>!>DM& &+BQ/I/3DM rDN)r)r zStringIO | TextIOBaser9r8r]r^)rYr8r]r))r\z int | Noner]r)r>r?r@r.rOrrCrDrErrxs* rDrcg}|t|dxst|tz}|s|||fStt|}t|trt |d}|j | ttj|jdtj}t|D]}|j |||gfS#t|D]}|jwxYw)zTry to memory map file/buffer.filenorr)access) rrMr8rr!rr rrrb ACCESS_READreversedrQ)rHrrwrappeds rErrs!#G'&(+Fz&#/FFJ z7**- (F&#fd#v II ''  w'F LLN( J )) w'F LLN(s )=C "C/cd}t|}t|ts|S tjj |}|S#t tf$rY|SwxYw)zTest whether file exists.F)rrMr8rnroexistsr|rx)r7rhs rE file_existsris` F'(:; (# .   23 M z "  M sAAAcd|vsd|vrd|vStjtjtjf}t t ||ryt |txsdt|d|vS)z+Whether the handle is opened in binary moderrFr:) r StreamWriter StreamReaderStreamReaderWriter issubclassrrM_get_binary_io_classesrN)rHr: text_classess rErrs d{cTkd{ !! L $v, - f46 7 3'C<rDcttf}tdd}|9|jj d5}|t |fz }ddd|S|S#1swY|SxYw)z!IO classes that that expect bytesrignore)rNrD)r r r"r stream_readerr)binary_classesrrs rErorosk)7 'BN &k( CD   " " $ 2 23 76 tF|o -N8 >8 s AA!c|t|tr tn t|tt|xr't|t xrt fd|DS)a Check whether or not the `columns` parameter could be converted into a MultiIndex. Parameters ---------- columns : array-like Object which may or may not be convertible into a MultiIndex index_col : None, bool or list, optional Column or columns to use as the (possibly hierarchical) index Returns ------- bool : Whether or not columns could become a MultiIndex c3HK|]}|vst|tywrT)rMr)rtc index_columnss rErvz+is_potential_multi_index.. s Pg-9O 1e$gs "")rMr<setr r(ry)columns index_colrxs @rEis_potential_multi_indexr|s_&Jy$7 I  G  Q7M2 2 Q PgP P rDct|}tt}t|D]]\}}||}|dkDrA|dz||<|r%t |t sJg|dd|dd|}n|d|}||}|dkDrA|||<|dz||<_|S)a: Rename column names if duplicates exist. Currently the renaming is done by appending a period and an autonumeric, but a custom pattern may be supported in the future. Examples -------- >>> dedup_names(["x", "y", "x", "x"], is_potential_multiindex=False) ['x', 'y', 'x.1', 'x.2'] rrNr`.)rarrw enumeraterMr)namesis_potential_multiindexcountsrucol cur_counts rE dedup_namesr s KE)4S)9FE"33K !m#a-F3K&!#u---;CR;SWIQyk":;Qyk*s I!ma!ms #" LrD)rgobjectr]r<)r7r8r]r8)r7r*r]r*)r7str | BaseBufferTr]r)r}rr]r^).)r7r/rr<r]r8)r7r*rr<r]r*)F)r7zFilePath | BaseBufferTrr<r]r)rrrrr]r)rgFilePath | BaseBufferr]r<)rNrN) r7rr9r8r;CompressionOptions | Noner:r8rStorageOptions | Noner]r5)ror8r]r8)r;r.r]z"tuple[str | None, CompressionDict])r7rr;r@r]r@)roz Path | strr]r^)rrr:r8r9r@r;r.rr<rzLiteral[False]rr@rr1r]zIOHandles[bytes])rrr:r8r9r@r;r.rr<rz Literal[True]rr@rr1r]zIOHandles[str])rrr:r8r9r@r;r.rr<rr<rr@rr1r]!IOHandles[str] | IOHandles[bytes])rrr:r8r9r@r;rrr<rr<rr@rrr]r)rHr6rr<r]z/tuple[str | BaseBuffer, bool, list[BaseBuffer]])r7rr]r<)rHrr:r8r]r<)r]ztuple[type, ...]rT)rzzSequence[Hashable] | MultiIndexr{zbool | Sequence[int] | Noner]r<)rSequence[Hashable]rr<r]r)mrA __future__rabcrrr collectionsrcollections.abcrrr r_ functoolsrior r r r rrrrnpathlibrrer0typingrrrrrrrrrr urllib.parserrrcrrrrrDpandas._typingr r!pandas.compat._optionalr"pandas.util._exceptionsr#pandas.core.dtypes.commonr$r%r&r'pandas.core.dtypes.genericr(ryrediscardcompilerr*typesr,r-r.r/r0r1r2pandasr3 dataclassr5rGrhrkr~rrrrrrvaluesrrrrrr rrrrrrir lru_cacheror|rrCrDrErs`"#       ?4 5-+- ;< B bjj!WXm:6 #"     ...b0$ 5 5 E E&C: " "8<""rD