sync-disk-cache
A sync disk cache. inspired by jgable/cache-swap
An async sibling version is also available: stefanpenner/async-disk-cache
By default, this will usge TMPDIR/<username>/
for storage, but this can be changed by setting the $TMPDIR
environment variable.
All stored values become strings.
Example
var Cache = require('sync-disk-cache');
var cache = new Cache('my-cache');
cache.has('foo') === wasFooFound;
cache.get('foo') === {
isCached: true,
path: 'foo',
content: 'content of foo'
}
cache.get('foo') === {
isCached: false,
path: 'foo',
content: undefined
}
cache.set('foo', 'content of foo');
cache.remove('foo');
cache.clear();
Enable compression:
note: node 0.10.x does not support the synchronous zlib method variants, so compression is only available > 0.10.x
var Cache = require('sync-disk-cache');
var cache = new Cache('my-cache', {
compression: 'gzip' | 'deflate' | 'deflateRaw'
})
HELP!...my TMP dir is growing unbounded!
description
In general most OS distributions come with cron like tasks, which purge unused files in $TMPDIR
. For example, ubuntu typically uses tmpreaper
and macOS uses various tasks in /etc/periodic/*
.
options
If your OS distribution does not provide such a cleanup mechanism:
a) We stronglly recommend utilizing one, as other sync-disk-cache is not alone in rely on this behavior
b) If that is not possible, we recommend changing your $TMPDIR
to something project specific and manually purging it.
License
Licensed under the MIT License, Copyright 2015 Stefan Penner