o js@s"dZddlZddlZddlmZmZddlZddlmZm Z ddl m Z ddl m Z mZmZmZmZddlmZee 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)LimitOptTokenOptapi_object_to_dict get_hf_api typer_factory)out PaperSortEnumcCsi|]}||qSr).0srrM/home/kuhnn/.local/lib/python3.10/site-packages/huggingface_hub/cli/papers.py Asr)typevaluereturncCs*|durdS|dkrtjS|S)z6Parse date option, converting 'today' to current date.Ntoday)lowerdatetimedater isoformat)rrrr _parse_dateDs  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 d d d dS) zList daily papers on the Hub.r&N)rr!r"r#r$r% submitted_byfullnameusernamesubmitted_by_name)idtitleupvotescomments published_atr,right)r/r0headers alignments)r rlist_daily_papersr getappendr table) rr!r"r#r$r%r&apisort_keyresults paper_infoitemr(rrr papers_lsPs( '   r?search)z"hf papers search "vision language"z1hf papers search "attention mechanism" --limit 10z*hf papers search "diffusion" --format jsonqueryzSearch query string.cCs>t|d}dd|j||dD}tj|gdddidd S) zSearch papers on the Hub.r'cSsg|]}t|qSr)r )rr=rrr sz!papers_search..)rBr%)r-r.summaryr/r1r/r2r3N)r list_papersr r9)rBr%r&r:r<rrr papers_searchs rFinfozhf 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)rHr&r:rGerrr papers_info  rRreadzhf papers read 2601.15621c CrI)zRead a paper as markdown.r'rJrKrLrMN)r read_paperrrNrOrr text)rHr&r:contentrQrrr papers_readrSrX)NNNNNrN)rAN)N)!__doc__renumtypingrrtyperhuggingface_hub.errorsrrhuggingface_hub.hf_apir _cli_utilsrr r r r _outputr _SORT_OPTIONSEnumstrrr papers_clicommandOptionr?ArgumentrFrRrXrrrrs          2