Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/astrohelm/metaforge
Library 📝 that allow you to describe data structures by subset of JavaScript syntax and validate them at runtime
https://github.com/astrohelm/metaforge
astrohelm checker dsl generator javascript json json-schema lightweight metadata metalanguage modular modular-design modules-architecture nodejs runtime-verification schema testing types validation zero-dependencies
Last synced: about 2 months ago
JSON representation
Library 📝 that allow you to describe data structures by subset of JavaScript syntax and validate them at runtime
- Host: GitHub
- URL: https://github.com/astrohelm/metaforge
- Owner: astrohelm
- License: mit
- Created: 2023-10-09T18:38:42.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-24T12:26:38.000Z (7 months ago)
- Last Synced: 2024-11-02T02:33:12.327Z (about 2 months ago)
- Topics: astrohelm, checker, dsl, generator, javascript, json, json-schema, lightweight, metadata, metalanguage, modular, modular-design, modules-architecture, nodejs, runtime-verification, schema, testing, types, validation, zero-dependencies
- Language: JavaScript
- Homepage: https://astrohelm.ru
- Size: 334 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Authors: AUTHORS
Awesome Lists containing this project
README
MetaForge v1.0.0 🕵️
## Describe your data structures by subset of JavaScript and:
- 📝 Generate data relational structures (types, jsdoc, diagrams, migrations, etc.)
- 🔎 Validate it in runtime with strict & partial validations
- 👀 Send it to other server to validate data consistency
- 🛠️ Handle it with custom modules
- 💉 Calculate fields
## Installation
```bash
npm i metaforge --save
```
## Usage example
```js
const userSchema = new Schema({
$id: 'userSchema',
$meta: { '@name': 'User', '@description': 'Schema for user testing' }, //? JSDOC
phone: { $type: 'union', types: ['number', 'string'] }, //? number or string
name: { $type: 'set', items: ['string', '?string'] }, //? set tuple
phrase: (sample, parent, root) => 'Hello ' + [...parent.name].join(' ') + ' !', // Calculated fields
mask: { $type: 'array', items: 'string' }, //? array of strings
ip: {
$meta: { '@description': 'User ip adress' },
$type: 'array',
$required: false,
$rules: [ip => ip[0] === '192'], //? custom rules
items: {
$type: 'union',
types: ['string', 'number', 'null'], // Array
condition: 'oneof',
$required: true,
},
},
type: ['elite', 'member', 'guest'], //? enum
'/[a-Z]+Id/': { $type: '?number', isPattern: true }, // pattern fields
address: 'string',
secondAddress: '?string', // optional fields
options: { notifications: 'boolean', lvls: ['number', 'string'] },
});
const systemSchema = new Schema({ $type: 'array', items: userSchema });
const sample = [
{
myId: 1,
phone: '7(***)...',
ip: ['192', 168, '1', null],
type: 'elite',
mask: ['255', '255', '255', '0'],
name: new Set(['Alexander', undefined]),
options: { notifications: true, lvls: [2, '["admin", "user"]'] },
address: 'Pushkin street',
},
//...
];
systemSchema.warnings; // Inspect warnings after build
systemSchema.calculate(sample); // Will assign calculated fields
systemSchema.test(sample); // Schema validation
systemSchema.dts('SystemInterface'); // Typescript generation
systemSchema.pull('userSchema').test(sample[0]); // Subschema validation
systemSchema.pull('userSchema').test({ phone: 123 }, 'root', true); // Partial validation
systemSchema.pull('userSchema'); // Metadata: {..., name: 'user', description: 'schema for users testing'}
```
## Docs
- ### [About modules / plugins](./docs/modules.md#modules-or-another-words-plugins)
- [Writing custom modules](./docs/modules.md#writing-custom-modules)
- [Metatype](./modules/types/README.md) | generate type annotations from schema
- [Handyman](./modules/handyman/README.md) | quality of life module
- [Metatest](./modules/test/README.md) | adds prototype testing
- ### [About prototypes](./docs/prototypes.md#readme-map)
- [How to build custom prototype](./docs/prototypes.md#writing-custom-prototypes)
- [Contracts](./docs/prototypes.md#schemas-contracts)
Copyright & contributors
Copyright © 2023 Astrohelm contributors.
This library is MIT licensed.
And it is part of Astrohelm ecosystem.