luisrudgeprisma-generator-fake-data
Generated with Bing Image Creator. Prompt: create a logo with a cute panda smiling and holding a triangular prisma, digital art
The easiest way to generate mock data based on your Prisma models!
What is prisma-generator-fake-data?
It's a Prisma Generator that uses faker.js to create realistic-looking fake data for your Prisma models. With this generator, you can quickly and easily create fake data for your Prisma models, without having to write barely any code.
Get started
- Setup your Prisma project as usual (Get Started With Prisma)
Install this package
npm install -D prisma-generator-fake-datayarn add -D prisma-generator-fake-datapnpm install -D prisma-generator-fake-databun add -D prisma-generator-fake-data
Modify your Prisma model file
generator custom_generator { provider = "prisma-generator-fake-data" output = "../types/fake-data.ts" }- Run
npx prisma generate
You're all done!
If you prefer, you can easily get started with this CodeSandbox.
Usage
Once the file is generated, you can import it in your project.
generator client {
provider = "prisma-client-js"
}
generator custom_generator {
provider = "prisma-generator-fake-data"
/// by default, the file will be generated at `./prisma/fake-data.ts`
}
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}
model User {
id String @id @default(cuid())
email String @unique
name String
/// Use comments to specify the faker method. For example:
///FAKE:faker.location.streetAddress({ useFullAddress: true })
address String
///FAKE:{notificationsEnabled: faker.datatype.boolean(), preferredColor: faker.color.rgb()}
settings Json
status UserStatus
profile Profile?
}
model Profile {
id Int @id @default(autoincrement())
someConfiguration Boolean
userId String @unique
user User @relation(fields: [userId], references: [id])
}
enum UserStatus {
active
inactive
}import { fakeUser, fakeProfileComplete } from './prisma/fake-data'; //or your custom output path
console.log(fakeUser());
console.log(fakeProfileComplete());
/*
{
email: 'Ella.Mayer@gmail.com',
name: 'Lana Gulgowski',
age: 81,
settings: { notificationsEnabled: true, preferredColor: '#ee5344' },
maybeString: undefined,
status: 'active'
}
{
id: 96601,
someConfiguration: true,
userId: '821cf67a-dd86-49d7-b0e4-9ad451ad173d'
}
*/Generator options
| Option | Required | Default | Example | Description |
|---|---|---|---|---|
| output | no | "./fake-data.ts" |
"../types/fake-data.ts" |
Path where the file will be exported to. Base folder is your prisma folder. |
| extraImport | no | "" |
"import {myCustomFunction} from '../utils/fakeImports'" |
This import will be added to your generated file. Useful when you want to use a custom function to generate fake JSON data. You can use your TypeScript aliases. Base folder is your prisma folder. |
| extraExport | no | "" |
"export * from '../utils/fakeImports'" |
This export will be added to your generated file. Useful when you want to export all of the fake methods created by this generator from the same file. Base folder is your prisma folder. |
| emptyValueAs | no | "undefined" |
"null" |
By default, optional fields will be generated with undefined. You can change this behavior by overriding this parameter. You can use a function imported in extraImport or just pass a hardcoded value like "null". |
Fields with special treatment:
name,fullName,firstName,lastName, andagewill use specificfaker-jsmethods to appear more realistic.- If you have an optional Prisma field (e.g.,
message String?), the fake data generator will always returnundefinedfor that property (customizable through theemptyValueAsoption). - If you have a
JSONPrisma field, you can add your own data shape by adding a special comment above your field.- Example:
///FAKE:{test: faker.lorem.word()} - Keep in mind that the generator will simply relay whatever is after the
FAKE:string to your generated code, so it needs to be valid TypeScript. - By using the
extraImportgenerator option, you can create your own helper methods to generate fake data for your JSON fields
- Example:
Inspired by https://github.com/toyamarinyon/prisma-factory-generator
This generator was bootstrapped using create-prisma-generator