Giter VIP home page Giter VIP logo

json-literal-typer's Introduction

JSON literal typer

npm version unit-tests npm-publish codecov

There are some tools out there that will produce TypeScript Interfaces from a given JSON structure for you. But they only give you the basic types (string, number, etc.). What if there is an API where you want to get its literal values/types?

Install

# to add to your project
npm install json-literal-typer
# to use command line interface
npm install --global json-literal-typer

Demo

There is a live demo at https://json-literal-typer.peppnet.de

Example

Let's assume there is an API for gas stations. It will respond with data like this:

{
  "stations": [
    { "id": 1, "name": "station A", "status": "OPEN", "attributes": ["fast"] },
    {
      "id": 2,
      "name": "station B",
      "status": "OPEN",
      "attributes": ["fast", "24/7"],
      "operator": "Station Corp."
    },
    {
      "id": 3,
      "name": "station C",
      "status": "CLOSED",
      "attributes": [],
      "operator": "ACME Inc."
    }
  ]
}

What you would get from other tools is:

interface Station {
  id: number;
  name: string;
  status: string;
  attributes: string[];
  operator?: string;
}
interface RootObject {
  stations: Station[];
}

Nice. But what if you could get:

interface Stations {
  attributes: ('24/7' | 'fast')[];
  id: 1 | 2 | 3;
  name: 'station A' | 'station B' | 'station C';
  operator?: 'ACME Inc.' | 'Station Corp.';
  status: 'CLOSED' | 'OPEN';
}

interface Root {
  stations: Stations[];
}

CLI

npm show json-literal-typer versions --json | json-literal-typer

related or inspiring projects

  • json-to-ts - Convert jsons to typescript interfaces
  • json2ts - generate TypeScript interfaces from JSON
  • quicktype - Generate types and converters from JSON, Schema, and GraphQL
  • ts-ast-viewer - TypeScript AST viewer

json-literal-typer's People

Contributors

mscottnelson avatar pabra avatar q00u avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

json-literal-typer's Issues

Does not handle escape sequences well

I've been trying to make this work with escape sequences, and have pretty much run up my clock on the task. Consider wishing to supply a RegExp related value in JSON, like so:
{"timeStampRegex": "<\\d+>(\\w+ \\d{2} \\d{2}:\\d{2}:\\d{2}).*"}

Currently, analyze() removes the escape characters. I figured that supplying a "raw string to analyze" could be a good workaround, and open analyze up to accepting either an object (when escape sequences and/or special characters are not needed) or a raw string, in which case a desire for exact preservation is assumed.

I thought I might be able to get somewhere with String.raw`<\\d+>(\\w+ \\d{2} \\d{2}:\\d{2}:\\d{2}).*`; and I think this is still an important element for the tests, but somehow, I think the values need to be double stringified: ie, input json string -> JSON.stringify -> JSON.parse to allow the eventual written value to maintain the exact string value supplied.

Would love to hear if you have any ideas about how to approach this problem.

cli usage

Allowing to use this package in scripts or in cli to make it easily usable.

json-literal-typer myType.json -o myTypeInterface.ts

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.