schemix - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #llm #machine-learning #docker #nodejs #macos #windows #cli #kubernetes #security #pytorch #ios #openai

schemix

(★ 480)

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

File Explorer

Download Latest Version (.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

# Installation Guide

1. Get the code

git clone https://github.com/ridafkih/schemix

Downloads the entire project code from GitHub to your computer.

cd schemix

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

yarn add schemix

Type this command into your terminal and run it.

npm install schemix

Downloads and installs the libraries listed in package.json.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// 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!