datagen

A random data generator which can be used to generate random data for testing purposes. The result schema can be defined using a JSON file.

The readme is still a work in progress, but you can check out the docs (opens in a new tab) for more information and examples. Check out the demo (opens in a new tab) to see datagen in action.

Similar projects

• synth (opens in a new tab)
• generatedata (opens in a new tab)

This project is heavily inspired by synth (opens in a new tab) but features more complex references and a plugin system.

Usage

Simply grab a binary built during a workflow run (opens in a new tab) or build it yourself using cargo build -p cli --release.

Docker

You can also use the Docker image ghcr.io/markusjx/datagen to run datagen in a container.

docker run -v $(pwd):/data ghcr.io/markusjx/datagen generate /data/schema.json /data/output.json

Check out the docker image documentation (opens in a new tab) for more information.

Command-line interface

datagen provides a command-line interface either written in Rust or TypeScript.

Rust CLI

The Rust CLI is the main CLI and is the most feature-rich CLI. It is also the fastest CLI.

Installation

You can download a binary from the releases page (opens in a new tab) or build it yourself using cargo build -p cli --release. The node CLI can be installed using npm install -g @datagen/cli.

Quick start

Create a file called schema.json with the following content:

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "value": "John"
    },
    "age": {
      "type": "integer",
      "value": 20
    }
  }
}

Then run datagen generate schema.json to generate data.

Available generators

Generators are used to generate random data. The generators are defined in the schema file as JSON objects. The following generators are available:

• integer (opens in a new tab): Generates random integers.
• number (opens in a new tab): Generates random floating point numbers.
• string (opens in a new tab): Generates random strings.
• bool (opens in a new tab): Generates random booleans.
• array (opens in a new tab): Generates random arrays.
• object (opens in a new tab): Generates random objects.
• reference (opens in a new tab): Used to reference (or copy) other data.
• anyOf (opens in a new tab): Chooses random data from a list of data.
• flatten (opens in a new tab): Flattens an array or object.
• plugin (opens in a new tab): Generates data using plugins (opens in a new tab).

JSON schema

A JSON schema file is provided for type checking. You can find it here (opens in a new tab).