\jfBdZddlZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z mZmZmZmZmZmZddlmZdd lmZd d lmZmZmZd d lmZmZmZmZd d l m!Z!m"Z"m#Z#d dlm$Z$m%Z%d dl&m'Z(d dl&m)Z*d dl+m,Z,m-Z-m.Z.GddeZ/de-dddfde0dee0de.dee de1dee1efde de0fdZ2dde-ddfde0dee1efdee0de.dee de1de de1fdZ3de-ddddfd ed!edee0de.dee de1dee1efd"e1de de1fd#Z4dde-ddfd edee1efdee0de.dee de1de de1fd$Z5de-dddfd%ee0e fdee1efde.dee de1dee0de de1fd&Z6d'e%de fd(Z7ejpdeefd)Z9ejpd%ee0e fd'e%deefd*Z:de-ddddddfd%ee0e fdee0de.dee de1d+e1dee1efd,e1d-eede de1fd.Z;e-dddfde0de.dee d/ee1e/fd0e1de deejxfd1Z=e-ddddfd ede.dee d/ee1e/fd0e1d2eee0de deejxfd3Z>e-dddfd%ee0e fde.dee d/ee1e/fd0e1de deejxfd4Z?e-dddfd5eee0e fde.dee d/ee1e/fd0e1de deejxfd6Z@de-fd7ee de.de de.fd8ZAy)9) ImportKeycheck_code_string check_file check_streamfind_imports_in_codefind_imports_in_filefind_imports_in_pathsfind_imports_in_stream place_moduleplace_module_with_reasonsort_code_string sort_file sort_streamN)EnumStringIO)chain)Path)AnyIteratorOptionalSetTextIOUnioncast)warn)core)filesidentifyio)ExistingSyntaxErrorsFileSkipCommentFileSkipSettingIntroducedSyntaxErrors)$ask_whether_to_apply_changes_to_filecreate_terminal_printershow_unified_diff)EmptyFile)module)module_with_reason)CYTHON_EXTENSIONSDEFAULT_CONFIGConfigc eZdZdZdZdZdZdZy)raDefines how to key an individual import, generally for deduping. Import keys are defined from less to more specific: from x.y import z as a ______| | | | | | | | PACKAGE | | | ________| | | | | | MODULE | | _________________| | | | ATTRIBUTE | ______________________| | ALIAS rN)__name__ __module__ __qualname____doc__PACKAGEMODULE ATTRIBUTEALIAS3/root/env/lib/python3.12/site-packages/isort/api.pyrr+s&G FI Er=rFcode extensionconfig file_pathdisregard_skip show_diff config_kwargsreturnc t|}t}td||d|}t||||||||jd|j S)aSorts any imports within the provided code string, returning a new string with them sorted. - **code**: The string of code with imports that need to be sorted. - **extension**: The file extension that contains imports. Defaults to filename extension or py. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **disregard_skip**: set to `True` if you want to ignore a skip set in config for this file. - **show_diff**: If `True` the changes that need to be done will be printed to stdout, if a TextIO stream is provided results will be written to it, otherwise no diff will be computed. - ****config_kwargs**: Any config modifications. pathrA)r@rArBrCrDrr<)r_configrseekread) r?r@rArBrCrDrE input_stream output_streams r>r r Esd(D>LJM  D)F Dm DF%q    r=c Rtd||d|}tt||||||S)a2Checks the order, format, and categorization of imports within the provided code string. Returns `True` if everything is correct, otherwise `False`. - **code**: The string of code with imports that need to be sorted. - **show_diff**: If `True` the changes that need to be done will be printed to stdout, if a TextIO stream is provided results will be written to it, otherwise no diff will be computed. - **extension**: The file extension that contains imports. Defaults to filename extension or py. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **disregard_skip**: set to `True` if you want to ignore a skip set in config for this file. - ****config_kwargs**: Any config modifications. rHrDr@rArBrCr<)rJrr)r?rDr@rArBrCrEs r>rris;* D)F Dm DF %  r=TrMrN raise_on_skipc |xs#|xr|jjdxsd}|rt} t|j} t d | | |||||d|} | j d| j dt | j| j||dur|n||j| Std ||d|}t|xsd} |s|r|j|r t| |} |jrE |j}t|| d dd t}|j's t} t)j*|| ||| } |jrd| j d t| j| d dd | j d| |k7r|j1| j| S#t$r0|tvr t!| |j"rt%| d YwxYw#t,$r t-| wxYw#t$r0|tvr t/| |j"rt%| d YwxYw)aSorts any imports within the provided code stream, outputs to the provided output stream. Returns `True` if anything is modified from the original input stream, otherwise `False`. - **input_stream**: The stream of code with imports that need to be sorted. - **output_stream**: The stream where sorted imports should be written to. - **extension**: The file extension that contains imports. Defaults to filename extension or py. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **disregard_skip**: set to `True` if you want to ignore a skip set in config for this file. - **show_diff**: If `True` the changes that need to be done will be printed to stdout, if a TextIO stream is provided results will be written to it, otherwise no diff will be computed. - ****config_kwargs**: Any config modifications. .py)rMrNr@rArBrCrQrT file_input file_outputrBoutput color_outputrHzPassed in contentexecrz< Python AST errors found but ignored due to Cython extension)r@rArQr<)suffixlstriprrLrrKr(rYrJstr is_skippedr$atomiccompile SyntaxErrorr-r"verboserreadablerprocessr#r%write)rMrNr@rArBrCrDrQrE_output_stream _input_streamchangedcontent_source_internal_output file_contents r>rrs0QiHI,<,<,C,CC,HQTI! !2!2!45   &()'     A1$))+&++-$-$5=9,,    D)F Dm DF9&9:N iF,=,=i,Hn--$ }} ',,.L L.&!Q ? - %%''z  .,,  '  }}a   $))+^VQ J  ! !! $ } ,    0 5 5 7 8 NM  11*>::~~%&&bc  ( .n--.  11,^<<~~%&&bc  s0 GH .H16HHH.16I*)I*c ztd ||d|}|rt|j}t|t||||}t |j |j|j}|s1|jr$|js|j|xsddy|j|xsdd|rt} |jd|j} tt| | ||||| jdt| | j||durd n||j y ) aEChecks any imports within the provided code stream, returning `False` if any unsorted or incorrectly imports are found or `True` if no problems are identified. - **input_stream**: The stream of code with imports that need to be sorted. - **show_diff**: If `True` the changes that need to be done will be printed to stdout, if a TextIO stream is provided results will be written to it, otherwise no diff will be computed. - **extension**: The file extension that contains imports. Defaults to filename extension or py. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **disregard_skip**: set to `True` if you want to ignore a skip set in config for this file. - ****config_kwargs**: Any config modifications. rH)rMrNr@rArBrC)colorerrorsuccessz Everything Looks Good!Tz1 Imports are incorrectly sorted and/or formatted.rNrUFr<)rJrrLrr)r'rY format_errorformat_successrb only_modifiedrornrKr() rMrDr@rArBrCrErhprinterrN file_contentss r>rrsA* D)F Dm DF 1 1 34 !% G&!!)<)>&"6"6 OOyB//FG H MMY_"%%VWX !$))+ !-0')   1$%**,$,4),,   r=filenamec p|}d|vrR|jdd}|r>|j|} |jrt| dd|t di| d}t j j|5} t| jf||||xs | j|d|cdddS#1swYyxYw)a)Checks any imports within the provided file, returning `False` if any unsorted or incorrectly imports are found or `True` if no problems are identified. - **filename**: The name or Path of the file to check. - **show_diff**: If `True` the changes that need to be done will be printed to stdout, if a TextIO stream is provided results will be written to it, otherwise no diff will be computed. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **disregard_skip**: set to `True` if you want to ignore a skip set in config for this file. - **extension**: The file extension that contains imports. Defaults to filename extension or py. - ****config_kwargs**: Any config modifications. config_trieNr used for file rrPr<) popsearchrbprintr/r!r*rLrstreamrI) rvrDrArBrCr@rE file_configrx config_info source_files r>rr1s*!K %#'' t< %,,X6K~~Q(zBC 2;q>2K h   ;    3;#3#3)       s 8*B,,B5rcf|jj|jjdzS)Nz.isorted)rI with_suffixr[)rs r> _tmp_filer]s*    ' ' (8(8(?(?*(L MMr=c#(Ktdyw)N)newlinerr<r=r> _in_memory_output_stream_contextras 4  sc#Kt|}|jd|jd5}tj|||dddy#1swYyxYww)Nzw+rp)encodingr)ropenrshutilcopymode)rvrtmp_filerNs r>_file_output_stream_contextrfsR%H tk&:&:B G=(+s*AA AAA ask_to_applywrite_to_stdoutrXc |} d| vrR| jdd} | r>| j|} |jrt| dd|t di| d} t j j|5} |xs | j}td|| d| }d} |r+t| jtj||||}n| |jr t}n t!|| }|5}t| j|||||}|j#d|r@|s|r| jj#dt%| jj|j||d urdnt't(||j* |s |rXt-t/| js: ddd |jst1| }|j3dddy| jj7|jrK|j#d| jj9d 5}t;j<||dddddd|rV|js&t1| }|j?| j|j@std | j |jst1| }|j3nt| j|||||}|rt|rr| jj#d|j#dt%| jj|j||d urdn||j* | jj7|cdddS#t4$rYwxYw#1swYYxYw#1swY^xYw#t4$rY@wxYw# |jst1| }|j3ww#t4$rYwwxYwxYw#tB$rtE|d YtF$rtE|dYwxYw#1swYyxYw)a:Sorts and formats any groups of imports imports within the provided file or Path. Returns `True` if the file has been changed, otherwise `False`. - **filename**: The name or Path of the file to format. - **extension**: The file extension that contains imports. Defaults to filename extension or py. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **disregard_skip**: set to `True` if you want to ignore a skip set in config for this file. - **ask_to_apply**: If `True`, prompt before applying any changes. - **show_diff**: If `True` the changes that need to be done will be printed to stdout, if a TextIO stream is provided results will be written to it, otherwise no diff will be computed. - **write_to_stdout**: If `True`, write to stdout instead of the input file. - **output**: If a TextIO is provided, results will be written there rather than replacing the original file content. - ****config_kwargs**: Any config modifications. rxNrryrrHF)rMrNrArBrCr@TrUwzFixing z- unable to sort due to existing syntax errorsz5 unable to sort as isort introduces new syntax errorsr<)$rzr{rbr|r/r!r*rLrIrJrr}sysstdoutoverwrite_in_placerrrKr(rrrYr&r]runlinkFileNotFoundErrorcloserr copyfileobjreplacequietr"rr%)rvr@rArBrCrrDrrXrEr~rxrractual_file_pathrhoutput_stream_contextrNrfss r>r r nsM8!K %#'' t< %,,X6K~~Q(zBC 2;q>2K h `;$8 (8(8T.{TmTZ ]%!,!3!3"%**!.#1' >5!!444T4V14O (+513!Nm&1-8-?-?.;'-*:/=*3 'G*..q1&#, $/$6$6$;$;A$>$53>3E3E3J3J3L4A4F4F4H2B+4+<04-1&)-D5;5H5H%&(1(40T,/ 0@0@,A1*059!NR!#)#<#<+4[+A ( 1G``h!, 2 2 8 8 :#)#<#<$1$6$6q$9)4)9)9)>)>s)C%Nr(.(:(:="(M%NA!ND##)#<#<+4[+A ( 0 01A1A B#)<< % 0@0@/A&B C!#)#<#<+4[+A ( 1*%0%7%7&,%"2'5"+ G9#**//2 A)'2'9'9'>'>'@(. &6+4+<4))/)<)<  &&,,.A``H 1! !%N%NA!N!NZ 1! ! !#)#<#<+4[+A ( 1$= 1! !.$ U $%%RS T% ] $%%Z[ \ ]{``s8!Q 0P %O0CN<6O?'N/AN<N/N< A O'O (B,PQ  N,(P+N,,P/N9 4N<<O O OPOPP'PP P PP PPQ,Q .QQ QQ  Quniquetop_onlyc +TKtdt|||||d|Ed{y7w)aFinds and returns all imports within the provided code string. - **code**: The string of code with imports that need to be sorted. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **unique**: If True, only the first instance of an import is returned. - **top_only**: If True, only return imports that occur before the first function or class. - ****config_kwargs**: Any config modifications. rMrArBrrNr<)r r)r?rArBrrrEs r>rrs<"&d^   s (&(_seenc+"Ktdd|i|}tj||||}|s |Ed{| tn|}|D]} |dtj fvr| j } n|tjk(r| jd| j} nQ|tjk(r | j} n1|tjk(r| jjdd}  s| |vs|j| | y7ܭw)afFinds and returns all imports within the provided code stream. - **input_stream**: The stream of code with imports that need to be sorted. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **unique**: If True, only the first instance of an import is returned. - **top_only**: If True, only return imports that occur before the first function or class. - **_seen**: An optional set of imports already seen. Generally meant only for internal use. - ****config_kwargs**: Any config modifications. rA)rArBrNTrSrr<)rJr importssetrr; statementr:r+ attributer9r8splitadd) rMrArBrrrrEidentified_importsseenidentified_importkeys r>r r s & 4F 4m 4F!))Vy8 %%%#mSUD/ $ dIOO, ,#--/C y** *&--.a0A0K0K/LMC y'' '#**C y(( (#**005a8C 3d? HHSM# # $ &s.DD B>D0D5Dc +Ktjj|5}td|j||xs |j ||d|Ed{dddy7 #1swYyxYww)acFinds and returns all imports within the provided source file. - **filename**: The name or Path of the file to look for imports in. - **extension**: The file extension that contains imports. Defaults to filename extension or py. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **unique**: If True, only the first instance of an import is returned. - **top_only**: If True, only return imports that occur before the first function or class. - ****config_kwargs**: Any config modifications. rNr<)r!r*rLr r}rI)rvrArBrrrErs r>rr=sz$ h  ;) $++3;#3#3           s. A+-AAA A+AA($A+pathsc +Ktddi|r tndtfdtjt t |ggDEd{y7w)ajFinds and returns all imports within the provided source paths. - **paths**: A collection of paths to recursively look for imports within. - **extension**: The file extension that contains imports. Defaults to filename extension or py. - **config**: The config object to use when sorting imports. - **file_path**: The disk location where the code string was pulled from. - **unique**: If True, only the first instance of an import is returned. - **top_only**: If True, only return imports that occur before the first function or class. - ****config_kwargs**: Any config modifications. rANc3>K|]}t|yw))rrArrN)r).0 file_namerArrrs r> z(find_imports_in_paths..os1  !&(RV   sr<)rJrrrfindmapr])rrArBrrrErs ` `` @r>rrZs\$ 4F 4m 4F(.suDD #ZZCRH  sAA%A#A%rIc t|r|tur d|vr d|vr||d<|r|tur tdtdi|}|S)N settings_path settings_fileziYou can either specify custom configuration options using kwargs or passing in a Config object. Not Both!r<)r. ValueErrorr/)rIrArEs r>rJrJxsZ . = 0 = 0)- o&  '8  (-( Mr=)B__all__ contextlibrrenumrr!r itertoolsrpathlibrtypingrrrrrrrwarningsrisortrrprr exceptionsr"r#r$r%formatr&r'r(r)r*placer+r r,r settingsr-r.r/rr]boolr rrrrrcontextmanagerrrr Importrr rrrJr<r=r>rs   DDD!! ed)A??8 $# $ %* ! ! }!  ! ~ !  ! T6\" ! !  ! L&+## $  T6\"}   ~    F $# $ %*bbb}b  b ~ b  bT6\"bbb bN&+## $ @@T6\"@}@  @ ~ @  @@ @J&+# $# ) CI) T6\")  ) ~ )  ) } ) )  ) XN4NDN !(6*:!! %T *:RZ[aRb $# $%*!#GCIG}G G~ G  G  GT6\"GG V GG GX$ $%*   ~ $ / "     hoo:$ $%* $ '$'$ '$~'$ $ / " '$  '$ CH  '$'$hoo'$X$ $%*  CI  ~  $ / "      hoo >$ $%*  E#t)$ % ~ $ / "     hoo> . 4.)/SV r=