mzrdb
TypeScript icon, indicating that this package has built-in type declarations

1.6.0 • Public • Published

New version 1.6.0!

  • findOne function added!

About

  • Designed for Beginners: The mzrdb module simplifies working with databases for new programmers. It provides an intuitive key-value interface, making data storage and retrieval a breeze.
  • Built on Proven Technologies: mzrdb leverages established database tools like Mongoose, Json, Yaml and Bson. This ensures compatibility and a familiar experience for developers.
  • Future-Proof Flexibility: The mzrdb module is designed with expandability in mind. Support for additional database types is planned for future releases, offering even greater flexibility.

Features

  • Beginner-friendly
  • All-inclusive
  • Easy to use
  • Customizable separators
  • Key-value methods
  • Quick response times
  • Seamless database switching

Benefits

  • Streamlined development process
  • Optimal performance and efficiency
  • Ultimate flexibility
  • Open-source and actively maintained
  • Extensive documentation and tutorials
  • Reliable and robust solutio

Moving Data From Quick.DB to mzrdb (Local Database)

const db = require('mzrdb');
const quickdb = require('quick.db');

await db.move(quickdb);

Moving Data From mzrdb to MongoDB

const db = require('mzrdb');
const jsondb = require('../yourFile.json');
db.setAdapter('mongodb', { url: 'yourMongoURL' });

await db.moveToMongo(jsondb);

All Mongo Adapter Methods

const db = require('mzrdb')

db.setLanguage('en') // en
db.setCheckUpdates(true) // true
db.setAdapter('mongodb', { url: 'yourMongoURL', schema: 'mzrdb', seperator: '.' }) // true
db.setFolder('mzrdb') // true
db.setFile('mzrdb') // true
db.setSeperator('-') // true

await db.set('key.mzr', 'value') // key: { mzr: "value" }
await db.set('key', 'value') // key: "value"

await db.add('key2', 1) // 1
await db.sub('key2', 1) // 0
await db.subtract('key2', 1) // 0

await db.get('key') // "value"
await db.fetch('key') // "value"

await db.all() // { key: "value" }
await db.getAll() // { key: "value" }
await db.fetchAll() // { key: "value" }

await db.all('object') // [[ "key", [ "value" ] ]]
await db.all('keys') // [ "key" ]
await db.all('values') // [ [ "value" ] ]

await db.push('key', 'value') // key: ["value"]
await db.push('key', 'mzr') // key: ["value", "mzr"]
await db.unpush('key', 'value') // ["mzr"]

await db.push('key', { mzr: 'value' }) // [ { mzr: "value" }]
await db.push('key', { mzr2: 'value2' }) // [ { mzr: "value" }, { mzr2: "value2" } ]

await db.delByPriority('key', 1) // [ { mzr2: "value2" } ]
await db.setByPriority('key', { new2: 'This Edited!' }, 1) // [ { new2: "This Edited!" } ]

await db.find('key', { mzr: 'value' }) // [ { mzr: "value" } ]
await db.findOne('key', { mzr: 'value' }) // { mzr: "value" }

await db.findAndUpdate('key', { mzr: 'value' }, { mzr: 'value2' }) // [ { old: { mzr: "value" }, new: { mzr: "value2" } } ]
await db.findAndDelete('key', { mzr: 'value' }) // [ { mzr: "value" } ]

await db.findOneAndUpdate('key', { mzr: 'value' }) // { old: { mzr: "value" }, new: { mzr: "value2" } }
await db.findOneAndDelete('key', { mzr: 'value' }) // { mzr: "value" }

await db.type('key') // string
await db.has('key') // true
await db.check('key') // true

await db.del('key') // true
await db.delete('key') // true

await db.deleteAll() // true (Cleans database)
await db.clear() // true (Cleans database)

await db.backup('fileName') // true (Backups database)
await db.destroy() // true (Deletes database file)

await db.uptime() // 30000 (Milliseconds)

await db.connecetion() // true
await db.disconnect() // true
await db.deleteMongo() // true

await db.exports('fileName') // true (Highly advanced)
await db.export('fileName') // true (Highly advanced)

await db.length() // 20 (Character count)

db.ping // { read: "1ms", write: "2ms", average: "1.5ms" }
db.size // 11 Bytes (Database size)
db.version // 1.6.0 (Module version)

All Local Adapter Methods

const db = require('mzrdb')

db.setLanguage('en') // en
db.setReadable(false) // false
db.setNoBlankData(false) // false
db.setCheckUpdates(true) // true
db.setAdapter('jsondb') // true
db.setFolder('mzrdb') // true
db.setFile('mzrdb') // true
db.setSeperator('-') // true

db.set('key.mzr', 'value') // key: { mzr: "value" }
db.set('key', 'value') // key: "value"

db.add('key2', 1) // 1
db.sub('key2', 1) // 0
db.subtract('key2', 1) // 0

db.get('key') // "value"
db.fetch('key') // "value"

db.all() // { key: "value" }
db.getAll() // { key: "value" }
db.fetchAll() // { key: "value" }

db.all('object') // [[ "key", [ "value" ] ]]
db.all('keys') // [ "key" ]
db.all('values') // [ [ "value" ] ]

db.push('key', 'value') // key: ["value"]
db.push('key', 'mzr') // key: ["value", "mzr"]
db.unpush('key', 'value') // ["mzr"]

db.push('key', { mzr: 'value' }) // [ { mzr: "value" }]
db.push('key', { mzr2: 'value2' }) // [ { mzr: "value" }, { mzr2: "value2" } ]

db.delByPriority('key', 1) // [ { mzr2: "value2" } ]
db.setByPriority('key', { new2: 'This Edited!' }, 1) // [ { new2: "This Edited!" } ]

db.find('key', { mzr: 'value' }) // [ { mzr: "value" } ]
db.findOne('key', { mzr: 'value' }) // { mzr: "value" }

db.findAndUpdate('key', { mzr: 'value' }, { mzr: 'value2' }) // [ { old: { mzr: "value" }, new: { mzr: "value2" } } ]
db.findAndDelete('key', { mzr: 'value' }) // [ { mzr: "value" } ]

db.findOneAndUpdate('key', { mzr: 'value' }) // { old: { mzr: "value" }, new: { mzr: "value2" } }
db.findOneAndDelete('key', { mzr: 'value' }) // { mzr: "value" }

db.type('key') // string
db.has('key') // true
db.check('key') // true

db.del('key') // true
db.delete('key') // true

db.deleteAll() // true (Cleans database)
db.clear() // true (Cleans database)

db.backup('fileName') // true (Backups database)
db.loadBackup('./mzrdb-backup') // true
db.destroy() // true (Deletes database file)

db.startsWith('ke') // [ { key: "key", data: "value" } ]
db.includes('e') // [ { key: "key", data: "value" } ]
db.endsWith('ey') // [ { key: "key", data: "value" } ]

db.length('object') // 1 
db.length() // 20 (Character count)

db.ping // { read: "1ms", write: "2ms", average: "1.5ms" }
db.size // 11 Bytes (Database size)
db.version // 1.6.0 (Module version)

Contact & Support

Discord Server

Package Sidebar

Install

npm i mzrdb

Weekly Downloads

26

Version

1.6.0

License

MIT

Unpacked Size

124 kB

Total Files

19

Last publish

Collaborators

  • mzrdev