aboutsummaryrefslogtreecommitdiff
path: root/node_modules/fragment-cache/index.js
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/fragment-cache/index.js')
-rw-r--r--node_modules/fragment-cache/index.js128
1 files changed, 128 insertions, 0 deletions
diff --git a/node_modules/fragment-cache/index.js b/node_modules/fragment-cache/index.js
new file mode 100644
index 0000000..8ce6216
--- /dev/null
+++ b/node_modules/fragment-cache/index.js
@@ -0,0 +1,128 @@
+/*!
+ * fragment-cache <https://github.com/jonschlinkert/fragment-cache>
+ *
+ * Copyright (c) 2016-2017, Jon Schlinkert.
+ * Released under the MIT License.
+ */
+
+'use strict';
+
+var MapCache = require('map-cache');
+
+/**
+ * Create a new `FragmentCache` with an optional object to use for `caches`.
+ *
+ * ```js
+ * var fragment = new FragmentCache();
+ * ```
+ * @name FragmentCache
+ * @param {String} `cacheName`
+ * @return {Object} Returns the [map-cache][] instance.
+ * @api public
+ */
+
+function FragmentCache(caches) {
+ this.caches = caches || {};
+}
+
+/**
+ * Prototype
+ */
+
+FragmentCache.prototype = {
+
+ /**
+ * Get cache `name` from the `fragment.caches` object. Creates a new
+ * `MapCache` if it doesn't already exist.
+ *
+ * ```js
+ * var cache = fragment.cache('files');
+ * console.log(fragment.caches.hasOwnProperty('files'));
+ * //=> true
+ * ```
+ * @name .cache
+ * @param {String} `cacheName`
+ * @return {Object} Returns the [map-cache][] instance.
+ * @api public
+ */
+
+ cache: function(cacheName) {
+ return this.caches[cacheName] || (this.caches[cacheName] = new MapCache());
+ },
+
+ /**
+ * Set a value for property `key` on cache `name`
+ *
+ * ```js
+ * fragment.set('files', 'somefile.js', new File({path: 'somefile.js'}));
+ * ```
+ * @name .set
+ * @param {String} `name`
+ * @param {String} `key` Property name to set
+ * @param {any} `val` The value of `key`
+ * @return {Object} The cache instance for chaining
+ * @api public
+ */
+
+ set: function(cacheName, key, val) {
+ var cache = this.cache(cacheName);
+ cache.set(key, val);
+ return cache;
+ },
+
+ /**
+ * Returns true if a non-undefined value is set for `key` on fragment cache `name`.
+ *
+ * ```js
+ * var cache = fragment.cache('files');
+ * cache.set('somefile.js');
+ *
+ * console.log(cache.has('somefile.js'));
+ * //=> true
+ *
+ * console.log(cache.has('some-other-file.js'));
+ * //=> false
+ * ```
+ * @name .has
+ * @param {String} `name` Cache name
+ * @param {String} `key` Optionally specify a property to check for on cache `name`
+ * @return {Boolean}
+ * @api public
+ */
+
+ has: function(cacheName, key) {
+ return typeof this.get(cacheName, key) !== 'undefined';
+ },
+
+ /**
+ * Get `name`, or if specified, the value of `key`. Invokes the [cache]() method,
+ * so that cache `name` will be created it doesn't already exist. If `key` is not passed,
+ * the entire cache (`name`) is returned.
+ *
+ * ```js
+ * var Vinyl = require('vinyl');
+ * var cache = fragment.cache('files');
+ * cache.set('somefile.js', new Vinyl({path: 'somefile.js'}));
+ * console.log(cache.get('somefile.js'));
+ * //=> <File "somefile.js">
+ * ```
+ * @name .get
+ * @param {String} `name`
+ * @return {Object} Returns cache `name`, or the value of `key` if specified
+ * @api public
+ */
+
+ get: function(name, key) {
+ var cache = this.cache(name);
+ if (typeof key === 'string') {
+ return cache.get(key);
+ }
+ return cache;
+ }
+};
+
+/**
+ * Expose `FragmentCache`
+ */
+
+exports = module.exports = FragmentCache;