# مرجع نظام التخزين المؤقت

تم تحديث نظام التخزين المؤقت في الإصدار v0.8.0 ليصبح نظام تخزين مؤقت مركزيًا مشتركًا عبر المكتبات التي تعتمد على Hub. اقرأ [دليل نظام التخزين المؤقت](../guides/manage-cache) للحصول على عرض مفصل للتخزين المؤقت في HF.

## المساعدات

### try_to_load_from_cache[[huggingface_hub.try_to_load_from_cache]]

#### huggingface_hub.try_to_load_from_cache[[huggingface_hub.try_to_load_from_cache]]

```python
huggingface_hub.try_to_load_from_cache(repo_id: str, filename: str, cache_dir: str | pathlib.Path | None = None, revision: str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/file_download.py#L1522)

**المعاملات:**

cache_dir (`str` أو `os.PathLike`) : المجلد الذي توجد فيه الملفات المخزنة مؤقتًا.

repo_id (`str`) : المعرّف الخاص بالمستودع على huggingface.co.

filename (`str`) : اسم الملف الذي يجب البحث عنه داخل `repo_id`.

revision (`str`، *اختياري*) : إصدار النموذج المحدد للاستخدام. سيُستخدم `"main"` افتراضيًا إذا لم يُقدَّم ولم يُقدَّم `commit_hash` أيضًا.

repo_type (`str`، *اختياري*) : نوع المستودع. سيكون الافتراضي `"model"`.

**يعيد:** `Optional[str]` أو `_CACHED_NO_EXIST`

ستعيد `None` إذا لم يتم تخزين الملف مؤقتًا. وإلا:
- المسار الدقيق للملف المخزّن مؤقتًا إذا وُجد في ذاكرة التخزين المؤقت
- قيمة خاصة `_CACHED_NO_EXIST` إذا لم يكن الملف موجودًا عند تجزئة الالتزام المحددة وتم تخزين هذا الأمر مؤقتًا.

يستكشف ذاكرة التخزين المؤقت لإرجاع أحدث ملف مخزّن مؤقتًا لإصدار معين إذا وُجد.

لن ترمي هذه الدالة أي استثناء إذا لم يكن الملف مخزّنًا مؤقتًا.

مثال:

```python
from huggingface_hub import try_to_load_from_cache, _CACHED_NO_EXIST

filepath = try_to_load_from_cache()
if isinstance(filepath, str):
    # file exists and is cached
    ...
elif filepath is _CACHED_NO_EXIST:
    # non-existence of file is cached
    ...
else:
    # file is not cached
    ...
```

### cached_assets_path[[huggingface_hub.cached_assets_path]]

#### huggingface_hub.cached_assets_path[[huggingface_hub.cached_assets_path]]

```python
huggingface_hub.cached_assets_path(library_name: str, namespace: str = 'default', subfolder: str = 'default', assets_dir: str | pathlib.Path | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_assets.py#L19)

**المعاملات:**

library_name (`str`) : اسم المكتبة التي ستدير مجلد التخزين المؤقت. مثال: `"dataset"`.

namespace (`str`، *اختياري*، القيمة الافتراضية "default") : مساحة الأسماء التي تنتمي إليها البيانات. مثال: `"SQuAD"`.

subfolder (`str`، *اختياري*، القيمة الافتراضية "default") : المجلد الفرعي الذي سيتم تخزين البيانات فيه. مثال: `extracted`.

assets_dir (`str`, `Path`, *اختياري*) : المسار إلى المجلد الذي تُخزَّن فيه الأصول مؤقتًا. يجب ألا يكون هذا المجلد هو نفسه المجلد الذي تُخزَّن فيه ملفات Hub مؤقتًا. الافتراضي هو `HF_HOME / "assets"` إذا لم يُقدَّم. يمكن أيضًا ضبطه عبر متغير البيئة `HF_ASSETS_CACHE`.

**يعيد:**

مسار مجلد التخزين المؤقت (`Path`).

إرجاع مسار مجلد لتخزين ملفات عشوائية مؤقتًا.

`huggingface_hub` يوفر مسار مجلد قياسي لتخزين الأصول. يُعد هذا هو الطريقة الموصى بها لدمج ذاكرة التخزين المؤقت في مكتبة لاحقة، إذ سيستفيد من الأدوات المدمجة لمسح ذاكرة التخزين المؤقت وحذفها بشكل صحيح.

يتم التمييز بين الملفات المخزنة مؤقتًا من Hub والموارد. تُخزَّن الملفات من Hub بطريقة واعية بـ git وتُدار بالكامل بواسطة `huggingface_hub`. راجع [التوثيق ذي الصلة](https://huggingface.co/docs/huggingface_hub/how-to-cache). تُعتبر جميع الملفات الأخرى التي تخزنها مكتبة لاحقة مؤقتًا "موارد" (ملفات تم تنزيلها من مصادر خارجية، أو تم استخراجها من أرشيف .tar، أو تم معالجتها مسبقًا للتدريب، ...).

بمجرد توليد مسار المجلد، يُكفَل وجوده وأنه مجلد. يعتمد المسار على ثلاثة مستويات من العمق: اسم المكتبة، ومساحة الأسماء، ومجلد فرعي. تمنح هذه المستويات الثلاثة مرونة مع السماح لـ`huggingface_hub` بالتوقع وجود مجلدات عند فحص/حذف أجزاء من ذاكرة التخزين المؤقت للأصول. داخل مكتبة معينة، يُتوقع أن تتشارك جميع مساحات الأسماء نفس مجموعة أسماء المجلدات الفرعية، لكن هذه ليست قاعدة إلزامية. تمتلك المكتبة المنبثقة عندها التحكم الكامل في هيكل الملفات المعتمد داخل ذاكرتها المؤقتة. مساحة الأسماء والمجلد الفرعي اختياريان (سيُستخدم مجلد فرعي افتراضي باسم `"default/"`)، لكن اسم المكتبة إلزامي لأننا نريد من كل مكتبة منبثقة إدارة ذاكرتها المؤقتة الخاصة بها.

الشجرة المتوقعة:
```text
    assets/
    └── datasets/
    │   ├── SQuAD/
    │   │   ├── downloaded/
    │   │   ├── extracted/
    │   │   └── processed/
    │   ├── Helsinki-NLP--tatoeba_mt/
    │       ├── downloaded/
    │       ├── extracted/
    │       └── processed/
    └── transformers/
        ├── default/
        │   ├── something/
        ├── bert-base-cased/
        │   ├── default/
        │   └── training/
    hub/
    └── models--julien-c--EsperBERTo-small/
        ├── blobs/
        │   ├── (...)
        │   ├── (...)
        ├── refs/
        │   └── (...)
        └── [ 128]  snapshots/
            ├── 2439f60ef33a0d46d85da5001d52aeda5b00ce9f/
            │   ├── (...)
            └── bbc77c8132af1cc5cf678da3f1ddf2de43606d48/
                └── (...)
```

مثال:
```py
>>> from huggingface_hub import cached_assets_path

>>> cached_assets_path(library_name="datasets", namespace="SQuAD", subfolder="download")
PosixPath('/home/wauplin/.cache/huggingface/extra/datasets/SQuAD/download')

>>> cached_assets_path(library_name="datasets", namespace="SQuAD", subfolder="extracted")
PosixPath('/home/wauplin/.cache/huggingface/extra/datasets/SQuAD/extracted')

>>> cached_assets_path(library_name="datasets", namespace="Helsinki-NLP/tatoeba_mt")
PosixPath('/home/wauplin/.cache/huggingface/extra/datasets/Helsinki-NLP--tatoeba_mt/default')

>>> cached_assets_path(library_name="datasets", assets_dir="/tmp/tmp123456")
PosixPath('/tmp/tmp123456/datasets/default/default')
```

### scan_cache_dir[[huggingface_hub.scan_cache_dir]]

#### huggingface_hub.scan_cache_dir[[huggingface_hub.scan_cache_dir]]

```python
huggingface_hub.scan_cache_dir(cache_dir: str | pathlib.Path | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L680)

**المعاملات:**

cache_dir (`str` or `Path`, `optional`) : Cache directory to cache. Defaults to the default HF cache directory.

امسح نظام كاش HF بالكامل وأعد بنية [~HFCacheInfo](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.HFCacheInfo).

استخدم `scan_cache_dir` لمسح نظام الكاش الخاص بك برمجياً. سيتم مسح الكاش مستودعاً تلو الآخر. إذا كان أحد المستودعات تالفاً، فسيتم طرح [~CorruptedCacheException](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.CorruptedCacheException) داخلياً لكنه سيُلتقط ويُعاد ضمن بنية [~HFCacheInfo](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.HFCacheInfo). لن تحصل المستودعات الصالحة فقط على تقرير سليم.

```py
>>> from huggingface_hub import scan_cache_dir

>>> hf_cache_info = scan_cache_dir()
HFCacheInfo(
    size_on_disk=3398085269,
    repos=frozenset({
        CachedRepoInfo(
            repo_id='t5-small',
            repo_type='model',
            repo_path=PosixPath(...),
            size_on_disk=970726914,
            nb_files=11,
            revisions=frozenset({
                CachedRevisionInfo(
                    commit_hash='d78aea13fa7ecd06c29e3e46195d6341255065d5',
                    size_on_disk=970726339,
                    snapshot_path=PosixPath(...),
                    files=frozenset({
                        CachedFileInfo(
                            file_name='config.json',
                            size_on_disk=1197
                            file_path=PosixPath(...),
                            blob_path=PosixPath(...),
                        ),
                        CachedFileInfo(...),
                        ...
                    }),
                ),
                CachedRevisionInfo(...),
                ...
            }),
        ),
        CachedRepoInfo(...),
        ...
    }),
    warnings=[
        CorruptedCacheException("Snapshots dir doesn't exist in cached repo: ..."),
        CorruptedCacheException(...),
        ...
    ],
)
```

يمكنك أيضًا طباعة تقرير مفصّل مباشرةً من سطر الأوامر `hf` باستخدام:
```text
> hf cache ls
ID                          SIZE     LAST_ACCESSED LAST_MODIFIED REFS
--------------------------- -------- ------------- ------------- -----------
dataset/nyu-mll/glue          157.4M 2 days ago    2 days ago    main script
model/LiquidAI/LFM2-VL-1.6B     3.2G 4 days ago    4 days ago    main
model/microsoft/UserLM-8b      32.1G 4 days ago    4 days ago    main

Done in 0.0s. Scanned 6 repo(s) for a total of 3.4G.
Got 1 warning(s) while scanning. Use -vvv to print details.
```

> [!WARNING]
> يرفع:
>
> `CacheNotFound` إذا لم يكن مجلد الكاش موجودًا.
>
> [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كان مجلد التخزين المؤقت ملفًا بدلاً من مجلد.

يعيد: كائن [~HFCacheInfo](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.HFCacheInfo).

## هياكل البيانات

تُبنى جميع الهياكل وتُعاد بواسطة [scan_cache_dir()](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.scan_cache_dir) وهي غير قابلة للتغيير.

### HFCacheInfo[[huggingface_hub.HFCacheInfo]]

#### huggingface_hub.HFCacheInfo[[huggingface_hub.HFCacheInfo]]

```python
huggingface_hub.HFCacheInfo(size_on_disk: int, repos: frozenset, incomplete_files: frozenset, warnings: list, cache_dir: pathlib.Path | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L384)

**المعاملات:**

size_on_disk (`int`) : الحجم الفعلي لنظام التخزين المؤقت بالبايت. يُحتسب أي كتلة مشتركة بين المستودعات مرة واحدة، وتُضمَّن الكتل المشتركة المخصصة للتخزين فقط التي لم تعد تشير إليها أي مستودعات. قد يكون أصغر من مجموع أحجام المستودعات الفردية.

repos (`frozenset[CachedRepoInfo]`) : مجموعة من [~CachedRepoInfo](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.CachedRepoInfo) تصف جميع المستودعات المخزنة مؤقتًا الصالحة التي تم العثور عليها في نظام التخزين المؤقت أثناء المسح.

incomplete_files (`frozenset[CachedIncompleteFileInfo]`) : مجموعة من [~CachedIncompleteFileInfo](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.CachedIncompleteFileInfo) تصف ملفات `*.incomplete` متروكة خلفها عمليات التحميل المقطوعة.

warnings (`list[CorruptedCacheException]`) : قائمة من [~CorruptedCacheException](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.CorruptedCacheException) التي حدثت أثناء فحص ذاكرة التخزين المؤقت. يتم التقاط هذه الاستثناءات حتى يتمكن الفحص من المتابعة. يتم تجاوز المستودعات التالفة من الفحص.

cache_dir (`Path` أو `None`) : مجلد التخزين المؤقت الذي تم فحصه.

بنية بيانات مجمّدة تحتوي على معلومات حول نظام الكاش بالكامل.

تُعاد هذه البنية البياناتية بواسطة [scan_cache_dir()](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.scan_cache_dir) وهي غير قابلة للتغيير.

> [!WARNING]
> `size_on_disk` يأخذ في الاعتبار الكتل (blobs) فقط، وتُتخطَّأ المستودعات التالفة. وهو حجم فيزيائي: على عكس `CachedRepoInfo.size_on_disk` الذي يُسند الكتلة المشتركة إلى كل مستودع يشير إليها، تُحتسب الكتلة المشتركة هنا مرة واحدة فقط.

#### delete_files[[huggingface_hub.HFCacheInfo.delete_files]]

```python
delete_files(*files: CachedFileInfo)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L536)

جهّز الاستراتيجية لحذف الملفات المخزّنة مؤقتًا بشكل فردي.

تُحذف إدخالات اللقطة فقط. لا يُحذف الكائن (blob) إلا إذا لم يكن أي ملف مخزّن مؤقت آخر يشير إليه، لذا تُحفظ الكائنات المشتركة مع مراجع أخرى. كما تُحفظ المراجع ومجلدات اللقطات أيضًا، حتى لو أصبحت اللقطة فارغة في النهاية. لحذف مراجع أو مستودعات كاملة، استخدم [delete_revisions()](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.HFCacheInfo.delete_revisions).

مثال:
```py
>>> from huggingface_hub import scan_cache_dir
>>> cache_info = scan_cache_dir()
>>> files = [
...     file
...     for repo in cache_info.repos
...     if repo.repo_id == "org/model"
...     for revision in repo.revisions
...     for file in revision.files
...     if file.file_name == "model-Q4_K_M.gguf"
... ]
>>> delete_strategy = cache_info.delete_files(*files)
>>> print(f"Will free {delete_strategy.expected_freed_size_str}.")
Will free 4.9G.
>>> delete_strategy.execute()
```

#### delete_revisions[[huggingface_hub.HFCacheInfo.delete_revisions]]

```python
delete_revisions(*revisions: str)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L433)

جهّز الاستراتيجية لحذف مراجعة واحدة أو أكثر مخزّنة مؤقتًا محليًا.

يمكن أن تكون مراجع الإدخال أي تجزئة مراجعة. إذا لم يتم العثور على تجزئة مراجعة في ذاكرة التخزين المؤقت المحلية، يتم طرح تحذير دون رفع خطأ. يمكن أن تكون المراجعات من مستودعات مخزنة مؤقتًا مختلفة نظرًا لأن التجزئات فريدة عبر المستودعات،

أمثلة:
```py
>>> from huggingface_hub import scan_cache_dir
>>> cache_info = scan_cache_dir()
>>> delete_strategy = cache_info.delete_revisions(
...     "81fd1d6e7847c99f5862c9fb81387956d99ec7aa"
... )
>>> print(f"Will free {delete_strategy.expected_freed_size_str}.")
Will free 7.9K.
>>> delete_strategy.execute()
```

```py
>>> from huggingface_hub import scan_cache_dir
>>> scan_cache_dir().delete_revisions(
...     "81fd1d6e7847c99f5862c9fb81387956d99ec7aa",
...     "e2983b237dccf3ab4937c97fa717319a9ca1a96d",
...     "6c0e6080953db56375760c0471a8c5f2929baf11",
... ).execute()
```

> [!WARNING]
> يعيد `delete_revisions` كائن [DeleteCacheStrategy](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.DeleteCacheStrategy) يحتاج إلى التنفيذ. لا يُقصد بـ [DeleteCacheStrategy](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.DeleteCacheStrategy) أن يُعدَّل، لكنه يتيح إجراء تجربة جافة قبل تنفيذ الحذف فعليًا.

#### export_as_table[[huggingface_hub.HFCacheInfo.export_as_table]]

```python
export_as_table(verbosity: int = 0)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L585)

**المعاملات:**

verbosity (`int`، *اختياري*) : مستوى التفصيل. القيمة الافتراضية هي 0.

**يعيد:** `str`

الجدول كنص.

أنشئ جدولاً من كائن [HFCacheInfo](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.HFCacheInfo).

مرّر `verbosity=0` للحصول على جدول يحتوي على صف واحد لكل مستودع، مع الأعمدة "repo_id" و"repo_type" و"size_on_disk" و"nb_files" و"last_accessed" و"last_modified" و"refs" و"local_path".

مرّر `verbosity=1` للحصول على جدول يحتوي على صف لكل مستودع ومراجعة (وبالتالي قد تظهر عدة صفوف لمستودع واحد)، مع الأعمدة "repo_id" و"repo_type" و"revision" و"size_on_disk" و"nb_files" و"last_modified" و"refs" و"local_path".

مثال:
```py
>>> from huggingface_hub.utils import scan_cache_dir

>>> hf_cache_info = scan_cache_dir()
HFCacheInfo(...)

>>> print(hf_cache_info.export_as_table())
REPO ID                                             REPO TYPE SIZE ON DISK NB FILES LAST_ACCESSED LAST_MODIFIED REFS LOCAL PATH
--------------------------------------------------- --------- ------------ -------- ------------- ------------- ---- --------------------------------------------------------------------------------------------------
roberta-base                                        model             2.7M        5 1 day ago     1 week ago    main ~/.cache/huggingface/hub/models--roberta-base
suno/bark                                           model             8.8K        1 1 week ago    1 week ago    main ~/.cache/huggingface/hub/models--suno--bark
t5-base                                             model           893.8M        4 4 days ago    7 months ago  main ~/.cache/huggingface/hub/models--t5-base
t5-large                                            model             3.0G        4 5 weeks ago   5 months ago  main ~/.cache/huggingface/hub/models--t5-large

>>> print(hf_cache_info.export_as_table(verbosity=1))
REPO ID                                             REPO TYPE REVISION                                 SIZE ON DISK NB FILES LAST_MODIFIED REFS LOCAL PATH
--------------------------------------------------- --------- ---------------------------------------- ------------ -------- ------------- ---- -----------------------------------------------------------------------------------------------------------------------------------------------------
roberta-base                                        model     e2da8e2f811d1448a5b465c236feacd80ffbac7b         2.7M        5 1 week ago    main ~/.cache/huggingface/hub/models--roberta-base/snapshots/e2da8e2f811d1448a5b465c236feacd80ffbac7b
suno/bark                                           model     70a8a7d34168586dc5d028fa9666aceade177992         8.8K        1 1 week ago    main ~/.cache/huggingface/hub/models--suno--bark/snapshots/70a8a7d34168586dc5d028fa9666aceade177992
t5-base                                             model     a9723ea7f1b39c1eae772870f3b547bf6ef7e6c1       893.8M        4 7 months ago  main ~/.cache/huggingface/hub/models--t5-base/snapshots/a9723ea7f1b39c1eae772870f3b547bf6ef7e6c1
t5-large                                            model     150ebc2c4b72291e770f58e6057481c8d2ed331a         3.0G        4 5 months ago  main ~/.cache/huggingface/hub/models--t5-large/snapshots/150ebc2c4b72291e770f58e6057481c8d2ed331a
```

### CachedRepoInfo[[huggingface_hub.CachedRepoInfo]]

#### huggingface_hub.CachedRepoInfo[[huggingface_hub.CachedRepoInfo]]

```python
huggingface_hub.CachedRepoInfo(repo_id: str, repo_type: typing.Literal['model', 'dataset', 'space', 'kernel'], repo_path: Path, size_on_disk: int, nb_files: int, revisions: frozenset, last_accessed: float, last_modified: float)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L176)

**المعاملات:**

repo_id (`str`) : معرّف المستودع على Hub. مثال: `"google/fleurs"`.

repo_type (`Literal["dataset", "model", "space", "kernel"]`) : نوع المستودع المخزّن مؤقتًا.

repo_path (`Path`) : المسار المحلي للمستودع المخزّن مؤقتًا.

size_on_disk (`int`) : مجموع أحجام ملفات blob في المستودع المخزّن مؤقتًا.

nb_files (`int`) : العدد الإجمالي لملفات blob في المستودع المخزّن مؤقتًا.

revisions (`frozenset[CachedRevisionInfo]`) : مجموعة من [~CachedRevisionInfo](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.CachedRevisionInfo) تصف جميع المراجعات المخزنة مؤقتًا في المستودع.

last_accessed (`float`) : طابع زمني لآخر وقت تم فيه الوصول إلى ملف blob في المستودع.

last_modified (`float`) : طابع زمني لآخر وقت تم فيه تعديل/إنشاء ملف blob في المستودع.

بنية بيانات مجمّدة تحتوي على معلومات حول مستودع مخزّن مؤقتًا.

> [!WARNING]
> `size_on_disk` ليس بالضرورة مجموع أحجام جميع المراجعات بسبب الملفات المكررة. علاوة على ذلك، يُؤخذ في الاعتبار حجم الكتل (blobs) فقط، وليس حجم المجلدات وروابط الرموز (symlinks) (الذي يُعدّ ضئيلاً).

> [!WARNING]
> يمكن أن تعتمد موثوقية `last_accessed` و`last_modified` على نظام التشغيل الذي تستخدمه. راجع [توثيق بايثون](https://docs.python.org/3/library/os.html#os.stat_result) لمزيد من التفاصيل.

#### size_on_disk_str[[huggingface_hub.CachedRepoInfo.size_on_disk_str]]

```python
size_on_disk_str()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L238)

(خاصية) مجموع أحجام ملفات blob كنص قابل للقراءة البشرية.

مثال: "42.2K".

#### المراجع[[huggingface_hub.CachedRepoInfo.refs]]

```python
refs()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L252)

(خاصية) الترميز بين `refs` وهياكل بيانات المراجعات.

### CachedRevisionInfo[[huggingface_hub.CachedRevisionInfo]]

#### huggingface_hub.CachedRevisionInfo[[huggingface_hub.CachedRevisionInfo]]

```python
huggingface_hub.CachedRevisionInfo(commit_hash: str, snapshot_path: Path, size_on_disk: int, files: frozenset, refs: frozenset, last_modified: float)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L105)

**المعاملات:**

commit_hash (`str`) : تجزئة المراجعة (فريدة). مثال: `"9338f7b671827df886678df2bdd7cc7b4f36dffd"`.

snapshot_path (`Path`) : المسار إلى مجلد المراجعة في مجلد `snapshots`. يحتوي على هيكل شجرة مطابق تمامًا للمستودع على Hub.

files : (`frozenset[CachedFileInfo]`): مجموعة من [~CachedFileInfo](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.CachedFileInfo) تصف جميع الملفات الموجودة في اللقطة.

refs (`frozenset[str]`) : مجموعة من `refs` تشير إلى هذا المراجعة. إذا لم يكن للمراجعة أي `refs`، فإنها تُعتبر منفصلة. مثال: `{"main", "2.4.0"}` أو `{"refs/pr/1"}`.

size_on_disk (`int`) : مجموع أحجام ملفات blob المرتبطة عبر روابط رمزية بواسطة هذا المراجعة.

last_modified (`float`) : طابع زمني لآخر وقت تم فيه إنشاء/تعديل المراجعة.

بنية بيانات مجمّدة تحتوي على معلومات حول نسخة.

يتوافق كل إصدار مع مجلد في مجلد `snapshots` ويُعبأ بهيكل شجرة مطابق لهيكل المستودع على Hub، لكنه يحتوي على روابط رمزية فقط. يمكن أن يُشار إلى إصدار واحد أو أكثر من `refs`، أو يكون "منفصلاً" (بدون أي refs).

> [!WARNING]
> `last_accessed` لا يمكن تحديده بشكل صحيح على مراجعة واحدة لأن ملفات blob مشتركة عبر المراجعات.

> [!WARNING]
> `size_on_disk` ليس بالضرورة مجموع أحجام جميع الملفات بسبب احتمال وجود ملفات مكررة. بالإضافة إلى ذلك، يُؤخذ في الاعتبار حجم الكائنات (blobs) فقط، وليس حجم المجلدات وروابط الرموز (symlinks) (الذي يُعدّ ضئيلاً).

#### size_on_disk_str[[huggingface_hub.CachedRevisionInfo.size_on_disk_str]]

```python
size_on_disk_str()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L158)

(خاصية) مجموع أحجام ملفات blob كنص قابل للقراءة البشرية.

مثال: "42.2K".

#### nb_files[[huggingface_hub.CachedRevisionInfo.nb_files]]

```python
nb_files()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L167)

(خاصية) إجمالي عدد الملفات في المراجعة.

### CachedFileInfo[[huggingface_hub.CachedFileInfo]]

#### huggingface_hub.CachedFileInfo[[huggingface_hub.CachedFileInfo]]

```python
huggingface_hub.CachedFileInfo(file_name: str, file_path: Path, blob_path: Path, size_on_disk: int, blob_last_accessed: float, blob_last_modified: float)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L40)

**المعاملات:**

file_name (`str`) : اسم الملف. مثال: `config.json`.

file_path (`Path`) : مسار الملف داخل مجلد `snapshots`. مسار الملف هو رابط رمزي يشير إلى كائن (blob) داخل مجلد `blobs`.

blob_path (`Path`) : مسار عنصر blob المحلي في المستودع الذي يشير إليه `file_path`. يمكن أن يكون عنصر blob نفسه رابطًا رمزيًا إلى مخزن blob المشترك على مستوى الكاش بالكامل.

size_on_disk (`int`) : حجم ملف blob بالبايت.

blob_last_accessed (`float`) : طابع زمني لآخر وقت تم فيه الوصول إلى ملف blob (من أي مراجعة).

blob_last_modified (`float`) : طابع زمني لآخر وقت تم فيه تعديل/إنشاء ملف blob.

بنية بيانات مجمّدة تحتوي على معلومات حول ملف مخزّن مؤقتًا واحد.

> [!WARNING]
> يمكن أن تعتمد موثوقية `blob_last_accessed` و`blob_last_modified` على نظام التشغيل الذي تستخدمه. راجع [توثيق بايثون](https://docs.python.org/3/library/os.html#os.stat_result) لمزيد من التفاصيل.

#### size_on_disk_str[[huggingface_hub.CachedFileInfo.size_on_disk_str]]

```python
size_on_disk_str()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L94)

(property) حجم ملف blob كنص قابل للقراءة البشرية.

مثال: "42.2K".

### CachedIncompleteFileInfo[[huggingface_hub.CachedIncompleteFileInfo]]

#### huggingface_hub.CachedIncompleteFileInfo[[huggingface_hub.CachedIncompleteFileInfo]]

```python
huggingface_hub.CachedIncompleteFileInfo(file_path: Path, size_on_disk: int)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L365)

**المعاملات:**

file_path (`Path`) : مسار ملف `.incomplete` في مجلد `blobs`.

size_on_disk (`int`) : حجم الملف الذي تم تنزيله جزئيًا بالبايت.

بنية بيانات مجمّدة تحتوي على معلومات حول تنزيل غير مكتمل واحد.

تترك التنزيلات المقطوعة ملفات `<cache>/<repo>/blobs/<etag>.incomplete`. ولا تُعد هذه الملفات جزءًا من أي مراجعة مُثبّتة، لذا تُعرض بشكل منفصل بواسطة [scan_cache_dir()](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.scan_cache_dir).

### DeleteCacheStrategy[[huggingface_hub.DeleteCacheStrategy]]

#### huggingface_hub.DeleteCacheStrategy[[huggingface_hub.DeleteCacheStrategy]]

```python
huggingface_hub.DeleteCacheStrategy(expected_freed_size: int, blobs: frozenset, refs: frozenset, repos: frozenset, snapshots: frozenset, files: frozenset = frozenset(), cache_dir: pathlib.Path | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L261)

**المعاملات:**

expected_freed_size (`float`) : الحجم المتوقع للتحرير بعد تنفيذ الاستراتيجية.

blobs (`frozenset[Path]`) : مجموعة مسارات ملفات blob التي سيتم حذفها.

refs (`frozenset[Path]`) : مجموعة مسارات ملفات مرجعية سيتم حذفها.

repos (`frozenset[Path]`) : مجموعة مسارات المستودع الكاملة التي سيتم حذفها.

snapshots (`frozenset[Path]`) : مجموعة من اللقطات التي سيتم حذفها (مجلد من الروابط الرمزية).

files (`frozenset[Path]`، *اختياري*) : مجموعة من إدخالات اللقطة الفردية التي سيتم حذفها. يتم حذف بياناتها (blobs) فقط إذا كانت مدرجة في `blobs`.

cache_dir (`Path` أو `None`) : مجلد التخزين المؤقت الذي تم حساب الاستراتيجية منه. يُستخدم لجمع الكتل المشتركة التي تشير إليها روابط رمزية محلية في المستودع وتمت إزالتها بواسطة عملية الحذف.

بنية بيانات مجمّدة تحتوي على الاستراتيجية لحذف المراجعات أو الملفات المخزّنة مؤقتًا.

لا يُقصد بهذا الكائن أن يُنشأ برمجياً، بل يُعاد بواسطة [delete_revisions()](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.HFCacheInfo.delete_revisions) أو [delete_files()](/docs/huggingface_hub/main/ar/package_reference/cache#huggingface_hub.HFCacheInfo.delete_files). راجع التوثيق لمثال على الاستخدام.

#### expected_freed_size_str[[huggingface_hub.DeleteCacheStrategy.expected_freed_size_str]]

```python
expected_freed_size_str()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_cache_manager.py#L295)

(property) الحجم المتوقع الذي سيتم تحريره كنص قابل للقراءة من قبل الإنسان.

مثال: "42.2K".

## استثناءات

### CorruptedCacheException[[huggingface_hub.CorruptedCacheException]]

#### huggingface_hub.CorruptedCacheException[[huggingface_hub.CorruptedCacheException]]

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/errors.py#L22)

استثناء لأي بنية غير متوقعة في نظام التخزين المؤقت الخاص بـ Huggingface.

