Module tectonic_bundles::cache

Local caching of bundle data.

This module implements Tectonic’s local filesystem caching mechanism for TeX support files. To enable efficient caching with proper invalidation semantics, the caching layer does not merely wrap IoProvider implementations. Instead, a cacheable bundle must implement the CacheBackend trait defined in this module. An example of such a bundle is the crate::itar::IndexedTarBackend for bundles served over HTTP.

In order to access a cacheable bundle, you need a handle to a local Cache, probably obtained with Cache::get_user_default(), and a URL, which you’ll pass to Cache::open(). When using this function, you must explicitly specify the concrete CacheBackend type that will service backend requests.

Structs

• BackendPullData
  Information describing a cache backend.
• Cache
  A cache of data from one or more bundles using the local filesystem.
• CachingBundle
  A caching bundle that obtains files from some a backend.

Traits

• CacheBackend
  A source of files that can supply a cache-based bundle.