�
���g�/ � � � d Z ddlmZ ddlmZ ddlmZmZmZmZ ddl m
Z
ddl m Z ed Z
e G d � d
� � � � Ze G d � d e� � � � Ze G d
� d� � � � Ze G d� de� � � � Ze G d� de� � � � Ze G d� de� � � � Ze G d� de� � � � Zdedefd�ZdS )a
Data structures to interact with Discussions and Pull Requests on the Hub.
See [the Discussions and Pull Requests guide](https://huggingface.co/docs/hub/repositories-pull-requests-discussions)
for more information on Pull Requests, Discussions, and the community tab.
� )� dataclass)�datetime)�List�Literal�Optional�Union� )� constants)�parse_datetime)�open�closed�merged�draftc � � e Zd ZU dZeed< eed< eed< eed< eed< eed< eed< e ed < eed
< e
d e e fd �� � Z e
d efd
�� � Z
dS )�
Discussiona
A Discussion or Pull Request on the Hub.
This dataclass is not intended to be instantiated directly.
Attributes:
title (`str`):
The title of the Discussion / Pull Request
status (`str`):
The status of the Discussion / Pull Request.
It must be one of:
* `"open"`
* `"closed"`
* `"merged"` (only for Pull Requests )
* `"draft"` (only for Pull Requests )
num (`int`):
The number of the Discussion / Pull Request.
repo_id (`str`):
The id (`"{namespace}/{repo_name}"`) of the repo on which
the Discussion / Pull Request was open.
repo_type (`str`):
The type of the repo on which the Discussion / Pull Request was open.
Possible values are: `"model"`, `"dataset"`, `"space"`.
author (`str`):
The username of the Discussion / Pull Request author.
Can be `"deleted"` if the user has been deleted since.
is_pull_request (`bool`):
Whether or not this is a Pull Request.
created_at (`datetime`):
The `datetime` of creation of the Discussion / Pull Request.
endpoint (`str`):
Endpoint of the Hub. Default is https://huggingface.co.
git_reference (`str`, *optional*):
(property) Git reference to which changes can be pushed if this is a Pull Request, `None` otherwise.
url (`str`):
(property) URL of the discussion on the Hub.
�title�status�num�repo_id� repo_type�author�is_pull_request�
created_at�endpoint�returnc �( � | j r
d| j � �S dS )z�
If this is a Pull Request , returns the git reference to which changes can be pushed.
Returns `None` otherwise.
zrefs/pr/N)r r ��selfs �i/home/asafur/pinokio/api/open-webui.git/app/env/lib/python3.11/site-packages/huggingface_hub/community.py�
git_referencezDiscussion.git_referenceE s$ � � � � )�(�d�h�(�(� (��t� c � � | j �| j t j k r| j � d| j � d| j � �S | j � d| j � d| j � d| j � �S )z-Returns the URL of the discussion on the Hub.N�/z
/discussions/zs/)r r
�REPO_TYPE_MODELr r r r s r �urlzDiscussion.urlO si � � �>� !�T�^�y�7P�%P�%P��m�K�K�d�l�K�K���K�K� K��-�Y�Y�$�.�Y�Y�D�L�Y�Y�t�x�Y�Y�Yr! N)�__name__�
__module__� __qualname__�__doc__�str�__annotations__�DiscussionStatus�int�boolr �propertyr r r% � r! r r r s� � � � � � � �$� $�L �J�J�J� � � � � �H�H�H�
�L�L�L��N�N�N� �K�K�K����������M�M�M�
��x��}� � � � �X�� �Z�S� Z� Z� Z� �X�Z� Z� Zr! r c � � e Zd ZU dZed ed< eee edf ed< e e ed< e e ed< e e ed< dS ) �DiscussionWithDetailsa7
Subclass of [`Discussion`].
Attributes:
title (`str`):
The title of the Discussion / Pull Request
status (`str`):
The status of the Discussion / Pull Request.
It can be one of:
* `"open"`
* `"closed"`
* `"merged"` (only for Pull Requests )
* `"draft"` (only for Pull Requests )
num (`int`):
The number of the Discussion / Pull Request.
repo_id (`str`):
The id (`"{namespace}/{repo_name}"`) of the repo on which
the Discussion / Pull Request was open.
repo_type (`str`):
The type of the repo on which the Discussion / Pull Request was open.
Possible values are: `"model"`, `"dataset"`, `"space"`.
author (`str`):
The username of the Discussion / Pull Request author.
Can be `"deleted"` if the user has been deleted since.
is_pull_request (`bool`):
Whether or not this is a Pull Request.
created_at (`datetime`):
The `datetime` of creation of the Discussion / Pull Request.
events (`list` of [`DiscussionEvent`])
The list of [`DiscussionEvents`] in this Discussion or Pull Request.
conflicting_files (`Union[List[str], bool, None]`, *optional*):
A list of conflicting files if this is a Pull Request.
`None` if `self.is_pull_request` is `False`.
`True` if there are conflicting files but the list can't be retrieved.
target_branch (`str`, *optional*):
The branch into which changes are to be merged if this is a
Pull Request . `None` if `self.is_pull_request` is `False`.
merge_commit_oid (`str`, *optional*):
If this is a merged Pull Request , this is set to the OID / SHA of
the merge commit, `None` otherwise.
diff (`str`, *optional*):
The git diff if this is a Pull Request , `None` otherwise.
endpoint (`str`):
Endpoint of the Hub. Default is https://huggingface.co.
git_reference (`str`, *optional*):
(property) Git reference to which changes can be pushed if this is a Pull Request, `None` otherwise.
url (`str`):
(property) URL of the discussion on the Hub.
�DiscussionEvent�eventsN�conflicting_files�
target_branch�merge_commit_oid�diff)
r& r' r( r) r r+ r r* r. r r0 r! r r2 r2 W s} � � � � � � �0� 0�d
�"� #�#�#�#� �T�#�Y��d� 2�3�3�3�3��C�=� � � � �s�m�#�#�#�
�3�-�����r! r2 c �F � e Zd ZU dZeed< eed< eed< eed< eed< dS )r3 a�
An event in a Discussion or Pull Request.
Use concrete classes:
* [`DiscussionComment`]
* [`DiscussionStatusChange`]
* [`DiscussionCommit`]
* [`DiscussionTitleChange`]
Attributes:
id (`str`):
The ID of the event. An hexadecimal string.
type (`str`):
The type of the event.
created_at (`datetime`):
A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
object holding the creation timestamp for the event.
author (`str`):
The username of the Discussion / Pull Request author.
Can be `"deleted"` if the user has been deleted since.
�id�typer r �_eventN)r& r' r( r) r* r+ r �dictr0 r! r r3 r3 � sN � � � � � � �� �, �G�G�G�
�I�I�I����� �K�K�K� �L�L�L�M�Mr! r3 c �� � e Zd ZU dZeed< eed< eed< edefd�� � Zede fd�� � Z
edefd�� � Z ede e
fd �� � Zedefd
�� � Zd S ) �DiscussionCommentaz A comment in a Discussion / Pull Request.
Subclass of [`DiscussionEvent`].
Attributes:
id (`str`):
The ID of the event. An hexadecimal string.
type (`str`):
The type of the event.
created_at (`datetime`):
A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
object holding the creation timestamp for the event.
author (`str`):
The username of the Discussion / Pull Request author.
Can be `"deleted"` if the user has been deleted since.
content (`str`):
The raw markdown content of the comment. Mentions, links and images are not rendered.
edited (`bool`):
Whether or not this comment has been edited.
hidden (`bool`):
Whether or not this comment has been hidden.
�content�edited�hiddenr c �4 � | j d d d S )z&The rendered comment, as a HTML string�data�latest�html�r< r s r �renderedzDiscussionComment.rendered� s � � �{�6�"�8�,�V�4�4r! c �N � t | j d d d � � S )�+The last edit time, as a `datetime` object.rD rE � updatedAt)r r< r s r �last_edited_atz DiscussionComment.last_edited_at� s# � � �d�k�&� 1�(� ;�K� H�I�I�Ir! c �x � | j d d � di � � � dd� � S )rJ rD rE r �name�deleted)r< �getr s r �last_edited_byz DiscussionComment.last_edited_by� s6 � � �{�6�"�8�,�0�0��2�>�>�B�B�6�9�U�U�Ur! c �( � | j d d S )z The edit history of the commentrD �historyrG r s r � edit_historyz DiscussionComment.edit_history� s � � �{�6�"�9�-�-r! c �* � t | j � � S )N)�lenrT r s r �number_of_editsz!DiscussionComment.number_of_edits� s � ��4�$�%�%�%r! N)r& r' r( r) r* r+ r. r/ rH r rL rQ r r= rT r- rW r0 r! r r? r? � s � � � � � � �� �0 �L�L�L� �L�L�L� �L�L�L�
�5�#� 5� 5� 5� �X�5� �J�� J� J� J� �X�J� �V�� V� V� V� �X�V� �.�d�4�j� .� .� .� �X�.� �&�� &� &� &� �X�&� &� &r! r? c � � e Zd ZU dZeed< dS )�DiscussionStatusChangeaV A change of status in a Discussion / Pull Request.
Subclass of [`DiscussionEvent`].
Attributes:
id (`str`):
The ID of the event. An hexadecimal string.
type (`str`):
The type of the event.
created_at (`datetime`):
A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
object holding the creation timestamp for the event.
author (`str`):
The username of the Discussion / Pull Request author.
Can be `"deleted"` if the user has been deleted since.
new_status (`str`):
The status of the Discussion / Pull Request after the change.
It can be one of:
* `"open"`
* `"closed"`
* `"merged"` (only for Pull Requests )
�
new_statusN�r& r' r( r) r* r+ r0 r! r rY rY � s% � � � � � � �� �. �O�O�O�O�Or! rY c �( � e Zd ZU dZeed< eed< dS )�DiscussionCommita� A commit in a Pull Request.
Subclass of [`DiscussionEvent`].
Attributes:
id (`str`):
The ID of the event. An hexadecimal string.
type (`str`):
The type of the event.
created_at (`datetime`):
A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
object holding the creation timestamp for the event.
author (`str`):
The username of the Discussion / Pull Request author.
Can be `"deleted"` if the user has been deleted since.
summary (`str`):
The summary of the commit.
oid (`str`):
The OID / SHA of the commit, as a hexadecimal string.
�summary�oidNr[ r0 r! r r] r] s. � � � � � � �� �* �L�L�L� �H�H�H�H�Hr! r] c �( � e Zd ZU dZeed< eed< dS )�DiscussionTitleChangea� A rename event in a Discussion / Pull Request.
Subclass of [`DiscussionEvent`].
Attributes:
id (`str`):
The ID of the event. An hexadecimal string.
type (`str`):
The type of the event.
created_at (`datetime`):
A [`datetime`](https://docs.python.org/3/library/datetime.html?highlight=datetime#datetime.datetime)
object holding the creation timestamp for the event.
author (`str`):
The username of the Discussion / Pull Request author.
Can be `"deleted"` if the user has been deleted since.
old_title (`str`):
The previous title for the Discussion / Pull Request.
new_title (`str`):
The new title.
� old_title� new_titleNr[ r0 r! r ra ra ! s. � � � � � � �� �* �N�N�N��N�N�N�N�Nr! ra �eventr c �` � | d }| d }t | d � � }t |||| � di � � � dd� � | �� � }|dk r<t di |�| d d
| d d | d d d
d���S |dk r t di |�d| d d i��S |dk r)t di |�| d d | d d d���S |dk r)t
di |�| d d | d d d���S t di |��S )z.Instantiates a [`DiscussionEvent`] from a dictr: r; � createdAtr rN rO )r: r; r r r< �commentrD rA rB rE �raw)rA rB r@ z
status-changerZ r �commit�subjectr_ )r^ r_ z title-change�from�to)rb rc r0 )r r= rP r? rY r] ra r3 )rd �event_id�
event_typer � common_argss r �deserialize_eventrp < s� � ��$�K�H��F�m�J� ��k� 2�3�3�J�� �
� ��y�y��2�&�&�*�*�6�9�=�=�� � � �K� �Y� � � �
�
��
���=��*���=��*��&�M�(�+�E�2�
�
�
�
�
� �_�$�$�%�
�
��
�
� �V�}�X�.�
�
�
�
� �X� � � �
�
��
��&�M�)�,��f�
�e�$�
�
�
�
�
�
�^�#�#�$�
�
��
��F�m�F�+��F�m�D�)�
�
�
�
�
� � )� )�[� )� )�)r! N)r) � dataclassesr r �typingr r r r � r
�utilsr r, r r2 r3 r? rY r] ra r= rp r0 r! r �<module>ru sI ��� � "� !� !� !� !� !� � � � � � � 1� 1� 1� 1� 1� 1� 1� 1� 1� 1� 1� 1� � � � � � � !� !� !� !� !� !� �>�?� � �@Z� @Z� @Z� @Z� @Z� @Z� @Z� ��@Z�F �7� 7� 7� 7� 7�J� 7� 7� ��7�t � N� N� N� N� N� N� N� �� N�@ �3&� 3&� 3&� 3&� 3&�� 3&� 3&� ��3&�l �� � � � �_� � � ���6 �
�
�
�
�
��
�
� ��
�4 �� � � � �O� � � ���4'*�T� '*�o� '*� '*� '*� '*� '*� '*r!