Jsoning - v1.0.0

jsoning

โœจ A simple key-value JSON-based lightweight database. โœจ


CodeCov Build Status Latest Stable Version NPM Downloads node-current FOSSA Status


View Demo ยท Report Bug ยท Request Feature


Jsoning is a simplified wrapper for Node.js that lets you write and read data to and from JSON files. It's designed to be beginner-friendly and easy to use, with a simple API that makes it easy to get started with. It's perfect for small projects, prototyping, and learning how to work with databases.

Features

  • Use existing JSON files to read and write key-value pairs
  • EventEmitters to listen to changes in the database
  • Atomic file writing to prevent data corruption
  • Easier to use than a toaster
  • TypeScript support for all the fixed-type addicts out there

Install ๐Ÿ’พ

Node.js v18.x or greater is required for this package to work.

npm i jsoning

# pnpm if you're feeling fast
pnpm i jsoning

# yarn if you're feeling fancy
yarn add jsoning

View the full documentation here.

Basic Usage

import { Jsoning, MathOps } from 'jsoning';
const db = new Jsoning('database.json');

// Set some values with a key
await db.set('birthday', '07-aug');
await db.set('age', '13');

// Push stuff to an array for a particular key
await db.push('transformers', 'optimus prime');
await db.push('transformers', 'bumblebee');
await db.push('transformers', 'iron hide');

// Get the value of a key
console.log(await db.get('transformers')); // [ 'optimus prime', 'bumblebee', 'iron hide' ]

// Get all the values
console.log(await db.all()); // { Record<string, JSONValue> of the whole database contents }

// does such a value exist?
console.log(await db.has('value2')); // false

// My age keeps changing, so I'm deleting it
console.log(await db.delete('age')); // true

// I got $100 for my birthday
await db.set('money', 100);

// and someone gave me $200 more
await db.math('money', MathOps.Add, 200);

// Just wanna make sure how much money I got
console.log(await db.get<number>('money')); // 300

// RIP iron hide, he died
await db.remove('transformers', 'iron hide');

// I'm getting bored, so I'm clearing the whole database
await db.clear();

Contributing

Please see CONTRIBUTING.md for more details on contributing!

Contributors

All Contributors

Thanks goes to these wonderful people (emoji key):

Khaleel Gibran
Khaleel Gibran

๐Ÿ’ป ๐Ÿ“– ๐ŸŽจ ๐Ÿš‡ โš ๏ธ โœ…
David
David

๐Ÿ“–
Jonyk56
Jonyk56

๐Ÿ’ป
ayntee
ayntee

๐Ÿ’ป
undefine
undefine

๐Ÿ’ป ๐Ÿ› ๐Ÿ›ก๏ธ
Aditya Gupta
Aditya Gupta

๐Ÿ’ป
Manuel Maly
Manuel Maly

๐Ÿ’ป ๐Ÿ›
wh0
wh0

๐Ÿ’ป
akpi816218
akpi816218

๐Ÿ’ป ๐Ÿ“– ๐Ÿ’ก ๐Ÿšง โš ๏ธ ๐Ÿ”ง

This project follows the all-contributors specification. Contributions of any kind are welcome!

License

This package is open sourced under the MIT License.

FOSSA Status