Ë
    -Œ:j  ã                   óÆ  — 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 ddlmZmZ  ee«      Z ej*                  d	eD � ci c]  } | | “Œ c} e¬
«      Zdedz  dedz  fd„Z ed¬«      Zej5                  dg d¢¬«      	 	 	 	 	 	 	 d.deedz   ej6                  de¬«      f   deedz   ej6                  d¬«      f   deedz   ej6                  d¬«      f   deedz   ej6                  d¬«      f   deedz   ej6                  d¬«      f   dededdfd „«       Zej5                  d!g d"¢¬«      	 	 d/d#ee ej:                  d$¬«      f   dededdfd%„«       Zej5                  d&d'g¬«      	 d0d(ee ej:                  d)¬«      f   deddfd*„«       Zej5                  d+d,g¬«      	 d0d(ee ej:                  d)¬«      f   deddfd-„«       Z yc c} w )1aÇ  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Ú
get_hf_apiÚtyper_factory)Ú_dataclass_to_dictÚoutÚPaperSortEnum)ÚtypeÚvalueÚreturnc                 óŠ   — | €y| j                  «       dk(  r,t        j                  j                  «       j	                  «       S | S )z6Parse date option, converting 'today' to current date.NÚtoday)ÚlowerÚdatetimeÚdater   Ú	isoformat)r   s    ú\/var/www/html/tokenscope/api/venv/lib/python3.12/site-packages/huggingface_hub/cli/papers.pyÚ_parse_dater   C   s9   € à€}ØØ‡{�{ƒ}˜ÒÜ�}‰}×"Ñ"Ó$×.Ñ.Ó0Ð0Ø€Ló    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)Úexamplesr   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                 ób  — t        |¬«      }|r|j                  nd}g }	|j                  | |||||¬«      D ]^  }
t        |
«      }|j	                  d«      xs i }|j	                  d«      xs |j	                  d«      xs d|d<   |	j                  |«       Œ` t        j                  |	g d	¢¬
«       y)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_atr+   ©Úheaders)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_lsr<   O   s¾   € ôN ˜5Ô
!€CÙ!ˆt�zŠz t€HØ€GØ×+Ñ+ØØØØØØð ,ó ò ˆ
ô " *Ó-ˆØ—x‘x Ó/Ò5°2ˆØ$0×$4Ñ$4°ZÓ$@Ò$fÀL×DTÑDTÐU_ÓD`Ò$fÐdfˆÐ Ñ!Ø�‰�tÕðô ‡I�IØÚ[ö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        |¬«      }|j                  | |¬«      D �cg c]  }t        |«      ‘Œ }}t        j                  |g d¢¬«       yc c}w )zSearch papers on the Hub.r&   )r>   r#   )r,   r-   Úsummaryr.   r0   r1   N)r   Úlist_papersr   r   r6   )r>   r#   r$   r7   r:   r9   s         r   Úpapers_searchrB   ‹   sK   € ô ˜5Ô
!€CØ@CÇÁÐV[ÐchÀÓ@iÖj°*Ô! *Õ-Ðj€GÐjÜ‡I�IˆgÒTÖUùò ks   ¢AÚinfozhf papers info 2601.15621Úpaper_idz'The arXiv paper ID (e.g. '2502.08025').c                 óâ   — t        |¬«      }	 |j                  | ¬«      }t        j                  |«       y# t        $ r/}|j                  j                  dk(  rt        d| › d�«      |‚‚ d}~ww xY w)z"Get info about a paper on the Hub.r&   ©r,   é”  úPaper 'ú' not found on the Hub.N)r   r:   r   ÚresponseÚstatus_coder   r   Údict)rD   r$   r7   rC   Úes        r   Úpapers_inforN   ž   sn   € ô ˜5Ô
!€CðØ�~‰~ ˆ~Ó*ˆô
 ‡H�HˆT…Nøô	 ò Ø�:‰:×!Ñ! SÒ(Ü˜W X JÐ.EÐFÓGÈQÐNØûðúó   Ž6 ¶	A.¿*A)Á)A.Úreadzhf papers read 2601.15621c                 óâ   — t        |¬«      }	 |j                  | ¬«      }t        j                  |«       y# t        $ r/}|j                  j                  dk(  rt        d| › d�«      |‚‚ d}~ww xY w)zRead a paper as markdown.r&   rF   rG   rH   rI   N)r   Ú
read_paperr   rJ   rK   r   r   Útext)rD   r$   r7   ÚcontentrM   s        r   Úpapers_readrU   ³   so   € ô ˜5Ô
!€CðØ—.‘. H�.Ó-ˆô
 ‡H�HˆWÕøô	 ò Ø�:‰:×!Ñ! SÒ(Ü˜W X JÐ.EÐFÓGÈQÐNØûðúrO   )NNNNNé2   N)é   N)N)!Ú__doc__r   ÚenumÚtypingr   r   ÚtyperÚhuggingface_hub.errorsr   r   Úhuggingface_hub.hf_apir   Ú
_cli_utilsr	   r
   r   r   Ú_outputr   r   Ú_SORT_OPTIONSÚEnumÚstrr   r   Ú
papers_cliÚcommandÚOptionr<   ÚArgumentrB   rN   rU   )Úss   0r   ú<module>rh      s
  ðñó> Û ß &ã ç ;Ý 4÷ó ÷ -ñ Ð*Ó+€Ø�—	‘	˜/¸-Ö+H°Q¨A¨q©DÒ+HÈsÔS€ð�s˜T‘zð  c¨D¡jó ñ Ð BÔC€
ð ×ÑØòð ó 
ð$ 	ð 	ð 	ð 	ð 	ØØñ3.Ø
Øˆd‰
Øˆ�‰Ø>Ø ô	
ð	ñð.ð Øˆd‰
Øˆ�‰ÐCÔDð	Fñð.ð Øˆd‰
Øˆ�‰ÐWÔXð	Zñð.ð  Øˆd‰
Øˆ�‰Ð@ÔAð	Cñð!.ð( Ø˜ÑØˆ�‰˜/Ô*ð	,ñð).ð0 ð1.ð2 ð3.ð4 
ò5.ó
ð.ðb ×ÑØòð ó ð ØñVØ�S˜.˜%Ÿ.™.Ð.DÔEÐEÑFðVàðVð ðVð 
ò	VóðVð ×ÑØ
à#ðð ó ð ñØ˜˜^˜UŸ^™^Ð1ZÔ[Ð[Ñ\ðàðð 
òóðð ×ÑØ
à#ðð ó ð ñØ˜˜^˜UŸ^™^Ð1ZÔ[Ð[Ñ\ðàðð 
òóñùòs ,Is   Á
G
