// With target dir specified
fc, err := filecache.New("/path/to/cache/dir")

// With temp dir as a target
fc, err := filecache.NewInTemp()

// With options
fc, err := filecache.New(
    "/path/to/cache/dir",
    filecache.InstanceOptions{
        PathGenerator: filecache.FilteredKeyPath,
        DefaultTTL:    time.Hour,
        GC:            filecache.NewIntervalGarbageCollector("/path/to/cache/dir", time.Hour),
    },
)

// From the io.Reader
_, err := fc.Write(context.Background(), "key1", strings.NewReader("value1"))

// From the byte array
_, err := fc.WriteData(context.Background(), "key2", []byte("value2"))

// With the item options
_, err := fc.Write(
    context.Background(), 
    "key3", 
    strings.NewReader("value3"),
    filecache.ItemOptions{
        Name:   "Key 3",
        TTL:    time.Hour * 24,
        Fields: filecache.NewValues("field1", "val1", "field2", "val2"),
    },
)

// Opening the cache file reader
res, err := fc.Open(context.Background(), "key1")
if err != nil { 
    // Handle the error...
}

if res.Hit() {
    reader := res.Reader()
    // Read the data...
}

// Read all the data
res, err := fc.Read(context.Background(), "key2")
if err != nil && res.Hit() {
    data := res.Data()
}

// Read options
res, err := fc.Read(context.Background(), "key3")
if err != nil && res.Hit() {
    name := res.Options().Name
}

scanner := filecache.NewScanner("/path/to/cache/dir")

err := scanner.Scan(func(entry filecache.ScanEntry) error {
    // Do something with the found entry...
	return nil
})
if err := nil {
    // Handle the error...
}