Mejoras

- Ahora podras especificar el directorio donde se guardaran tus base de datos, tambien podras usar sub directorios.
- Errores descriptivos.
- Se agregaron métodos para conseguir imgs randoms.
- Se actualizaron los métodos con sus nombres.
- Ejemplos mejores y explicados.
- Constructores y API's actualizados.

Importante

• Por default se creará una carpeta llamada memvaz.database_databases en la carpeta principal de tu proyecto (puedes cambiar el nombre de esta carpeta en el constructor) newDB. No borres dicha carpeta a menos que quieras borrar absolutamente todas tus base de datos.

Changelog

Versión: 3.0.1

Se agregaron metodos como add, all, delete, fetch, has, push, set, substract, type, Estos metodos no crearan un archivo .json como los demas, este npm esta diseñado para mejorar la experiencia del usuario, y como hemos visto, a muchas personas les molesta el .json, se estan creando metodos para trabajar con tablas.

Versión 4.0.0

Se actualizaron todos los métodos disponibles de uso de json y uso de tablas, se añadieron API´s que permiten obtener imágenes random, consulte los métodos

Constructor:

• newDB
• memDB
• tables
• imgs

Instalacion:

npm install memvaz.database --save

Ejemplo del requerimiento del package:

const db = require('memvaz.database');

newDB(nombre_db, sub_directorio)

Este constructor te permite crear una base de datos en un archivo .json

Modo de uso

Este constructor tiene dos modos de uso:

Modo #1

Este modo es el que siempre se ha usado, aqui debes de especificar el nombre de la base de datos y el sub directorio (opcional).

En este modo por default la carpeta donde se almacenarán tus bases de datos será memvaz_databases, y si esta carpeta no existe se creará automaticamente.

Ejemplo

//Ejemplo 1
const db = require('memvaz.database');
let personas = new db.newDB('personas');
/*
Esto hará que se cree la base de datos personas.json dentro de la carpeta memvaz.database_databases

Estructura:

[+] memvaz.database_databases
    - personas.json

*/

//Ejemplo 2
const db = require('memvaz.database');
let economia = new db.newDB('guild_1', 'economia_db');
/*
Esto hará que se cree un sub directorio llamado "economia_db" dentro de la carpeta memvaz.database_databases, y dentro de este sub directorio se creará la base de datos guild_1.json

Estructura:

[+] memvaz_databases
    [+] economia_db
        - guild_1.json
    - niveles.json
*/

Modo #2

Este modo te permite hacer lo mismo que el modo #1, la unica diferencia es que ahora puedes especificar el nombre de la carpeta donde se almacenaran tus bases de datos y tambien añadir la opcion de que tu base de datos no se llegue a reescribir rapidamente.

En este modo solo se puede hacer uso de un parametro la cual debe de contener un objeto con 3 propiedades.

Ejemplo

//Ejemplo 1
const db = require('memvaz.database');
let niveles = new db.newDB({
  nombre: "levels",
  carpeta: "datos_niveles"
});
/*
Esto hará que se cree la base de datos levels.json dentro de la carpeta mencionada.

Estructura:

[+] datos_niveles
    - levels.json

*/

El constructor memDB te permitira crear una base de datos en memoria de forma eficiente. Que quiere decir base de datos en memoria? Practicamente los datos que agregues no se guardaran en un archivo ya que se mantendran en la memoria interna de este package, recuerda que los datos que agregues se perderan cada vez que tu proyecto/app se apague o reinicie. Esto es perfecto para hacer cosas rapidas.

memDB(nombre_db)

Argumentos

1. nombre_db: Nombre de la base de datos, en caso de que quieras obtener los datos de esta db en otro archivo, solo debes de colocar el mismo nombre.

Recuerda

No habrá ningun problema si colocas el nombre de una base de datos que esta siendo usada en el constructor newDB, ambas dbs guardaran datos por separado.

Importante

Este constructor puede usar unicamente los siguientes metodos:

• establecer
• obtener
• tiene
• eliminar
• purgeall
• sumar
• restar
• push
• extract
• datos
• ordenar
• random
• keys
• values
• size
• find
• filter
• map
• some
• setIndex
• delIndex
• findKey
• partition

Ejemplos

//Ejemplo 1
const db = require('memvaz.database');
let puntos = new db.memvaz.database('niveles');
/*
Esto hará que se cree la base de datos niveles en la memoria interna
*/

Argumentos

1. Para cualquier img se usara el método: get

Recuerda

Respeta las mayúsculas y minúsculas ya que puede que salgan errores

Importante

Este constructor puede usar unicamente los siguientes metodos:

• getDog
• getFox
• getCat
• getPanda
• getMeme
• getHug
• getSmoke
• getKoala

Ejemplos

// Ejemplo de todos los constructores:

//Nota: El evento o emmiter debe estar en una función asíncrona.

/** 
 * @declare module memvaz.db => Declaramos el modulo
 * 
 * @async funtion()
 * 
 * @function get
 * 
 * @returns Link de la imágen
 * 
 * @example:
*/

const memvaz = require("memvaz.db") //Llamamos al npm.
        let imgDog = await memvaz.getDog() //Obtenemos la img del perro.
        let imgFox = await memvaz.getFox() //Obtenemos la img del zorro.
        let imgCat = await memvaz.getCat() //Obtenemos la img del gato.
        let imgPanda = await memvaz.getPanda() //Obtenemos la img del panda.
        let imgMeme = await memvaz.getMeme() //Obtenemos un meme random.
        let imgHug = await memvaz.getHug() //Obtenemos la img de hug.
        let imgSmoke = await memvaz.getSmoke() //Obtenemos la img smoke.
        let imgKoala = await memvaz.getKoala() //Obtenemos la img del koala.