markdown-body entry-content container-lg" itemprop="text">

JS Database (aka. NSCDB) v0.1.7

A simple lightweight package to manage data
Read the Wiki »
Explore the typedoc »
See Changelog »

Quickstart · Report Bug · Request Feature

About the Project
- Built With
- Dependencies
Getting Started
- Prerequisites
- Installation
Usage
- Basic Usage
Roadmap
Contributing
License
Contact

About The Project

Built With

Dependencies

Optional Dependencies

js-yaml@^3.14.0 - the package has an integrated adaptor for yaml using js-yaml (install if you want to use yaml)
xml-js@^1.6.11 - the package has an integrated adaptor for xml using xml-js (install if you want to use xml)

[See all dependencies]

Getting Started

To get the package up and running follow these simple steps.

Prerequisites

You should have already installed npm to install this package

npm install npm@latest -g

Installation

1. Install the package

[using npm]

npm i nscdb

[using yarn]

yarn add nscdb

2. (Optional) install optional dependencies

js-yaml (for using yaml files)
[using npm]

npm i js-yaml

[using yarn]

yarn add js-yaml

xml-js (for using xml files)
[using npm]

npm i xml-js

[using yarn]

yarn add xml-js

Usage

Basic Usage

Import using Typescript

import { createDatabase } from 'nscdb';
import { JsonFileAdapter } from 'nscdb/json_adapter';

Import using Javascript

const { createDatabase } = require('nscdb');
const { JsonFileAdapter } = require('nscdb/json_adapter');

A small system using the api

let database = await createDatabase(new JsonFileAdapter("./database.json"));

// Set defaults
database.setDefaults({
  users: []
});

// Push a value into the Database
let users = database.get("users");
users.push({
  id: database.generateId("users"),
  name: 'Harleen Dolan',
  password: 'a password'
});

users.push({
  id: database.generateId("users"),
  name: 'Lisa Bradley',
  password: 'another password'
});

// print output data from the database
console.log(database.data);

// Console Output:
// >> {
// >>   users: [
// >>     { id: 0, name: 'Harleen Dolan', password: 'a password' },
// >>     { id: 1, name: 'Lisa Bradley', password: 'another password' }
// >>   ],
// >>   id_counters: { users: 1 }
// >> }

// Save the Database
await database.saveData();

⇒ Continue after Quickstart ⇐

For more examples, please refer to the Documentation

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Fork the Project
Create your own Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

License

Distributed under the BSD2-Clause License. See LICENSE for more information.

Contact

Project Link: https://github.com/nsc-de/js-database

JS Database (aka. NSCDB) v0.1.7

Table of Contents

About The Project

Built With

Dependencies

Optional Dependencies

Getting Started

Prerequisites

Installation

1. Install the package

2. (Optional) install optional dependencies

Usage

Basic Usage

Roadmap

Contributing

License

Contact

License

nsc-de/js-database

ErrorLooks like something went wrong!

About

Topics

Resources

License

Code of conduct

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 7

Packages 0

Uh oh!

Contributors 3

Languages

Error
Looks like something went wrong!

Packages