
    js                        d Z ddlZddlZddlmZmZ ddlZddlmZm	Z	 ddl
mZ ddlmZmZmZmZmZ ddlmZ  ee          Z ej        d	d
 eD             e          Zdedz  dedz  fdZ ed          Ze                    dg d          	 	 	 	 	 	 	 d1deedz   ej        de          f         deedz   ej        d          f         deedz   ej        d          f         deedz   ej        d          f         deedz   ej        d          f         d ed!eddfd"            Ze                    d#g d$          	 	 d2d&ee ej        d'          f         d ed!eddfd(            Ze                    d)d*g          	 d3d+ee ej        d,          f         d!eddfd-            Ze                    d.d/g          	 d3d+ee ej        d,          f         d!eddfd0            Z dS )4a  Contains 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)	Annotatedget_args)CLIErrorHfHubHTTPError)DailyPapersSort_T   )LimitOptTokenOptapi_object_to_dict
get_hf_apityper_factory)outPaperSortEnumc                     i | ]}||S  r   ).0ss     ]/var/www/html/Carbon-Document/venv/lib/python3.11/site-packages/huggingface_hub/cli/papers.py
<dictcomp>r   A   s    +H+H+HQAq+H+H+H    )typevaluereturnc                     | dS |                                  dk    r0t          j                                                                        S | S )z6Parse date option, converting 'today' to current date.Ntoday)lowerdatetimedater   	isoformat)r   s    r   _parse_dater    D   sD    }t{{}}}""$$..000Lr   z Interact with papers on the Hub.)helpz	list | ls)zhf papers lszhf papers ls --sort trendingzhf papers ls --date 2025-01-23zhf papers ls --week 2025-W09z hf papers ls --submitter akhaliqzhf papers ls --format json)examples2   r   z+Date in ISO format (YYYY-MM-DD) or 'today'.)r!   callbackweekz'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.limittokenc                    t          |          }|r|j        nd}g }	|                    | |||||          D ]l}
t          |
          }|                    d          pi }|                    d          p|                    d          pd|d<   |	                    |           mt          j        |	g d	d
d
d           dS )zList daily papers on the Hub.r*   N)r   r%   r&   r'   r(   r)   submitted_byfullnameusername submitted_by_name)idtitleupvotescommentspublished_atr1   right)r4   r5   headers
alignments)r   r   list_daily_papersr   getappendr   table)r   r%   r&   r'   r(   r)   r*   apisort_keyresults
paper_infoitemr-   s                r   	papers_lsrD   P   s   N 5
!
!
!C!+tzztHG++ ,    
 "*--xx//52$0$4$4Z$@$@$fLDTDTU_D`D`$fdf !tI[[[&G<<     r   search)z"hf papers search "vision language"z1hf papers search "attention mechanism" --limit 10z*hf papers search "diffusion" --format json   queryzSearch query string.c                     t          |          }d |                    | |          D             }t          j        |g dddi           dS )	zSearch papers on the Hub.r,   c                 ,    g | ]}t          |          S r   )r   )r   rB   s     r   
<listcomp>z!papers_search.<locals>.<listcomp>   s!    jjj*!*--jjjr   )rG   r)   )r2   r3   summaryr4   r6   r4   r7   r8   N)r   list_papersr   r>   )rG   r)   r*   r?   rA   s        r   papers_searchrM      sd     5
!
!
!CjjV[ch@i@ijjjGIgTTTbkmtauvvvvvvr   infozhf papers info 2601.15621paper_idz'The arXiv paper ID (e.g. '2502.08025').c                     t          |          }	 |                    |           }n7# t          $ r*}|j        j        dk    rt          d|  d          | d}~ww xY wt          j        |           dS )z"Get info about a paper on the Hub.r,   r2     Paper '' not found on the Hub.N)r   rB   r   responsestatus_coder   r   dict)rO   r*   r?   rN   es        r   papers_inforY      s     5
!
!
!C~~~**   :!S((FXFFFGGQN HTNNNNN   ) 
A%AAreadzhf papers read 2601.15621c                     t          |          }	 |                    |           }n7# t          $ r*}|j        j        dk    rt          d|  d          | d}~ww xY wt          j        |           dS )zRead a paper as markdown.r,   rQ   rR   rS   rT   N)r   
read_paperr   rU   rV   r   r   text)rO   r*   r?   contentrX   s        r   papers_readr`      s     5
!
!
!C..H.--   :!S((FXFFFGGQN HWrZ   )NNNNNr#   N)rF   N)N)!__doc__r   enumtypingr   r   typerhuggingface_hub.errorsr   r   huggingface_hub.hf_apir   
_cli_utilsr	   r
   r   r   r   _outputr   _SORT_OPTIONSEnumstrr   r    
papers_clicommandOptionrD   ArgumentrM   rY   r`   r   r   r   <module>rp      sg   >   & & & & & & & &  ; ; ; ; ; ; ; ; 4 4 4 4 4 4                    *++	/+H+H-+H+H+HsSSSsTz cDj     ] BCCC
     
 
$ 	 	 	 	 	3/ /
d
> 	
 	
 	
	/ d
CDDD	F/ d
WXXX	Z/  d
@AAA	C!/( /***	,)/0 1/2 3/4 
5/ / /
 
/d       w wS.%..DEEEEFww w 
	w w w w 
#     ^U^1Z[[[[\ 
    
#     ^U^1Z[[[[\ 
     r   