{bj>\%SrSSKJrJr SSKJr SSKrSSKJr SSK J r J r J r J r Jr SSKJr S S KJrJrJrJr S S KJr S S KJrJr S S KJrJr S SKJrJ r \RB"\"5r#\"SS9r$\$RKS/SQS9SS\\&\"SS94S\\'\"SSS94S\\S-\"SSS94S\\'\"SSS94S\S S4 S!jj5r(S"\&S \'4S#jr)\$RKS$/S%QS9SS"\\&S-\"S&S94S'\\'\"S(S)S*S94S+\\'\"S,S-S94S.\\'\"S/S0S1S94S2\S\S S4S3jj5r*S4\&S-S2\&S-S'\'S+\'S.\'S\&S-S S4S5jr+S6\\ \ -S7\&S \\ \ -4S8jr,S"\&S'\'S+\'S.\'S\&S-S S4 S9jr-\$RKS:S;Sjj5r.\$RKS?/S@QS9SS\\&\"S=S94SA\\'\"SBSCSDS94SE\\'\"SFSGS94S\S S4 SHjj5r/\$RKSI/SJQS9SS"\\&\"SKS94S.\\'\"S/S0SLS94SA\\'\"SBSCSDS94SM\\'\"SNSOS94SP\\0\&S-\"SQS94SR\\0\&S-\"SSS94S\S S4STjj5r1\$RKSU/SVQS9SSW\\&\"SXS94SY\\&\"SZS94S\S S4S[jj5r2\$RKS\/S]QS9SS\\&\"S=S94S\\'\"SS^S94S_\\'\"S`SaS94S\S S4 Sbjj5r3\$RKSc/SdQS9SSe\\&S-\"SfS94Sg\\&S-\"ShS94S?\\'\"SiS94Sj\\'\"SkSlS94Sm\\'\"SnSoS94Sp\\&S-\"SqS94Sr\\&S-\"SsS94SM\\'\"SNStS94SP\\0\&S-\"SuS94SR\\0\&S-\"SvS94Sw\\&S-\"SxS94Sy\\'\"SzS{S94S|\\'\"S}S~S94S\\'\"SSSS94S\S S4 Sjj5r4\$RKS/SQS9"\"S55 g)z7Contains commands to interact with buckets via the CLI.)IterableIterator) AnnotatedN)logging) BUCKET_PREFIX BucketFile BucketFolder FilterMatcher_parse_bucket_uri) REPO_REGIONS) SearchOptTokenOpt get_hf_api typer_factory)make_cp) format_sizeprint_file_listing)ArgumentOption) OutputFormatoutz"Commands to interact with buckets.)helpcreate)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-okz,hf buckets create user/my-bucket --region us)nameexamples bucket_idzTBucket ID: bucket_name, namespace/bucket_name, or hf://buckets/namespace/bucket_nameprivatez --privatezCreate a private bucket.regionz--regionzdCloud region in which to create the bucket. Can be one of 'us' or 'eu'. Requires Team plan or above.exist_okz --exist-okz3Do not raise an error if the bucket already exists.tokenreturnc[US9nUR[5(aI[U5nUR(a![ R "SUS[S35eURnURUU(aUOSUUS9n[R"SURR5URS9 g) zCreate a new bucket.r"z-Cannot specify a prefix for bucket creation: . Use namespace/bucket_name or namespace/bucket_name.N)rr r!zBucket created)uriurl)r startswithrr path_in_repoclick BadParameterid create_bucketrresultr(to_urir))rrr r!r"apiparsed bucket_urls ڗ/tmp/claude-0/-home-danvics-docker-quiz/c1e0577a-e42c-4a3d-b1ea-3edd61103a4e/scratchpad/stt/lib/python3.13/site-packages/huggingface_hub/cli/buckets.pyrr1sT 5 !CM**"9-   $$? {K11>?UW II """ #J JJZ^^%:%:%<*..QargumentcrUR[5(aU[[5SnSU;$UnSU;$)zFCheck if argument is a bucket ID (namespace/name) vs just a namespace.N/)r*rlen)r7paths r5 _is_bucket_idr<osB=))M*,- $; $;r6z 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.)r7r=r>r?r") namespacer@r=r>r?r")r<r,r- _list_files _list_buckets)r7r=r>r?r@r" is_file_modes r5list_cmdrFxsgr4'CM(,CL  $$%NO O)   )  r6rBc *U(a[R"S5eU(a[R"S5eUb=UR[5(a#U[ [5SnUR S5n[ US9nURXS9Vs/sHZnURURU(a[URU5O URURURS.PM\ nn[R"USS 0S 9 gs snf) zList buckets in a namespace.z'Cannot use --tree when listing buckets.z,Cannot use --recursive when listing buckets.Nr9r%)rBr@)r.rsize total_files created_atrHright) alignments)r,r-r*rr:rstripr list_bucketsr.rrrHrIrJrtable) rBr@r=r>r?r"r2bucketitemss r5rDrDs  !JKK  !OPP!5!5m!D!Dc-023 $$S) 5 !C&&&J KF ))~~@NK ^ keep only what's actually under the prefix. r9N)rMr;r*)rQrRitems r5_iter_under_prefixrUsL ]]3 Ff, 0D0Dxq\0R0RJs AA Ac TU(a8[R[R:Xa[R "S5e[ US9n[U5n[[URURUR=(d SUS9UR55n[XqX#S9 g)zList files in a bucket.z%Cannot use --tree with --format json.r%NrRr?)r=r>r?)rmoderjsonr,r-rr listrUlist_bucket_treer.r+r)r7r=r>r?r"r2r3rQs r5rCrCs388|000  !HII 5 !C x (F    **2d# !       EuWbr6infozhf buckets info user/my-bucketz+hf buckets info hf://buckets/user/my-bucketzFBucket ID: namespace/bucket_name or hf://buckets/namespace/bucket_namec[US9n[U5nURUR5n[R "USS9 g)zGet info about a bucket.r%r.)id_keyN)rr bucket_infor.rdict)rr"r2r3rPs r5r\r\s8" 5 !C y )F __VYY 'FHHVD!r6delete)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(aJ[U5nUR(a![R "SUS[S35eUR nO'SU;a![R "SUS[S35e[R"SUS3US 9 [US 9nURXS 9 [R"S US 9 g)zwDelete a bucket. This deletes the entire bucket and all its contents. Use `hf buckets rm` to remove individual files. z-Cannot specify a prefix for bucket deletion: r&r'r9Invalid bucket ID: -. Must be in format namespace/bucket_name or z(Are you sure you want to delete bucket ''?rbr%)rczBucket deleted)rN) r*rr r+r,r-r.rconfirmr delete_bucketr0)rrbrcr"r3r2s r5rara)sJM**"9-   $$? {K11>?UW II I   !)-;;H/I_ a  KK:9+RHcR 5 !Ci7JJ95r6z 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^[U5nURmURnUS:Xa$U(d[R"STSTS35eU(dU(aU(d[R"S5e[ US9n U(Ga8[ R"S5n /n [U RTU=(d SS S 9U5HIn [U [5(dMU RU 5 U RS [U 5S 35 MK U RS [U 5S 35 U(dU(a=[!XES 9n 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[U5US9 gUnU(d[R"S 5eU(a9[ R*"S![4TS"U35 [ R*"S#5 g[ R."S$US%TS3US9 U R1TU/S9 [ R2"S&UTS'9 gs snfs snf)(zZRemove files from a bucket. To delete an entire bucket, use `hf buckets delete` instead. z?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 remoteNTrWzListing files from remote (z files))include_patternsexclude_patternsc38# UHoRv M g7fN)rH).0fs r5 remove..s7As)r=zNo files to remove.z file(s) totaling  c3,# UH nSU3v M g7f)z N)rtr;s r5rvrwsBztD6{zszRemove z from 'rgFrhc3@># UHnS[TSU3v M g7f)delete: r9N)r)rtr;rs r5rvrws%cXbPT- 1TFKXbsz (dry run) z would be removed.)razRemoved ')r files_deletedrHzFile path cannot be empty.r|r9z"(dry run) 1 file would be removed.zRemove 'z' from 'z File removed)r;r)r r.r+r,r-rrstatusrUr[ isinstancerappendupdater:doner matchesr;sumrtextjoinribatch_bucket_filesr0r)r7r?rbrkrlrmr"r3rRr2r all_filesrTmatcherru matched_files file_paths total_sizesize_str count_label file_pathrs @r5removercszx (F I  F |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/   $$%AB B  HHx yk9+F G HH9 :  hyk)B?SI y)= > YGYN5s #M&4M&M+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[U5nUR(a![R"SUS[S35e[U5nUR(a![R"SUS[S35e[ US9nUR URURS9 [R"SURURS9 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 r+r,r-rr move_bucketr.rr0)rrr" parsed_from parsed_tor2s r5rrs2$G,K  7yA--:O;Q S  "%(I  7w?--:O;Q S  5 !COOKNN),,O?JJ~{~~Y\\Jr6settings)z,hf buckets settings user/my-bucket --privatez+hf buckets settings user/my-bucket --publicz9hf buckets settings hf://buckets/user/my-bucket --privatezMake the bucket private.publicz--publiczMake the bucket public.cX:Xa[R"S5eUR[5(aJ[ U5nUR (a![R"SUS[S35eUR nO'SU;a![R"SUS[S35e[US9nURXS 9 [R"S XS 9 [R"S US 35 g)z$Update bucket settings (visibility).z-Specify exactly one of --private or --public.z-Cannot specify a prefix for bucket settings: r&r'r9rerfr%)rzBucket settings updated)rrzRun `hf buckets info z` to view bucket details.N) r,r-r*rr r+r.rupdate_bucket_settingsrr0hint)rrrr"r3r2s r5rrs@  !PQQM**"9-   $$? {K11>?UW II I   !)-;;H/I_ a  5 !Cy:JJ(IOHH$YK/H IJr6sync)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.jsonlzrs >. #" :(&   H %!EF    0   90R g  0R  +  0R t w   0R*  F  +0R8 90R: ;0R 0RfCD   0    E>  d W  >    7  > $  F  %> 2   C  3> B C> D E> F G> > B 3Tz 3 $J 3 3 3  3 : 3  3F hzL'@A 3 S[\fiu\uSv cccc c : c  c6  (5 " Y   "  "  " "   .  -.6 Y  .6    ,   .6  F  .6, -.6. /.6.6b   6    [BH a  BH   C  BH$    ,   %BH4  K  5BHB S Dd  CBHN S D_  OBHZ [BH\ ]BH BHJ  *"K  `  "K  e   "K "K "K"KJ  *  +,K Y  ,K  +  ,K   *   ,K* +,K, -,K,Kh    &         yrP  d ^   rP  d c   rP  B   rP&  N  'rP4  O  5rPB  d P   CrPN  d 6   OrPZ  H  [rPh S DI  irPt S DI  urP@ d ;  ArPL  T  MrPZ  V  [rPh   8  irPx yrPz {rP rPv    )r6