https://github.com/ajv-validator/ajv-pack

🚨[ARCHIVED] Produces a compact module exporting JSON-schema validation functions compiled by Ajv
https://github.com/ajv-validator/ajv-pack

ajv compiler json-schema validator

Last synced: 4 days ago
JSON representation

🚨[ARCHIVED] Produces a compact module exporting JSON-schema validation functions compiled by Ajv

• Host: GitHub
• URL: https://github.com/ajv-validator/ajv-pack
• Owner: ajv-validator
• License: mit
• Archived: true
• Created: 2016-09-22T20:05:01.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2020-12-13T15:29:22.000Z (almost 4 years ago)
• Last Synced: 2024-09-14T21:20:35.419Z (19 days ago)
• Topics: ajv, compiler, json-schema, validator
• Language: JavaScript
• Homepage: https://ajv.js.org
• Size: 40 KB
• Stars: 43
• Watchers: 5
• Forks: 8
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# ajv-pack

## DEPRECATED / ARCHIVED

Please use [standalone validation code](https://github.com/ajv-validator/ajv/blob/master/docs/standalone.md) module included in Ajv v7.

Produces a compact module exporting JSON-schema validation functions compiled by [Ajv](https://github.com/epoberezkin/ajv)

[![Build Status](https://travis-ci.org/epoberezkin/ajv-pack.svg?branch=master)](https://travis-ci.org/epoberezkin/ajv-pack)

[![npm version](https://badge.fury.io/js/ajv-pack.svg)](https://www.npmjs.com/package/ajv-pack)

[![Coverage Status](https://coveralls.io/repos/github/epoberezkin/ajv-pack/badge.svg?branch=master)](https://coveralls.io/github/epoberezkin/ajv-pack?branch=master)

## Purpose

This package allows to create standalone modules for validation functions that are pre-compiled and can be used without Ajv. It can be necessary for several reasons:

- to reduce the browser bundle size - Ajv is not included in the bundle (although if you have a large number of schemas the bundle can become bigger - when the total size of generated validation code is bigger than Ajv code).

- to reduce the startup time - the validation and compilation of schemas will happen during build time.

- to avoid dynamic code evaluation with Function constructor (used for schema compilation) - it can be prohibited in case [Content Security Policy](http://www.html5rocks.com/en/tutorials/security/content-security-policy/) is used.

__Please note__: there are many cases when Ajv works as expected and ajv-pack does not. Some of these cases are listed in [Limitations](#limitations). It is recommended to test schemas compiled with this package more thoroughly than you would when using Ajv (which is very stable and well tested). Please submit issues with cases that fail.

## Usage with CLI

In most cases you would use this package via [ajv-cli](https://github.com/jessedc/ajv-cli) (>= 1.0.0) to generate module that exports validation function.

```sh

npm install -g ajv-cli

ajv compile -s schema.json -o validate_schema.js

```

`validate_schema.js` will contain the module exporting validation function that can be bundled into your application.

## Usage from code

```sh

npm install ajv-pack

```

```javascript

var Ajv = require('ajv'); // version >= 4.7.4

var ajv = new Ajv({sourceCode: true}); // this option is required

var pack = require('ajv-pack');

var schema = {

  type: 'object',

  properties: {

    foo: {

      type: 'string',

      pattern: '^[a-z]+$'

    }

  }

};

var validate = ajv.compile(schema);

var moduleCode = pack(ajv, validate);

// now you can

// 1. write module code to file

var fs = require('fs');

var path = require('path');

fs.writeFileSync(path.join(__dirname, '/validate.js'), moduleCode);

// 2. require module from string

var requireFromString = require('require-from-string');

var packedValidate = requireFromString(moduleCode);

```

Ajv should still be a run-time dependency, but generated modules will only depend on some parts of it, the whole Ajv will not be included in the bundle if you require these modules from your code.

## Limitations

At the moment ajv-pack does not support schemas with:

- custom 'compiled' and 'validated' keywords; custom inline and macro keywords are supported.

- custom formats (they will be ignored during validation).

- recursive references (reference to the current schema `{ "$ref": "#" }` is supported).

- asynchronous schemas (they require custom keywords/formats).

## License

[MIT](https://github.com/epoberezkin/ajv-pack/blob/master/LICENSE)