schemix - GitLite

KO | EN

gitlite — search

#javascript #python #react #ai #typescript #android #machine-learning #rust #docker #awesome #cli #vue #awesome-list #pytorch

schemix

(★ 480)

Schemix allows you to programmatically create Prisma schemas using TypeScript ⌨️

파일 탐색기

최종 버전 다운로드 (.zip)

- - check-lint.yml
  - npm-publish.yml
  - unit-test.yml
- FUNDING.yml
- settings.json
- - index.ts
  - package.json
  - README.md
  - schema.prisma
  - tsconfig.json
  - yarn.lock
- - index.ts
  - package.json
  - README.md
  - tsconfig.json
  - yarn.lock
- - index.ts
  - package.json
  - README.md
  - schema.prisma
  - tsconfig.json
  - yarn.lock
- - index.ts
  - package.json
  - README.md
  - schema.prisma
  - tsconfig.json
  - yarn.lock
- - PrismaEnum.ts
  - PrismaEnumField.ts
  - PrismaModel.ts
  - PrismaRelationalField.ts
  - PrismaScalarField.ts
  - PrismaSchema.ts
- - prisma-block.ts
  - prisma-datasource.ts
  - prisma-enum.ts
  - prisma-field.ts
  - prisma-generator.ts
  - prisma-type-options.ts
- - blocks.ts
  - create.ts
  - export.ts
  - extend.ts
  - import.ts
  - options.ts
  - parse.ts
  - stack.ts
- index.ts
- - additional-paths.spec.ts.snap
  - additionalPaths.spec.ts.snap
  - incomplete-schema.spec.ts.snap
  - incompleteSchema.spec.ts.snap
  - index.spec.ts.snap
- - PrismaEnum.spec.ts
  - PrismaEnumField.spec.ts
  - PrismaModel.spec.ts
  - PrismaSchema.spec.ts
- additional-paths.spec.ts
- incomplete-schema.spec.ts
- index.spec.ts
- tsconfig.json
.eslintignore
.eslintrc
.gitignore
babel.config.cjs
LICENSE
package.json
README.md
tsconfig.json
vite.config.ts
yarn.lock

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
  <h1>Schemix</h1>
  <p>Easily create modular Prisma schemas.</p>
  <p>Welcome to Schemix. An easy-to-use TypeScript layer over designing Prisma schemas, allowing for modularization, mixins, and other added capabilities.</p>
  	<span>
		<a href="#installation">Installation</a>
		<span>&nbsp;&nbsp;·&nbsp;&nbsp;</span>
		<a href="#setup">Setup</a>
		<span>&nbsp;&nbsp;·&nbsp;&nbsp;</span>
		<a href="#usage">Usage</a>
		<span>&nbsp;&nbsp;·&nbsp;&nbsp;</span>
		<a href="#contribute">Contribute</a>
	</span>
</div>
<hr>

![example usage](https://user-images.githubusercontent.com/9158485/184518260-c6961cdd-e665-484c-ae83-e3896f604bd4.png)

## Installation

To install Schemix, simply use your favourite Node.js package manager.

```bash
yarn add schemix
```

```bash
npm install schemix
```

## Setup

You will need to create three folders that will contain your source files for your Prisma schema.

- `enums/`
- `mixins/`
- `models/`

Your resulting file structure for your project may end up looking like what follows.

```
project/
├── node_modules/
│   └── *
├── prisma/
│   ├── index.ts
│   ├── schema.prisma
│   ├── enums/
│   │   └── Status.enum.ts
│   ├── mixins/
│   │   ├── DateTime.mixin.ts
│   │   └── UUID.mixin.ts
│   └── models/
│       ├── Post.model.ts
│       └── User.model.ts
├── index.ts
├── tsconfig.json
└── package.json
```

Once that's set up, you can add a script to your `package.json` in your root directory for your project which runs the `prisma/index.ts` file, thus generating the `schema.prisma`. file. Any time you generate your `@prisma/client`, you should first re-run the schemix script.

## Usage

You can see an example usage in the [examples/](./examples) folder in this repository.

### Schema Index

```ts
// ./index.ts

import { createSchema } from "schemix";

createSchema({
  // basePath should be a path to the folder containing models/, enums/, and mixins/.
  basePath: __dirname,
  datasource: {
    provider: "postgresql",
    url: { env: "DATABASE_URL" },
  },
  generator: {
    provider: "prisma-client-js",
  },
}).export(__dirname, "schema");
```

### Model Structure

```ts
// ./models/User.model.ts

import { createModel } from "schemix";

import PostModel from "./Post.model";
import UUIDMixin from "../mixins/UUID.mixin";

export default createModel((UserModel) => {
  UserModel.mixin(UUIDMixin)
    .relation("friends", UserModel, { list: true, name: "friends" })
    .relation("friendsRelation", UserModel, { list: true, name: "friends" })
    .relation("posts", PostModel, { list: true });
});
```

As you can see, you can self-reference, and cross-reference relations, apply mixins, etc.

### Override Resulting Model Name

The model name will default to the name of the file, if you want to override this behaviour, simply pass it in as the first parameter in the `createModel` function.

```ts
// ./models/User.model.ts

import { createModel } from "schemix";

import PostModel from "./Post.model";
import UUIDMixin from "../mixins/UUID.mixin";

export default createModel("UserModel", (UserModel) => {
  UserModel.mixin(UUIDMixin)
    .relation("friends", UserModel, { list: true, name: "friends" })
    .relation("friendsRelation", UserModel, { list: true, name: "friends" })
    .relation("posts", PostModel, { list: true });
});
```

### Extending Models

Sometimes one model is derivative of another, and the extension feature can be quite useful for this.

If we want to extend the PostModel to create an ImagePostModel which has all its old properties but with an `imageUrl` string column, we can do so without having to re-write every single other attribute.

```ts
// ./models/ImagePost.model.ts

import { extendModel } from "schemix";

import PostModel from "./Post.model";

export default extendModel(PostModel, (ImagePostModel) => {
  ImagePostModel.string("imageUrl");
});
```

## Contribute

Feel free to contribute to the repository. Pull requests and issues with feature requests are _super_ welcome!