# simple-ultra-db

> serve

Latest version **3.1.0** (published 2022-06-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install simple-ultra-db
pnpm add simple-ultra-db
yarn add simple-ultra-db
bun add simple-ultra-db
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.1.0 |
| Published | 2022-06-25 |
| First published | 2022-02-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 11.7 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| Author | henrique-o-developer |
| Maintainers | henrique-o-developer |
| Keywords | db, simple, json |

## Links

- npm: https://www.npmjs.com/package/simple-ultra-db
- Repository: https://github.com/henrique-o-developer/simple-ultra-db
- Homepage: https://github.com/henrique-o-developer/simple-ultra-db#readme
- Issues: https://github.com/henrique-o-developer/simple-ultra-db/issues
- npm.io page: https://npm.io/package/simple-ultra-db

## Dependencies (2)

- [fs](https://npm.io/package/fs.md) 0.0.1-security
- [json-format](https://npm.io/package/json-format.md) ^1.0.1

## Alternatives

- [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads
- [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads
- [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads
- [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads
- [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads

## Recent versions

- 3.1.0 (latest) — 2022-06-25
- 3.0.5 — 2022-06-25
- 3.0.4 — 2022-06-25
- 3.0.3 — 2022-06-25
- 3.0.2 — 2022-06-25
- 3.0.1 — 2022-06-25
- 3.0.0 — 2022-06-25
- 2.0.2 — 2022-04-23
- 2.0.1 — 2022-04-23
- 2.0.0 — 2022-02-12
- 1.2.8 — 2022-02-09
- 1.2.7 — 2022-02-08
- 1.2.6 — 2022-02-08
- 1.2.5 — 2022-02-08
- 1.2.4 — 2022-02-08
- … 15 more at https://npm.io/package/simple-ultra-db/versions

## README

# commands

## PT

### criando a database

```js
    var db = new simpleUltraDb("./database/Itens.json", args)
    // ou
    var db = new simpleUltraDb("./database/Itens", args)
```

### args

1. return instance: 
    - true or false 
    - esse parametro determina se ao requisitar algo no banco de dados ele retornara o valor bruto ou uma outra instancia da database 
    - default: false
2. autosave:
    - true or false
    - esse parametro determina se quando voce fizer uma modificação ela salvara altomaticamente
    - default: true
3. autoGenerateArrayWhenNumber
    - true or false
    - resumindo caso voce use `set("a.1.1", "hehe-boy")` o resultado seria `{a: [["hehe-boy"]]}`
    - default: true
4. config
    - json
    - o parametro config do `json-formater`
    - default: `{type: 'space', size: 4}`
5. default
    - json
    - caso a database não existir, por padrão ela ira assumir esse valor
    - default: `{}`


### como usar:

__o primeiro caso sempre parte que voce ativou o `return instance`__

#### get

```js
    db.get("itemname").get("itemname")
    // ou 
    db.get("itemname.itemname")
```

#### set

```js
    db.get("item.item").set("more one item")
    //ou
    db.set("item.item", "more one item")
```

#### has

```js
    db.get("item.item").has()
    //ou
    db.has("item.item")

    //outra forma de usar é:

    db.get("item.item").has("maisUmItem")
    //ou
    db.has("item.item", "maisUmItem")

    // nesse caso ele ira checar se dentro de item.item existe maisUmItem, funciona pra array e object

```

#### push

```js
    db.get("item.array").push("item")
    // ou
    db.push("item.array", "item")
```

#### delete

```js
    db.get("all.deleteThis").delete()
    // ou
    db.delete("all.deleteThis")
```

#### pop 

```js
    db.get("all.pop").pop()
    // ou
    db.pop("all.pop")
```

### voce pode se referir a uma posição de um array colocando o index

```js
    /*
    * {
    *   all: []
    * }
    */

    db.set("all.1", "hehe-boy")

    /*
    * {
    *   all: [
    *       "hehe-boy"
    *   ]
    * }
    */
```

### updates:

- melhor uso de memoria ram com `async`<br>
- metodo `pop`<br>
- interação com elementos em um array passando o `index`<br>
- o metodo has agora conta com busca dentro do conteudo do `array/object`

---
_Source: https://npm.io/package/simple-ultra-db · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._