QЦi'0 SrSSKrSSKrSSKrSSKrSSKJr SSKJrJrJ r SSK r SSK J r SSK JrJrJrJrJrJrJr SSKJrJrJrJr SS KJrJrJrJrJrJ r J!r!J"r" \ RF"\$5r%\""S S 9r&S \'S \(\'\'44Sjr)SS\ \*\+4S\,S \'4Sjjr-SS\\S\,S \'4Sjjr.SS\/\ \\4S\,S\,S \/\'4Sjjr0SS\1S\/\'S\'S\*S\*S\,S S4Sjjr2\&RgS/SQS 9SS!\\'\ Rh"S"S 94S#\\,\ Rj"S$S%S 94S&\\,\ Rj"S'S(S 94S\S)\S S4 S*jj5r6S \'S \,4S+jr7\&RgS,/S-QS 9SSSS\RpSS4S \\\'\ Rh"S.S 94S\\,\ Rj"S/S0S1S 94S2\\,\ Rj"S3S4S 94S5\\,\ Rj"S6S7S8S 94S9\S\S)\S S4S:jj5r9S;\\'S\,S2\,S5\,S9\S\,S)\\'S S4S<jr:S \'S\,S2\,S5\,S9\S\,S)\\'S S4S=jr;\&RgS>S?S@/S 9SS!\\'\ Rh"SAS 94S\S)\S S4SBjj5r<\&RgSC/SDQS 9SS!\\'\ Rh"SAS 94SE\\,\ Rj"SFSGSHS 94SI\\,\ Rj"SJSKS 94S\S)\S S4 SLjj5r=\&RgSM/SNQS 9SS \\'\ Rh"SOS 94S5\\,\ Rj"S6S7SPS 94SE\\,\ Rj"SFSGSHS 94SQ\\,\ Rj"SRSSS 94ST\\\/\'\ Rj"SUS 94SV\\\/\'\ Rj"SWS 94S\S)\S S4SXjj5r>\&RgSY/SZQS 9SS[\\'\ Rh"S\S 94S]\\'\ Rh"S^S 94S)\S S4S_jj5r?\&RgS`/SaQS 9SSb\\\'\ Rh"ScS 94Sd\\\'\ Rh"SeS 94SC\\,\ Rj"SfS 94Sg\\,\ Rj"ShSiS 94Sj\\,\ Rj"SkSlS 94Sm\\\'\ Rj"SnS 94So\\\'\ Rj"SpS 94SQ\\,\ Rj"SRSqS 94ST\\\/\'\ Rj"SrS 94SV\\\/\'\ Rj"SsS 94St\\\'\ Rj"SuS 94Sv\\,\ Rj"SwSxS 94Sy\\,\ Rj"SzS{S 94S|\\,\ Rj"S}S~SS 94S\\,\ Rj"SSSS 94S)\S S4"Sjj5r@\&RgS/SQS 9SS\\'\ Rh"SS 94S\\\'\ Rh"SS 94S\S)\S S4 Sjj5rAg)z7Contains commands to interact with buckets via the CLI.N)datetime) AnnotatedOptionalUnion)logging) BUCKET_PREFIX BucketFile BucketFolder FilterMatcher_is_bucket_path_parse_bucket_path_split_bucket_id_and_prefix) StatusLineare_progress_bars_disableddisable_progress_barsenable_progress_bars) FormatOpt OutputFormatQuietOptTokenOptapi_object_to_dict get_hf_apiprint_list_output typer_factoryz"Commands to interact with buckets.)helpargumentreturncUR[5(a [U5$[U5$![a [ SUS[S35ef=f)zParse a bucket argument accepting both 'namespace/name(/prefix)' and 'hf://buckets/namespace/name(/prefix)'. Returns: tuple: (bucket_id, prefix) where bucket_id is "namespace/bucket_name" and prefix may be empty string. zInvalid bucket argument: -. Must be in format namespace/bucket_name or znamespace/bucket_name) startswithrr r ValueError)rs Z/var/www/html/ai-image-ml/venv/lib/python3.13/site-packages/huggingface_hub/cli/buckets.py_parse_bucket_argumentr$8se =))!(++ *844  'z2 /!6 8   s 2!AFsizehuman_readablecU(d [U5$SH'nUS:aUS:Xa USU3s $USSU3s $US-nM) USS3$)zFormat a size in bytes.)BKBMBGBTBir( z.1fz PB)str)r%r&units r# _format_sizer0Ise 4y- $;s{q''3Zq' '   . 3Zs mtimec\UcgU(aURS5$URS5$)z0Format mtime datetime to a readable date string.z %b %d %H:%Mz%Y-%m-%d %H:%M:%S)strftime)r2r&s r# _format_mtimer6Ws, }~~m,, >>- ..r1itemsquietc 20nUHmnURRS5nUnUSSHnXv;aS00Xg'XgSnM USn[U[5(aX;aS00Xh'MeMgSU0Xh'Mo Sn Sn Sn U(dUHpn[U[5(dM[ UR U5n [U [U 55n [URU5n [U [U 55n Mr U S:aU S-U -n /n[UUSU U US 9 U$) aBuild a tree representation of files and directories. Produces ASCII tree with size and date columns before the tree connector. When quiet=True, only the tree structure is shown (no size/date). Args: items: List of BucketFile/BucketFolder items human_readable: Whether to show human-readable sizes and short dates quiet: If True, show only the tree structure without sizes/dates Returns: List of formatted tree lines /N __children____item__rr4 prefix_widthmax_size_widthr&) pathsplit isinstancer r r0r%maxlenr6r2 _render_tree)r7r&r8treeitempartscurrentpart final_partr@rAmax_date_widthsize_strdate_strliness r# _build_treerR`sC&D $#2JD"!/ 4 mN3G 2Y dL ) )('5r&:#)$.t"4G  LNN D$ ++' >B!$^S]!C(^D!$^S]!C  A )A->LE   !%%  Lr1noderQindentr@rAc n[UR55n[U5GH unupU[U5S- :Hn U (aSOSn SU ;n U R S05n US:aU (aSU-nOQU R S5nUb8[ UR U5n[URU5nUS U3S U3nOSU-nURUS UU UU (aS OS 35 O"URUU UU (aS OS 35 U (dMX*(aS OS-n[U UUUUUS9 GM g)z:Recursively render a tree structure with size+date prefix.ru └── u ├── r<rr-r=N> r:r4z u│ r?) sortedr7 enumeraterFgetr0r%r6r2appendrG)rSrQrTr@rAr&r7inamevalueis_last connectoris_dirchildrenprefixrIrOrP child_indents r#rGrGsE 4::< E%e,=Ds5zA~%$+L 5(99^R0 ! |+yy,#+DII~FH,TZZHH (>*:(:;2hZHF </F LLF82fXi[fsRT>UV W LLF8I;tfFS4KL M 8!wVHEL )--  1-r1create)zhf buckets create my-bucketz hf buckets create user/my-bucketz-hf buckets create hf://buckets/user/my-bucketz*hf buckets create user/my-bucket --privatez+hf buckets create user/my-bucket --exist-ok)r]examples bucket_idzTBucket ID: bucket_name, namespace/bucket_name, or hf://buckets/namespace/bucket_nameprivatez --privatezCreate a private bucket.exist_okz --exist-okz3Do not raise an error if the bucket already exists.tokenc[US9nUR[5(a8[U5upgU(a![ R "SUS[S35eUnURUU(aUOSUS9n U(a[U R5 g[SU RSU RS 35 g![a$n[ R "[U55eSnAff=f) zCreate a new bucket.rjNz-Cannot specify a prefix for bucket creation: . Use namespace/bucket_name or namespace/bucket_name.)rhrizBucket created: z (handle: )) rr!rr$r"typer BadParameterr. create_bucketprinthandleurl) rgrhrir8rjapi parsed_idrce bucket_urls r#reresF 5 !CM** - 6y A I $$? {K11>?UW  """#J   j    0 :;L;L:MQOP# -$$SV, , -s B:: C(C##C(crUR[5(aU[[5SnSU;$UnSU;$)zFCheck if argument is a bucket ID (namespace/name) vs just a namespace.Nr:)r!rrF)rrBs r# _is_bucket_idr{sB=))M*,- $; $;r1z list | ls) zhf buckets listzhf buckets list huggingfacezhf buckets list user/my-bucketz!hf buckets list user/my-bucket -Rz!hf buckets list user/my-bucket -hz%hf buckets list user/my-bucket --treez(hf buckets list user/my-bucket --tree -hz+hf buckets list hf://buckets/user/my-bucketz%hf buckets list user/my-bucket/sub -RzyNamespace (user or org) to list buckets, or bucket ID (namespace/bucket_name(/prefix) or hf://buckets/...) to list files.z--human-readablez-hz$Show sizes in human readable format.as_treez--treez3List files in tree format (only for listing files). recursivez --recursivez-Rz0List files recursively (only for listing files).formatc |USL=(a [U5nU(a[UUUUUUUS9 g[UUUUUUUS9 g)zList buckets or files in a bucket. When called with no argument or a namespace, lists buckets. When called with a bucket ID (namespace/bucket_name), lists files in the bucket. N)rr&r|r}r~r8rj) namespacer&r|r}r~r8rj)r{ _list_files _list_buckets)rr&r|r}r~r8rj is_file_modes r#list_cmdrsXr4'CM(,CL)  ) r1rc X^U(a[R"S5eU(a[R"S5eUb=UR[5(a#U[ [5SnUR S5n[ US9nURUS9Vs/sHn[U5PM n nU (dCU(d<U[R:wa(UbUOUR5Sn [SU S 35 g/S Qn S [S [[4U4S jjn SSS.n [!XX[XS9 gs snf)zList buckets in a namespace.z'Cannot use --tree when listing buckets.z,Cannot use --recursive when listing buckets.Nr:rl)rr]z"No buckets found under namespace ''.)idrhr% total_files created_atrIrc >SSKJn U"URS55U"URS55[URSS5TS9U"URS55U"URS 55/$) Nr) _format_cellrrhr%rr&rr) _cli_utilsrrZr0)rIrr&s r#row_fn_list_buckets..row_fnsj, $ ( ), - &!,^ L -0 1 ,/ 0   r1right)r%r)r~r8headersr alignments)rprqr!rrFrstripr list_bucketsrrjsonwhoamirsdictlistr.r)rr&r|r}r~r8rjrvbucketresultsresolved_namespacerrrs ` r#rras  !JKK  !OPP!5!5m!D!Dc-023 $$S) 5 !C8;8H8HS\8H8]^8]f!&)8]G^ <#4#44.7.CV\I]  67I6J"M N DG  T  d3i  "':JgESYq-_sD'c U(a*U[R:Xa[R"S5e[ US9n[ U5up[URUU =(d SUS95n U (d [S5 g[SU 55n U[R:Xa;U V s/sHn [U 5PM nn [[R"USS95 GOU(a[XUS 9nUHn[U5 M OU(aNU HGn [U [ 5(a[U R"S 35 M2[U R"5 MI OU Hn [U [ 5(a8[%U R&U5n[S S S USS U R"S 35 MP[)U R*U5n[%U R,U5n[US S USS U R"35 M U(d"U (a[/5R1S5 ggg![ a$n [R"[U 55eSn A ff=fs sn f)zList files in a bucket.z%Cannot use --tree with --format json.rlNrcr}z(empty)c3B# UHn[U[5v M g7fN)rDr ).0rIs r# _list_files..sKUT*T<88Usr>rT)r&r8r:r4z>12rWz>19z!Use -R to list files recursively.)rrrprqrr$r"r.rlist_bucket_treersanyrdumpsrRrDr rBr6 uploaded_atr0r%r2rdone)rr&r|r}r~r8rjrvrgrcrxr7has_directoriesrIr tree_linesline mtime_strrOs r#rrs6\...  !HII 5 !C)28<   >T   E  iKUKKO """8=>%d+> djj+,  US D $K D$ -- 1o&dii D$ --)$*:*:NK C9S/DII;a@A' >B)$**nE #b3r$))EF  =>)9W )  Q(()&?s H&)I& I0IIinfozhf buckets info user/my-bucketz+hf buckets info hf://buckets/user/my-bucketzFBucket ID: namespace/bucket_name or hf://buckets/namespace/bucket_namec>[US9n[U5upEUR U5nU(a[UR5 g[[R"[U5SS95 g![a$n[R"[ U55eSnAff=f)zGet info about a bucket.rlNr>r) rr$r"rprqr. bucket_inforsrrrr)rgr8rjrvrw_rxrs r#rrs~$ 5 !C)-i8 __Y 'F  fii djj+F3A>? )  Q(()s A.. B8BBdelete)z hf buckets delete user/my-bucketz-hf buckets delete hf://buckets/user/my-bucketz&hf buckets delete user/my-bucket --yesz-hf buckets delete user/my-bucket --missing-okyesz--yesz-yzSkip confirmation prompt. missing_okz --missing-okz3Do not raise an error if the bucket does not exist.c\UR[5(a9[U5upVU(a![R "SUS[S35eUnO'SU;a![R "SUS[S35eU(dA[R"SUS 35nU(d [S 5 [R"5e[US 9n U RXS 9 U(a [U5 g[S U35 g![a$n[R "[ U55eSnAff=f)zwDelete a bucket. This deletes the entire bucket and all its contents. Use `hf buckets rm` to remove individual files. Nz-Cannot specify a prefix for bucket deletion: rmrnr:zInvalid bucket ID: r z(Are you sure you want to delete bucket ''?Aborted.rl)rzBucket deleted: ) r!rr$r"rprqr.confirmrsAbortr delete_bucket) rgrrr8rjrwrcrxrrvs r#rrs)LM** - 6y A I $$? {K11>?UW  I   !)-;;H/I_ a  --"J9+UW XY * ++-  5 !Ci7  i   ,-3 -$$SV, , -s C== D+D&&D+z remove | rm)z)hf buckets remove user/my-bucket/file.txtz2hf buckets rm hf://buckets/user/my-bucket/file.txtz.hf buckets rm user/my-bucket/logs/ --recursivez:hf buckets rm user/my-bucket --recursive --include "*.tmp"z8hf buckets rm user/my-bucket/data/ --recursive --dry-runzBucket path: namespace/bucket_name/path or hf://buckets/namespace/bucket_name/path. With --recursive, namespace/bucket_name is also accepted to target all files.z0Remove files recursively under the given prefix.dry_runz --dry-runz8Preview what would be deleted without actually deleting.includezQInclude only files matching pattern (can specify multiple). Requires --recursive.excludezLExclude files matching pattern (can specify multiple). Requires --recursive.c[U5upU S:Xa$U(d[R"SUSUS35eU(dU(aU(d[R"S5e[ US9n U(Gak[ U(+S9n U RS 5 /n U RUU RS 5=(d SS S 9HIn[U[5(dMU RU5 U RS [U 5S35 MK U RS [U 5S35 U(dU(a>[XES9nU Vs/sH'nUR!UR"5(dM%UPM) nnOU nUVs/sHnUR"PM nn[%SU55n['US S9nU(dU(d [)S5 g[U5SU3nU(diU(dbU(dUHn[)SU35 M [R*"SUSUS35nU(d [)S5 [R,"5eU(a0UHn[)S[.US U35 M [)SUS35 gU R1UUS9 U(aUHn[)U5 M gUHn[)S[.US U35 M [)SUSUS35 gU RS 5nU(d[R"S5eU(a#[)S[.US U35 [)S 5 gU(dD[R*"S!US"US35nU(d [)S5 [R,"5eU R1UU/S9 U(a [)U5 g[)S[.US U35 g![a$n [R"[ U 55eSn A ff=fs snfs snf)#zZRemove files from a bucket. To delete an entire bucket, use `hf buckets delete` instead. Nr4z?No file path specified. To remove files, provide a path (e.g. 'zd/FILE') or use --recursive to remove all files. To delete the entire bucket, use `hf buckets delete z`.z,--include and --exclude require --recursive.rl)enabledzListing files from remoter:TrzListing files from remote (z files))include_patternsexclude_patternsc38# UHoRv M g7fr)r%)rfs r#rremove..s7AsrzNo files to remove.z file(s) totaling rWzRemove z from 'rrzdelete: z (dry run) z would be removed.)rzRemoved rzFile path cannot be empty.z"(dry run) 1 file would be removed.zRemove 'z' from ')r$r"rprqr.rrupdaterrrDr r[rFrr matchesrBsumr0rsrrrbatch_bucket_files)rr}rrrrr8rjrgrcrxrvstatus all_filesrImatcherr matched_files file_paths total_sizerO count_labelrBr file_paths r#remover7s|)28< |I   k"DDM;b R  7I  !OPP 5 !CI. 12&( (( ==%-) D $ ++  & ;C N;K7ST   1#i.1AIJ g#WWG(1M 1W__QVV5LQ MMM%M&34maffm 4777  4@+, Z));H:F 7&DBtf+&'mmgk]')B$OPGj!kkm# " {!D6BC# J{m+=> ?  y< "d ## {!D6BC# H[M 2> ?MM#& $$%AB B  H]OI;a {C D 6 7 mmhyk)B$OPGj!kkm# y)=  )  H]OI;a {C Dw )  Q(()@N5s) N?$O0-O0<O5? O- O((O-move)z/hf buckets move user/old-bucket user/new-bucketz/hf buckets move user/my-bucket my-org/my-bucketzIhf buckets move hf://buckets/user/old-bucket hf://buckets/user/new-bucketfrom_idzMSource bucket ID: namespace/bucket_name or hf://buckets/namespace/bucket_nameto_idzRDestination bucket ID: namespace/bucket_name or hf://buckets/namespace/bucket_namec*[U5up4U(a![R"SUS[S35e[U5upVU(a![R"SUS[S35e[ US9nUR X5S9 [ SUSU35 g) z2Move (rename) a bucket to a new name or namespace.z)Cannot specify a prefix for bucket move: rmrnrl)rrzBucket moved:  -> N)r$rprqrr move_bucketrs)rrrjparsed_from_id from_prefix parsed_to_id to_prefixrvs r#rrs2#9"AN  7yA--:O;Q S  5U;L  7w?--:O;Q S  5 !COONO? N>*$|n =>r1sync)z2hf buckets sync ./data hf://buckets/user/my-bucketz2hf buckets sync hf://buckets/user/my-bucket ./dataz;hf buckets sync ./data hf://buckets/user/my-bucket --deletez^hf buckets sync hf://buckets/user/my-bucket ./data --include "*.safetensors" --exclude "*.tmp"zIhf buckets sync ./data hf://buckets/user/my-bucket --plan sync-plan.jsonlz'hf buckets sync --apply sync-plan.jsonlzhf buckets cp my-config.json hf://buckets/user/my-bucket/logs/zKhf buckets cp my-config.json hf://buckets/user/my-bucket/remote-config.jsonz7hf buckets cp - hf://buckets/user/my-bucket/config.jsonsrcz9Source: local file, hf://buckets/... path, or - for stdindstz?Destination: local path, hf://buckets/... path, or - for stdoutc  [US9n[U5nUSL=(a [U5nUS:HnUS:HnU(aU(a[R"S5eU(d=U(d6U(d/Uc[R"S5e[R"S5eU(aU(d[R"S5eU(aKU(aDUce[ U5upU S:XdU R S 5(a[R"S 5eU(aU(d[R"S 5eU(dAU(d:[ RRU5(a[R"S 5eU(Ga9[ U5upU S:XdU R S 5(a[R"S 5eU RS S5Sn U(a[5n U (d [5 [R"5n[ RRX5nURXU4/5 [!US5n["R$R&R)UR+55 SSS5 SSS5 U (d [-5 ggUcU nO[ RRU5(d:UR [ R.5(dUR S 5(a [ RRX5nOUn[ RR1U5nU(a[ R2"USS9 U(a [5 URXU4/5 U(a [-5 U(d[5SUSU35 ggU(a[ U5un n["R6R&R+5nU(a [5 UR9U UU4/S9 U(a [-5 U(d[5SU35 gg[ RR;U5(d[R"SU35e[ U5upU S:Xa [ RR=U5nO;U R S 5(a#U [ RR=U5-nOU nU(a [5 UR9XU4/S9 U(a [-5 U(dUS[>U S U35 gg!,(df  GN=f!,(df  GN=f!U (d [-5 ff=f!U(a [-5 ff=f!U(a [-5 ff=f!U(a [-5 ff=f)z'Copy a single file to or from a bucket.rlN-z$Remote-to-remote copy not supported.z2Missing destination. Provide a bucket path as DST.z;One of SRC or DST must be a bucket path (hf://buckets/...).z+Stdin upload requires a bucket destination.r4r:zAStdin upload requires a full destination path including filename.z"Cannot pipe to stdout for uploads.zNSource must be a file, not a directory. Use `hf buckets sync` for directories.zJSource path must include a file name, not just a bucket or directory path.rr;rbT)riz Downloaded: r)addzUploaded: stdin -> zSource file not found: z Uploaded: ) rr rprqr endswithosrBisdirrsplitrrtempfileTemporaryDirectoryjoindownload_bucket_filesopensysstdoutbufferwritereadrsepdirnamemakedirsrsstdinrisfilebasenamer)rrr8rjrv src_is_bucket dst_is_bucket src_is_stdin dst_is_stdoutrrcrgfilenamepbar_was_disabledtmp_dirtmp_pathr local_path parent_dir remote_pathdatas r#rrso, 5 !C#C(MtO<(H--i8:L9MNh- ))//9.3 )(*){% s##s||BFF';';s||C?P?PWW\\#8  4J J6%' +)))z6J5KL(* SEj\:; !3C!8 ;yy$$&  ! # '  " "9D+3F2G " H$& 'u- . ww~~c""$$'>se%DE E.s3 R<''**3/K __S ! ! 277#3#3C#88K K  ! # '  " "93E2F " G$& Jse4 yk;-P QI.-32 )(*)*(* $&2$&sa>U1AU8U  UU1VVV6 U U U.)U11VVV36W )F)FF)rrF)FFFN)FN)FFFNNFNr)NNFFFNNFNNNFFFFN)NFN)B__doc__rrrrrtypingrrrrphuggingface_hubrhuggingface_hub._bucketsrr r r r r rhuggingface_hub.utilsrrrrrrrrrrrrr get_logger__name__logger buckets_clir.tupler$intfloatboolr0r6rrRrrGcommandArgumentOptionrer{tablerrrrrrrrrr1r#r!s > -- #vu      H %!EF  S U38_ " uS%Z( $ 3 /(+/T/c/!< j,./ 0<< < #Y <F ) ) 9) ) )  )  ) )X   .  -/Q  g  /Q  +  /Q  F  /Q* +/Q, -/Q. //Q /QdCD    .    $**G@   W  @    7  @ $  F  %@ 2   C  3@ B C@ D E@ F G@ H I@  @ F-r}-r-r-r -r  -r  -r C=-r -r`>?>?>?>? >?  >?  >? C=>? >?B  (5@  Y  @ @ @ @@2  .  /9.  Y  9.    ,   9.  F  9., -9.. /9.0 19.9.x   6    ]QE  a  QE   C  QE$    ,   %QE4  K  5QEBc d  CQENc _  OQEZ [QE\ ]QE^ _QE QEh  *"?   `  "?   e   "? "? "?"?T    &          Ix   ^   x   c   x   B   x&  N  'x4  O  5xB   P   CxN   6   OxZ  H  [xhc I  ixtc I  ux@  ;  AxL  T  MxZ  V  [xh   8  ixx    "   yxH IxJ Kx x@    "  R 3,ghh iR  u~~+lmm R  R  R R Rr1