# fmt-to-json

> Format string to a json like template.

Latest version **1.0.4** (published 2022-09-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install fmt-to-json
pnpm add fmt-to-json
yarn add fmt-to-json
bun add fmt-to-json
```

Provides the command `fmt2json`.

## 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 | 1.0.4 |
| Published | 2022-09-28 |
| First published | 2022-09-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 177.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | liujin0506 |
| Maintainers | liujin0506 |
| Keywords | fmt2json, format2json, json, zjson, toJson, beJson, str2json, string2json, str-to-json, string-to-json, fmt-to-json, format-to-json, json-kit, json-like, json-editor, json-tools, json-utils, json-formatter, json-algorithm |

## Links

- npm: https://www.npmjs.com/package/fmt-to-json
- Repository: https://github.com/liujin0506/format-to-json
- Homepage: https://github.com/liujin0506/format-to-json#readme
- Issues: https://github.com/liujin0506/format-to-json/issues
- npm.io page: https://npm.io/package/fmt-to-json

## Dependencies (3)

- [funclib](https://npm.io/package/funclib.md) ^5.1.3
- [enquirer](https://npm.io/package/enquirer.md) ^2.3.6
- [commander](https://npm.io/package/commander.md) ^2.19.0

## 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

- 1.0.4 (latest) — 2022-09-28
- 1.0.3 — 2022-09-28
- 1.0.2 — 2022-09-28
- 1.0.1 — 2022-09-28
- 1.0.0 — 2022-09-28

## README

# format-to-json

<p align="center">
  <a href="https://unpkg.com/format-to-json@2.1.1/index.html">
    <img src="https://github.com/liujin0506/format-to-json/blob/master/images/format_html.png?raw=true">
  </a>
</p>

[![npm](https://img.shields.io/npm/v/format-to-json.svg)](https://www.npmjs.com/package/format-to-json)
[![LICENSE MIT](https://img.shields.io/npm/l/format-to-json.svg)](https://github.com/liujin0506/format-to-json/blob/master/LICENSE)

> Format string to a json like template 

* [Usages](#Usages)
  - [In HTML](#in-html)
  - [In JavaScript](#in-javascript)
* [Intterface](#Interface)
  - [fmt2json](#mehtod-fmt2json)
  - [Options](#interface-options)
  - [Result](#interface-result)
* [Terminal](#Terminal)

## Usages

#### In HTML
```html
<script src="https://unpkg.com/format-to-json@2.1.2/fmt2json.min.js"></script>
<script>
  const source = `{"zjson":"ZJSON","description":"Online json formatter","version":"v4.1.8","updateTime":"2018-11-23","url":"http://zjson.net","project":"http://github.com/CN-Tower/zjson","language":["中文（简体）","English"],"keywords":["zjson","json formatter"],"content":{"array":["element 001","element 002"],"boolean":true,"null":null,"number":123,"string":"Hello World","object":{"property":"value","key":"val"}}}`;
  (async () => {
    const jsonLike = await fmt2json(source, { resultOnly: true });
    console.log(jsonLike);
  })()
</script>
```
#### In Javascript
Run: `npm install format-to-json --save`;
```javascript
const fmt2json = require('format-to-json');

(async () => {
  const source = '{"zjson":"ZJSON","description":"Online json formatter","version":"v4.1.8","updateTime":"2018-11-23","url":"http://zjson.net","project":"http://github.com/CN-Tower/zjson","language":["中文（简体）","English"],"keywords":["zjson","json formatter"],"content":{"array":["element 001","element 002"],"boolean":true,"null":null,"number":123,"string":"Hello World","object":{"property":"value","key":"val"}}}';

  fmtInfo = await fmt2json(source);
  console.log(fmtInfo.result);
})();
```
Result:
```terminal
{
  "zjson": "ZJSON",
  "description": "Online json formatter",
  "version": "v4.1.8",
  "updateTime": "2018-11-23",
  "url": "http://zjson.net",
  "project": "http://github.com/CN-Tower/zjson",
  "language": [
    "中文（简体）",
    "English"
  ],
  "keywords": [
    "zjson",
    "json formatter"
  ],
  "content": {
    "array": [
      "element 001",
      "element 002"
    ],
    "boolean": true,
    "null": null,
    "number": 123,
    "string": "Hello World",
    "object": {
      "property": "value",
      "key": "val"
    }
  }
}
```

## Interface

#### [Mehtod] fmt2json
```typescript
fmt2json(source: string, options?: Options): Promise<Result | string>;
```
#### [Interface] Options
```typescript
interface Options {
  indent?: number;      // Integer, Large then 0, default: 2
  expand?: boolean;   // Default: true
  strict?: boolean;   // Default: false
  escape?: boolean;   // Default: false
  unscape?: boolean;  // Default: false
  keyQtMark?: "'" | "\"" | ""; // Default: "\""
  valQtMark?: "'" | "\"";      // Default: "\""
}
```
#### [Interface] Result
```typescript
// If `{ resultOnly: true }` in option,
// Just return the format result string.
interface Result {
  result: string;
  status: {
    fmtLines: number;
    fmtType: 'info' | 'success' | 'warning' | 'danger';
    fmtSign: 'ost' | 'col' | 'val' | 'end' | 'war' | 'scc' | 'err';
    message: string;
    errFormat: boolean;
    errIndex: number;
    errExpect: string;
    errNear: string;
  }
}
```

## Terminal

<p align="left">
  <img width="500" src="https://github.com/liujin0506/format-to-json/blob/master/images/format_cmd.png?raw=true">
</p>

Run: `npm install -g format-to-json`   
Run: `fmt2json -h`
```terminal
Usage: fmt2json [options]

Options:
  -V, --version          output the version number
  -v, --version          output the version number
  -i, --indent <indent>  Indnet number.
  -q, --qtMark <qtMark>  Quotation mark, one of ['""', "''", '"', "'"] (default: "\"\"")
  -c, --collapse         Collapse the formatted results.
  -e, --escape           Escape the formatted results.
  -u, --unescape         Unescape source before format.
  -s, --strict           Strict mode.
  -r, --resultOnly       Result only, not return the formatted info.
  -h, --help             output usage information
```
Run: `fmt2json -i 4 -q "'"`
```terminal
√ Input a string to foramt: · [{name: "Tom", age: 28, gender: "male"}]

==================================================================
                [10:42:20] format-to-json(1.0.4)
------------------------------------------------------------------
[
    {
        name: 'Tom',
        age: 28,
        gender: 'male'
    }
]
------------------------------------------------------------------
{ fmtType: 'success',
  fmtSign: 'scc',
  fmtLines: 8,
  message: 'Success formated 8 lines!',
  errFormat: false,
  errIndex: NaN,
  errExpect: '',
  errNear: '' }
==================================================================
```

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