npm-local-cache v0.1.2
npm-local-cache
Creates a local searchable NPM cache. Good for building your own module repo based on NPM.
Functionality:
- Filter on custom keywords (useful for when NPM is used as module repo, like in the case of mongoosejs and breach.cc).
- Customizable search fields.
- Cache time to live (update cache periodically).
- Build from local NPM cache.
Install
npm install --save npm-local-cache
Usage
Either require the library like this:
var cache = require('npm-local-cache')();
.. or pass in an options object to configure. These are the default values:
var cache = require('npm-local-cache')({
keywords: [],
searchFields: ['name', 'description', 'keywords'],
useLocal: true,
localCachePath: '$HOME/.npm/-/all/.cache.json',
cachePath: 'node_modules/../cache.json',
ttl: 86400000,
writeCache: true
});
(see options details below)
The cache is build lazily, so go ahead and search. Search returns a Promise.
cache.search(query, optionalKeywordArray).then(onSuccess, onError).catch(errHandler);
E.g.
cache.search('json', ['mongoosejs'])
.then(function (pkgs) {
// MongooseJS modules pertaining to _json_
console.log(pkgs);
}, function (err) {
console.error(err);
});
Packages are filtered on keywords first, then based on the query.
You can refresh the cache using refresh()
or just let the automatic refresh take place (see ttl
below):
cache.refresh(); // returns a promise
Options
keywords: Add one or several keywords to filter packages from NPM. Default: []
searchFields: An array of package fields to do text search on. Legal values: 'name', 'description', 'author', 'keywords', 'dependencies', 'devDependencies'. Default: ['name', 'description', 'keywords']
useLocal: If true
the local NPM cache will be used to build the cache, instead of fetching from the NPM server. Default: true
localCachePath: Path to local NPM cache. Unless you changed it will be $HOME/.npm/-/all/.cache.json
which is also the default value.
cachePath: The path where to store the cache. By default it is stored in the parent folder of node_modules
.
ttl: Time To Live of the cache in millies. After expiring the cache will update on next search()
invocation. Default: 86400000
Note that the keywords
option that is passed when constructing the cache limits the entire cache to those keywords, whereas the keywords
option for the search method will only filter based on the keywords for that one query.