# Önbellek sistemi referansı Önbellekleme sistemi, Hub'a bağımlı kütüphaneler arasında paylaşılan merkezi önbellek sistemi haline gelmesi için v0.8.0 sürümünde güncellendi. HF'de önbellekleme hakkında ayrıntılı bir sunum için [önbellek sistemi kılavuzunu](../guides/manage-cache) okuyun. ## Yardımcılar ### 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) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/file_download.py#L1522) **Parametreler:** cache_dir (`str` veya `os.PathLike`) : Önbelleğe alınan dosyaların bulunduğu klasör. repo_id (`str`) : huggingface.co üzerindeki repozituarın kimliği. filename (`str`) : `repo_id` içinde aranacak dosya adı. revision (`str`, *isteğe bağlı*) : Kullanılacak belirli model sürümü. Sağlanmazsa ve `commit_hash` de sağlanmazsa varsayılan olarak `"main"` kullanılır. repo_type (`str`, *isteğe bağlı*) : Deponun türü. Varsayılan olarak `"model"` olur. **Dönüş:** `Optional[str]` veya `_CACHED_NO_EXIST` Dosya önbelleğe alınmadıysa `None` döndürülür. Aksi halde: - Önbellekte bulunursa önbelleğe alınmış dosyanın tam yolu - Belirtilen commit hash'inde dosya yoksa ve bu durum önbelleğe alındıysa özel bir değer olan `_CACHED_NO_EXIST`. Belirtilen bir revizyon için en son önbelleğe alınmış dosyayı, bulunursa, önbelleği tarayarak döndürür. Bu fonksiyon, dosya önbelleğe alınmamışsa herhangi bir istisna yükseltmez. Örnek: ```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) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_assets.py#L19) **Parametreler:** library_name (`str`) : Önbellek klasörünü yönetecek kütüphanenin adı. Örnek: `"dataset"`. namespace (`str`, *isteğe bağlı*, varsayılan "default") : Verinin ait olduğu ad alanı. Örnek: `"SQuAD"`. subfolder (`str`, *isteğe bağlı*, varsayılan "default") : Verilerin depolanacağı alt klasör. Örnek: `extracted`. assets_dir (`str`, `Path`, *isteğe bağlı*) : Varlıkların önbelleğe alındığı klasörün yolu. Bu, Hub dosyalarının önbelleğe alındığı klasörle aynı olmamalıdır. Verilmezse varsayılan olarak `HF_HOME / "assets"` kullanılır. Ayrıca `HF_ASSETS_CACHE` ortam değişkeni ile de ayarlanabilir. **Dönüş:** Önbellek klasörüne yol (`Path`). Arbitrary dosyaları önbelleğe almak için bir klasör yolu döndürür. `huggingface_hub`, varlıkları depolamak için standart bir klasör yolu sağlar. Bu, önbelleği aşağı akış kütüphanesine entegre etmenin önerilen yoludur; çünkü önbelleğin taranmasını ve doğru şekilde silinmesini sağlayan yerleşik araçlardan faydalanır. Hub'dan önbelleğe alınan dosyalar ile varlıklar arasında bir ayrım yapılır. Hub'dan gelen dosyalar git-farkında bir şekilde önbelleğe alınır ve tamamen `huggingface_hub` tarafından yönetilir. [ilgili belgelere](https://huggingface.co/docs/huggingface_hub/how-to-cache) bakın. Aşağı akış kütüphanesinin önbelleğe aldığı diğer tüm dosyalar "varlık" (dış kaynaklardan indirilen dosyalar, .tar arşivinden çıkarılan dosyalar, eğitim için ön işleme tabi tutulan dosyalar, ...) olarak kabul edilir. Klasör yolu oluşturulduğunda, var olduğu ve bir dizin olduğu garanti edilir. Yol, 3 derinlik seviyesine dayanır: kütüphane adı, bir ad alanı (namespace) ve bir alt klasör. Bu 3 seviye, `huggingface_hub`'ün varlık önbelleğinin (assets cache) bölümlerini tarama/silme sırasında klasörleri beklemesine olanak tanıyarak esneklik sağlar. Bir kütüphane içinde, tüm ad alanlarının (namespace) alt klasör adlarının aynı alt kümesini paylaşması beklenir ancak bu zorunlu bir kural değildir. Sonuç olarak, aşağı akış (downstream) kütüphanesi, önbelleği içinde hangi dosya yapısını benimseyeceğinin tam kontrolüne sahiptir. Ad alanı (namespace) ve alt klasör isteğe bağlıdır (varsayılan olarak bir `"default/"` alt klasörü kullanılır) ancak her aşağı akış (downstream) kütüphanesinin kendi önbelleğini yönetmesini istediğimiz için kütüphane adı zorunludur. Beklenen ağaç: ```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/ └── (...) ``` Örnek: ```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) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L680) **Parametreler:** cache_dir (`str` or `Path`, `optional`) : Cache directory to cache. Defaults to the default HF cache directory. Tüm HF önbellek sistemini tarayın ve bir [~HFCacheInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.HFCacheInfo) yapısı döndürün. Önbellek sisteminizi programatik olarak taramak için `scan_cache_dir` kullanın. Önbellek, depo depo taranır. Bir depo bozuksa, [~CorruptedCacheException](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.CorruptedCacheException) içsel olarak atılır ancak yakalanır ve [~HFCacheInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.HFCacheInfo) yapısında döndürülür. Yalnızca geçerli depolar için uygun bir rapor oluşturulur. ```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(...), ... ], ) ``` Ayrıca `hf` komut satırından şu komutu kullanarak ayrıntılı bir raporu doğrudan yazdırabilirsiniz: ```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] > Şunları yükseltir: > > `CacheNotFound` Önbellek dizini mevcut değilse. > > [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) Önbellek dizini bir dizin yerine bir dosya ise. Dönüş: [~HFCacheInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.HFCacheInfo) nesnesi. ## Veri yapıları Tüm yapılar [scan_cache_dir()](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.scan_cache_dir) tarafından oluşturulur ve döndürülür ve değiştirilemezdir. ### 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) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L384) **Parametreler:** size_on_disk (`int`) : Önbellek sisteminin bayt cinsinden fiziksel boyutu. Depolar arasında paylaşılan bir blob bir kez sayılır ve hiçbir depo tarafından artık referanslanmayan, yalnızca depolanan paylaşılan bloblar dahil edilir. Depo başına boyutların toplamından küçük olabilir. repos (`frozenset[CachedRepoInfo]`) : Tarama sırasında önbellek sisteminde bulunan tüm geçerli önbelleğe alınmış depoları tanımlayan [~CachedRepoInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.CachedRepoInfo) kümesi. incomplete_files (`frozenset[CachedIncompleteFileInfo]`) : Kesintiye uğrayan indirmeler tarafından geride bırakılan yetim `*.incomplete` dosyalarını açıklayan [~CachedIncompleteFileInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.CachedIncompleteFileInfo) kümesi. warnings (`list[CorruptedCacheException]`) : Önbelleği tararken oluşan [~CorruptedCacheException](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.CorruptedCacheException) listesi. Taramanın devam edebilmesi için bu istisnalar yakalanır. Bozuk depolar taramadan atlanır. cache_dir (`Path` veya `None`) : Taranan önbellek dizini. Tüm önbellek sistemi hakkında bilgi tutan donmuş veri yapısı. Bu veri yapısı [scan_cache_dir()](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.scan_cache_dir) tarafından döndürülür ve değiştirilemezdir. > [!WARNING] > `size_on_disk` yalnızca blobları hesaba katar ve bozuk depolar atlanır. Bu, fiziksel bir boyuttur: bir paylaşılan blobu onu referans veren her depoya atfeden `CachedRepoInfo.size_on_disk`'in aksine, burada bir paylaşılan blob yalnızca bir kez sayılır. #### delete_files[[huggingface_hub.HFCacheInfo.delete_files]] ```python delete_files(*files: CachedFileInfo) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L536) Bireysel önbelleğe alınmış dosyaları silmek için stratejiyi hazırlayın. Yalnızca snapshot girdileri kaldırılır. Bir blob, başka bir önbelleğe alınmış dosya tarafından referanslanmıyorsa silinir; bu nedenle diğer revizyonlarla paylaşılan bloblar korunur. Ref'ler ve snapshot dizinleri de, bir snapshot boş kalsa bile korunur. Tüm revizyonları veya depoları silmek için [delete_revisions()](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.HFCacheInfo.delete_revisions) kullanın. Örnek: ```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) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L433) Yerel olarak önbelleğe alınmış bir veya daha fazla revizyonu silmek için stratejiyi hazırlayın. Girdi revizyonları herhangi bir revizyon hash'i olabilir. Bir revizyon hash'i yerel önbellekte bulunamazsa bir uyarı oluşturulur ancak bir hata fırlatılmaz. Hash'ler depolar arasında benzersiz olduğundan, revizyonlar farklı önbelleğe alınmış depolardan gelebilir, Örnekler: ```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`, çalıştırılması gereken bir [DeleteCacheStrategy](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.DeleteCacheStrategy) nesnesi döndürür. [DeleteCacheStrategy](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.DeleteCacheStrategy) değiştirilmek üzere tasarlanmamıştır, ancak silme işleminin gerçekten uygulanmasından önce bir kuru çalıştırma (dry run) yapılmasına olanak tanır. #### export_as_table[[huggingface_hub.HFCacheInfo.export_as_table]] ```python export_as_table(verbosity: int = 0) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L585) **Parametreler:** verbosity (`int`, *isteğe bağlı*) : Ayrıntı düzeyi. Varsayılan olarak 0'dır. **Dönüş:** `str` Tablonun bir dize olarak gösterimi. [HFCacheInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.HFCacheInfo) nesnesinden bir tablo oluşturun. Her depo için tek satırlı bir tablo almak için `verbosity=0` parametresini geçirin; sütunlar "repo_id", "repo_type", "size_on_disk", "nb_files", "last_accessed", "last_modified", "refs", "local_path" olacaktır. Her depo ve revizyon için bir satır içeren bir tablo almak için `verbosity=1` parametresini geçin (bu nedenle tek bir depo için birden fazla satır görünebilir); sütunlar "repo_id", "repo_type", "revision", "size_on_disk", "nb_files", "last_modified", "refs", "local_path" şeklindedir. Örnek: ```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) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L176) **Parametreler:** repo_id (`str`) : Hub'daki repozituarın repo kimliği. Örnek: `"google/fleurs"`. repo_type (`Literal["dataset", "model", "space", "kernel"]`) : Önbelleğe alınan repozitorinin türü. repo_path (`Path`) : Önbelleğe alınan repoya yerel yol. size_on_disk (`int`) : Önbelleğe alınan depodaki blob dosya boyutlarının toplamı. nb_files (`int`) : Önbelleğe alınmış depodaki blob dosyalarının toplam sayısı. revisions (`frozenset[CachedRevisionInfo]`) : Depoda önbelleğe alınan tüm revizyonları açıklayan [~CachedRevisionInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.CachedRevisionInfo) kümesi. last_accessed (`float`) : Depodaki bir blob dosyasının son erişim zaman damgası. last_modified (`float`) : Depodaki bir blob dosyasının son değiştirilme/oluşturulma zaman damgası. Önbelleğe alınmış bir depoyla ilgili bilgileri tutan donmuş veri yapısı. > [!WARNING] > `size_on_disk`, kopyalanmış dosyalar nedeniyle tüm revizyon boyutlarının toplamına eşit olmak zorunda değildir. Ayrıca, klasörlerin ve sembolik bağlantıların (ihmal edilebilir) boyutları dikkate alınmaz, yalnızca blob'lar hesaba katılır. > [!WARNING] > `last_accessed` ve `last_modified` güvenilirliği, kullandığınız işletim sistemine bağlı olabilir. Daha fazla ayrıntı için [python belgelerini](https://docs.python.org/3/library/os.html#os.stat_result) inceleyin. #### size_on_disk_str[[huggingface_hub.CachedRepoInfo.size_on_disk_str]] ```python size_on_disk_str() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L238) (property) Blob dosya boyutlarının toplamı, insan tarafından okunabilir bir dize olarak. Örnek: "42.2K". #### refs[[huggingface_hub.CachedRepoInfo.refs]] ```python refs() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L252) (property) `refs` ile revizyon veri yapıları arasındaki eşleme. ### 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) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L105) **Parametreler:** commit_hash (`str`) : Revizyonun hash'i (benzersiz). Örnek: `"9338f7b671827df886678df2bdd7cc7b4f36dffd"`. snapshot_path (`Path`) : `snapshots` klasöründeki revizyon dizinine giden yol. Hub'daki depoyla birebir aynı ağaç yapısını içerir. files : (`frozenset[CachedFileInfo]`): Snapshot'ta bulunan tüm dosyaları tanımlayan [~CachedFileInfo](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.CachedFileInfo) kümesi. refs (`frozenset[str]`) : Bu revizyona işaret eden `refs` kümesi. Revizyonun `refs` yoksa, kopuk (detached) olarak kabul edilir. Örnek: `{"main", "2.4.0"}` veya `{"refs/pr/1"}`. size_on_disk (`int`) : Revizyonun sembolik bağlantı olarak işaretlediği blob dosya boyutlarının toplamı. last_modified (`float`) : Revizyonun son oluşturulma/değiştirilme zaman damgası. Bir revizyon hakkında bilgi tutan donmuş veri yapısı. Bir revizyon, `snapshots` klasöründeki bir klasöre karşılık gelir ve Hub'daki depoyla aynı ağaç yapısına sahip olacak şekilde doldurulur, ancak yalnızca sembolik bağlantılar içerir. Bir revizyon, 1 veya daha fazla `refs` tarafından referans alınabilir veya "detached" (ref'siz) olabilir. > [!WARNING] > `last_accessed`, blob dosyalarının revizyonlar arasında paylaşıldığı için tek bir revizyon üzerinde doğru olarak belirlenemez. > [!WARNING] > `size_on_disk`, olası yinelenen dosyalar nedeniyle tüm dosya boyutlarının toplamı olmak zorunda değildir. Ayrıca, klasörlerin ve sembolik bağlantıların (ihmal edilebilir) boyutları dikkate alınmaz, yalnızca blob'lar hesaba katılır. #### size_on_disk_str[[huggingface_hub.CachedRevisionInfo.size_on_disk_str]] ```python size_on_disk_str() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L158) (property) Blob dosya boyutlarının toplamı, insan tarafından okunabilir bir dize olarak. Örnek: "42.2K". #### nb_files[[huggingface_hub.CachedRevisionInfo.nb_files]] ```python nb_files() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L167) (property) Revizyondaki dosyaların toplam sayısı. ### 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) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L40) **Parametreler:** file_name (`str`) : Dosyanın adı. Örnek: `config.json`. file_path (`Path`) : `snapshots` dizinindeki dosyanın yolu. Dosya yolu, `blobs` klasöründeki bir blob'a atıfta bulunan sembolik bir bağlantıdır. blob_path (`Path`) : `file_path` tarafından referans verilen repo-yerel blob girdisinin yolu. Blob girdisi, önbellek genelinde paylaşılan blob deposuna bir sembolik bağlantı olabilir. size_on_disk (`int`) : Blob dosyasının bayt cinsinden boyutu. blob_last_accessed (`float`) : Blob dosyasının son erişim zaman damgası (herhangi bir revizyondan). blob_last_modified (`float`) : Blob dosyasının son değiştirilme/oluşturulma zaman damgası. Tek bir önbelleğe alınmış dosya hakkında bilgi tutan donmuş veri yapısı. > [!WARNING] > `blob_last_accessed` ve `blob_last_modified` güvenilirliği, kullandığınız işletim sistemine bağlı olabilir. Daha fazla ayrıntı için [python belgelerini](https://docs.python.org/3/library/os.html#os.stat_result) inceleyin. #### size_on_disk_str[[huggingface_hub.CachedFileInfo.size_on_disk_str]] ```python size_on_disk_str() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L94) (property) Blob dosyasının boyutu, insan tarafından okunabilir bir dize olarak. Örnek: "42.2K". ### CachedIncompleteFileInfo[[huggingface_hub.CachedIncompleteFileInfo]] #### huggingface_hub.CachedIncompleteFileInfo[[huggingface_hub.CachedIncompleteFileInfo]] ```python huggingface_hub.CachedIncompleteFileInfo(file_path: Path, size_on_disk: int) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L365) **Parametreler:** file_path (`Path`) : `blobs` klasöründeki `.incomplete` dosyasının yolu. size_on_disk (`int`) : Kısmen indirilen dosyanın bayt cinsinden boyutu. Tek bir eksik indirme hakkında bilgi tutan donmuş veri yapısı. Kesilen indirmeler `//blobs/.incomplete` dosyalarını geride bırakır. Bunlar taahhüt edilmiş bir revizyonun parçası olmadığından, [scan_cache_dir()](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.scan_cache_dir) tarafından ayrı olarak listelenir. ### 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) ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L261) **Parametreler:** expected_freed_size (`float`) : Strateji uygulandığında serbest bırakılacak beklenen boyut. blobs (`frozenset[Path]`) : Silinecek blob dosya yollarının kümesi. refs (`frozenset[Path]`) : Silinecek referans dosya yollarının kümesi. repos (`frozenset[Path]`) : Silinecek tüm depo yollarının kümesi. snapshots (`frozenset[Path]`) : Silinecek anlık görüntülerin kümesi (sembolik bağlantılar dizini). files (`frozenset[Path]`, *isteğe bağlı*) : Silinecek bireysel anlık görüntü girdilerinin kümesi. Blobları yalnızca `blobs` içinde listelenmişlerse silinir. cache_dir (`Path` veya `None`) : Stratejinin hesaplandığı önbellek dizini. Silinme işlemiyle kaldırılan, depoya yerel sembolik bağlantılarla referans verilen paylaşılan blob'ları toplamak için kullanılır. Önbelleğe alınmış sürümleri veya dosyaları silme stratejisini tutan donmuş veri yapısı. Bu nesne programatik olarak örneklenmek için değil, [delete_revisions()](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.HFCacheInfo.delete_revisions) veya [delete_files()](/docs/huggingface_hub/v2.4.0/tr/package_reference/cache#huggingface_hub.HFCacheInfo.delete_files) tarafından döndürülmek üzere tasarlanmıştır. Kullanım örneği için dokümantasyona bakın. #### expected_freed_size_str[[huggingface_hub.DeleteCacheStrategy.expected_freed_size_str]] ```python expected_freed_size_str() ``` [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/utils/_cache_manager.py#L295) (property) Serbest bırakılacak beklenen boyut, insan tarafından okunabilir bir dize olarak. Örnek: "42.2K". ## İstisnalar ### CorruptedCacheException[[huggingface_hub.CorruptedCacheException]] #### huggingface_hub.CorruptedCacheException[[huggingface_hub.CorruptedCacheException]] [Kaynak](https://github.com/huggingface/huggingface_hub/blob/v2.4.0/src/huggingface_hub/errors.py#L22) Huggingface önbellek sistemindeki beklenmeyen herhangi bir yapı için istisna.