1.1.1 • Published 2 years ago

pluscache v1.1.1

Weekly downloads
-
License
ISC
Repository
github
Last release
2 years ago

Plus Cache 💾

Información

Plus Cache es un módulo de caché completo que permite limitar los datos guardados, diferenciar entre tipos de datos (keys) e incluso importar archivos JSON para introducirlos en la caché.

Instalación

¡Use en su consola npm i pluscache y empiece a disfrutar! Puede también instalar el módulo con npm i https://github.com/167BOT/PlusCache.git usando Github.

Sintaxis

El módulo es completamente síncrono y fácil de usar. Puede ver a continuación las funciones.

Clase Cache(Options)

Options
limitDataLimita los datos que pueden entrar en caché. Por defecto, pueden entrar los datos que quieras. Recibe un Number
differenceTypesKeysDiferencia entre los tipos de datos en las keys (ej: 1 == '1'). Por defecto, es true. Recibe un Boolean

Funciones

La clase incluye diversas funciones para controlar su caché de forma sencilla. Todas ellas son asíncronas.

insert(Key, Value)

Inserta datos en la caché de forma rápida.

Propiedades
KeyLa key para acceder al valor.
ValueEl valor que quieres darle a la key
const Cache = require('pluscache')
const myCache = new Cache({limitData: 100})//limit data for 100 key:value

let insert = myCache.insert('names', [{name: 'Coco'}])

/*
{
  sucess: true,
  getThis: { data: { names: [Array] }, length: 3 },
  length: 3
}
*/

getOne(Key)

Obtén un solo dato de forma sencilla y rápida.

Propiedades
KeyEl identificador del valor que se está buscando
let get = cache.getOne('names')

/*
{ data: { names: [ [Object] ] }, length: 1 }
*/

getAll()

Obtén todos los datos que hay en caché de forma sencilla.

cache.insert('guilds', [{guild: 'La Fortaleza'}])
cache.insert('ids', [{id: 1}])

let all = cache.getAll()

/*
{
  data: [ { names: [Array] }, { guilds: [Array] }, { ids: [Array] } ],
  length: 3
}
*/

update(Key, Value)

Actualiza de forma rápida y sencilla cualquier identificador-valor.

Propiedades
KeyEl identificador al cuál quieres editar su valor
ValueEl valor por el que quieres reemplazar el anterior valor
let getTwo = cache.getOne('names').data.names
getTwo.push({name: 'Mia'})

let update = cache.update('names', getTwo)

/*
{
  sucess: true,
  getThis: { data: { names: [Array] }, length: 3 },
  length: 3
}
*/

hasKey(Key)

Busca y verifica de forma sencilla si hay un identificador

Propiedades
KeyEl identificador que vas a verificar su existencia
let hasTrue = cache.hasKey('names')//true

/*
{ sucess: true, has: { data: { names: [Array] }, length: 3 } }
*/

let hasFalse = cache.hasKey('games')//false

/*
{ sucess: true, has: false }
*/

iterable()

Itera toda la caché de forma fácil

let iterable = cache.iterable()

for (let data of iterable) {
    console.log(`ID: ${data[0]} | Nombre: ${Object.keys(data[1])[0]}`)
}

/*
ID: 0 | Nombre: names
ID: 1 | Nombre: guilds
ID: 2 | Nombre: ids
*/

saveJSON(Pathway, Name)

Guarda dentro de un archivo JSON todos los datos de la caché

Propiedades
PathwayLa ruta donde quieras guardar el archivo. Recibe un String
NameEl nombre del archivo (opcional). Recibe un String
let save = cache.saveJSON(`./path/to`)//without name. Sometimes have some problems

/*
{
  sucess: true,
  json: '{"data":[{"names":[{"name":"John"},{"name":"Mia"}]},{"guilds":[{"guild":"La Fortaleza"}]},{"ids":[{"id":1}]}],"length":3}',
  path: 'C:\\Users\\xxx\\Desktop\\myProject\\test\\DBBZdcVKgQ==.json'
}
*/

let save = cache.saveJSON(`./path/to`, 'test')//with name

/*
{
  sucess: true,
  json: '{"data":[{"names":[{"name":"John"},{"name":"Mia"}]},{"guilds":[{"guild":"La Fortaleza"}]},{"ids":[{"id":1}]}],"length":3}',
  path: 'C:\\Users\\xxx\\Desktop\\myProject\\test\\test.json'
}

importJSON(Pathway)

Importa archivos JSON para introducirlos en la caché.

Propiedades
PathwayLa ruta donde quieras guardar el archivo. Recibe un String
let importJSON = cache.importJSON('./path/to/test.json')

/*
{
  sucess: true,
  getThis: { data: [ [Object], [Object], [Object] ], length: 3 }
}
*/