ii% SrSSKrSSKrSSKJr SSKrSSKJr SSKJ r J r J r J r J r Jr SSKJrJrJrJrJr SSKJrJrJrJr SS KJrJr SS KJrJr \R@"\!5r"\"S S 9r#S \$S\%4Sjr&S\$S\'\$\$44Sjr(\#RSS/SQS9S}S\\$\RT"SS 94S\\%\RV"SSS 94S\\%\RV"SSS 94S\SS4 Sjj5r,S\$S\%4Sjr-\#RSS /S!QS9S~S\\$S-\RT"S"S 94S#\\%\RV"S$S%S&S 94S'\\%\RV"S(S)S 94S*\\%\RV"S+S,S-S 94S.\S\SS4S/jj5r.S0\$S-S.\$S-S#\%S'\%S*\%S\$S-SS4S1jr/S\$S#\%S'\%S*\%S\$S-SS4 S2jr0\#RSS3S4S5/S9SS\\$\RT"S6S 94S\SS4S7jj5r1\#RSS8/S9QS9S}S\\$\RT"S6S 94S:\\%\RV"S;S\\%\RV"S?S@S 94S\SS4 SAjj5r2\#RSSB/SCQS9SS\\$\RT"SDS 94S*\\%\RV"S+S,SES 94S:\\%\RV"S;S?UW  """#J JJ (9(9z~~N -$$SV, , -s B!! C+C  CcrUR[5(aU[[5SnSU;$UnSU;$)zFCheck if argument is a bucket ID (namespace/name) vs just a namespace.N/)rrlen)r!rs r _is_bucket_idr@sB=))M*,- $; $;r z list | ls) zhf buckets listzhf buckets list huggingfacez$hf buckets list --search "my-prefix"zhf 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.human_readablez--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).searchc USL=(a [U5nU(a'Ub[R"S5e[UUUUUS9 g[ UUUUUUS9 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. Nz'Cannot use --search when listing files.)r!rArBrCr,) namespacerDrArBrCr,)r@r3r4 _list_files _list_buckets)r!rArBrCrDr, is_file_modes rlist_cmdrJsgr4'CM(,CL  $$%NO O)   )  r rFc ,U(a[R"S5eU(a[R"S5eUb=UR[5(a#U[ [5SnUR S5n[ US9nURXS9Vs/sHZnURURU(a[URU5O URURURS.PM\ nn[R"USSS .S 9 gs snf) zList buckets in a namespace.z'Cannot use --tree when listing buckets.z,Cannot use --recursive when listing buckets.Nr>r.)rFrD)idr*size total_files created_atright)rMrN) alignments)r3r4rrr?rstripr list_bucketsrLr*rrMrNrOrtable) rFrDrArBrCr,r8bucketitemss rrHrHs  !JKK  !OPP!5!5m!D!Dc-023 $$S) 5 !C&&&J KF ))~~@NK ^T   EuWb )  Q(()s B B3B..B3infozhf buckets info user/my-bucketz+hf buckets info hf://buckets/user/my-bucketzFBucket ID: namespace/bucket_name or hf://buckets/namespace/bucket_namec[US9n[U5up4UR U5n[R"USS9 g![a$n[R"[ U55eSnAff=f)zGet info about a bucket.r.NrL)id_key) rr%r$r3r4r5 bucket_infordict)r)r,r8r9_r;rUs rr]r]sd" 5 !C)-i8 __Y 'FHHVD! )  Q(()s ? A- A((A-delete)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.cUR[5(a9[U5upEU(a![R "SUS[S35eUnO'SU;a![R "SUS[S35e[R"SUS 3US 9 [US 9nURXS 9 [R"S US9 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: r/r0r>zInvalid bucket ID: r#z(Are you sure you want to delete bucket ''?rdr.)rezBucket deleted)r)) rrr%r$r3r4r5rconfirmr delete_bucketr7)r)rdrer,r9r:r;r8s rrcrc9sJM** - 6y A I $$? {K11>?UW  I   !)-;;H/I_ a  KK:9+RHcR 5 !Ci7JJ95% -$$SV, , -s C C0 C++C0z 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^[U5umnUS:Xa$U(d[R"STSTS35eU(dU(aU(d[R"S5e[ US9n U(Ga`[ [R[R:HS9n U RS 5 /n U RTURS 5=(d SS S 9HIn [U [5(dMU R!U 5 U RS [#U 5S35 MK U R%S [#U 5S35 U(dU(a=['XES9n U Vs/sH&oR)UR*5(dM$UPM( nnOU nUVs/sHoR*PM nn[-SU55n[/US S9nU(d[R0"S5 g[#U5SU3nU(dOU(dH[R0"SR3SU555 [R4"SUSTS3SS9 U(aJ[R0"SR3U4SjU555 [R0"SUS35 gU R7TUS9 [R8"SUSTS 3T[#U5US!9 gURS 5nU(d[R"S"5eU(a9[R0"S#[:TS U35 [R0"S$5 g[R4"S%US&TS3US9 U R7TU/S9 [R8"S'UTS(9 g![a$n[R"[ U55eSnAff=fs snfs snf))zZRemove files from a bucket. To delete an entire bucket, use `hf buckets delete` instead. Nz?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.r.)enabledzListing files from remoter>TrXzListing files from remote (z files))include_patternsexclude_patternsc38# UHoRv M g7fN)rM).0fs r remove..s7As)rAzNo files to remove.z file(s) totaling  c3,# UH nSU3v M g7f)z N)rurs rrwrxsBztD6{zszRemove z from 'rgFrhc3@># UHnS[TSU3v M g7f)delete: r>N)r)rurr)s rrwrxs%cXbPT- 1TFKXbsz (dry run) z would be removed.)rczRemoved ')r) files_deletedrMzFile path cannot be empty.r}z"(dry run) 1 file would be removed.zRemove 'z' from 'z File removed)rr))r%r$r3r4r5rr rrYrhumanupdater\rR isinstancerappendr?donermatchesrsumrtextjoinribatch_bucket_filesr7r)r!rCrdrkrlrmr,r:r;r8status all_filesitemmatcherrv matched_files file_paths total_sizesize_str count_label file_pathr)s @rremovervs<z)28< 6|I   k"DDM;b R  7I  !OPP 5 !CCHH0D0J0J$JK 12&( (( ==%-) D $ ++  & ;C N;K7ST   1#i.1AIJ g#WWG(1M 1__QVV5LQ MMM%M&34mffm 4777 z$? HH* + Z));H:F 7 HHTYYBzBB C KK'+gi[C O  HHTYYcXbcc d HHz+.@A B  y< {m79+Q 7j/  MM#& $$%AB B  HHx yk9+F G HH9 :  hyk)B?SI y)= > YGY )  Q(()@N5s)N !#N:N:N? N7N22N7move)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_namec2[U5up4U(a![R"SUS[S35e[U5upVU(a![R"SUS[S35e[ US9nUR X5S9 [ R"SX5S9 g)z2Move (rename) a bucket to a new name or namespace.z)Cannot specify a prefix for bucket move: r/r0r.)rrz Bucket movedN)r%r3r4rr move_bucketrr7)rrr,parsed_from_id from_prefix parsed_to_id to_prefixr8s rrrs2#9"AN  7yA--:O;Q S  5U;L  7w?--:O;Q S  5 !COONO?JJ~~Jr sync)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.jsonzVhf buckets cp hf://buckets/user/my-bucket/logs/ hf://buckets/user/archive-bucket/logs/zehf buckets cp hf://datasets/user/my-dataset/processed/ hf://buckets/user/my-bucket/dataset/processed/srczMSource: local file, any hf:// handle (model, dataset, bucket), or - for stdindstz@Destination: local path, bucket hf://... handle, or - for stdoutc( [US9n[U5nUSL=(a [U5n[U5nUSL=(a [U5nUS:HnUS:Hn U(a/U(a(URX5 [R"SXS9 gU(d=U(d6U(d/Uc[ R "S5e[ R "S5eU(aU(d[ R "S5eU(aFU(a?[U5upU S :XdU RS 5(a[ R "S 5eU (aU(d[ R "S 5eU(dAU(d:[RRU5(a[ R "S 5eU(Ga-[U5upU S :XdU RS 5(a[ R "S5eU RS S5SnU (a[!5nU(d [#5 [%5n[RR'UU5nUR)XU4/5 [+US5nUR-S5=n(aC[.R0R2R5U5 UR-S5=n(aMCSSS5 SSS5 U(d [75 ggUcUnO[RRU5(d:UR[R85(dURS 5(a [RR'X5nOUn[RR;U5nU(a[R<"USS9 UR)XU4/5 [R"SUUS9 gU(a`[U5un n[.R>R2R-5nURAU UU4/S9 [R"SSUS9 g[RRCU5(d[ R "SU35e[U5upU S :Xa [RREU5nO;U RS 5(a#U [RREU5-nOU nURAXU4/S9 [R"SU[FU S U3S9 g![a$n [ R "[U 55eSn A ff=f!,(df  GN=f!,(df  GN=f!U(d [75 ff=f)zCopy files to or from buckets.r.N-Copied)rrz2Missing 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.ror>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.rrbiHT)r+ Downloaded)addUploadedstdinzSource file not found: )$rrr copy_filesr$r3r4r5rr7r endswithosrisdirrsplitr rr rdownload_bucket_filesopenreadsysstdoutbufferwritersepdirnamemakedirsrrisfilebasenamer)rrr,r8 src_is_hf dst_is_hf src_is_bucket dst_is_bucket src_is_stdin dst_is_stdoutr;rbr:r)filenamepbar_was_disabledtmp_dirtmp_pathrvchunk local_path parent_dir remote_pathdatas rrrsG2 5 !Cc"I46M#$6I#C(MtO<(H--i8:L9MNh-'(vvj'99e9JJ--33E:()vvj'99e9..)(*){% s##s||BFF';';s||C?P?PWW\\#8  4J J6  % %i:2F1G H JJ|* = !3C!8 ;yy$$& yk/B.CD :74ww~~c""$$'>se%DE E.s3 R<''**3/K __S ! ! 277#3#3C#88K K y[/A.BC :3}oi[+,WXw -$$SV, , -Z.-.-)(*)sV%T(, U=6AU+7AUU+U=( U2UU U( #U++ U:5U==V)FFN)NFFFNNrt)FFFNNN)NNFFFNNFNNNFFFN)NN)8__doc__rrtypingrr3huggingface_hubrhuggingface_hub._bucketsrrrrr r huggingface_hub.utilsr r r rr _cli_utilsrrrr _file_listingrr_outputrr get_logger__name__logger buckets_clir5boolrtupler%commandArgumentOptionr&r@rJrHrGr]rcr[rrrrr{r rrs >  # ;.   H %!EF $$$ S U38_ "   .  ++O  g  +O  +  +O  F  +O* ++O, -+O +O\CD   0    E>  d  W  >    7  > $  F  %> 2   C  3> B C> D E> F G> > B KTz K $J K K K  K : K  KFcccc c : c  c:  (5"  Y  " " ""*  .  -16  Y  16    ,   16  F  16, -16. /1616h   6    [AH  a  AH   C  AH$    ,   %AH4  K  5AHB S D d  CAHN S D _  OAHZ [AH\ ]AH AHH  *"K   `  "K   e   "K "K "K"KT    &         yrP  d  ^   rP  d  c   rP   B   rP&  N  'rP4  O  5rPB  d  P   CrPN  d  6   OrPZ  H  [rPh S D I  irPt S D I  urP@ d  ;  ArPL  T  MrPZ  V  [rPh   8  irPx yrPz {rP rPt   * rY  U^^!p qq rY  d ENN(jkk  rY rY rYrYr