o 2j@s"dZddlZddlZddlmZmZddlZddlmZm Z ddl m Z ddl m Z mZmZmZddlmZmZee Zejd d d eDed Zd edBdedBfddZeddZejdgdd       d7deedBejdedfdeedBejddfdeedBejddfdeedBejddfd eedBejd!dfd"e d#eddfd$d%Zejd&gd'd ( d8d)eeejd*dfd"e d#eddfd+d,Zejd-d.gd d9d/eeejd0dfd#eddfd1d2Zejd3d4gd d9d/eeejd0dfd#eddfd5d6Z dS):aContains commands to interact with papers on the Hugging Face Hub. Usage: # list daily papers (most recently submitted) hf papers ls # list trending papers hf papers ls --sort=trending # list papers from a specific date, ordered by upvotes hf papers ls --date=2025-01-23 # list today's papers, ordered by upvotes hf papers ls --date=today # list papers from a specific week hf papers ls --week=2025-W09 # list papers by a specific submitter hf papers ls --submitter=someuser # search papers hf papers search "vision language" # get info about a paper hf papers info 2502.08025 # read a paper as markdown hf papers read 2502.08025 N) Annotatedget_args)CLIErrorHfHubHTTPError)DailyPapersSort_T)LimitOptTokenOpt get_hf_api typer_factory)_dataclass_to_dictout PaperSortEnumcCsi|]}||qSr).0srrU/var/www/html/whisper/venv/lib/python3.10/site-packages/huggingface_hub/cli/papers.py @sr)typevaluereturncCs*|durdS|dkrtjS|S)z6Parse date option, converting 'today' to current date.Ntoday)lowerdatetimedater isoformat)rrrr _parse_dateCs  rz Interact with papers on the Hub.)helpz list | ls)z hf papers lszhf papers ls --sort trendingzhf papers ls --date 2025-01-23zhf papers ls --week 2025-W09z hf papers ls --submitter akhaliqzhf papers ls --format json)examples2rz+Date in ISO format (YYYY-MM-DD) or 'today'.)rcallbackweekz'ISO week to filter by, e.g. '2025-W09'.monthz;Month to filter by in ISO format (YYYY-MM), e.g. '2025-02'. submitterz$Filter by username of the submitter.sortz Sort results.limittokenc Cst|d}|r |jnd}g} |j||||||dD] } t| } | dp%i} | dp1| dp1d| d<| | qtj| gd d dS) zList daily papers on the Hub.r&N)rr!r"r#r$r% submitted_byfullnameusernamesubmitted_by_name)idtitleupvotescomments published_atr,headers)r rlist_daily_papersr getappendr table) rr!r"r#r$r%r&apisort_keyresults paper_infoitemr(rrr papers_lsOs& '   r=search)z"hf papers search "vision language"z1hf papers search "attention mechanism" --limit 10z*hf papers search "diffusion" --format jsonqueryzSearch query string.cCs8t|d}dd|j||dD}tj|gdddS)zSearch papers on the Hub.r'cSsg|]}t|qSr)r )rr;rrr sz!papers_search..)r@r%)r-r.summaryr/r1r2N)r list_papersr r7)r@r%r&r8r:rrr papers_searchs rDinfozhf papers info 2601.15621paper_idz'The arXiv paper ID (e.g. '2502.08025').c Cbt|d}z|j|d}Wnty)}z|jjdkr$td|d|d}~wwt|dS)z"Get info about a paper on the Hub.r'r-Paper '' not found on the Hub.N)r r;rresponse status_coderr dict)rFr&r8rEerrr papers_info  rPreadzhf papers read 2601.15621c CrG)zRead a paper as markdown.r'rHrIrJrKN)r read_paperrrLrMrr text)rFr&r8contentrOrrr papers_readrQrV)NNNNNrN)r?N)N)!__doc__renumtypingrrtyperhuggingface_hub.errorsrrhuggingface_hub.hf_apir _cli_utilsrr r r _outputr r _SORT_OPTIONSEnumstrrr papers_clicommandOptionr=ArgumentrDrPrVrrrrs         1