Denky Database

Um simples banco de dados em JSON com o foco em performance e simplicidade.

Inspirado no quick.db e no Enmap.

Eu tive essa ideia quando o meu bot Denky ainda usava Enmap pois eu não tinha alternativas leves ou gratuitas.

Ideal para bots do Discord ou projetos que precisem guardar dados facilmente em key-value.

---

Instalação e suporte

Instale a database com npm install denky-database

Obtenha ajuda em meu servidor do Discord: clique aqui

---

Exemplo básico

1const DatabaseManager = require('denky-database')
2
3//Essa será a varíavel que você usará para manipular a Database.
4const Database = new DatabaseManager('./banco.json')
5
6//Define a chave 'pessoas bonitas' para uma lista com Veric e BONEE
7Database.set('pessoas bonitas', ['Veric', 'BONEE'])
8
9//Adiciona o valor Toledo a chave 'pessoas bonitas' (apenas arrays/listas)
10Database.push('pessoas bonitas', 'Toledo')
11
12//Define a chave 'pessoas bonitas' para google.com
13Database.set('website', 'google.com')
14
15//Retorna o valor contido na chave website
16Database.get('website')
17
18//Excluí a chave website
19Database.delete('website')

---

Documentação

Interrogação (?) signfica que uma opção é opcional e já possui um valor atribuído por padrão.

Opções sem interrogação retornarão um erro dizendo que uma opção está faltando em tal metódo.

• Database#set(chave, valor) | Cria ou altera uma chave com o valor específico

  1Database.set('melhor bot', 'Denky')

  • Tipos:
    • Chave: string, number
    • Valor: any (*)
    • Resultado: undefined

• Database#get(chave) | Retorna o valor da chave

  1Database.get('melhor bot')

  • Tipos:
    • Chave: string | number
    • Resultado: undefined | any (*)

• Database#delete(chave) | Exclui uma chave

  1Database.delete('moedas')

  • Tipos:

    • Chave: string | number

    • Resultado: undefined

• Database#exists(chave) | Verifica se uma chave existe

  1Database.exists('moedas')

  • Tipos:
    • Chave: string | number
    • Resultado: boolean

• Database#add(chave, quantia) | Adiciona um número para a chave (adição)

  1Database.add('dinheiro', 1200)

  • Tipos:
    • Chave: string | number
    • Quantia: number
    • Resultado: undefined

• Database#remove(chave, quantia) | Remove um número para a chave (subtração)

  1Database.remove('dinheiro', 1200)

  • Tipos:
    • Chave: string | number
    • Quantia: number
    • Resultado: undefined

• Database#push(chave, item) | Adiciona um item a uma array

  1Database.push('amigos', 'Jookie')

  • Tipos:

    • Chave: string | number

    • Item: any

    • Resultado: undefined

• Database#pull(chave, item) | Remove um item de uma array

  1Database.pull('amigos', 'Darkness')

  • Tipos:
    • Chave: string | number
    • Item: any
    • Resultado: undefined

• Database#includes(chave, item) | Verifica se uma array possui um item específico

  1Database.includes('amigos', 'MrPowerGamerBR')

  • Tipos:
    • Chave: string | number
    • Item: any
    • Resultado: boolean

• Database#ping | Informa o tempo em miliseggundos para escrever e remover um item

  1Database.ping

  • Tipos:
    • Resultado: number

• Database#deleteAll() | Apaga todos os itens do banco de dados

  1Database.deleteAll()

  • Tipos:
    • Resultado: undefined

• Database#storage | Retorna o objeto da database

  1Database.storage

  • Tipos:
    • Resultado: object

• Database#all(tipo?) | Retorna todos os itens da database

  1Database.all('all') //Retorna todas as entradas da database
  2Database.all('keys') //Retorna todas as chaves da database
  3Database.all('values') //Retorna todas os valores da database

  • Tipos:
    • Resultado: object