Ë
    ÂÓ^jJ  ã                   óô   — d Z ddlmZmZmZ ddlmZ ddlmZ ddl	m
Z
  e
d«      Zg d¢Zdd	gZd
d
d
dœdee   dee   ez  d
z  dee   ez  d
z  deegef   d
z  deed
d
f   f
d„Zdeez  defd„Zdedefd„Zy
)z6Contains utilities to handle paths in Huggingface Hub.é    )ÚCallableÚ	GeneratorÚIterable©Úfnmatchcase)ÚPath)ÚTypeVarÚT)ú.gitz.git/*z*/.gitz
**/.git/**z.cache/huggingfacez.cache/huggingface/*z*/.cache/huggingfacez**/.cache/huggingface/**r   z.cacheN)Úallow_patternsÚignore_patternsÚkeyÚitemsr   r   r   Úreturnc             #   ó¶  ‡K  — t        |t        «      r|g}t        |t        «      r|g}|�!|D �cg c]  }t        t        |«      «      ‘Œ }}|�!|D �cg c]  }t        t        |«      «      ‘Œ }}|€dt        dt        fd„}|}| D ]E  }t         ||«      «      Š|�t        ˆfd„|D «       «      sŒ+|�t        ˆfd„|D «       «      rŒB|–— ŒG yc c}w c c}w ­w)aµ
  Filter repo objects based on an allowlist and a denylist.

    Input must be a list of paths (`str` or `Path`) or a list of arbitrary objects.
    In the later case, `key` must be provided and specifies a function of one argument
    that is used to extract a path from each element in iterable.

    Patterns are Standard Wildcards (globbing patterns), NOT regular expressions. The pattern matching is based on
    Python's `fnmatch.fnmatchcase`, so it is case-sensitive on every platform. Backslashes are treated as path separators
    and normalized to forward slashes in both patterns and paths before matching, so patterns built with `os.path.join`
    on Windows work as expected.

    Note that it matches `*` across path boundaries, unlike traditional Unix shell globbing. For example, `"data/*.json"`
    will match both `data/file.json` and `data/subdir/file.json`.

    See https://docs.python.org/3/library/fnmatch.html for more details.

    Args:
        items (`Iterable`):
            List of items to filter.
        allow_patterns (`str` or `list[str]`, *optional*):
            Patterns constituting the allowlist. If provided, item paths must match at
            least one pattern from the allowlist.
        ignore_patterns (`str` or `list[str]`, *optional*):
            Patterns constituting the denylist. If provided, item paths must not match
            any patterns from the denylist.
        key (`Callable[[T], str]`, *optional*):
            Single-argument function to extract a path from each item. If not provided,
            the `items` must already be `str` or `Path`.

    Returns:
        Filtered list of objects, as a generator.

    Raises:
        :class:`ValueError`:
            If `key` is not provided and items are not `str` or `Path`.

    Example usage with paths:
    ```python
    >>> # Filter only PDFs that are not hidden.
    >>> list(filter_repo_objects(
    ...     ["aaa.pdf", "bbb.jpg", ".ccc.pdf", ".ddd.png"],
    ...     allow_patterns=["*.pdf"],
    ...     ignore_patterns=[".*"],
    ... ))
    ["aaa.pdf"]
    ```

    Example usage with objects:
    ```python
    >>> list(filter_repo_objects(
    ... [
    ...     CommitOperationAdd(path_or_fileobj="/tmp/aaa.pdf", path_in_repo="aaa.pdf")
    ...     CommitOperationAdd(path_or_fileobj="/tmp/bbb.jpg", path_in_repo="bbb.jpg")
    ...     CommitOperationAdd(path_or_fileobj="/tmp/.ccc.pdf", path_in_repo=".ccc.pdf")
    ...     CommitOperationAdd(path_or_fileobj="/tmp/.ddd.png", path_in_repo=".ddd.png")
    ... ],
    ... allow_patterns=["*.pdf"],
    ... ignore_patterns=[".*"],
    ... key=lambda x: x.path_in_repo
    ... ))
    [CommitOperationAdd(path_or_fileobj="/tmp/aaa.pdf", path_in_repo="aaa.pdf")]
    ```
    NÚitemr   c                 óz   — t        | t        «      r| S t        | t        «      rt        | «      S t        d| › d�«      ‚)Nz9Please provide `key` argument in `filter_repo_objects`: `z` is not a string.)Ú
isinstanceÚstrr   Ú
ValueError)r   s    úg/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/huggingface_hub/utils/_paths.pyÚ	_identityz&filter_repo_objects.<locals>._identityz   s=   € Ü˜$¤Ô$Ø�Ü˜$¤Ô%Ü˜4“yÐ ÜÐXÐY]ÐX^Ð^pÐqÓrÐró    c              3   ó6   •K  — | ]  }t        ‰|«      –— Œ y ­w©Nr   ©Ú.0ÚrÚpaths     €r   ú	<genexpr>z&filter_repo_objects.<locals>.<genexpr>‡   s   øè ø€ Ò1_È1´+¸dÀA×2FÑ1_ùó   ƒc              3   ó6   •K  — | ]  }t        ‰|«      –— Œ y ­wr   r   r   s     €r   r    z&filter_repo_objects.<locals>.<genexpr>‹   s   øè ø€ Ò.]È¬{¸4À×/CÑ.]ùr!   )r   r   Ú_add_wildcard_to_directoriesÚ_normalize_separatorsr
   Úany)r   r   r   r   Úpr   r   r   s          @r   Úfilter_repo_objectsr'   '   sø   øè ø€ ôL �.¤#Ô&Ø(Ð)ˆä�/¤3Ô'Ø*Ð+ˆàÐ!ØZhÖiÐUVÔ6Ô7LÈQÓ7OÕPÐiˆÐiØÐ"Ø[jÖkÐVWÔ7Ô8MÈaÓ8PÕQÐkˆÐkà
€{ð	sœAð 	s¤#ó 	sð ˆàò ˆÜ$¡S¨£YÓ/ˆð Ð%¬cÓ1_ÐP^Ô1_Ô._Øð Ð&¬3Ó.]È_Ô.]Ô+]Øà‹
ñùò jùâkùs   ƒ-C°CÁCÁCÁ.A+CÚvaluec                 ó8   — t        | «      j                  dd«      S )Nú\ú/)r   Úreplace)r(   s    r   r$   r$   ‘   s   € ô ˆu‹:×Ñ˜d CÓ(Ð(r   Úpatternc                 ó2   — | j                  d«      r| dz   S | S )Nr+   Ú*)Úendswith)r-   s    r   r#   r#   ˜   s   € Ø×Ñ˜ÔØ˜‰}ÐØ€Nr   )Ú__doc__Úcollections.abcr   r   r   Úfnmatchr   Úpathlibr   Útypingr	   r
   ÚDEFAULT_IGNORE_PATTERNSÚFORBIDDEN_FOLDERSÚlistr   r'   r$   r#   © r   r   ú<module>r:      sã   ðñ =ç 9Ñ 9Ý Ý Ý ñ ˆCƒL€ò	Ð ð ˜XÐ&Ð ð .2Ø.2Ø%)ògØ�A‰;ðgð ˜‘I ‘O dÑ*ðgð ˜#‘Y ‘_ tÑ+ð	gð
 
�1�#�s�(Ñ	˜dÑ	"ðgð ˆq�$˜ˆ}ÑógðT)  t¡ð )°ó )ð¨#ð °#ô r   