4 releases

0.1.3 May 21, 2024
0.1.2 May 21, 2024
0.1.1 May 17, 2024
0.1.0 May 14, 2024

#279 in Caching

Download history 347/week @ 2024-05-13 297/week @ 2024-05-20

644 downloads per month

MIT/Apache

24KB
498 lines

A safe, zero-copy, rust-based chrome cache parser, supporting chrome cache versions 2.0, 2.1, and 3.0.

So far, it only parses the cache entries themselves. You can use it to programmatically inspect the cache index and, for example, display the known cache keys (e.g., URIs) stored in the cache, along with some entry metadata (timestamp, etc.). It provides no utility for extracting the cache data itself since I currently have no purpose for that capability. It also only supports cache keys stored inline with the cache entry, not the longer, out-of-band cache keys.

Run The Example

By default, it'll display the cache entries from a typical google chrome cache path. Provide --path to point it somewhere else.

cargo run --example display-chrome-cache

Example Usage

use std::{path::PathBuf};

use chrome_cache_parser::{CCPError, CCPResult, ChromeCache};
use chrono::{DateTime, Local};

let cache = ChromeCache::from_path(PathBuf::from(path)).unwrap();

let entries = cache.entries().unwrap();

entries.for_each(|e| {
    let e = e.get().unwrap();
    println!("[{:?}\t=>\t{:?}]: {:?}", e.hash, e.key, DateTime::<Local>::from(e.creation_time));
});

Implementation

The implementation is mostly just transmutations via the zerocopy library and some lazy traversing of the cache index's hash table and internal entry linked lists.

Background

For an overview of the chrome cache implementation, see here.

The Chromium sources were helpful for understanding the cache format.

Particularly:

Dependencies

~2–2.8MB
~46K SLoC