Yj,h% SrSSKrSSKrSSKJr SSKrSSKJr SSKJ r J r J r J r J r Jr SSKJrJr SSKJrJrJrJr SS KJrJr SS KJrJr \R:"\5r\"S S 9r S \!S\"4Sjr#S\!S\$\!\!44Sjr%\ RMS/SQS9S}S\\!\RN"SS 94S\\"\RP"SSS 94S\\"\RP"SSS 94S\SS4 Sjj5r)S\!S\"4Sjr*\ RMS /S!QS9S~S\\!S-\RN"S"S 94S#\\"\RP"S$S%S&S 94S'\\"\RP"S(S)S 94S*\\"\RP"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 S2jr-\ RMS3S4S5/S9SS\\!\RN"S6S 94S\SS4S7jj5r.\ RMS8/S9QS9S}S\\!\RN"S6S 94S:\\"\RP"S;S\\"\RP"S?S@S 94S\SS4 SAjj5r/\ RMSB/SCQS9SS\\!\RN"SDS 94S*\\"\RP"S+S,SES 94S:\\"\RP"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)rrs r _is_bucket_idr=sB=))M*,- $; $;rz 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.)rr>r?r@r)) namespacerAr>r?r@r))r=r0r1 _list_files _list_buckets)rr>r?r@rAr) is_file_modes rlist_cmdrGsgr4'CM(,CL  $$%NO O)   )  rrCc ,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+)rCrA)idr'size total_files created_atright)rJrK) alignments)r0r1rrr<rstripr list_bucketsrIr'rrJrKrLrtable) rCrAr>r?r@r)r5bucketitemss rrErEs  !JKK  !OPP!5!5m!D!Dc-023 $$S) 5 !C&&&J KF ))~~@NK ^r?r@) rmoderjsonr0r1rr"r!r2listlist_bucket_treer) rr>r?r@r)r5r&r7r8rSs rrDrDs3883888  !HII 5 !C)28<    >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+NrI)id_key) rr"r!r0r1r2 bucket_infordict)r&r)r5r6_r8rRs rrZrZsd" 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,r-r;zInvalid bucket ID: r z(Are you sure you want to delete bucket ''?rar+)rbzBucket deleted)r&) rrr"r!r0r1r2rconfirmr delete_bucketr4)r&rarbr)r6r7r8r5s rr`r`6sJM** - 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.cB^[U5umnUS:Xa$U(d[R"STSTS35eU(dU(aU(d[R"S5e[ US9n U(Ga=[ R"S5n /n U RTURS 5=(d SS S 9HIn [U [5(dMU RU 5 U RS [U 5S 35 MK U RS [U 5S 35 U(dU(a=[!XES9n U Vs/sH&oR#UR$5(dM$UPM( nnOU nUVs/sHoR$PM nn['SU55n[)US S9nU(d[ R*"S5 g[U5SU3nU(dOU(dH[ R*"SR-SU555 [ R."SUSTS3SS9 U(aJ[ R*"SR-U4SjU555 [ R*"SUS35 gU R1TUS9 [ R2"SUSTS3T[U5US 9 gURS 5nU(d[R"S!5eU(a9[ R*"S"[4TS U35 [ R*"S#5 g[ R."S$US%TS3US9 U R1TU/S9 [ R2"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+zListing files from remoter;TrUzListing files from remote (z files))include_patternsexclude_patternsc38# UHoRv M g7fN)rJ).0fs r remove..s7As)r>zNo files to remove.z file(s) totaling  c3,# UH nSU3v M g7f)z N)rqrs rrsrtsBztD6{zszRemove z from 'rdFrec3@># UHnS[TSU3v M g7f)delete: r;N)r)rqrr&s rrsrts%cXbPT- 1TFKXbsz (dry run) z would be removed.)r`zRemoved ')r& files_deletedrJzFile path cannot be empty.ryz"(dry run) 1 file would be removed.zRemove 'z' from 'z File removed)rr&)r"r!r0r1r2rrstatusrYrO isinstancerappendupdater<donermatchesrsumrtextjoinrfbatch_bucket_filesr4r)rr@rarhrirjr)r7r8r5r| all_filesitemmatcherrr matched_files file_paths total_sizesize_str count_label file_pathr&s @rremoverss#z)28< 6|I   k"DDM;b R  7I  !OPP 5 !C78&( (( ==%-) 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)= > YGW )  Q(()>N5s)M&>#N%N4N& N0NNmove)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,r-r+)rrz Bucket movedN)r"r0r1rr move_bucketrr4)rrr)parsed_from_id from_prefix parsed_to_id to_prefixr5s rrrs2#9"AN  7yA--:O;Q S  5U;L  7w?--:O;Q S  5 !COONO?JJ~~Jrsync)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.jsonzchf buckets cp hf://buckets/user/my-bucket/logs hf://buckets/user/archive-bucket/ # nests logs/ dirzihf buckets cp hf://buckets/user/my-bucket/logs/ hf://buckets/user/archive-bucket/ # copies contents onlyzehf 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[!5 [#5n[RR%X5nUR'XU4/5 [)US5nUR+S5=n(aC[,R.R0R3U5 UR+S5=n(aMCSSS5 SSS5 SSS5 gUcUnO[RRU5(d:UR[R45(dURS 5(a [RR%X5nOUn[RR7U5nU(a[R8"USS9 UR'XU4/5 [R"SUUS9 gU(a`[U5un n[,R:R0R+5nUR=U UU4/S9 [R"SSUS9 g[RR?U5(d[ R "SU35e[U5upU S :Xa [RRAU5nO;U RS 5(a#U [RRAU5-nOU nUR=XU4/S9 [R"SU[BU S U3S9 g![a$n [ R "[U 55eSn A ff=f!,(df  GN=f!,(df  GN=f!,(df  g=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.rlr;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.r rbiHT)r( Downloaded)addUploadedstdinzSource file not found: )"rrr copy_filesr!r0r1r2rr4r endswithosrisdirrsplitr r rdownload_bucket_filesopenreadsysstdoutbufferwritesepdirnamemakedirsrrisfilebasenamer)rrr)r5 src_is_hf dst_is_hf src_is_bucket dst_is_bucket src_is_stdin dst_is_stdoutr8r_r7r&filenametmp_dirtmp_pathrrchunk local_path parent_dir remote_pathdatas rrrs$4 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[+,WXk -$$SV, , -T.-.-)(sV%T  U!%AU%AT=U U! T:T55T:= U U U U!! U/)FFN)NFFFNNrp)FFFNNN)NNFFFNNFNNNFFFN)NN)5__doc__rrtypingrr0huggingface_hubrhuggingface_hub._bucketsrrrrr r huggingface_hub.utilsr r _cli_utilsrrrr _file_listingrr_outputrr get_logger__name__logger buckets_clir2boolrtupler"commandArgumentOptionr#r=rGrErDrZr`rXrrrrrwrrrs >  #  ;.   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    [@H  a  @H   C  @H$    ,   %@H4  K  5@HB S D d  C@HN S D _  O@HZ [@H\ ]@H @HF  *"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   , lY  U^^!p qq lY  d ENN(jkk  lY lY lY! lYr