cachimo ·

Stores key with value in-memory and can be deleted manually or after given timeout.

Installation

npm

npm install cachimo

Yarn

yarn add cachimo

Usage

API

• put

import * as cachimo from "cachimo";

// Stores element in cache, you can remove it manually whenever you want.
// Returns true if element was successfully stored in cache, false if such key already exist.
cachimo.put("key", "value");

import * as cachimo from "cachimo";

// Stores element in cache and it will be deleted after given timeout which returns Promise.
cachimo
	.put("key", "value", 1000) // It will be deleted after 1 sec. and Promise will be resolved or rejected.
	.then(({ key, value, timeout }) => {
		// Returns key, value and timeout after delete.
		console.log(`Deleted ${key}:${value} after ${timeout}`);
	})
	.catch((err) => {
		// You will get error if key was deleted before timeout.
		throw err; // "Key doesn't exist."
	});

import * as cachimo from "cachimo";

// If you don't want to use Promise you can send callback which will be executed after given timeout.
cachimo.put("key", "value", 1000, (err, key, value, timeout) => {
	// You will get error if key was deleted before timeout.
	if (err) {
		throw err; // "Key doesn't exist."
	}

	// Returns key, value and timeout after delete.
	console.log(`Deleted ${key}:${value} after ${timeout}`);
});

• clear

import * as cachimo from "cachimo";

// Removes all elements stored in cache and clears all timeouts.
// Returns number of how much elements was removed from cache.
cachimo.clear();

• get

import * as cachimo from "cachimo";

// Returns value from cache by given key.
cachimo.get("key");

• remove

import * as cachimo from "cachimo";

// Returns true if element was removed, false otherwise.
cachimo.remove("key");

• has

import * as cachimo from "cachimo";

// Checks if whether an element with given key exists.
// Returns true if element exists, false otherwise.
cachimo.has("key");

• size

import * as cachimo from "cachimo";

// Returns the number of elements stored in cache.
cachimo.size();

• keys

import * as cachimo from "cachimo";

// Returns all keys stored in cache.
cachimo.keys();

• values

import * as cachimo from "cachimo";

// Returns all values stored in cache.
cachimo.values();

• entries

import * as cachimo from "cachimo";

// Returns all entries (keys and values) stored in cache.
cachimo.entries();

Contributing

Feel free to open issues or PRs!