^j^'dZddlZddlmZmZddlmZmZddlm Z m Z m Z m Z ddl mZmZddlmZmZeeZej(d eDcic]}||c}e ZeeZej(d eDcic]}||c}e Ze d Zej5dgd dSdeedzed fdeedzed fdeedzed fde de ddf dZej5ddg dTdeeed fde ddfdZej5d gd! dUd"eeed# fd$eedzed% fd&eedzed' fd(eeed) fd*eeed+ fde ddfd,Zej5d-gd. dVdeeed fd"eedzed/ fd&eedzed0 fd1eedzed2 fd(eedzed3 fd4eedzed5 fde ddfd6Z ej5d7d8d9g dWdeeed fd:eeed; fde ddfd<Z!ej5d=gd> dXdeeed fd?eeed@ fdAeeedB fdCeedzedD fd*eeedE fde ddfdFZ"ej5dGdHdIg dYdeeed fdJeeedK fdCeedzedL fd1eedzedM fde ddf dNZ#ej5dO dWdeeed fdJeeedP fd:eeedQ fde ddf dRZ$ycc}wcc}w)ZzGContains commands to interact with collections on the Hugging Face Hub.N) Annotatedget_args)CollectionItemType_TCollectionSort_T)LimitOptTokenOpt get_hf_api typer_factory)ArgumentOption)_dataclass_to_dictoutCollectionItemType)typeCollectionSortz%Interact with collections on the Hub.)helpz list | ls)zhf collections lsz hf collections ls --owner nvidiazLhf collections ls --item models/teknium/OpenHermes-2.5-Mistral-7B --limit 10)examplesownerz)Filter by owner username or organization.itemzkFilter collections containing a specific item (e.g., "models/gpt2", "datasets/squad", "papers/2311.12983").sortz4Sort results by last modified, trending, or upvotes.limittokenreturnct|}|r |jnd}|j||||Dcgc] }t|}}t j |ycc}w)zList collections on the Hub.rN)rrrr)r valuelist_collectionsrrtable) rrrrrapisort_key collectionresultss j/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/huggingface_hub/cli/collections.pycollections_lsr%%sn6 5 !C!tzztH.. /   :&GIIgsAinfoz/hf collections info username/my-collection-slugcollection_slugz7The collection slug (e.g., 'username/collection-slug').cht|}|j|}tj|y)z'Get info about a collection on the Hub.rN)r get_collectionrdict)r'rr r"s r$collections_infor+Ns* 5 !C##O4JHHZcreate)z!hf collections create "My Models"z^hf collections create "My Models" --description "A collection of my favorite models" --privatez9hf collections create "Org Collection" --namespace my-orgtitlezThe title of the collection. namespacezMThe namespace (username or organization). Defaults to the authenticated user. descriptionz!A description for the collection.privatezCreate a private collection. exists_okz7Do not raise an error if the collection already exists.ct|}|j|||||}tjd|j|j y)z#Create a new collection on the Hub.r)r.r/r0r1r2zCollection createdslugurlN)r create_collectionrresultr5r6)r.r/r0r1r2rr r"s r$collections_creater9^sM: 5 !C&& 'JJJ#*//z~~Nr,update)z@hf collections update username/my-collection --title "New Title"zPhf collections update username/my-collection --description "Updated description"zDhf collections update username/my-collection --private --theme greenz!The new title for the collection.z'The new description for the collection.positionz7The new position of the collection in the owner's list.z)Whether the collection should be private.themez;The theme color for the collection (e.g., 'green', 'blue').ct|}|j||||||}tjd|j|j y)z*Update a collection's metadata on the Hub.r)r'r.r0r;r1r<zCollection updatedr4N)r update_collection_metadatarr8r5r6) r'r.r0r;r1r<rr r"s r$collections_updater?sQB 5 !C//' 0JJJ#*//z~~Nr,deletez,hf collections delete username/my-collectionz9hf collections delete username/my-collection --missing-ok missing_okz6Do not raise an error if the collection doesn't exist.cpt|}|j||tjd|y)z!Delete a collection from the Hub.r)rAzCollection deletedr5N)r delete_collectionrr8)r'rArr s r$collections_deleterEs0 5 !C/jAJJ#/:r,zadd-item)zGhf collections add-item username/my-collection moonshotai/kimi-k2 modelz`hf collections add-item username/my-collection Qwen/DeepPlanning dataset --note "Useful dataset"zGhf collections add-item username/my-collection Tongyi-MAI/Z-Image spaceitem_idzCThe ID of the item to add (repo_id for repos, paper ID for papers). item_typezGThe type of item (model, dataset, space, paper, collection, or bucket).notez2A note to attach to the item (max 500 characters).z?Do not raise an error if the item is already in the collection.ct|}|j|||j||}tjd||j y)zAdd an item to a collection.r)r'rFrGrHr2zItem added to collectionr4N)r add_collection_itemrrr8r6)r'rFrGrHr2rr r"s r$collections_add_itemrKsM4 5 !C(('//  )JJJ)Z^^Tr,z update-itemzVhf collections update-item username/my-collection ITEM_OBJECT_ID --note "Updated note"zMhf collections update-item username/my-collection ITEM_OBJECT_ID --position 0item_object_idzTThe ID of the item in the collection (from 'item_object_id' field, not the repo_id).z-A new note for the item (max 500 characters).z/The new position of the item in the collection.ctt|}|j||||tjd|y)zUpdate an item in a collection.r)r'rLrHr;zItem updated in collectionrCN)r update_collection_itemrr8)r'rLrHr;rr s r$collections_update_itemrOs>0 5 !C'%   JJ+/Br,z delete-itemznThe ID of the item in the collection (retrieved from `item_object_id` field returned by 'hf collections info'.z0Do not raise an error if the item doesn't exist.crt|}|j|||tjd|y)z!Delete an item from a collection.r)r'rLrAzItem deleted from collectionrCN)r delete_collection_itemrr8)r'rLrArr s r$collections_delete_itemrRs; 5 !C'% JJ-ODr,)NNN N)N)NNFFN)NNNNNN)FN)NFN)NNN)%__doc__enumtypingrrhuggingface_hub.hf_apirr _cli_utilsrr r r _frameworkr r _outputrr_COLLECTION_ITEM_TYPESEnumstrr_COLLECTION_SORT_OPTIONSrcollections_clicommandr%r+boolr9intr?rErKrOrR)tss00r$resN &IEE(,""67TYY3DZ5[qad5[bef#$45+ @ "O d MN P"O t ?@ B"O$  d QR T %"O, -"O. /"O"OJ 6C  ;sH2k$llm ; LM O ;  ;  ; ;$  UsH2k$llmU sH*opp qU_` bU  d HI K U UV XU U  !UU:`W  CsH2k$llmC lm oC  d CD F  C d EF HC C CC6' EsH2k$llmE B  E FG IE E E(Ei6\.Vs M2 8 M7