Quick Start

First install the rngo CLI with Homebrew:

brew install rngodev/tap/cli

Next sign up for rngo, go to the API keys page, create an API key and copy it. Then log into the CLI and enter the API key when prompted:

rngo login
> API Key: *************

Make a file called rngo.yml with this configuration:

seed: 1
effects:
  users.create:
    schema:
      type: object
      properties:
        id:
          type: id.integer
        name:
          type: person.name
  posts.create:
    schema:
      type: object
      properties:
        id:
          type: id.integer
        title:
          enum:
            - Lorem Ipsum
            - Dolor Sit Amet
            - Sed Mattis Eu Erat
        authorId:
          type: function
          expression: user.id
          variables:
            user:
              type: reference
              effect: users.create

Now run the simulation like this:

rngo sim --spec rngo.yml --stdout

This will output data that looks something like this:

{"entity":"users","offset":683878,"value":{"id": 1, "name": "Alice Jones"}}
{"entity":"users","offset":729698,"value":{"id": 2, "name": "Bob Hyland"}}
{"entity":"posts","offset":1036600,"value":{"id": 1, "title": "Lorem Impsum"},"authorId":1}

Next Step

Visit Application Setup to learn how to integrate rngo into your own application.