+ jRt^RIt^RIHtHtHt^RIHt^RIH t ^RI H t ] !R4t .ROt RR.tRR R lltR RR RR R/RRlltRRltRRltR#)z6Contains utilities to handle paths in Huggingface Hub.N)Callable GeneratorIterable fnmatchcase)Path)TypeVarT.gitz.cachecRV^8dQhR\\,R\R\/#)path max_lengthreturn)strrint)formats"]/home/luca/screen-checking/.venv/lib/python3.14/site-packages/huggingface_hub/utils/_paths.py __annotate__r(s%%%3:%3%%c6\V4p\PR8wdV#\PP V4p\ V4V8:gVP R4'dV#VP R4'dRVR,,#RV,#)acReturn `path` in its Windows extended-length form if it is too long, unchanged otherwise. Some Windows versions do not allow for paths longer than 255 characters (247 for directories, i.e. MAX_PATH minus room for an 8.3 file name). In this case, we must specify them as extended paths by using the `\\?\` prefix, which only works on absolute paths. Network shares take the `\\?\UNC\server\share\...` form: prefixing them verbatim would produce an invalid `\\?\\\server\...` path. Args: path (`str` or `Path`): The path to convert. Returned unchanged on non-Windows platforms, if it is short enough, or if it is already an extended path. max_length (`int`, *optional*): Length above which the path must be converted. Defaults to 255, the limit for files. Pass 247 for paths whose parent directories are created by the caller. ntz\\?\z\\z\\?\UNC\:r NN)rosnamer abspathlen startswith)r r absolute_paths&& ras_extended_pathr(s} t9D ww$ GGOOD)M =Z'=+C+CI+N+N '' b 111 } $$rallow_patternsignore_patternskeyc ,V^8dQhR\\,R\\,\,R,R\\,\,R,R\\.\3,R,R\ \RR3,/#)r itemsrNr r!r)rr listrrr)rs"rrrCs|gg A;gIOd*g#Y_t+ g 1#s( d " g q$} grc#a"\V\4'dV.p\V\4'dV.pVe$VUu.uFp\\V44NK ppVe$VUu.uFp\\V44NK ppVf RRlpTpVFp\V!V44oVeC\;QJdV3RlV4F 'gK RM RM!V3RlV44'gKZVeC\;QJdV3RlV4F 'gK RM RM!V3RlV44'dKVxK R#uupiuupi5i)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")] ``` Nc0V^8dQhR\R\/#)r itemr)r r)rs"rr)filter_repo_objects..__annotate__s s sA s# src\V\4'dV#\V\4'd \V4#\RV R24h)z9Please provide `key` argument in `filter_repo_objects`: `z` is not a string.) isinstancerr ValueError)r's&r _identity&filter_repo_objects.._identitysC$$$ $%%4y XY]X^^pqr rrc3<<"TFp\SV4xK R#5iNr.0rr s& r &filter_repo_objects..s1_P^1+dA2F2FP^TFc3<<"TFp\SV4xK R#5ir/rr0s& rr3r4s.]_{4/C/C_r5)r*r_add_wildcard_to_directories_normalize_separatorsany)r#rr r!pr,r'r s&$$$ @rfilter_repo_objectsr;CsL.#&&()/3''*+!ZhiZhUV67LQ7OPZhi"[jk[jVW78Ma8PQ[jk { s$SY/  %cc1_P^1_ccc1_P^1_._._   &33.]_.]333.]_.]+]+]  jks@;ED< E%E2E5E E*E;EE0EcFV^8dQhR\\,R\/#)r valuer)rr)rs"rrrs))t))rc8\V4PRR4#)\/)rreplace)r=s&rr8r8s u:  dC ((rc0V^8dQhR\R\/#)r patternr)r)rs"rrrs##rcFVPR4'd VR,#V#)r@*)endswith)rCs&rr7r7s"} Nr)r z.git/*z*/.gitz **/.git/**z.cache/huggingfacez.cache/huggingface/*z*/.cache/huggingfacez**/.cache/huggingface/**))__doc__rcollections.abcrrrfnmatchrpathlibrtypingrr DEFAULT_IGNORE_PATTERNSFORBIDDEN_FOLDERSrr;r8r7rrrPss= 99 CL X&%6g.2g/3 g &* gT)r